本指南說明如何向 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),我們提供「標記兒童導向內容」設定。設定這個標記即表示您確認這項通知正確無誤,而且您有權代表應用程式擁有者採取行動。您瞭解濫用這項設定可能會導致 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()
,表示您未指定廣告請求是否應針對歐洲經濟區 (EEA) 境內未滿法定同意年齡的使用者採用受限的資料處理模式。
以下範例表示您希望在廣告要求中加入 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 示範應用程式中實作廣告指定目標,請參閱廣告指定目標範例。