このガイドでは、ターゲティング情報を広告リクエストに提供する方法について説明します。
前提条件
- スタートガイドの手順を完了します。
RequestConfiguration
RequestConfiguration
は、SetRequestConfiguration()
グローバル関数を介してグローバルに適用されるターゲティング情報を収集する構造体です。
リクエストの構成を更新するには、まず現在の構成を取得し、必要な更新を実行して、次のように設定します。
firebase::gma::RequestConfiguration retrieved_configuration = firebase::gma::GetRequestConfiguration(); // .. apply your changes, then: firebase::gma::SetRequestConfiguration(request_configuration);
子ども向けの設定
児童オンライン プライバシー保護法(COPPA)に基づき、「子供向け取り扱いタグ」という設定が用意されています。このタグを設定すると、この通知が正確であり、アプリの所有者を代理する権限を有していることを証明したことになります。この設定を不正使用した場合、Google アカウントが削除される可能性があることを理解したことになります。
アプリ デベロッパーは広告リクエストを行う際に、コンテンツを子ども向けとして取り扱うかどうかを指定できます。コンテンツを子ども向けとして取り扱うよう指定した場合、Google はその広告リクエストで IBA とリマーケティング広告を無効にします。
この設定は、RequestConfiguration
構造体の tag_for_child_directed_treatment
メンバーを次のいずれかの列挙値に割り当てることで構成できます。
- COPPA に沿ってコンテンツを子ども向けとして扱うように指定するには、
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 を遵守する目的でコンテンツを子ども向けとして取り扱うよう指定しています。
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
があります。このメンバーは次の列挙値で構成できます。
- 欧州経済領域(EEA)の同意年齢に満たないユーザーのために広告リクエストが許可されることを示すには、
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
に割り当てます。
次の例は、広告リクエストに 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();