本指南說明如何為廣告請求提供指定目標資訊。如需實際範例,請下載 Android API 試用版應用程式。
必要條件
- 完整閱讀入門指南
RequestConfiguration
RequestConfiguration
物件可收集指定目標資訊,然後透過 MobileAds
靜態方法在全域套用。
如要更新要求設定,請從現有設定取得建構工具,執行所需更新,然後依照下列方式設定:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
兒童導向設定
根據兒童網路隱私保護法 (COPPA) 規定,我們提供名為「兒童導向內容標記」的設定。設定此標記,即表示您確認這則通知正確無誤,且您是應用程式擁有者的授權代理人。瞭解濫用這項設定可能會導致 Google 帳戶遭到終止。
如果您是應用程式開發人員,則可指明是否希望 Google 在您提出廣告請求時將您的內容視為兒童導向內容。如果您表明希望 Google 將內容視為兒童導向內容,我們就會針對該廣告請求停用 IBA 和再行銷廣告。
您可透過 RequestConfiguration.Builder.setTagForChildDirectedTreatment(int)
搭配所有版本的 Google Play 服務 SDK 使用這項設定:
呼叫
setTagForChildDirectedTreatment
和TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE
,表明您想將您的內容視為兒童導向內容,以符合 COPPA 規範。這樣做可避免傳輸 Android 廣告 ID (AAID)。使用
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE
呼叫setTagForChildDirectedTreatment
,表示您不想將您的內容視為兒童導向內容,以符合 COPPA 規定。如果您不想指出您希望內容在廣告請求中遵守 COPPA 的處理方式,請使用
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED
呼叫setTagForChildDirectedTreatment
。
以下示例表示您希望根據 COPPA 將內容視為兒童導向內容:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var 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) 傳輸。呼叫
setTagForUnderAgeOfConsent()
並指定TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE
,表示您希望廣告請求「不要」為歐洲經濟區 (EEA) 境內未滿規定年齡的使用者發出通知。請使用
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
呼叫setTagForUnderAgeOfConsent()
,表示您並未指明廣告請求是否應接收未滿法定同意年齡的歐洲經濟區 (EEA) 使用者標記。
以下範例表示您希望廣告請求中包含 TFUA:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var 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
內的數位內容標籤標示:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
請參閱下列文章:
發布商隱私權處理方式 (Beta 版)
發布商隱私權處理方式
(PPT) API 是一項選用工具,可讓應用程式決定是否使用 setPublisherPrivacyPersonalizationState()
方法,為所有廣告請求停用廣告個人化功能。
使用這項功能時,在接下來的所有廣告請求中,系統都會納入發布商隱私權處理 (PPT) 參數。
根據預設,傳送給 Google 的廣告請求會放送個人化廣告。下方程式碼會為所有廣告請求停用廣告個人化功能:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
廣告請求
AdRequest
物件會收集要與廣告請求一併傳送的指定目標資訊。