指定目標

選取平台： 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;

為確保所有廣告請求都套用請求設定變更，請在初始化 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 帳戶遭到終止。

針對未滿規定年齡的歐洲經濟區 (EEA) 使用者，您可以在廣告請求中加上相關處理標記。這項功能的立意是協助發布商遵守《一般資料保護規則》(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;

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

Publisher Privacy Treatment (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。
如何將額外的指定目標參數傳送至中介服務聯播網？
請參閱中介服務說明文件，瞭解如何將指定目標傳送至中介服務聯播網。