Targeting

ターゲティングを使用すると、Google Mobile Ads SDK for React Native にコンテキスト情報とオーディエンス情報を提供して、ユーザーに関連性の高い広告を配信できます。

ターゲティングは次のレベルで設定できます。

  • グローバル リクエスト構成: 子どもや 13 歳以上のユーザー向けの取り扱い、広告レーティングの上限、パブリッシャーのプライバシーに関する取り扱い、テストデバイス ID など、アプリ内のすべての広告リクエストに設定を適用します。
  • リクエストごとのターゲティング: コンテンツ URL やネットワークについての追加情報など、広告リクエスト オブジェクトを使用して個別の広告リクエストをカスタマイズします。

このガイドでは、ターゲット設定情報を Google Mobile Ads SDK for React Native に設定する方法を説明します。

前提条件

先に進む前に、Google Mobile Ads SDK for React Native を設定してください。

リクエスト構成を設定する

RequestConfiguration オブジェクトは、すべての広告リクエストにグローバルに適用されるターゲット設定情報を収集します。

最初の広告リクエストのターゲティング設定を適用するには、initialize メソッドを呼び出すときに requestConfiguration プロパティを設定します。

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
  testDeviceIds: ["TEST_DEVICE_HASHED_ID"],
};

initialize({requestConfiguration}, (_status: InitializationStatus) => {
  // SDK initialization is complete.
});

TEST_DEVICE_HASHED_ID は、ハッシュ化されたテストデバイス ID に置き換えます。この ID は、テスト広告を受信するデバイスを指定します。

Google Mobile Ads SDK for React Native を初期化した後にターゲティング設定を更新するには、setRequestConfiguration メソッドを呼び出します。setRequestConfiguration メソッドは既存の構成を置き換え、それ以降の広告リクエストに適用されます。

次の例では、更新されたターゲティング設定で RequestConfiguration オブジェクトを修正し、その設定を広告リクエストに適用しています。

const requestConfiguration: RequestConfiguration = {
  ...getRequestConfiguration(),
  maxAdContentRating: MaxAdContentRating.PG,
  ageRestrictedTreatment: AgeRestrictedTreatment.TEEN,
};

setRequestConfiguration(requestConfiguration);

年齢に応じた取り扱いを設定する

Google Mobile Ads SDK for React Native には、子どもや未成年者を対象にしたプライバシーに関する規則のコンプライアンス管理をサポートするため、年齢に応じた取り扱いの設定が用意されています。年齢に応じた取り扱いの設定では、Google Mobile Ads SDK for React Native で子ども、未成年者、または年齢未指定のユーザーのための広告配信保護対策を適用するかどうかを指定できます。

年齢に応じた取り扱いは、RequestConfiguration の ageRestrictedTreatment プロパティで設定できます。

子どもの取り扱いを広告リクエストに適用する場合の例を次に示します。

const requestConfiguration: RequestConfiguration = {
  // Indicate that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
};

setRequestConfiguration(requestConfiguration);

13 歳以上の未成年者または年齢未指定のユーザーの取り扱いを指定するには、AgeRestrictedTreatment.CHILD の設定を次のように置き換えます。

この設定を使用すると、Google Mobile Ads SDK for React Native は広告リクエストに tfat パラメータを含めます。該当する年齢に応じた取り扱いをユーザーにどのように適用するかは、法律および規制上の義務に基づき、弁護士に相談のうえ判断してください。詳しくは、年齢制限に応じた取り扱いのタグをアプリの広告リクエストに設定するをご覧ください。

広告コンテンツをフィルタする

広告レーティングの上限を使用すると、ユーザーに表示する広告のコンテンツを管理できます。広告レーティングの上限の設定は、プラットフォーム ポリシーの準拠にも役立ちます。

アプリの広告リクエストの広告レーティングの上限を設定するには、RequestConfiguration オブジェクトの maxAdContentRating プロパティを使用します。この設定を行うと、指定されたレーティング以下のコンテンツ レーティングの広告が返されます。この設定で使用できる値は、デジタル コンテンツ ラベルの分類に基づいており、次のいずれかの定数になります。

次の例では、RequestConfiguration オブジェクトを設定して、G 定数以下のデジタル コンテンツ ラベルに対応する広告コンテンツを返すように指定しています。

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
};

setRequestConfiguration(requestConfiguration);

詳細については、以下をご覧ください。

省略可: PPT API（ベータ版）を設定する

Publisher Privacy Treatment（PPT）API を使用すると、RequestConfiguration オブジェクトの publisherPrivacyPersonalizationState プロパティを使用して、すべての広告リクエストで広告のパーソナライズを無効にするかどうかを指定できます。この機能を使用すると、Google Mobile Ads SDK for React Native は、それ以降の残りのセッションのすべての広告リクエストに、パブリッシャーのプライバシーに関する取り扱い（PPT）のパラメータを含めます。

デフォルトでは、Google への広告リクエストに対してパーソナライズド広告が配信されます。次の例では、すべての広告リクエストで広告のパーソナライズを無効にしています。

const requestConfiguration: RequestConfiguration = {
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
};

setRequestConfiguration(requestConfiguration);

AdRequest オブジェクトを設定する

AdRequest オブジェクトは、広告リクエストと一緒に送るターゲット設定情報を収集します。

setRequestConfiguration メソッドで設定されたグローバル構成とは異なり、AdRequest オブジェクトは広告フォーマット クラスの load メソッドに渡されます（インタースティシャル広告の場合は InterstitialAd.load、バナー広告の場合は BannerAd.load）。

ネットワークについての情報を追加する

折りたたみ可能広告のパラメータなど、ネットワーク固有のパラメータを Google Mobile Ads SDK for React Native に渡すには、extras プロパティを使用します。

次の例では、collapsible の追加パラメータキーを bottom の値とともに設定します。

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  extras: {
    collapsible: 'bottom',
  },
};

コンテンツの URL を指定する

コンテンツ ターゲット広告とブランド保護のためにコンテンツの URL を指定するには、contentUrl プロパティを追加します。

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  contentUrl: 'https://www.example.com',
};

コンテンツの URL は 512 文字以下にする必要があります。