本指南說明如何向 Google Mobile Ads SDK 提供指定資訊。
如需實際範例,請下載 Android API 試用版應用程式。修課條件
- 完成入門指南。
RequestConfiguration
RequestConfiguration
會收集全域套用到每個廣告請求的指定目標資訊。如要查看可用的指定目標標記,請參閱 RequestConfiguration.Builder
說明文件。
如要更新要求設定,請從現有設定取得建構工具,執行所需的更新,然後依下列方式設定:
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
兒童導向內容設定
為符合《兒童網路隱私保護法 (COPPA)》的規範,系統提供了名為「tag for 兒童導向內容」的設定。設定這個標記,即表示您確認這項通知正確無誤,且您有權代表應用程式的擁有者行事。 您瞭解濫用這項設定可能會導致您的 Google 帳戶遭到終止。
如果您是應用程式開發人員,則可指明是否希望 Google 在您提出廣告請求時將內容視為兒童導向內容。如果您指明 Google 將內容視為兒童導向內容,我們會採取措施, 停用廣告請求的按照興趣顯示廣告和再行銷廣告。
您可以透過
setTagForChildDirectedTreatment()
:
請使用
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE
呼叫setTagForChildDirectedTreatment
,表示您希望系統根據 COPPA 將內容視為兒童導向內容。這可避免傳送 Android 廣告 ID (AAID)。使用
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE
呼叫setTagForChildDirectedTreatment
,表示您不希望系統將內容視為 COPPA 所定義的兒童導向內容。如果您不想在廣告請求中指出希望如何處理內容,請使用
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED
呼叫setTagForChildDirectedTreatment
。
以下範例表示您希望內容在符合 COPPA 規範的情況下視為兒童導向內容:
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
未滿法定同意年齡的使用者
您可以替廣告請求設定未滿規定年齡的歐洲經濟區使用者標記。這項功能的立意是協助發布商遵守《一般資料保護規則》(GDPR)。請注意,您可能也需要配合 GDPR 遵守其他法律義務請詳閱歐盟指南並諮詢您的法律顧問。請注意,Google 提供工具的用意是協助發布商遵守規定,而非方便發布商規避法定義務。 進一步瞭解 GDPR 對發布商的影響。
使用這項功能時,廣告請求會包含「未滿法定同意年齡的歐洲使用者標記」(TFUA) 參數。這個參數會針對所有廣告請求停用個人化廣告功能 (包括再行銷),並且停止向第三方廣告供應商 (例如廣告評估像素和第三方廣告伺服器) 提出其他請求。
與兒童導向設定一樣,RequestConfiguration.Builder
提供一個設定 TFUA 參數的方法:
setTagForUnderAgeOfConsent()
、
具備下列選項。
使用
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE
呼叫setTagForUnderAgeOfConsent()
,表示您希望廣告請求接受未滿規定年齡的歐洲經濟區 (EEA) 使用者治療。這也能避免傳送 Android 廣告 ID (AAID)。搭配
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE
呼叫setTagForUnderAgeOfConsent()
,表示您希望廣告請求「不」針對歐洲經濟區 (EEA) 境內未滿法定同意年齡的使用者採取相關處理模式。使用
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
呼叫setTagForUnderAgeOfConsent()
,代表您並未指定廣告請求是否應針對歐洲經濟區未滿規定年齡的使用者採取治療措施。
以下範例表示您希望在廣告要求中加入 TFUA:
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
啟用「兒童導向設定」和 setTagForUnderAgeOfConsent()
的標記不應同時設為 true
。如果是這種情況,系統會優先採用兒童導向設定。
廣告素材篩選功能
為了遵守 Google Play 的不當廣告政策,廣告中的相關優惠也包含在內,應用程式中所有廣告和相關優惠都必須適合應用程式的內容分級,即使內容本身違反了 Google Play 政策也一樣。
您可利用廣告內容分級上限這類工具,進一步掌控向使用者放送的廣告內容。您可以設定內容分級上限,以利遵守平台政策。
應用程式可以使用
setMaxAdContentRating
方法,為廣告請求設定廣告內容分級上限。當此設定的內容分級等於或低於該層級時,系統會傳回 AdMob 廣告。此聯播網額外項目的可能值是根據數位內容標籤分類而定,必須是下列其中一個字串:
MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA
下列程式碼會設定 RequestConfiguration
物件,指定傳回的廣告內容對應的數位內容標籤標示不得高於 G
:
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
請參閱下列文章:
發布商隱私權處理方式 (Beta 版)
發布商隱私權處理方式
(PPT) API 是選用工具,可讓應用程式使用 setPublisherPrivacyPersonalizationState()
方法,指出是否要停用所有廣告請求的廣告個人化設定。使用這項功能時,日後所有廣告請求 (在工作階段的其餘時間) 都會包含發布商隱私權處理 (PPT) 參數。
根據預設,傳送給 Google 的廣告請求會放送個人化廣告。下列程式碼會為所有廣告請求關閉廣告個人化功能:
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
廣告請求
AdRequest
物件會收集要與廣告請求一併傳送的指定目標資訊。
如要瞭解如何在 Android API 示範應用程式中實作廣告指定目標,請參閱廣告指定目標範例。