指定目標

選取平台： Android iOS Unity Flutter

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

如想查看指定廣告目標的應用實例，請下載以 Swift 或 Objective-C 開發的 iOS API 試用版應用程式。

下載 API 試用版

必備條件

完成入門指南的步驟。

GADRequestConfiguration

GADRequestConfiguration 物件用來收集指定目標資訊，並透過 GADMobileAds 共用例項在全域套用。您可以使用以下程式碼取得此物件：

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

為確保廣告請求都會套用相應的配置變更，請先設定請求配置，再初始化 Google Mobile Ads SDK。

兒童導向內容設定

我們配合《兒童網路隱私保護法》(COPPA) 規定，提供 tagForChildDirectedTreatment 設定。

應用程式開發人員可利用這個設定，在送出廣告請求時，指明 Google 可否將自家應用程式的內容視為兒童導向。如果可以，Google 會採取行動，對廣告請求停用「依興趣指定目標對象」(IBA) 功能和再行銷廣告。設定方式如下：

  • 將 tagForChildDirectedTreatment 設為 true，表示要依據 COPPA 規定將內容視為兒童導向，避免傳送廣告 ID (廣告識別碼)。
  • 將 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) 參數。此外，這個參數不但會停用當下廣告請求的個人化廣告功能 (包括再行銷)，也會停止向第三方廣告供應商 (例如廣告評估像素和第三方廣告伺服器) 提出請求。

這項設定適用於所有的 Google Mobile Ads SDK 版本，只要設定 GADMobileAds.requestConfiguration 物件的 tagForUnderAgeOfConsent 屬性，並傳遞 true 值，即可啟用。

  • 將 tagForUnderAgeOfConsent 設為 true，指明廣告請求的處理方式須適合未滿規定年齡的使用者。這麼做也能避免系統傳送廣告 ID (廣告識別碼)。
  • 如未設定 tagForUnderAgeOfConsent，表示處理廣告請求時，不需要受限於未滿規定年齡使用者適用的方式。

以下範例說明如何在廣告請求中加入 TFUA：

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

用來啟用兒童導向設定的標記和 tagForUnderAgeOfConsent 不應同時設為 true，否則系統會優先採用兒童導向內容設定。

廣告內容篩選

您可利用 GADRequestConfiguration 的 maxAdContentRating 屬性，為應用程式設定所有廣告請求的廣告內容分級上限，而且這項設定會套用至同一工作階段中所有的後續廣告請求。此屬性可能的值取決於數位內容標籤分級，且必須是下列其中一個常數：

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

以下程式碼會設定所有的廣告請求，指定最高只能傳回下列數位內容標籤分級的廣告內容：GADMaxAdContentRatingGeneral。

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Publisher Privacy Treatment (Beta 版)

如有需要，您可使用 Publisher Privacy Treatment (PPT) API 這個工具，利用 GADRequestConfiguration 的 publisherPrivacyPersonalizationState 屬性，指明應用程式是否要對所有的廣告請求停用個人化廣告。如果採用這項功能，同一工作階段後續的廣告請求中，都會包含 Publisher Privacy Treatment (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。
如何將額外的指定目標參數傳送至中介服務聯播網？
請參閱中介服務相關說明，瞭解如何將指定目標傳送至中介服務聯播網。