このガイドでは、ターゲット設定情報を広告リクエストに設定する方法を説明します。
広告のターゲット設定の動作を確認するには、iOS API デモアプリ（Swift または Objective-C）をダウンロードしてください。
前提条件
先に進む前に、Google Mobile Ads SDK を設定してください。
GADRequestConfiguration
GADRequestConfiguration は、GADMobileAds 共有インスタンスを介してグローバルに適用されるターゲット情報を収集するオブジェクトです。次のコードでアクセスできます。
Swift
let requestConfiguration = MobileAds.shared.requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
すべての広告リクエストにリクエスト構成の変更が適用されるようにするには、Google Mobile Ads SDK を初期化する前にリクエスト構成を設定します。
年齢に応じた取り扱いを設定する
Google Mobile Ads SDK には、子どもや未成年に関連するプライバシー規則への遵守を管理するため、年齢に応じた取り扱いの設定が用意されています。年齢に応じた取り扱いの設定では、Google Mobile Ads SDK で子どもや未成年者のための広告配信保護対策を適用するかどうかを指定できます。この設定を使用すると、Google Mobile Ads SDK により広告リクエストに tfat パラメータが含められます。年齢に応じた取り扱いをユーザーにどのように適用するかは、法律および規制上の義務に基づき、弁護士に相談のうえ判断してください。
年齢に応じた取り扱いは、GADRequestConfiguration の ageRestrictedTreatment プロパティで設定できます。
子どもの取り扱いを設定する
子どもの取り扱いを広告リクエストに適用する場合の例を次に示します。
Swift
// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
Objective-C
// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
GADAgeRestrictedTreatmentChild;
13 歳以上の未成年者の取り扱いを設定する
13 歳以上の未成年者の取り扱いを広告リクエストに適用する場合の例を次に示します。
Swift
// Indicates that ad requests should have teen age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .teen
Objective-C
// Indicates that ad requests should have teen age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
GADAgeRestrictedTreatmentTeen;
年齢に応じた取り扱いを設定しない
年齢に応じた取り扱いを広告リクエストに適用しない場合の例を次に示します。
Swift
// Indicates that ad requests should have unspecified age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .unspecified
Objective-C
// Indicates that ad requests should have unspecified age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
GADAgeRestrictedTreatmentUnspecified;
TFCD と TFUA から年齢に応じた取り扱いに移行する
年齢に応じた取り扱いの設定は、非推奨となった tagForChildDirectedTreatment（TFCD）プロパティと tagForUnderAgeOfConsent（TFUA）プロパティに代わるものです。
次の表に、tagForChildDirectedTreatment および tagForUnderAgeOfConsent の設定と、それに対応する年齢に応じた取り扱いを示します。
TFCD
tagForChildDirectedTreatment |
年齢に応じた取り扱い |
|---|---|
tagForChildDirectedTreatment = true |
GADAgeRestrictedTreatmentChild |
tagForChildDirectedTreatment = false |
GADAgeRestrictedTreatmentUnspecified |
tagForChildDirectedTreatment に割り当てられた値なし |
GADAgeRestrictedTreatmentUnspecified |
| 対応するプロパティなし | GADAgeRestrictedTreatmentTeen |
TFUA
tagForUnderAgeOfConsent |
年齢に応じた取り扱い |
|---|---|
tagForUnderAgeOfConsent = true |
GADAgeRestrictedTreatmentChild |
tagForUnderAgeOfConsent = false |
GADAgeRestrictedTreatmentUnspecified |
tagForUnderAgeOfConsent に割り当てられた値なし |
GADAgeRestrictedTreatmentUnspecified |
| 対応するプロパティなし | GADAgeRestrictedTreatmentTeen |
年齢に応じた取り扱いと TFCD および TFUA の関係について
年齢に応じた取り扱いの設定と TFCD または TFUA の設定を両方とも設定した場合は、最も厳格な制限が適用されます。
子ども向けの設定
児童オンライン プライバシー保護法（COPPA）に基づき、tagForChildDirectedTreatment という設定が用意されています。
アプリ デベロッパーは広告リクエストを行う際に、自社コンテンツを子供向けとして扱ってほしいかどうかを示すことができます。子供向けコンテンツとして扱うように示すと、その広告リクエストについてはインタレスト ベース広告（IBA）とリマーケティング広告を無効にする措置が取られます。設定オプションは次のとおりです。
- COPPA に基づく子供向けコンテンツとして扱うように示すには、
tagForChildDirectedTreatmentにtrueを設定します。これにより、広告 ID（IDFA）が送信されなくなります。 - COPPA に基づく子供向けコンテンツとして扱わないよう示すには、
tagForChildDirectedTreatmentにfalseを設定します。 - COPPA に関してコンテンツがどのように取り扱われるようにするかを指定しない場合は、
tagForChildDirectedTreatmentを設定しないでください。
コンテンツが COPPA に基づく子供向けコンテンツとして取り扱われるよう指定する場合の例を次に示します。
Swift
MobileAds.shared.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
MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;
子供向けの設定を有効にするタグと tagForUnderAgeOfConsent に設定する値を、同時に両方とも true にしてはいけません。両方ともその値にすると、子供向けの設定が優先されます。
広告コンテンツのフィルタリング
アプリは、GADRequestConfiguration のプロパティ maxAdContentRating を使用して、すべての広告リクエストの広告レーティングの上限を設定できます。この設定は、残りのセッションの今後のすべての広告リクエストに適用されます。このプロパティが取り得る値はデジタル コンテンツ ラベルの分類に基づき、次のいずれかの定数になります。
GADMaxAdContentRatingGeneralGADMaxAdContentRatingParentalGuidanceGADMaxAdContentRatingTeenGADMaxAdContentRatingMatureAudience
次のコードは、すべての広告リクエストに対して、デジタル コンテンツ ラベル指定が GADMaxAdContentRatingGeneral 階層までの広告コンテンツを返すように指定しています。
Swift
MobileAds.shared.requestConfiguration.maxAdContentRating =
GADMaxAdContentRating.general
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral;
Publisher Privacy Treatment（ベータ版）
Publisher Privacy Treatment（PPT）API は、GADRequestConfiguration の publisherPrivacyPersonalizationState プロパティを使用して、すべての広告リクエストで広告のパーソナライズを無効にするかどうかをアプリで指定するための、オプションのツールです。この機能を使用すると、それ以降の残りのセッションのすべての広告リクエストに、パブリッシャーのプライバシーに関する取り扱い（PPT）のパラメータが含まれるようになります。
デフォルトでは、Google への広告リクエストに対してパーソナライズド広告が配信されます。次のコードは、すべての広告リクエストで広告のパーソナライズを無効にしています。
Swift
MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
.disabled
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
GADPublisherPrivacyPersonalizationStateDisabled;
GADRequest
GADRequest オブジェクトは、広告リクエストと一緒に送るターゲット設定情報を収集します。
ネットワークについての情報を追加する
ネットワークについての追加情報は、広告リクエストとともに送信される追加の詳細情報で、1 つの広告ソースに固有のものです。
次のコード スニペットでは、collapsible の追加パラメータキーを bottom の値とともに Google に設定します。
Swift
let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)
Objective-C
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 を渡して関連キーワードをターゲットに設定できます。
Swift
let request = Request()
request.contentURL = "https://www.example.com"
Objective-C
GADRequest *request = [GADRequest request];
request.contentURL = @"https://www.example.com";
よくある質問
- 広告が自動的に更新される際は、どのターゲット設定が使用されますか？
- 広告が更新される際は、前回指定した
GADRequestオブジェクトが再度ターゲット設定に使用されます。 新しくターゲット設定を行うには、新しいGADRequestオブジェクトを指定してGADBannerViewのloadRequestを明示的に呼び出します。 - 追加のターゲット設定パラメータをメディエーション ネットワークに渡すにはどうすればよいですか？
- メディエーションをご覧のうえ、ターゲット設定をメディエーション ネットワークに渡す方法をご確認ください。