指定目標

選取平台： 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) 的規範，Google Mobile Ads SDK 提供 tagForChildDirectedTreatment 設定。

應用程式開發人員可以在發出廣告請求時，指出是否希望 Google 將內容視為兒童導向。一旦 Google 確認內容為兒童導向，就不會傳回 IBA 和再行銷廣告。設定方式如下：

  • 將 tagForChildDirectedTreatment 設為 true，表示需依 COPPA 規定視為兒童導向內容處理，避免傳送廣告 ID (IDFA)。
  • 將 tagForChildDirectedTreatment 設為 false，表示內容非兒童導向。
  • 若不想表明內容是否為兒童導向，可不設定 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 (IDFA)。
  • 如未設定 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 屬性，指定是否停止對所有廣告請求傳回個人化廣告。啟用這項功能後，工作階段後續的廣告請求都會加入發布商隱私處理 (PPT) 參數。

根據預設，Google 會對廣告請求提供個人化廣告。以下是停止讓廣告請求傳回個人化廣告的程式碼：

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

GAMRequest 物件會收集指定目標資訊，並將這些資訊隨廣告請求一併傳送。

新增聯播網額外資訊

聯播網額外資訊是隨廣告請求傳送的附加資訊，只適用於特定廣告來源。

以下是將額外參數鍵 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 = AdManagerRequest()
request.contentURL = "https://www.example.com"

Objective-C

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

自訂指定目標

在 Ad Manager 使用者介面設定好鍵/值組合後，您可以在廣告請求中使用這些鍵/值設定自訂指定目標。只要委刊項符合這些鍵/值設定，就有資格放送廣告。如果某個鍵需要對應多個值，請用半形逗號分隔各值。

Swift

let request = AdManagerRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

Objective-C

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

品牌安全 (Beta 版)

如果應用程式會依目標對象顯示動態內容，可以透過 neighboringContentURLs 屬性提供簡短的網址清單。這些鄰近內容網址不同於 contentURL 屬性，僅用於評估品牌安全。

假設應用程式的動態消息會同時顯示廣告與四個網址的內容，就可以藉由傳遞這些網址，請求內容分級相近的廣告，做法如下：

Swift

let request = AdManagerRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

Objective-C

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

發布商提供的 ID

您可以設定發布商提供的 ID (PPID)，跨裝置管理廣告放送方式，例如指定展示頻率上限、區隔目標對象及指定目標、安排廣告依序輪播，以及採取其他依目標對象調整的控制措施。

PPID 是透過 GAMRequest 設定：

Swift

let request = AdManagerRequest()
request.publisherProvidedID = "AB123456789"

Objective-C

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

請參考 Ad Manager 的 PPID 範例，觀察 iOS API 試用版應用程式如何導入發布商提供的 ID (PPID)。

Swift Objective-C

發布商提供的信號

您可以在廣告請求中，以發布商提供的信號 (PPS) 形式傳送目標對象和比對內容資料。PPS 能幫助您利用使用者資料提升程式輔助營利成效，將目標對象特徵以標準分類傳達給所有交易類型的出價方，而且無需分享使用者 ID。目標對象特徵可包括行為和興趣資料 (IAB 目標對象分類 1.1 版)，以及比對內容資料 (IAB 內容分類 2.2 版)。

Swift

let extras = Extras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = AdManagerRequest()
request.register(extras)

Objective-C

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

常見問題

廣告自動重新整理時，會使用哪些指定目標設定？
廣告重新整理時，系統會再次使用先前指定的 GAMRequest 物件來指定目標。如要更新指定目標，請在 GAMBannerView 上明確呼叫 loadRequest，並傳入新的 GAMRequest 物件。
如何將額外的指定目標參數傳送至中介服務聯播網？
請參閱中介服務說明文件，瞭解如何將指定目標傳送至中介服務聯播網。