本頁面由 Cloud Translation API 翻譯而成。

指定目標

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

如要瞭解廣告指定目標的運作方式，請下載 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;

GAMRequest

GAMRequest 物件會收集要透過廣告請求傳送的指定目標資訊。

內容網址

應用程式在要求廣告時，可以傳遞所放送內容的網址。這樣一來，關鍵字指定目標就能將廣告與內容配對。

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

Swift

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

Objective-C

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

自訂指定目標

在 Ad Manager 使用者介面中設定鍵/值組合後，請在廣告請求中使用鍵/值組合設定自訂指定目標。這時，指定這些鍵/值的委刊項就有資格放送廣告。如要針對一個鍵指定多個值，請以逗號分隔的字串輸入值。

Swift

let request = GAMRequest()
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 = GAMRequest()
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)，用於設定展示頻率上限、目標對象區隔和指定目標、廣告依序輪播，以及其他以目標對象為準的跨裝置廣告放送控制項。

您可以透過 GAMRequest 設定 PPID：

Swift

let request = GAMRequest()
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 = GADExtras()
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 = GAMRequest()
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 物件進行指定。如要設定新的指定目標，請使用新的 GAMRequest 物件，明確地在 GAMBannerView 上呼叫 loadRequest。
如何將額外的指定參數傳遞至中介服務聯播網？: 請參閱「中介服務」，瞭解如何將指定目標傳送至中介服務聯播網。