このページでは

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

実験を設定する

機能実験は次の2段階のプロセスで設定します。

  • デプロイメントを作成します。
  • 使用したい SDK をインストールします。

実験の設定は実験の作成と同じではありません。 実験を作成する前に、実験を設定し、それが機能していることを確認してください。 このページでは機能実験について説明します。Web 実験を設定するには、Web 実験を実装してください。

デプロイメントを作成します。

実験では、デプロイメントはコード実行のためのフラグや実験のグループを提供します。デプロイメントを作成すると、実験はフラグと実験をルーティングするためのアクセスキーを生成します。

デプロイメントは、Amplitude アナリティクスプロジェクト内に存在します。プロジェクトには複数のデプロイメントを配置できますが、各デプロイメントは1つのプロジェクトに関連付けられます。

デプロイを作成するには、次の手順に従ってください。

  1. 実験 > Deployments に移動し、Create Deployment をクリックします。

  2. デプロイメントに関連付けるAmplitude アナリティクスプロジェクトを選択します。複数のプロジェクトでデプロイメントを作成するには、ドロップダウンリストから関連するすべてのプロジェクトを選択します。

  3. デプロイメントの分かりやすい名前を入力します。

  4. そのタイプを指定します：

    • クライアント側: これらのデプロイメントは、Web ブラウザやモバイルアプリなどのクライアントデバイス上で実行されます。 クライアントデプロイメント用のデプロイメントキーは一般に閲覧可能であり、クライアント側のSDKと連携します。
    • サーバー側: これらのデプロイメントは、Webサーバーやバッチ処理システムなど、ユーザーが制御するサーバー上で実行されます。サーバーデプロイメント用のデプロイメントキーは秘密にしておき、サーバー側のSDKと併用してください。サーバー側のキーは、フラグ評価のためにREST APIにアクセスできます。完全な実験を実行するのではなく、REST API を使用してフラグを評価するだけの必要がある場合は、サーバー側のデプロイメントを作成してください。

  5. デプロイメントを作成をクリックします。実験はデプロイメントを作成し、コピーして使用するためのキーを生成します。

デプロイメントキー

各デプロイメントでは、データの整合性を確保する一意のキーが生成されます。キーは、実験で収集されたすべてのデータをそのデプロイメントに関連付けるため、結果とアナリティクスの正確性が維持されます。キーに関する詳細については、「キーとトークン」を参照してください。

  • クライアント側のキー: クライアントデプロイメント用のデプロイメントキーは、公開されています。
  • サーバー側のキー: サーバーデプロイメント用のデプロイメントキーは秘密にしておき、サーバー側のSDKでのみ使用してください。サーバー側のキーは、フラグ評価のためにAPIにアクセスします。

SDKをインストールする

API を使用しない場合は、次に実験 SDK をインストールしてください。 すべてのSDKは、ユーザーにサービスを提供するフラグ設定を決定するためにAmplitude 実験にリクエストを送信します。クライアント側とサーバー側の SDK の違いは次のとおりです。

エンジニアはSDKをインストールする必要があります。 そうしないと、データリポジトリに問題が発生するリスクがあります。

クライアント側の SDK は、エンドユーザーアプリケーションの導入環境で実行されます。 クライアント側の SDK：

  • 単一ユーザーの導入を想定しています。
  • クライアント側の導入キーを使用します。これは公開され、エンドユーザーに表示されます。
  • 指定されたユーザーのバリアントを事前に取得します。
  • オフラインモード用にバリアントをクライアントにローカルに保存します。

サーバー側 SDK はサーバー環境で実行されます。 サーバー側のSDK：

  • 複数ユーザーの導入を想定しています。
  • サーバー側のデプロイメントキーを使用してください。このキーは秘密にしておく必要があります。
  • 各リクエストでバリアントを取得します。

ユーザーのコンテキスト

バリアントを割り当てる際、評価エンジンはターゲット設定ルールをユーザーコンテキストオブジェクトに適用します。これは個々のユーザーのIDを表します。クライアント側の SDK では、SDK は初期化時にこのオブジェクトを設定し、バリアント要求ごとにそれをサーバーに渡します。 サーバー側の SDK では、ユーザーは変更されることがあり、SDK はリクエストごとにユーザーを設定します。

個々のユーザーを対象にバリアントを割り当てる場合、実験はuser_idやdevice_idなど、リストされている任意のユーザー識別子を照合します。ルールベースのユーザーセグメントを使用すると、ユーザーは事前定義された任意のプロパティ（国、プラットフォームなど）またはuser_propertiesオブジェクト内のカスタムプロパティに基づいて一致します。実験ユーザーの定義について詳しくはこちらをご覧ください。

アナリティクスへのデータの送信に使用するのと同じユーザーIDをAmplitude 実験に使用してください。このようにして、IDは正しく解決され、アナリティクスは生成されたデータを同じユーザーに関連付けることができます。

これは役に立ちましたか？