このページでは

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.

リモート評価

リモート評価は、ユーザーのバリアントを取得するためにAmplitude 実験の評価サーバーにリクエストを送信します。リモート評価は、クライアント側アプリケーションでユーザーを評価するためのデフォルトの方法であり、サーバー側環境からも機能します。

クライアント側

クライアント側からのリモート評価リクエストフロー図

サーバ側

サーバ側のリモート評価リクエストフロー図

ターゲティング機能

リモート評価のターゲティングとID 解決はどちらも、Amplitude アナリティクスのユーザー履歴データを使用しています。リモート評価を使用すると、Amplitude ID解決、IPジオロケーション、プロパティの正規化、行動コホートのターゲティング、ユーザープロパティ履歴などの高度な機能が利用できます。

実装

リモート評価はAmplitude内のユーザーを解決し、エンリッチされたユーザーを評価実装に渡す前に、そのユーザーに追加情報を追加します。

バリアント割り当て前にユーザーのエンリッチメントを行うリモート評価の図

AmplitudeID解決

Amplitude IDの解決は追加のユーザーエンリッチメントの前に行われます。このため、実験ではAmplitude IDによるバケット作成を行う際に、この解決が必要となります。

Amplitudeの高度なID解決の詳細についてはこちらをご覧ください。

ユーザーエンリッチメント

ジオロケーション

フラグに位置情報ベースのターゲティングを使用する場合、リモート評価はクライアントのIPから位置情報を解決し、正規のCountryユーザープロパティを使用してターゲティングの一貫性を保ちます。

リモート評価では、IPジオロケーションを使用して次のフィールドを解決できます。

  • Country
  • City
  • Region
  • DMA

正規化

リモート評価は入力内容を正規化するため、デバイスがわずかに異なる値をレポートした場合でも、プラットフォーム、OS、言語、または国ごとにユーザーをセグメント化できます。正規化は、既知のデバイス、言語、および国を入力したデータを、クライアント間で一貫性を保つ正規値に変換します。

リモート評価では、次のフィールドを正規化します。

  • Platform
  • Device Family
  • Device Type
  • Language
  • Country

ユーザープロパティ

競合条件

:最近設定されたユーザープロパティをターゲットにすると、そのユーザープロパティを適用しているAmplitude アナリティクスと、それにアクセスしている実験との間で競合が発生する可能性があります。この競合を回避するには、リモートフェッチリクエストでユーザープロパティを明示的に設定してください。

ユーザープロパティをリモートフェッチリクエストに渡しても、これらのユーザープロパティは関連する分析イベントで更新されません。

解決されたAmplitude IDは、過去のアナリティクスデータからユーザーの現在のユーザープロパティにアクセスします。Amplitudeは、これらのプロパティと、フェッチリクエストで明示的に送信された任意のユーザープロパティをマージし、マージされたセットを評価に渡します。

ユーザープロパティのマージ優先度

Amplitudeは、リモートフェッチリクエストで明示的に送信されたユーザープロパティを、分析からアクセスされたユーザープロパティよりも優先します。

初回確認日

リモート評価は、Amplitude IDテーブルに組み込まれたFirst Seenユーザープロパティを使用してユーザーをエンリッチします。この値は、Amplitudeが最初にユーザーを認識した時のタイムスタンプです(エポックミリ秒(UTC)単位)。

First Seenは、行動コホートを作成または同期することなく、新しいユーザーをターゲットにするために使用します。プロパティをタイムスタンプと比較して、過去7日または30日以内に参加したユーザーなどの時間枠を定義します。

最初のセッションのタイミング

ユーザーの最初のセッション中は、First Seenをまだターゲット設定に使用できない場合があります。新しいユーザーのセッションで、最初のページ読み込みやイベント時に評価する必要があるフラグや実験では、First Seenに依存することは避けてください。

コホートメンバーシップ

リモート評価は、ユーザーのコホートメンバーシップを分析から取得するため、ターゲット設定セグメントでのコホートターゲティングが可能になります。

1時間ごとのコホート同期

動的コホートは1時間ごとに同期されます。コホートターゲティングは、バケット作成が時間に依存しない場合にのみ使用してください。 時間が重要となるターゲット設定を行うには、ユーザープロパティをリモートフェッチリクエストに明示的に渡します。

変換されたプロパティ

リモート評価では、ターゲット設定ルールを評価する前に、プロジェクトのトランスフォーメーション設定をユーザープロパティに適用します。Amplitudeは変換設定を取得し、設定済みのマージおよび名前変更ルールを適用し、変換された値に対してターゲティングを評価します。 変換された値は、アナリティクスがグラフやコホートで使用する値と一致します。

ターゲットセグメントのプロパティピッカーは、標準ユーザープロパティとともに変換後のユーザープロパティを表示します。 アナリティクスがすでに使用しているのと同じ正規値に基づいてターゲティングルールを構築できます。

分析との一貫性

トランスフォーメーションされたプロパティに対するターゲット設定では、両方に同じトランスフォーメーションルールが使用されるため、実験と機能フラグのセグメントが、分析のチャートやコホートと同じ母集団に確実に一致します。

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