コホートターゲティング

コホートとは、Amplitudeで定義された静的または動的なユーザーの集合です。 実験ユースケースの場合、コホートは詳細なオーディエンスターゲティングに役立ちます。コホートが常にターゲティングにとって最適なソリューションであるとは限らないため、コホートターゲティングがローカルまたはリモートでの評価とどのように連携するかを理解することが重要です。

実験コホートターゲティングは、ユーザーコホートのターゲティングのみをサポートしています。

リモート評価

リモート評価フラグでコホートをターゲットに設定すると、AmplitudeはコホートをAmplitude 実験の送信先に同期させます。動的コホートの場合、この同期はデフォルトで1時間ごとに実行されます。 リモート評価の対象となる動的コホートはリアルタイムで更新されません。 たとえば、Sign Upイベントを実行したユーザーのコホートをターゲットに設定した場合、Amplitudeはイベントの発生から1時間以内にそれらのユーザーをターゲットに設定します。

リモート評価の対象となるコホートは、差の大きさに応じて、最初の同期時または大きな変更後の伝搬遅延が発生することがあります。 たとえば、1000万人のユーザーのコホートの最初の同期は、その後の同期よりも時間がかかります。

リモート評価は、最大1000万人のユーザーをサポートします。

リモート評価コホートをターゲティングする場合のユースケース

• 実験ターゲティングセグメントでは利用できないユーザーの行動やプロパティに基づいてユーザーをターゲットにしています。
• コホート同期間隔によるターゲティングの遅延はプロセスを中断しません。

次の場合は、リモート評価におけるコホートターゲティングを使用しないでください。

• ユーザーをリアルタイムでターゲットにする必要があります。

ローカル評価

最新のサーバー側SDKに展開されたローカル評価フラグや実験も、コホートをターゲットにできます。ローカル評価フラグでコホートをターゲットに設定すると、Amplitudeはコホートを「実験ローカル評価」の送信先に同期します。動的コホートの場合、この同期は1時間ごとに実行されます。 ローカル評価で対象とされた動的コホートはリアルタイムで更新されません。 たとえば、Sign Upイベントを実行したユーザーのコホートをターゲットに設定する場合、Amplitudeはイベント直後ではなく、イベント発生から1時間以内にそれらのユーザーをターゲットに設定します。

ローカル評価は最大5,000万人のユーザーをサポートしています。

SDK サポート

サーバー側のSDKは、ユーザーが設定した場合にコホートをターゲットにすることができます。クライアント側の SDK は、ローカル評価コホートのターゲット設定をサポートしていません。

初期化時に、プロジェクト API と秘密鍵を使用してコホート同期設定を構成し、ローカル評価コホートのダウンロードとターゲット設定を有効にします。

const experiment = Experiment.initializeLocal('DEPLOYMENT_KEY', {
  // (Recommended) Enable local evaluation cohort targeting.
  cohortSyncConfig: {
    apiKey: 'API_KEY',
    secretKey: 'SECRET_KEY'
  }
});

トラブルシューティング

動的なコホートとコホートの同期は非同期であるため、コホートのターゲティングはトラブルシューティングが困難な場合があります。 実験が対象となるコホートに属するはずのユーザーを対象としていない場合は、以下のことを試してください。

• ローカル評価の場合、SDKのバージョンがローカル評価コホートターゲット設定をサポートしていること、および初期化時にコホート同期設定を設定していることを確認してください。
• コホートが必要な同期（リモート評価の場合はAmplitude 実験、ローカル評価の場合は実験ローカル評価）状態にあることを確認してください。
• コホートに想定されるユーザーが含まれていることを確認してください。 ユーザーが現在のコホートに属している場合は、そのコホートの同期履歴を確認してください。 このユーザーは、評価が行われた後に同期中にコホートに追加された可能性があります。
• fetchまたはevaluateに渡されたユーザー情報が正しいことを確認してください。