このガイドでは、ターゲット設定情報を Google Mobile Ads SDK に設定する方法を説明します。
実際の動作を確認するには、Android API デモアプリをダウンロードしてください。前提条件
- スタートガイドの手順を完了していること。
RequestConfiguration
RequestConfiguration
は、すべての広告リクエストにグローバルに適用されるターゲット設定情報を収集します。使用可能なターゲット設定タグについては、RequestConfiguration.Builder
のドキュメントをご覧ください。
リクエスト構成を更新するには、既存の構成からビルダーを取得し、必要な更新を行って、次のように設定します。
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
すべての広告リクエストにリクエスト構成の変更が適用されるようにするには、Google Mobile Ads SDK を初期化する前にリクエスト構成を設定します。
子供向けの設定
児童オンライン プライバシー保護法(COPPA: Children's Online Privacy Protection Act)に基づき、「子供向け取り扱いタグ」という設定が用意されています。このタグを設定することによって、この通知内容が正確であり、アプリの所有者を代理する権限があることを証明できます。子供向けの設定を不正に利用すると、Google アカウントは削除される場合があります。
アプリ デベロッパーは広告リクエストを行う際に、自社コンテンツを子供向けとして扱ってほしいかどうかを示すことができます。子供向けコンテンツとして扱うように示すと、その広告リクエストについてはインタレスト ベース広告(IBA)とリマーケティング広告を無効にする措置が取られます。
子供向けの設定は、setTagForChildDirectedTreatment()
を使って適用できます。
コンテンツを、COPPA に基づく子供向けのものとして取り扱うよう指定するには、
setTagForChildDirectedTreatment
をTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE
に設定して呼び出します。これにより、Android 広告 ID(AAID)が送信されなくなります。COPPA に基づく子供向けコンテンツとして扱わないよう示すには、
setTagForChildDirectedTreatment
をTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE
に設定して呼び出します。COPPA に関してコンテンツをどのように取り扱うかを広告リクエストで指定しない場合は、
setTagForChildDirectedTreatment
をTAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED
に設定して呼び出します。
次の例では、コンテンツを COPPA に基づく子供向けコンテンツとして取り扱うよう指定しています。
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
同意年齢に満たないユーザー
欧州経済領域(EEA)の同意年齢に満たないユーザーについては、その広告リクエストにマークを付けることで適切な取り扱いを受けることができます。この機能は、一般データ保護規則(GDPR)の準拠に向けた対応をサポートするためのものです。なお、GDPR の下では他の法的義務が課せられる場合もありますので、欧州連合(EU)のガイダンスをご確認のうえ、お客様の顧問弁護士にご相談ください。なお、Google が提供するツールの目的は、法令遵守をサポートすることであり、パブリッシャー様を法的義務から解放することではありません。GDPR がパブリッシャー様に与える影響の詳細
この機能を利用すると、広告リクエストに TFUA(Tag For Users under the Age of Consent in Europe: 同意年齢に満たない欧州ユーザーに対するタグ)パラメータが含まれるようになります。このパラメータを含むすべての広告リクエストでは、リマーケティングなどによるパーソナライズド広告を無効にし、第三者広告ベンダー(広告測定ピクセルや第三者広告サーバーなどの事業者)へのリクエストも無効にします。
子供向けの設定と同様、RequestConfiguration.Builder
には TFUA パラメータを設定するためのメソッド setTagForUnderAgeOfConsent()
があります。このメソッドでは次のオプションを使用できます。
欧州経済領域(EEA)の同意年齢に満たないユーザーに適した方法で広告リクエストを処理するよう指定するには、
setTagForUnderAgeOfConsent()
をTAG_FOR_UNDER_AGE_OF_CONSENT_TRUE
に設定して呼び出します。これにより、Android 広告 ID(AAID)も送信されなくなります。欧州経済領域(EEA)の同意年齢に満たないユーザーに適した方法で広告リクエストを処理しないように指定するには、
setTagForUnderAgeOfConsent()
をTAG_FOR_UNDER_AGE_OF_CONSENT_FALSE
に設定して呼び出します。欧州経済領域(EEA)の同意年齢に満たないユーザーに適した方法で広告リクエストを処理するかどうか指定しない場合は、
setTagForUnderAgeOfConsent()
をTAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
に設定して呼び出します。
次の例では、広告リクエストに TFUA を含めるよう指定しています。
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
子供向けの設定を有効にするタグと setTagForUnderAgeOfConsent()
に設定する値を、同時に両方とも true
にしないでください。同時に設定している場合、子供向けの設定が優先されます。
広告コンテンツのフィルタリング
広告内の関連する提案を含む Google Play の不適切な広告に関するポリシーに準拠するため、アプリ内で表示されるすべての広告および関連する提案は、アプリのコンテンツ レーティングに適合したものである必要があります。これはコンテンツ自体が Google Play のポリシーに準拠している場合でも同様です。
広告レーティングの上限などのツールを使用すると、ユーザーに表示する広告のコンテンツをより細かく管理できます。広告レーティングの上限の設定は、プラットフォーム ポリシーの準拠にも役立ちます。
アプリでは、setMaxAdContentRating
メソッドを使って、広告リクエストの広告レーティングの上限を設定できます。上限を設定した場合は、指定されたレベル以下のコンテンツ レーティングの AdMob 広告が返されます。このネットワーク追加メソッドで使用できる値は、デジタル コンテンツ ラベルの分類に基づいており、次の文字列のいずれかになります。
MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA
次のコードは、G
以下のデジタル コンテンツ ラベルに対応する広告コンテンツを返すように、RequestConfiguration
オブジェクトを設定しています。
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
詳細情報:
Publisher Privacy Treatment(ベータ版)
Publisher Privacy Treatment(PPT)API は、setPublisherPrivacyPersonalizationState()
メソッドを使って、すべての広告リクエストで広告のパーソナライズをオフにするかどうかをアプリで指定するためのオプションのツールです。この機能を使用すると、それ以降の残りのセッションのすべての広告リクエストに、パブリッシャーのプライバシーに関する取り扱い(PPT)のパラメータが含まれるようになります。
デフォルトでは、Google への広告リクエストに対してパーソナライズド広告が配信されます。次のコードは、すべての広告リクエストで広告のパーソナライズを無効にしています。
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
広告リクエスト
AdRequest
オブジェクトは、広告リクエストと一緒に送るターゲット設定情報を収集します。
ネットワークについての情報を追加する
ネットワークについての追加情報は、広告リクエストとともに送信される追加の詳細情報で、1 つの広告ソースに固有のものです。
次のコード スニペットでは、collapsible
の追加パラメータキーを bottom
の値とともに Google に設定します。
Kotlin
val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest = AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
.build()
adLoader.loadAd(adRequest)
Java
Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest = new AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class, extras)
.build();
adLoader.loadAd(adRequest);