定位

本指南說明如何為廣告請求提供指定目標資訊。如需實際範例,請下載 Android API 示範應用程式。

下載 API 示範

必備條件

要求設定

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 版本搭配使用:

  • 呼叫 setTagForChildDirectedTreatmentTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE 來表示您想將內容視為兒童導向內容,以符合 COPPA 規範。這將避免傳輸 Android 廣告 ID (AAID)

  • 呼叫 setTagForChildDirectedTreatmentTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE,表明您不希望系統將內容視為兒童導向內容並接受 COPPA 規範。

  • 如果不想在廣告請求中對內容遵守 COPPA 規範,請呼叫 setTagForChildDirectedTreatment 並呼叫 TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED

以下範例表示您希望將內容視為兒童導向內容,以符合 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(),但有下列選項。

  • 呼叫 setTagForUnderAgeOfConsent()TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE,表明您希望廣告請求接受未滿法定同意年齡的歐洲經濟區使用者。這樣做也會避免傳輸 Android 廣告 ID (AAID)

  • TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE 呼叫 setTagForUnderAgeOfConsent(),表明您希望廣告請求「不會」在未滿法定同意年齡的歐洲經濟區使用者放送。

  • 呼叫 setTagForUnderAgeOfConsent()TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED,表明您尚未對廣告請求指定未滿法定同意年齡的歐洲經濟區使用者。

以下範例表示您希望廣告請求包含 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。 如果這兩者同時設定,系統會優先採用兒童導向內容設定。

廣告素材篩選

應用程式可以使用 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)

廣告請求

AdRequest 物件會收集要與廣告請求一併傳送的指定目標資訊。

請參閱廣告指定目標範例,瞭解如何在 Android API 示範應用程式中導入廣告指定目標。