このページでは

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.

ローカル評価

ローカル評価は、SDK内の評価ロジックを実行します。このアプローチにより、リモート評価が各ユーザーに対して行うネットワーク要求を回避できます。Amplitudeは、大規模な処理能力が求められる、レイテンシの影響を受けやすいシステム向けに、ミリ秒未満の評価を実現します。

ターゲティング機能

ローカル評価はAmplitudeの外部で行われるため、Amplitude アナリティクスの詳細なターゲティングとID 解決をサポートしていません。ローカル評価はターゲットセグメントとの一貫したバケット設定をサポートしますが、これで十分な場合が多いです。

クライアント側のローカル評価

クライアント側のローカル評価には、クライアントにロードされるフラグ設定内のすべてのターゲティングデータが含まれます。たとえば、特定のユーザーをメールアドレスでターゲット設定する場合、ユーザーに関係なくすべてのクライアントがそのメールアドレスを確認できます。

機能リモート評価ローカル評価
一貫したバケット設定✅✅
個別の対象✅✅
ターゲット設定セグメント✅✅
Amplitude ID解決✅❌
ユーザーエンリッチメント✅❌
スティッキーバケット化✅❌

コホートターゲティング

サーバー側の SDK は、設定次第でコホートをターゲットにすることができます。ローカル評価コホートはユーザーIDのみを対象とすることができます。

SDKコホートターゲティングバージョン
Node.js✅1.10.0+
ルビー✅1.5.0+
JVM✅1.4.0+
Go✅1.6.0+
Python✅1.4.0+
PHP❌該当なし

実装

ローカル評価は評価です。これはユーザーとフラグを入力として受け取り、バリアントを出力する関数です。

ローカル評価のワークフローを説明する図。

スタートアップ時、SDK はフラグ設定の更新をサーバーからロードし、各評価の前にアクセスできるようにメモリに保存します。スタートアップ後、SDK はフラグ設定の更新についてサーバーをポーリングします。

エッジ評価

ローカル評価のNode.js SDKは、JavaScriptと分散ストアをサポートするエッジワーカーまたは関数内で実行できます。詳細については、担当者にお問い合わせいただくか、experiment@amplitude.comまでメールでお問い合わせください。

エクスポージャーと割り当ての追跡

ローカル評価は、エクスポージャーイベントを自動的に追跡するリモート評価とは異なり、割り当てを追跡します。ローカル評価の場合：

  • クライアント側SDKは、コードがクライアント側のExperiment SDKからバリアントにアクセスするときに、自動的にエクスポージャーイベントを追跡します。
  • サーバー側SDKは、ユーザーがSDKをそのように設定している場合に、SDKがユーザーを評価するときに割り当てイベントを追跡します。サーバー側SDKは自動的にエクスポージャーを追跡しません。そのため、必要に応じてエクスポージャーを個別に追跡する必要があります。

サーバー側のローカル評価実験の場合、実験分析の露出イベントとして割り当てイベントを使用してください。

パフォーマンス

次の結果は、単一フラグ評価を反映しています。 Amplitudeは、10,000回の評価反復を10回実行する中で、これらのデータを収集しました。各反復では、3つの可能な構成からランダムに選択された1つのフラグ構成に対してランダム化されたユーザー入力を使用しました。

SDK平均値中央値コールドスタート
Node.js0.025ミリ秒0.018ミリ秒3ミリ秒
Go0.098ミリ秒0.071ミリ秒0.7ミリ秒
JVM0.007ミリ秒0.005ミリ秒6ms

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