Key-Value セグメンテーションを実装する

Key-Value セグメンテーションを使用すると、広告リクエストを通じてユーザーをセグメント化するカスタム ターゲティングを定義できます。Key-Value セグメンテーションの詳細(AdMob 管理画面で Key-Value ペアを追加する方法など)については、メディエーション グループに Key-Value セグメンテーションを追加するをご覧ください。

このページでは、Google Mobile Ads SDK for React Native を使用して広告リクエストを設定する際に、Key-Value セグメンテーションを実装する方法について説明します。

始める前に

アプリで Key-Value セグメンテーションを設定するには、まずメディエーション グループに Key-Value セグメンテーションを追加する必要があります。

広告リクエストに Key-Value ペアを添付する

AdMob の管理画面でカスタム Key-Value ペアを設定したら、アプリの広告リクエストにペアを添付します。

AdRequest オブジェクトの customTargeting プロパティに、カスタム ターゲティング データを表す Key-Value レコードを設定します。

次の例では、アプリの利用時間でユーザーをセグメント化しています。

const daysInApp = 1;

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  customTargeting: {
    USER_DURATION: daysInApp < 3 ? 'NEW' : 'MATURE',
  },
};

Key-Value セグメンテーションの設定をテストする

カスタム Key-Value ペアの実装をテストするには、広告リクエストを送信して、レスポンス情報オブジェクトを確認します。mediation_group_name フィールドの値が、想定されるメディエーション グループ名と一致していることを確認します。

次の例では、広告レスポンスでメディエーション グループ名を確認しています。

{
  "responseId": "r6_DZtitA8Gi2OMPyKeksAI",
  ...
  "responseExtras": {
    "mediation_group_name": "Mediation group for new users"
  }
}