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

ターゲティング

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

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

API デモをダウンロード

前提条件

スタートガイドの手順を完了していること

GADRequestConfiguration

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

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

子供向けの設定

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

アプリデベロッパーは、広告リクエストを行う際に、コンテンツが子供向けであるかどうかを指定することができます。コンテンツを子供向けとして指定すると、その広告リクエストに対してインタレストベース広告とリマーケティング広告が無効になります。設定オプションは次のとおりです。

COPPA に基づく子供向けコンテンツとして扱うように示すには、tagForChildDirectedTreatment に true を設定します。これにより、広告 ID（IDFA）が送信されなくなります。
COPPA に基づく子供向けコンテンツとして扱わないよう示すには、tagForChildDirectedTreatment に false を設定します。
COPPA に基づくコンテンツの扱い方を示さない場合は、tagForChildDirectedTreatment を指定しません。

次の例では、コンテンツを COPPA に基づく子供向けコンテンツとして取り扱うよう指定しています。

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

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 を含めるように示すものです。

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

子供向けの設定を有効にするタグと tagForUnderAgeOfConsent に設定する値を、同時に両方とも true にしてはいけません。両方ともその値にすると、子供向けの設定が優先されます。

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

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

GADMaxAdContentRatingGeneral
GADMaxAdContentRatingParentalGuidance
GADMaxAdContentRatingTeen
GADMaxAdContentRatingMatureAudience

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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

パブリッシャーのプライバシー保護（PPT）API は、オプションのツールです。アプリは、GADRequestConfiguration の publisherPrivacyPersonalizationState プロパティを使用して、すべての広告リクエストで広告のパーソナライズを無効にするかどうかを指定できます。この機能を利用すると、残りのセッションの今後のすべての広告リクエストにパブリッシャーのプライバシー保護（PPT）パラメータが含まれるようになります。

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

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

コンテンツの URL

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

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

Swift

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

Objective-C

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

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

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

Swift

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

Objective-C

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

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

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

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

Swift

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

Objective-C

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 を使用します。

Swift

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

Objective-C

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

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

Swift Objective-C

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

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

Swift

let extras = GADExtras()
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 = GAMRequest()
request.register(extras)

Objective-C

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 を明示的に呼び出します。
追加のターゲット設定パラメータをメディエーションネットワークに渡すにはどうすればよいですか？: メディエーションをご覧のうえ、ターゲット設定をメディエーションネットワークに渡す方法をご確認ください。