Targeting

非推奨: Google Mobile Ads C++ SDK は 2024 年 6 月 17 日をもって非推奨となりました。この SDK がまだ使用されていないプロジェクトでは採用しないでください。2025 年 6 月 17 日に メンテナンス終了（EoM）となります。EoM より前にリリースされた SDK のバージョンは引き続き機能しますが、EoM の後にバグの修正や変更がリリースされることはありません。

Google Mobile Ads C++ SDK の代わりに、AdMob の iOS SDK と Android SDK を使用することを検討してください。 サポートが必要な場合は、 お問い合わせフォームからご連絡ください。

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

前提条件

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

RequestConfiguration

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

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

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

子ども向けの設定

児童オンライン プライバシー保護法 （COPPA: Children's Online Privacy Protection Act）に基づき、「子供向け取り扱いタグ」という設定が用意されています。このタグを設定することによって、この通知が正確であり、アプリの所有者としての代理権限があることが保証されます。子供向けの設定を不正に利用すると、Google アカウントが削除される場合があります。

アプリ デベロッパーは、広告リクエストの際に、コンテンツを子ども向けとして取り扱うかどうかを指定できます。コンテンツを子供向けとして扱うように示すと、その広告リクエストについてはインタレスト ベース広告（IBA）とリマーケティング広告を無効にする措置が取られます。

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

• RequestConfiguration::tag_for_child_directed_treatment に RequestConfiguration::kChildDirectedTreatmentTrue を割り当てると、COPPA の目的でコンテンツを子ども向けとして扱うよう指定できます。
• RequestConfiguration::tag_for_child_directed_treatment に RequestConfiguration::kChildDirectedTreatmentFalse を割り当てると、COPPA の目的でコンテンツを子ども向けとして扱わないよう指定できます。
• COPPA に関してコンテンツをどのように取り扱うかを広告リクエストで指定しない場合は、RequestConfiguration::tag_for_child_directed_treatment に RequestConfiguration::kChildDirectedTreatmentUnspecified を割り当てます。

次の例では、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 アカウントが削除される場合があります。

**注:** ファミリー向けプログラムで「主に子供向け」として分類されているアプリと、ファミリー リンクで管理された Google アカウントにログインしているユーザーに対しては、すべての広告リクエストで子供向けとして扱われたコンテンツだけが自動的に配信されます。

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

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

この機能を使用すると、広告リクエストに TFUA（Tag For Users under the Age of Consent in Europe: 同意年齢に満たない欧州ユーザー向け取り扱いタグ）パラメータが追加されます。広告リクエストにこのパラメータが追加されている場合、リマーケティングなどによるパーソナライズド広告の配信が無効になります。第三者広告ベンダー（広告の測定ピクセルや第三者広告サーバーなどの事業者）へのリクエストも無効にします。

子供向けの設定と同様、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 を割り当てると、欧州経済領域（EEA）の同意年齢に満たないユーザーに適した方法で広告リクエストを処理しないよう指定できます。
• RequestConfiguration::tag_for_under_age_of_consent に RequestConfiguration::kUnderAgeOfConsentUnspecified を割り当てると、欧州経済領域（EEA）の同意年齢に満たないユーザーに適した方法で広告リクエストを処理するかどうかを指定しないよう指定できます。

次の例では、広告リクエストに 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

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

  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();