Targeting

プラットフォームを選択: Android iOS Unity Flutter Android（以前のバージョン）

このガイドでは、ターゲット設定情報を Google Mobile Ads SDK に設定する方法を説明します。

実際の動作を確認するには、Android API デモアプリをダウンロードしてください。

API デモをダウンロード

前提条件

先に進む前に、Google Mobile Ads SDK (Legacy) を設定してください。

RequestConfiguration

RequestConfiguration は、すべての広告リクエストにグローバルに適用されるターゲット設定情報を収集します。使用可能なターゲット設定タグについては、RequestConfiguration.Builder のドキュメントをご覧ください。

リクエスト構成を更新するには、既存の構成からビルダーを取得し、必要な更新を行って、次のように設定します。

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);

すべての広告リクエストにリクエスト構成の変更が適用されるようにするには、Google Mobile Ads SDK (Legacy) を初期化する前にリクエスト構成を設定します。

年齢に応じた取り扱いを設定する

Google Mobile Ads SDK (Legacy) には、子どもや未成年を対象にしたプライバシーに関する規則のコンプライアンス管理をサポートするため、年齢に応じた取り扱いの設定が用意されています。年齢に応じた取り扱いの設定では、Google Mobile Ads SDK (Legacy) で子ども、未成年者、または年齢未指定のユーザーのための広告配信保護対策を適用するかどうかを指定できます。

年齢に応じた取り扱いは、RequestConfiguration.Builder API の setAgeRestrictedTreatment() メソッドで設定できます。

子どもの取り扱いを広告リクエストに適用する場合の例を次に示します。

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

13 歳以上の未成年者または年齢未指定のユーザーの取り扱いを指定するには、CHILD の設定を次のように置き換えます。

  • TEEN
  • UNSPECIFIED

この設定を使用すると、Google Mobile Ads SDK (Legacy) は広告リクエストに tfat パラメータを含めます。年齢に応じた取り扱いをユーザーにどのように適用するかは、法律および規制上の義務に基づき、弁護士に相談のうえ判断してください。詳しくは、広告リクエストに年齢に応じた取り扱いタグを設定するをご覧ください。

TFCD と TFUA から年齢に応じた取り扱いに移行する

年齢に応じた取り扱いの設定は、非推奨となった .setTagForChildDirectedTreatment()（TFCD）設定と .setTagForUnderAgeOfConsent()（TFUA）設定に代わるものです。

次の表に、TFCD と TFUA の設定と、対応する年齢に応じた取り扱いを示します。

TFCD

TFCD 年齢に応じた取り扱い
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
値が割り当てられていません .setTagForChildDirectedTreatment() AgeRestrictedTreatment.UNSPECIFIED
対応するプロパティなし AgeRestrictedTreatment.TEEN

TFUA

TFUA 年齢に応じた取り扱い
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
値が割り当てられていません .setTagForUnderAgeOfConsent() AgeRestrictedTreatment.UNSPECIFIED
対応するプロパティなし AgeRestrictedTreatment.TEEN

年齢に応じた取り扱いと TFCD および TFUA の関係について

年齢に応じた取り扱いの設定と TFCD または TFUA の設定を両方とも設定した場合は、最も厳格な制限が適用されます。

メディエーションで年齢に応じた取り扱いを転送する

Google Mobile Ads SDK (Legacy) を使用して年齢に応じた取り扱いを設定すると、メディエーション アダプタは、メディエーション対象の第三者 SDK に年齢に応じた取り扱いのシグナルを転送します。

次の表に、年齢制限に応じた取り扱いのシグナルをメディエーション対象のサードパーティの SDK に転送できるメディエーション アダプタのバージョンを示します。

メディエーション アダプタ名 サポートされている最小バージョン
AppLovin 13.6.3.0
BidMachine 3.7.1.1
Bigo 5.9.0.1
Chartboost 9.12.1.1
DTExchange（Fyber） 8.4.5.1
i-mobile 2.3.2.4
InMobi 11.3.0.1
IronSource 9.4.3.0
Liftoff Monetize（Vungle） 7.7.4.2
LINE ヤフー（LINE） 3.1.1.1
maio 2.0.9.0
Meta（Facebook） 6.21.0.4
Mintegral 17.1.61.1
Moloco 4.10.0.0
MyTarget 5.47.1.1
Pangle 8.1.0.3.1
PubMatic 5.1.2.2
Verve 3.9.0.0

子ども向けの設定

。

児童オンライン プライバシー保護法（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(
      RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
    )
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setPublisherPrivacyPersonalizationState(
            RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

広告リクエスト

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

ネットワークについての情報を追加する

ネットワークについての追加情報は、広告リクエストとともに送信される追加の詳細情報で、各広告ソースに固有のものです。

次のコード スニペットでは、collapsible の追加パラメータキーを bottom の値とともに Google に設定します。

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
    new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);

カスタム ターゲティング

カスタムの Key-Value ペアを渡して、Google アド マネージャー キャンペーンの広告申込情報のターゲットを設定できます。広告リクエストでカスタムの Key-Value ペアを渡す方法の例を次に示します。

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 代半ばのユーザーにターゲットを設定するには、次のように指定します。

Kotlin

.addCustomTargeting("age", listOf("24", "25", "26"))

Java

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

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

カテゴリの除外

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 デモアプリでカテゴリの除外を利用するには、アド マネージャーのカテゴリ除外のサンプルをご覧ください。

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

フリークエンシー キャップ、オーディエンス セグメンテーションやターゲット設定、広告のローテーション設定などユーザー属性に基づき各種端末に広告を配信する機能に、パブリッシャー指定の識別子（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 =
  AdManagerAdRequest.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", new ArrayList<>(Arrays.asList(6, 284)));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", new ArrayList<>(Arrays.asList(4, 5, 6)));

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

コンテンツの URL

コンテンツ ターゲット広告とブランド保護のためにコンテンツの URL を指定するには、以下を追加します。

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();

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

さまざまなユーザー向けに動的コンテンツを表示するアプリでは、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

List<String> urls =
    Arrays.asList(
        "https://www.mycontenturl1.com",
        "https://www.mycontenturl2.com",
        "https://www.mycontenturl3.com",
        "https://www.mycontenturl4.com");

AdManagerAdRequest requestWithContent =
    new AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build();

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