指定目標

本指南說明如何為廣告請求提供指定目標資訊。

如要查看廣告指定目標的實際操作情形,請在 Swift 或 Objective-C 中下載 iOS API 示範應用程式。

下載 API 示範影片

先備知識

完成開始使用指南。

GADRequestConfiguration

GADRequestConfiguration 物件會收集指定目標資訊,以便透過 GADMobileAds 共用執行個體進行全域套用。可透過下列程式碼存取:

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

兒童導向設定

為符合《兒童網路隱私保護法 (COPPA)》的規範,系統提供了名為 tagForChildDirectedTreatment 的設定。

如果您是應用程式開發人員,則可指明是否希望 Google 在您提出廣告請求時將內容視為兒童導向內容。如果您表示希望 Google 將內容視為兒童導向內容,Google 會採取措施,針對廣告請求停用按照興趣顯示的廣告和再行銷廣告。設定選項如下:

  • tagForChildDirectedTreatment 設為 true,表示 Google 希望將您的內容視為兒童導向內容,以符合 COPPA 的規範。這樣就能防止傳輸廣告識別碼 (IDFA),
  • tagForChildDirectedTreatment 設為 false 代表您不希望內容被視為兒童導向內容,以符合 COPPA 的規範。
  • 如果您不想表明 Google 如何根據 COPPA 規定處理內容,請不要設定 tagForChildDirectedTreatment

以下範例表示您希望在符合 COPPA 規範的情況下,將內容視為兒童導向內容:

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

設定這個標記,即表示您確認這項通知正確無誤,而且您有權代表應用程式的擁有者行事。您瞭解濫用這項設定可能會導致您的 Google 帳戶遭到終止。

您可以替廣告請求設定未滿規定年齡的歐洲經濟區使用者標記。這項功能的立意是協助發布商遵守《一般資料保護規則》(GDPR)。請注意,您可能也需要配合 GDPR 遵守其他法律義務請詳閱歐盟指南,並諮詢您的法律顧問。請注意,Google 提供工具的用意是協助發布商遵守規定,而非方便發布商規避其法律義務。 進一步瞭解 GDPR 對發布商的影響

使用這項功能時,日後所有的廣告請求都會納入「未滿規定年齡 (TFUA)」參數的使用者。這個參數會停用特定廣告請求的個人化廣告 (包括再行銷)。並且停止向第三方廣告供應商 (例如廣告評估像素和第三方廣告伺服器) 提出其他請求。

這項設定適用於所有版本的 Google Mobile Ads SDK,方法是在 GADMobileAds.requestConfiguration 物件上設定 tagForUnderAgeOfConsent 屬性,並傳入 true

  • tagForUnderAgeOfConsent 設為 true,表示您希望以適合未滿規定年齡使用者的方式處理廣告請求。這也能防止傳輸廣告識別碼 (IDFA) 傳送。
  • 如未設定 tagForUnderAgeOfConsent,即表示您不希望以適合未滿規定年齡使用者的方式處理廣告請求。

以下舉例說明您想在廣告請求中加入 TFUA:

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

啟用兒童導向設定tagForUnderAgeOfConsent 的標記不應同時設為 true。如果是這種情況,系統會優先採用兒童導向設定。

廣告素材篩選功能

應用程式可以使用 GADRequestConfigurationmaxAdContentRating 屬性,為所有廣告請求設定廣告內容分級上限。這項設定適用於工作階段剩餘期間的所有日後的廣告請求。這個屬性的可能值是根據數位內容標籤分類而定,應為下列其中一個常數:

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

下列程式碼會設定所有廣告請求,指定傳回的廣告內容應對應不超過 GADMaxAdContentRatingGeneral 的數位內容標籤標示。

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

發布商隱私權保護措施 (Beta 版)

發布商隱私權條例 (PPT) API 是一項選用工具,可讓應用程式指出是否要使用 GADRequestConfigurationpublisherPrivacyPersonalizationState 資源,針對所有廣告請求停用廣告個人化功能。使用這項功能時,日後工作階段其餘的廣告請求都會包含發布商隱私權處理 (PPT) 參數。

根據預設,傳送給 Google 的廣告請求會放送個人化廣告。以下程式碼會關閉所有廣告請求的廣告個人化功能:

Swift

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

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GADRequest

GADRequest 物件會收集要與廣告請求一併傳送的指定目標資訊。

內容網址

請求廣告時,應用程式可以傳遞所放送內容的網址。這樣可以讓關鍵字指定功能比對廣告與內容。

舉例來說,如果您的應用程式在顯示 https://www.example.com 的內容時要求廣告,您可以傳遞此網址來指定相關的關鍵字:

Swift

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

Objective-C

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

常見問題

廣告重新整理時,系統會使用哪種指定目標?
廣告重新整理時,系統會再次使用先前指定的 GADRequest 物件來指定目標。如要設定新的指定目標,請使用新的 GADRequest 物件在 GADBannerView 上明確呼叫 loadRequest
如何將額外的指定目標參數傳遞至中介服務聯播網?
請參閱中介服務,瞭解如何將指定目標傳送至中介服務聯播網。