Targeting

このガイドでは、ターゲット設定情報を広告リクエストに設定する方法を説明します。

広告のターゲット設定の動作を確認するには、iOS API デモアプリ（Swift または Objective-C）をダウンロードしてください。

API デモをダウンロード

前提条件

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

GADRequestConfiguration

GADRequestConfiguration は、GADMobileAds 共有インスタンスを介してグローバルに適用されるターゲット情報を収集するオブジェクトです。次のコードでアクセスできます。

let requestConfiguration = MobileAds.shared.requestConfiguration

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

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

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

年齢に応じた取り扱いは、GADRequestConfiguration の ageRestrictedTreatment プロパティで設定できます。

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

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
RequestConfigurationSnippets.swift

// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
    GADAgeRestrictedTreatmentChild;
RequestConfigurationSnippets.m

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

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

年齢に応じた取り扱いの設定は、非推奨となった tagForChildDirectedTreatment（TFCD）プロパティと tagForUnderAgeOfConsent（TFUA）プロパティに代わるものです。

次の表に、tagForChildDirectedTreatment および tagForUnderAgeOfConsent の設定と、それに対応する年齢に応じた取り扱いを示します。

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

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

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

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

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

子ども向けの設定

児童オンライン プライバシー保護法（COPPA）に基づき、tagForChildDirectedTreatment という設定が用意されています。

アプリ デベロッパーは広告リクエストを行う際に、自社コンテンツを子ども向けとして扱ってほしいかどうかを示すことができます。子ども向けコンテンツとして扱うように示すと、その広告リクエストについてはインタレスト ベース広告（IBA）とリマーケティング広告を無効にする措置が取られます。設定オプションは次のとおりです。

• COPPA に基づく子ども向けコンテンツとして扱うように示すには、tagForChildDirectedTreatment に true を設定します。これにより、広告 ID（IDFA）が送信されなくなります。
• COPPA に基づく子ども向けコンテンツとして扱わないよう示すには、tagForChildDirectedTreatment に false を設定します。
• COPPA に関してコンテンツがどのように取り扱われるようにするかを指定しない場合は、tagForChildDirectedTreatment を設定しないでください。

コンテンツが COPPA に基づく子ども向けコンテンツとして取り扱われるよう指定する場合の例を次に示します。

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

お客様はこのタグを設定することで、この通知の内容が正確であり、ご自身がアプリ所有者の代理人としての権限をもつことを認めるものとします。また、この設定の不正使用は Google アカウントの解除につながる場合があることを理解しているものとします。

同意年齢に満たないユーザー

欧州経済領域（EEA）の同意年齢に満たないユーザーについては、その広告リクエストにマークを付けることで適切な取り扱いを受けることができます。この機能は、一般データ保護規則（GDPR）の準拠に向けた対応をサポートするためのものです。GDPR の下では他の法的義務が課せられる場合もありますので、欧州連合（EU）のガイダンスをご確認のうえ、お客様の顧問弁護士にご相談ください。Google が提供するツールの目的は、法令遵守をサポートすることであり、パブリッシャー様を法的義務から解放することではありません。 GDPR がパブリッシャー様に与える影響の詳細

この機能を利用すると、今後のすべての広告リクエストに TFUA（Tag For Users under the Age of Consent in Europe: 同意年齢に満たない欧州ユーザーに対するタグ）パラメータが含まれるようになります。このパラメータは、その広告リクエストでリマーケティングなどによるパーソナライズド広告へのリクエストを無効にします。また、広告測定ピクセルや第三者広告サーバーなどを扱う第三者広告ベンダーへのリクエストも無効にします。

この設定は、GADMobileAds.requestConfiguration オブジェクトの tagForUnderAgeOfConsent プロパティを設定して true を渡すことで、Google Mobile Ads SDK のすべてのバージョンで使用できます。

• 同意年齢に満たないユーザーに適した方法で広告リクエストを処理するように示すには、tagForUnderAgeOfConsent を true に設定します。これにより、広告 ID（IDFA）も送信されなくなります。
• 同意年齢に満たないユーザーに適した方法で広告リクエストを処理しないように示すには、tagForUnderAgeOfConsent を設定しません。

次の例は、広告リクエストに TFUA を含めるように示すものです。

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

子ども向けの設定を有効にするタグと tagForUnderAgeOfConsent に設定する値を、同時に両方とも true にしないでください。両方ともその値にすると、子ども向けの設定が優先されます。

広告コンテンツのフィルタリング

アプリは、GADRequestConfiguration のプロパティ maxAdContentRating を使用して、すべての広告リクエストの広告レーティングの上限を設定できます。この設定は、残りのセッションの今後のすべての広告リクエストに適用されます。このプロパティが取り得る値はデジタル コンテンツ ラベルの分類に基づき、次のいずれかの定数になります。

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

次のコードは、すべての広告リクエストに対して、デジタル コンテンツ ラベル指定が GADMaxAdContentRatingGeneral 階層までの広告コンテンツを返すように指定しています。

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Publisher Privacy Treatment（ベータ版）

Publisher Privacy Treatment（PPT）API は、GADRequestConfiguration の publisherPrivacyPersonalizationState プロパティを使用して、すべての広告リクエストで広告のパーソナライズを無効にするかどうかをアプリで指定するための、オプションのツールです。この機能を使用すると、それ以降の残りのセッションのすべての広告リクエストに、パブリッシャーのプライバシーに関する取り扱い（PPT）のパラメータが含まれるようになります。

デフォルトでは、Google への広告リクエストに対してパーソナライズド広告が配信されます。次のコードは、すべての広告リクエストで広告のパーソナライズを無効にしています。

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

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

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

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

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

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];

コンテンツの URL

アプリは広告をリクエストする際に、配信するコンテンツの URL を渡すことができます。これにより、キーワード ターゲティングで広告とコンテンツを一致させることができます。

たとえば、アプリで https://www.example.com のコンテンツを表示する際に広告をリクエストする場合は、この URL を渡して関連キーワードをターゲットに設定できます。

let request = AdManagerRequest()
request.contentURL = "https://www.example.com"

GAMRequest *request = [GAMRequest request];
request.contentURL = @"https://www.example.com";

カスタム ターゲティング

アド マネージャーの管理画面で Key-Value ペアを設定したら、広告リクエストに Key-Value を含むカスタム ターゲティングを設定します。その広告リクエストでは、それらの Key-Value をターゲティングしている広告申込情報が配信の対象となります。1 つのキーについて複数の値を設定するには、値をカンマ区切りの文字列として入力します。

let request = AdManagerRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

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

ユーザーごとに異なるコンテンツを動的に表示するアプリでは、neighboringContentURLs プロパティを使用して URL の簡単なリストを指定できます。周辺コンテンツ URL は、ブランド保護のためだけに使用されるという点で contentURL プロパティとは異なります。

アプリで、広告も含まれるフィードに 4 つの URL のコンテンツを表示するとします。コンテンツのレーティングがそれらの URL と同程度の広告をリクエストするには、URL を次のように渡します。

let request = AdManagerRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

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

フリークエンシー キャップ、オーディエンス セグメンテーションやターゲット設定、広告のローテーション設定などユーザー属性に基づき各種端末に広告を配信する機能に、パブリッシャー指定の識別子（PPID）を設定できます。

PPID の設定には GAMRequest を使用します。

let request = AdManagerRequest()
request.publisherProvidedID = "AB123456789"

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

iOS API デモアプリで PPID を実装するには、アド マネージャーの PPID のサンプルをご覧ください。

Swift Objective-C

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

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

let extras = Extras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = AdManagerRequest()
request.register(extras)

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

よくある質問

広告が自動的に更新される際は、どのターゲット設定が使用されますか？

広告が更新される際は、前回指定した GAMRequest オブジェクトが再度ターゲット設定に使用されます。 新しくターゲット設定を行うには、新しい GAMRequest オブジェクトを指定して GAMBannerView の loadRequest を明示的に呼び出します。

追加のターゲット設定パラメータをメディエーション ネットワークに渡すにはどうすればよいですか？

メディエーションをご覧のうえ、ターゲット設定をメディエーション ネットワークに渡す方法をご確認ください。