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

指定目標

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

若想查看實際指定廣告，請下載 Swift 或 iOS 版的 iOS API 試用版應用程式， Objective-C：

下載 API 示範影片

必要條件

完成開始使用指南。

GADRequestConfiguration

GADRequestConfiguration敬上物件會收集指定目標資訊，以便全面套用到這個 GADMobileAds 共用執行個體。可透過下列程式碼存取：

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

兒童導向設定

用於《兒童網路隱私保護法》 (COPPA), 有個設定叫做 tagForChildDirectedTreatment。

如果您是應用程式開發人員，則可指明是否希望 Google 將內容標示為兒童導向內容。當您指定您希望 Google 將您的內容視為兒童導向內容，Google 會採取相應步驟即可針對該廣告請求停用按照興趣顯示的廣告和再行銷廣告。設定選項包括如下所示：

將 tagForChildDirectedTreatment 設為 true，表示想要內容視為兒童導向內容。這樣一來，廣告識別碼 (IDFA) 的傳輸流量。
將 tagForChildDirectedTreatment 設為 false，表示不需要您的內容將視為兒童導向內容，以符合 COPPA 規範
如果不想指定 tagForChildDirectedTreatment，請勿設定您是否希望自己的內容符合 COPPA 規範

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

設定這個代碼，即表示您確認這項通知正確無誤，而且。您瞭解濫用這麼做可能會導致您的 Google 帳戶遭到終止。

未滿規定年齡的使用者

您可以在未滿規定年齡的歐洲經濟區 (EEA)。這項功能協助您遵循《一般大眾內容》資料保護規則 (GDPR)。請注意，您有其他法律規範所負責任 AI 技術的義務。詳閱歐盟指南，並向建議諮詢法律顧問請注意，Google 工具旨在合乎規定，而非讓任何特定發布商履行其義務法律。進一步瞭解 GDPR 的影響發布商。

使用這項功能時，系統會加上未滿規定年齡使用者標記日後所有的廣告請求都會包含歐洲 (TFUA) 參數。這個參數會停用以下項目的個人化廣告 (包括再行銷)：來自特定廣告請求並且停止向第三方廣告供應商提出請求例如廣告評估像素和第三方廣告伺服器

這項設定可用於所有版本的 Google Mobile Ads SDK，設定針對「tagForUnderAgeOfConsent」屬性 GADMobileAds.requestConfiguration 物件並傳入 true。

將 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 是一項選用工具，可讓應用程式指明是否要關閉廣告功能針對所有採用 publisherPrivacyPersonalizationState GADRequestConfiguration 屬性。使用這項功能時隱私權處理 (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)，用於展示頻率上限、目標對象區隔和指定目標、廣告依序輪播和其他目標對象導向的跨裝置廣告放送控制項

設定 PPID 時，可透過 GAMRequest 完成：

Swift

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

Objective-C

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

請參閱 Ad Manager PPID 範例，瞭解如何導入發布商提供的 iOS API 試用版應用程式中的識別碼 (PPID)：

快速 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 物件再次指定目標。如要設定新的指定目標，請在以下項目中明確呼叫 loadRequest：有一張新優惠的 GAMBannerView GAMRequest 物件。
如何將額外的指定目標參數傳遞至中介服務聯播網？: 請參閱「中介服務」一文，瞭解如何將指定目標傳送到中介服務聯播網