このページは Cloud Translation API によって翻訳されました。

ターゲット設定

このガイドでは、ターゲット設定情報を広告リクエストに設定する方法を説明します。

前提条件

スタートガイドの手順を完了します。

`RequestConfiguration`

RequestConfiguration は、SetRequestConfiguration() グローバル関数を介してグローバルに適用されるターゲット設定情報を収集する構造体です。

リクエスト構成を更新するには、まず現在の構成を取得し、必要な更新を行って、次のように設定します。

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

子供向けの設定

児童オンラインプライバシー保護法（COPPA）に基づき、「子供向け取り扱いタグ」という設定が用意されています。このようにこの通知が正確であり、かつアプリの所有者に代わって動作する。あなたは、この設定の不正使用について Google アカウントが停止される可能性があります。

アプリデベロッパーは、広告リクエストを行う際に、コンテンツが子供向けであるかどうかを指定することができます。コンテンツを子供向けとして指定された広告リクエストでは、インタレストベース広告（IBA）とリマーケティング広告が無効になります。

この設定は、RequestConfiguration 構造体の tag_for_child_directed_treatment メンバーを次の列挙型値のいずれかに割り当てることで構成できます。

RequestConfiguration::tag_for_child_directed_treatment を RequestConfiguration::kChildDirectedTreatmentTrue に割り当てることで、コンテンツが COPPA に基づく子供向けであることを指定します。
COPPA に基づく子供向けコンテンツとして扱わないよう示すには、RequestConfiguration::tag_for_child_directed_treatment を RequestConfiguration::kChildDirectedTreatmentFalse に割り当てます。
RequestConfiguration::tag_for_child_directed_treatment の割り当て先 RequestConfiguration::kChildDirectedTreatmentUnspecified COPPA に照らして、コンテンツの取り扱い方法を指定しますあります。

次の例は、コンテンツを特定のコンテンツとして COPPA を遵守する子ども向けコンテンツ:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

お客様はこのタグを設定することで、この通知の内容が正確であり、ご自身がアプリ所有者の代理人としての権限をもつことを認めるものとします。また、この設定の不正使用は Google アカウントの解除につながる場合があることを理解しているものとします。

同意年齢に満たないユーザー

欧州経済領域（EEA）の同意年齢に満たないユーザーについては、その広告リクエストにマークを付けることで適切な取り扱いを受けることができます。この機能は一般データ保護規則の遵守を促進する（GDPR）。なお、GDPR の下で他の法的義務が生じる場合もありますので、欧州連合（EU）のガイダンスをご確認のうえ、お客様の顧問弁護士にご相談ください。Google が提供するツールの目的は、皆様の法令遵守をサポートすることであり、特定のパブリッシャー様の法的義務を軽減することではありません。詳細パブリッシャーへの GDPR の影響についてご覧ください。

この機能を使用する場合は、欧州の同意年齢に満たないユーザー用の [タグ] が（TFUA）パラメータが広告リクエストに追加されます。このパラメータは、すべての広告リクエストについて、リマーケティングなどによるパーソナライズド広告を無効にし、第三者広告ベンダー（広告測定ピクセルや第三者広告サーバーなどの事業者）へのリクエストも無効にします。

子供向けの設定と同様に、RequestConfiguration には TFUA パラメータの構成: tag_for_under_age_of_consent（次の列挙値で構成されます。

RequestConfiguration::tag_for_under_age_of_consent を RequestConfiguration::kUnderAgeOfConsentTrue に割り当てて、欧州経済領域（EEA）の同意年齢に満たないユーザーに適した方法で広告リクエストを処理するよう指定します。
RequestConfiguration::tag_for_under_age_of_consent の割り当て先 RequestConfiguration::kUnderAgeOfConsentFalse を指定して、欧州経済領域のユーザーが対象にならないよう、広告リクエスト同意年齢に満たないユーザーに限られます。
RequestConfiguration::tag_for_under_age_of_consent の割り当て先 RequestConfiguration::kUnderAgeOfConsentUnspecified の場合は、広告リクエストをユーザーとして処理するかどうかを指定していない（同意年齢に満たない）

次の例は、広告リクエストに TFUA を含める必要があることを示しています。

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

子ども向けの設定と同意年齢に満たないユーザーを有効にするタグ両方を同時に true に設定しないでください。設定されている場合、子ども向け設定が優先されます。

広告コンテンツのフィルタリング

アプリは RequestConfiguration::max_ad_content_rating field を使用して、広告リクエストの広告コンテンツ上限レーティングを設定できます。次の場合に返される AdMob 広告コンテンツのレーティングがそのレベル以下に設定されている。考えられるデジタルコンテンツラベルの分類に基づいており、次のいずれかの列挙値になります。

RequestConfiguration::kMaxAdContentRatingG
RequestConfiguration::kMaxAdContentRatingPG
RequestConfiguration::kMaxAdContentRatingT
RequestConfiguration::kMaxAdContentRatingMA

次のコードは、RequestConfiguration 構造体を設定し、G 以下のデジタルコンテンツラベルに対応する広告コンテンツを返すように指定しています。

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

`AdRequest`

AdRequest オブジェクトは、広告とともに送信されるターゲティング情報を収集します。リクエストできます。

コンテンツの URL

アプリは広告をリクエストする際に、配信するコンテンツの URL を渡すことができます。これにより、キーワードターゲティングによって広告とコンテンツを一致させることができます。

たとえば、アプリで https://www.example.com のコンテンツを表示する際に広告をリクエストする場合は、この URL を渡して関連キーワードをターゲットに設定できます。

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();