このガイドでは、ターゲット設定情報を広告リクエストに設定する方法を説明します。
広告のターゲット設定の動作を確認するには、iOS API デモアプリ(Swift または Objective-C)をダウンロードしてください。
前提条件
スタートガイドの手順を完了していること
GADRequestConfiguration
GADRequestConfiguration
は、GADMobileAds
共有インスタンスを介してグローバルに適用されるターゲット情報を収集するオブジェクトです。次のコードでアクセスできます。
Swift
let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
子供向けの設定
児童オンライン プライバシー保護法(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 は、オプションのツールです。この 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 のサンプルをご覧ください。
パブリッシャー提供のシグナル
オーディエンスとコンテキスト データは、広告リクエストでパブリッシャー提供のシグナル(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
を明示的に呼び出します。 - 追加のターゲット設定パラメータをメディエーション ネットワークに渡すにはどうすればよいですか?
- メディエーションをご覧のうえ、ターゲット設定をメディエーション ネットワークに渡す方法をご確認ください。