本指南說明如何為廣告請求提供指定目標資訊。
如要查看廣告指定目標的實際運作情形,請在 Swift 或 Objective-C 中下載 iOS API 試用版應用程式。
必要條件
完成開始使用指南。
GADRequestConfiguration
GADRequestConfiguration
是一個物件,可收集指定目標資訊,並透過 GADMobileAds
共用例項在全域套用。程式碼可透過以下程式碼存取:
Swift
let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
兒童導向設定
為符合兒童網路隱私保護法 (COPPA) 的規定,我們提供名為 tagForChildDirectedTreatment
的設定。
如果您是應用程式開發人員,則可指明是否希望 Google 在您提出廣告請求時將您的內容視為兒童導向內容。如果您指示 Google 將內容視為兒童導向內容,Google 就會針對該廣告請求停用 IBA 和再行銷廣告。設定選項如下:
- 將
tagForChildDirectedTreatment
設為true
,表示您想將您的內容視為兒童導向內容,以符合 COPPA 規範。這樣就無法傳輸廣告識別碼 (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) 參數。這個參數會針對特定廣告請求停用個人化廣告 (包括再行銷)。還會停止向第三方廣告伺服器 (例如廣告評估像素和第三方廣告伺服器) 發出要求。
此設定可搭配所有版本的 Google Mobile Ads SDK 使用,方法是在 GADMobileAds.requestConfiguration
物件上設定 tagForUnderAgeOfConsent
屬性並傳入 true
。
- 將
tagForUnderAgeOfConsent
設為true
,表示您希望以適合未滿規定年齡使用者的方式處理廣告請求。這樣做也能防止系統傳輸廣告識別碼 (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 UI 中設定鍵/值組合後,請使用廣告請求中的鍵/值設定自訂指定目標。指定這些鍵值的委刊項就有資格針對該廣告請求放送廣告。如要為同一個鍵指定多個值,請以半形逗號分隔字串輸入值。
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):
發布商提供的信號
您可以在廣告請求中,以發布商提供的信號 (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
。 - 如何將額外的指定目標參數傳遞給中介服務聯播網?
- 請參閱「中介服務」一文,瞭解如何將指定目標傳送至中介服務聯播網。