本指南說明如何向廣告請求提供指定目標資訊。
如要查看廣告指定目標的實際運作情形，請下載以 Swift 或 Objective-C 撰寫的 iOS API 示範應用程式。
必要條件
完成「開始使用」指南。
GADRequestConfiguration
GADRequestConfiguration
是收集目標對象資訊的物件，可透過
GADMobileAds
共用執行個體全域套用。您可以使用下列程式碼存取該屬性：
Swift
let requestConfiguration = MobileAds.shared.requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
為確保所有廣告請求都套用請求設定變更，請在初始化 Mobile Ads SDK 前設定請求設定。
兒童導向設定
為遵守兒童網路隱私保護法 (COPPA)，我們提供「tagForChildDirectedTreatment」設定。
如果您是應用程式開發人員，則可指明是否希望 Google 在您提出廣告請求時將內容視為兒童導向內容。如果您指明希望 Google 將內容視為兒童導向內容，Google 就會採取相應措施，針對該廣告請求停用按照興趣顯示的廣告和再行銷廣告。設定選項如下：
- 將
tagForChildDirectedTreatment設為true，指明您希望內容視為兒童導向內容並接受 COPPA 規範。這樣一來，系統就不會傳輸廣告 ID (IDFA)。 - 將
tagForChildDirectedTreatment設為false，指明您不希望內容視為兒童導向內容並接受 COPPA 規範。 - 如果不想指出您希望如何根據 COPPA 處理內容，請勿設定
tagForChildDirectedTreatment。
以下範例表示您希望根據 COPPA 將內容視為兒童專屬內容：
Swift
MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;
設定這個標記即表示您確認這項通知正確無誤，而且您是應用程式擁有者的授權代理人。您瞭解如果濫用這項設定，可能會導致 Google 帳戶遭到終止。
未滿規定年齡的使用者
您可以替廣告請求設定未滿法定同意年齡的歐洲經濟區使用者標記。這項功能的立意是協助發布商遵守《一般資料保護規則》(GDPR)。請注意，您可能還有 GDPR 所衍生的其他法律義務。請查看歐盟發布的指南並諮詢您的法律顧問。請注意，Google 提供工具的用意是協助發布商遵守規定，不是幫忙任何發布商規避其法律義務。進一步瞭解 GDPR 對發布商的影響。
使用這項功能時，日後的所有廣告請求都會包含「未滿法定同意年齡的歐洲使用者標記」(TFUA) 參數。這個參數會針對特定廣告請求停用個人化廣告功能 (包括再行銷)，並且停止向第三方廣告供應商 (例如廣告評估像素和第三方廣告伺服器) 提出其他請求。
只要在 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。否則系統將以兒童導向設定為準。
廣告內容篩選
應用程式可以使用 maxAdContentRating GADRequestConfiguration 的屬性，為所有廣告請求設定廣告內容分級上限。這項設定會套用至工作階段剩餘時間內的所有後續廣告請求。這個屬性的可能值取決於數位內容標籤分類，且應為下列常數之一：
GADMaxAdContentRatingGeneralGADMaxAdContentRatingParentalGuidanceGADMaxAdContentRatingTeenGADMaxAdContentRatingMatureAudience
下列程式碼會設定所有廣告請求，指定傳回的廣告內容數位內容標籤不得高於 GADMaxAdContentRatingGeneral。
Swift
MobileAds.shared.requestConfiguration.maxAdContentRating =
GADMaxAdContentRating.general
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral;
發布商隱私權處理方式 (Beta 版)
「發布商隱私權處理方式」(PPT) API 是選用工具，可讓應用程式使用 GADRequestConfiguration 的 publisherPrivacyPersonalizationState 屬性，指出是否要停用所有廣告請求的廣告個人化設定。使用這項功能時，在工作階段的其餘時間內，所有後續廣告請求都會包含發布商隱私權處理 (PPT) 參數。
根據預設，傳送給 Google 的廣告請求會放送個人化廣告。下列程式碼會針對所有廣告請求停用廣告個人化功能：
Swift
MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
.disabled
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
GADPublisherPrivacyPersonalizationStateDisabled;
GADRequest
GADRequest 物件會收集指定目標資訊，以便隨廣告請求一併傳送。
加購電視網
聯播網額外資訊是指隨廣告請求傳送的額外詳細資料，專屬於單一廣告來源。
下列程式碼片段會將額外參數鍵 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];
內容網址
應用程式請求廣告時，可以傳遞放送內容的網址。 這樣一來，關鍵字指定目標就能比對廣告和內容。
舉例來說，如果應用程式在顯示 https://www.example.com 的內容時要求放送廣告，您可以傳遞這個網址來指定相關關鍵字：
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。 - 如何將額外的指定參數傳遞至中介服務聯播網？
- 請參閱「中介服務」，瞭解如何將指定目標傳送至中介服務聯播網。