このガイドでは、広告リクエストにターゲティング情報を提供する方法について説明します。
前提条件
- スタートガイドを完了している。
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
メンバーを次のいずれかの列挙値に割り当てます。
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 アカウントの停止につながる可能性があることを理解しています。
同意年齢に満たないユーザー
欧州経済領域(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
に割り当てると、欧州経済領域(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
次のコードは、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();