データモデル

Amplitudeでは、組織は階層構造の最上位レベルです。 組織内では、実験はAmplitudeアナリティクスが定義したプロジェクト構造に従います。すべての実験データを1つの分析プロジェクトに関連付けてください。

Amplitudeプロジェクトにはフラグ、実験、デプロイメントが含まれています。

プロジェクト

実験はAmplitudeアナリティクスと同じプロジェクトを使用しています。 ベストプラクティスとして、プロダクトごとおよび環境ごとにプロジェクトを作成してください。フラグ、実験、およびデプロイメントは単一のプロジェクト内にのみ存在するため、これらのオブジェクトは同じプロダクトについて複数のプロジェクトに複製してください。

デプロイメントは、アプリケーションで使用するためのフラグや実験のグループを提供します。各プロジェクトには、プロジェクト API キーをデプロイメントキーとして使用するデプロイメントがあります。デフォルトで使用できます。 Amplitudeはデプロイメントキーをランダムに生成します。 作成時に、Amplitudeは各実験デプロイメントに関連付けられたデプロイメントキーを割り当てます。 実験はデプロイメントキーを使用してデプロイメントを識別し、評価サーバーへのリクエストを承認します。

デプロイメント

デプロイメントは分析プロジェクトに属しており、1 つのプロジェクトに複数のデプロイメントを含めることができます。実験がバリアントを提供しているプラットフォーム（クライアント側）またはサービス（サーバー側）にちなんでデプロイメントに名前を付けます（例：android、ios、web）。デフォルトのプロジェクト API キーのデプロイメントは、始める際に役立ちます。 ただし、各プラットフォームまたはサービスに対する明示的なデプロイメントは、同じアプリケーションに対して複数のプラットフォーム間で同じAmplitudeプロジェクトを共有している大規模な組織やチームにとってより効果的です。

同じプロジェクト内のフラグと実験にデプロイメントを追加します。実験の評価サーバーがユーザーのバリアントを取得するためのリクエストを受信すると、実験はデプロイメントキーを使用して評価用に関連付けられているすべてのフラグと実験を検索します。

フラグと実験

実験は機能フラグと実験を使用して、ユーザーにさまざまな体験を提供しています。フラグキーはフラグと実験を識別します。フラグと実験は0-nのデプロイメントに関連付けられ、1-kのバリアントを含んでいます。評価モード（ローカルまたはリモート）は、フラグまたは実験がローカル評価をサポートしているかどうかを決定し、ローカルモードはフラグのターゲティング機能を制限する場合があります。

フィーチャーフラグと実験は同じ基本データモデルを共有しており、一方からもう一方へ遡及的に移行できます。最も目に見える違いはプロダクトインターフェイスにあります。実験では実験ライフサイクル全体をガイドし、成功指標を定義して分析を実行できます。フラグにはより基本的な機能が含まれており、特別な計画セクションや分析セクションは含まれていません。

フラグ

ユーザー分析を伴わない標準的な機能フラグには、フラグを使用してください。新しいフラグには、デフォルトのバリアント on が用意されています。

実験

ユーザーに対する機能の実験のために実験を使用してください。新しい実験には、controlおよびtreatmentという2つのデフォルトのバリアントが用意されています。

バリエーション

バリアントとは、カスタマーのために変更する実験の一部です。たとえば、コール・トゥ・アクション（CTA）ボタンのテキストを実験すると、テキストの各バージョンはバリアントになります。バリエーションはフラグ内や実験内に存在することができます。 単一のバリアントを単一のフラグに関連付けることもできますし、複数のバリアントをより大規模な実験に関連付けることもできます。 実験には、実験の仮説を検証できるようにバリエーションが必要です。

ユーザー

実験ユーザーはAmplitudeアナリティクス内のユーザーにマップされます。 フラグ設定に加えて、ユーザーも評価への入力要素となります。フラグと実験ターゲティングルールはユーザープロパティにアクセスします。

ユーザーを、リモート評価のリクエストfetchを通じて評価に渡すか、ローカル評価のためにevaluate関数に直接渡します。

| プロパティ | 型 | 説明 || --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | | user_id | string | ユーザー ID はユーザーの主要な識別子です。 この値は通常、システム内のユーザーの ID です。 実験は、リモート評価の前のエンリッチメント時にAmplitude IDを解決する際、ユーザーIDを使用します。この場合、Amplitude IDがデフォルトのバケットキーとなります。 | | device_id| string| デバイス ID は、ユーザーの二次識別子です。 通常、アナリティクス SDK はクライアント側でデバイス ID をランダムに生成するか、サーバー側の Cookie に設定します。 また、実験はリモート評価の前にエンリッチメント時にAmplitude IDを解決するときにもデバイスIDを使用します。この場合、Amplitude IDはデフォルトのバケットキーです。 | | user_properties| object| ローカルまたはリモートの評価中にユーザーを評価するときに使用されるカスタムプロパティのオプションオブジェクト。 | | groups| object| ベータ。 このユーザーに関連付けられているグループをリストするオプションのオブジェクト。 形式はオブジェクトです。キーはグループタイプで、値はグループ値文字列の配列です（例：{"org name":["Amplitude"]}）。 | | group_properties| objectベータ。このユーザーに関連付けられているグループプロパティをリストするオプションのオブジェクト。形式は、キーがグループタイプであり、値がオブジェクト（キーがグループ値であり、値がプロパティオブジェクト）であるネストされたオブジェクトです（例：{"org name":{"Amplitude":{"plan":"enterprise"}}}）。 |

完全なユーザー定義