プロジェクトに機能を追加する - Amazon CloudWatch

プロジェクトに機能を追加する

CloudWatch Evidently の機能 は、起動する機能、またはバリエーションをテストする機能を表しています。

機能を追加する前に、プロジェクトを作成する必要があります。詳細については、「 の新規プロジェクトの作成」を参照してください。

プロジェクトに機能を追加するには
  1. CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/) を開きます。

  2. ナビゲーションペインで、[Application Signals][Evidently] の順に選択します。

  3. プロジェクトの名前を選択します。

  4. [Add feature] (機能を追加) を選択します。

  5. [Feature name] (機能名) に、このプロジェクト内でこの機能を識別するために使用する名前を入力します。

    オプションとして機能の説明を追加することもできます。

  6. [Feature variations] (機能のバリエーション) では、[Variation type] (バリエーションの型) として [Boolean][Long][Double]、または [String] を選択します。詳細については、「バリエーションの型」を参照してください。

  7. 機能に最大 5 つのバリエーションを追加します。各バリエーションの [Value] (値) は、選択した Variation type (バリエーションの型) として有効である必要があります。

    デフォルトにするバリエーションの 1 つを指定します。これは、他のバリエーションが比較対象とするベースラインであり、現在ユーザーに提供されているバリエーションであることが望ましいです。これは、この機能の起動や実験に加わっていないユーザーに提供されるバリエーションでもあります。

  8. [Sample code] (サンプルコード) を選択します。コード例は、バリエーションをセットアップしてそこにユーザーセッションを割り当てるためにアプリケーションに追加する必要があるものを示しています。コードには JavaScript、Java、および Python を選択できます。

    今すぐアプリケーションにコードを追加する必要はありませんが、起動または実験を開始する前に、追加する必要があります。

    詳細については、「アプリケーションにコードを追加する」を参照してください。

  9. (オプション) 特定のユーザーに常に特定のバリエーションが表示されるように指定するには、[Overrides] (オーバーライド)、[Add override] (オーバーライドを追加) を選択します。次に、ユーザー ID、アカウント ID、またはその他の識別子を [Identifier] (識別子) に入力してユーザーを指定し、そのユーザーに表示されるバリエーションを指定します。

    これは、自分のテストチームのメンバーや他の内部ユーザーに特定のバリエーションが必ず表示されるようにする場合に便利です。オーバーライドが割り当てられているユーザーのセッションは、起動または実験メトリクスに寄与しません。

    [オーバーライドを追加] を再度選択すると、最大 20 人のユーザーに対してこれを繰り返すことができます。

  10. (オプション) この機能にタグを追加するには、[Tags] (タグ)、[Add new tag] (新しいタグを追加) を選択します。

    [Key] (キー) に、タグの名前を入力します。[値] では、任意でタグに値を追加できます。

    (オプション) 別のタグを追加するには、[Add new tag] (新しいタグを追加) を再度選択します。

    詳細については、「AWS リソースのタグ付け」を参照してください。

  11. [Add feature] (機能を追加) を選択します。

バリエーションの型

機能を作成してバリエーションを定義するときは、バリエーションの型を選択する必要があります。可能な型は次のとおりです。

  • ブール値

  • 長整数

  • 倍精度浮動小数点数

  • 文字列

バリエーションの型で、コード内の異なるバリエーションを区別する方法を設定します。バリエーションの型を使用すると、CloudWatch Evidently の実装を簡素化し、起動や実験で機能を変更するプロセスを簡素化することもできます。

例えば、バリエーションを長整数型にして機能を定義する場合、バリエーションを区別するために指定する整数は、コードに直接渡される数値になります。ボタンのピクセルサイズをテストするとします。バリエーションの型の値は、各バリエーションで使用されるピクセル数になります。各バリエーションのコードは、バリエーションの型の値を読み取り、それをボタンのサイズとして使用できます。他のコードを変更せずに、バリエーションの値に使用される数値を変更すれば、新しいボタンサイズをテストできます。

機能内でバリエーションの型の値を設定する場合、CloudWatch Evidently の最初の試行として A/A テストを行う場合や、その他の理由がある場合を除き、同じ値を複数のバリエーションに割り当てないようにしてください。

Evidently は、JSON を型としてネイティブサポートしていませんが、文字列のバリエーション型で JSON を渡し、コード内でその JSON を解析できます。