このページは Cloud Translation API によって翻訳されました。

ターゲット設定

このガイドでは、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);

子供向けの設定

児童オンラインプライバシー保護法（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（同意年齢に満たない欧州ユーザーに対するタグ）パラメータが含まれるようになります。このパラメータは、すべての広告リクエストについて、リマーケティングなどによるパーソナライズド広告を無効にし、第三者広告ベンダー（広告測定ピクセルや第三者広告サーバーなどの事業者）へのリクエストも無効にします。

子供向けの設定と同様、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);

詳細情報:

パブリッシャーのプライバシーに関する取り扱い（ベータ版）

パブリッシャーのプライバシー保護（PPT）API は、オプションのツールです。この 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);

広告リクエスト

AdManagerAdRequest オブジェクトは、広告リクエストとともに送信するターゲット設定情報を収集します。

カスタムのターゲット設定

カスタマイズした Key-Value ペアを渡して、AdManagerAdRequest.Builder.addCustomTargeting() から Google アドマネージャーキャンペーン（広告申込情報）のターゲットを設定できます。

Kotlin

// Example: Pass custom targeting "age=25".
val newRequest = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25")
  .build()

Java

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25")
    .build();

文字列のリストとして、キーに複数の値を渡すことができます。たとえば、25 歳に加えて 20 代半ばのユーザーにターゲットを設定するには、次のように指定します。

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))

Android API デモアプリでカスタムターゲット設定を実装するには、Google アドマネージャーのカスタムターゲット設定のサンプルをご覧ください。

カテゴリの除外

AdManagerAdRequest.Builder で提供される addCategoryExclusion() メソッドを使用して、リクエストにスロット単位でカテゴリの除外レベルを追加できます。

Kotlin

// Example: Exclude "automobile" and "boat" categories.
val newRequest = AdManagerAdRequest.Builder()
  .addCategoryExclusion("automobile")
  .addCategoryExclusion("boat")
  .build()

Java

// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build();

Android API デモアプリでカテゴリの除外を利用するには、Google アドマネージャーのカテゴリ除外のサンプルをご覧ください。

パブリッシャー指定の識別子

フリークエンシーキャップ、オーディエンスセグメンテーションとターゲティング、広告の順次ローテーション、その他オーディエンスに基づく各種デバイスへの広告配信管理で使用する識別子をパブリッシャー指定の識別子（PPID）として設定できます。

PPID の設定例は次のとおりです。

Kotlin

val adRequest = AdManagerAdRequest.Builder()
  .setPublisherProvidedId("AB123456789")
  .build()

Java

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .setPublisherProvidedId("AB123456789")
    .build();

Android API デモアプリでパブリッシャー指定の識別子（PPID）を実装する方法については、アドマネージャーの PPID のサンプルをご覧ください。

パブリッシャー提供のシグナル

オーディエンスとコンテキストデータは、広告リクエストでパブリッシャー提供のシグナル（PPS）として送信できます。PPS を使用すると、ユーザー識別子を共有することなく、標準の分類を使用して、すべての取引タイプのビッダーにオーディエンスの特性を伝えることで、ユーザーデータを使用してプログラマティックな収益化を改善できます。オーディエンスの特性には、行動や興味に基づくデータ（IAB オーディエンスの分類 1.1）やコンテキストデータ（IAB コンテンツの分類 2.2）が含まれます。

Kotlin

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))

val request = AdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()

Java

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter.class, extras)
  .build()

コンテンツの URL

コンテンツターゲット広告とブランド保護のためにコンテンツの URL を指定するには、AdManagerAdRequest の作成時に setContentUrl() を呼び出します。

Kotlin

val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()

Java

AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();

ブランド保護（ベータ版）

さまざまなユーザー向けに動的コンテンツを表示するアプリでは、AdManagerAdRequest の作成時に setNeighboringContentUrls() メソッドを使用して URL の簡単なリストを指定できます。

Kotlin

val urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
val requestWithContent = AdManagerAdRequest.Builder()
  .setNeighboringContentUrls(urls)
  .build()

Java

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
    .setNeighboringContentUrls(urls)
    .build();

.setNeighboringContentUrls() は、ブランド保護のみに使用されるという点で .setContentUrl() と異なっています。