Targeting

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

Google Mobile Ads C++ SDK の代わりに、AdMob の iOS SDK と Android SDK の使用を検討してください。サポートが必要な場合は、 Google Mobile Ads SDK 技術フォーラム:

このガイドでは、ターゲティング情報を広告リクエストに提供する方法について説明します。

前提条件

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

RequestConfiguration

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

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

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

子供向けの設定

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

アプリ デベロッパーは、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 を遵守するためにコンテンツを子ども向けとして取り扱わないようにしたい場合。
• 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 アカウントが停止される可能性があります。

注: ファミリー向けのアプリは、 プログラムは主に 子ども向けアプリとユーザー ファミリー グループで管理されている 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）のユーザーのために処理を受けるための広告リクエスト 使用しないでください。
• 欧州経済領域（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();