このガイドでは、ターゲティング情報を広告リクエストに提供する方法について説明します。
広告のターゲット設定の動作を確認するには、Swift または Objective-C の iOS API デモアプリをダウンロードしてください。
前提条件
スタートガイドを完了していること。
GADRequestConfiguration
GADRequestConfiguration
は、GADMobileAds
共有インスタンスを介してグローバルに適用されるターゲティング情報を収集するオブジェクトです。次のコードでアクセスできます。
Swift
let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
子ども向けの設定
児童オンライン プライバシー保護法(COPPA)に基づき、tagForChildDirectedTreatment
という設定が用意されています。
アプリ デベロッパーは広告リクエストを行う際に、コンテンツを子ども向けとして取り扱うかどうかを指定できます。コンテンツを子ども向けとして取り扱うよう指定すると、Google はその広告リクエストで IBA とリマーケティング広告を無効にします。設定オプションは次のとおりです。
- 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)パラメータが含まれるようになります。このパラメータを指定すると、その広告リクエストに対して、リマーケティングなどのパーソナライズド広告が無効になります。また、広告測定ピクセルや第三者広告サーバーなどの第三者広告ベンダーへのリクエストも無効になります。
この設定は、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 の短いリストを提供できます。隣接コンテンツの URL はブランド保護のみに使用されるという点で、contentURL
プロパティとは異なります。
広告を含むフィードに 4 つの URL のコンテンツを表示するアプリがあるとします。これらの URL とコンテンツ レーティングが似ている広告をリクエストするには、次のように広告を渡します。
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 では、ユーザー ID を共有することなく、標準の分類を使用して、すべてのトランザクション タイプの入札者にオーディエンスの特性を伝えることで、ユーザーデータを使用してプログラマティックな収益化を改善できます。オーディエンス特性には、行動およびインタレスト ベースのデータ(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
を明示的に呼び出します。 - 追加のターゲティング パラメータをメディエーション ネットワークに渡すにはどうすればよいですか?
- ターゲティングをメディエーション ネットワークに送信する方法については、メディエーションをご覧ください。