指定目標

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

如要瞭解廣告指定目標的運作方式，請下載 Swift 或 Objective-C 版 iOS API 示範應用程式。

下載 API 示範

必要條件

完成入門指南。

GADRequestConfiguration

GADRequestConfiguration 是一個物件，可收集指定資訊，並透過 GADMobileAds 共用例項在整個網站上套用。您可以使用下列程式碼存取該值：

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

為確保所有廣告請求都會套用請求設定變更，請在初始化 Mobile Ads SDK 之前設定請求設定。

兒童導向內容設定

根據《兒童網路隱私保護法》(COPPA) 規定，我們提供名為 tagForChildDirectedTreatment 的設定。

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

  • 將 tagForChildDirectedTreatment 設為 true，表示您希望系統將內容視為兒童導向內容並接受 COPPA 規範。這可避免傳送廣告 ID (IDFA)。
  • 將 tagForChildDirectedTreatment 設為 false，表示您不希望系統將內容視為兒童導向內容並接受 COPPA 規範。
  • 如果不想指出如何根據 COPPA 處理內容，請勿設定 tagForChildDirectedTreatment。

以下範例表示您希望系統依 COPPA 將內容視為兒童導向：

Swift

GADMobileAds.sharedInstance().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

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;

發布商隱私權處理方式 (Beta 版)

發布商隱私權處理方式 (PPT) API 是選用工具，可讓應用程式使用 GADRequestConfiguration 的 publisherPrivacyPersonalizationState 屬性，指出是否要為所有廣告請求停用廣告個人化設定。使用這項功能時，日後所有廣告請求 (在工作階段的其餘時間) 都會包含發布商隱私處理 (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。
如何將額外的指定參數傳遞至中介服務聯播網？
請參閱「中介服務」，瞭解如何將指定目標傳送至中介服務聯播網。