RequestConfiguration.Builder

public class RequestConfiguration.Builder

RequestConfiguration 的建構工具。

摘要

公用建構函式

公用方法
RequestConfiguration

可建構 RequestConfiguration。
RequestConfiguration.Builder

設定年齡限制處理方式設定。
RequestConfiguration.Builder

設定廣告內容分級上限。
RequestConfiguration.Builder

設定發布商隱私權處理方式的個人化狀態。
RequestConfiguration.Builder

這個方法已淘汰。

請改用 setAgeRestrictedTreatment。
RequestConfiguration.Builder

這個方法已淘汰。

請改用 setAgeRestrictedTreatment。
RequestConfiguration.Builder

設定與測試裝置相應的測試裝置 ID 清單，這些裝置一律會要求測試廣告。

公用建構函式

Builder

public Builder()

公用方法

build

public RequestConfiguration build()

可建構 RequestConfiguration。

setAgeRestrictedTreatment

@CanIgnoreReturnValue
public RequestConfiguration.Builder setAgeRestrictedTreatment(
    @Nullable AgeRestrictedTreatment ageRestrictedTreatment
)

設定年齡限制處理方式設定。

請諮詢法律顧問，根據您應盡的法律與法規義務，決定要對使用者採取的年齡處理方式。如要進一步瞭解這項設定，請參閱 https://developers.google.com/admob/android/targeting#set_the_age_treatment

設定這項屬性，代表您保證這項通知資訊正確無誤，且您有權代表應用程式擁有者行事。您知悉濫用這項設定可能導致 Google 帳戶遭終止。

參數
@Nullable AgeRestrictedTreatment ageRestrictedTreatment

年齡限制處理方式，指出廣告請求應視為兒童、青少年或未指定。

setMaxAdContentRating

@CanIgnoreReturnValue
public RequestConfiguration.Builder setMaxAdContentRating(
    @RequestConfiguration.MaxAdContentRating @Nullable String maxAdContentRating
)

設定廣告內容分級上限。系統為您的應用程式傳回的 AdMob 廣告，就不會超過指定的內容分級上限。有效值為 MAX_AD_CONTENT_RATING_G、MAX_AD_CONTENT_RATING_PG、MAX_AD_CONTENT_RATING_T 和 MAX_AD_CONTENT_RATING_MA。

setPublisherPrivacyPersonalizationState

@CanIgnoreReturnValue
public RequestConfiguration.Builder setPublisherPrivacyPersonalizationState(
    RequestConfiguration.PublisherPrivacyPersonalizationState publisherPrivacyPersonalizationState
)

設定發布商隱私權處理方式的個人化狀態。

setTagForChildDirectedTreatment

@CanIgnoreReturnValue
public RequestConfiguration.Builder setTagForChildDirectedTreatment(
    @RequestConfiguration.TagForChildDirectedTreatment int tagForChildDirectedTreatment
)

這個方法可讓您指定是否要依《兒童網路隱私保護法》(COPPA) 規定 ( http://business.ftc.gov/privacy-and-security/childrens-privacy) 將應用程式視為針對兒童的內容。

如果將這個方法設為 TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE，即表示應用程式應根據《兒童網路隱私保護法》(COPPA) 視為針對兒童的。

如果將這個方法設為 TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE，代表根據《兒童網路隱私保護法》(COPPA)，應用程式不應視為針對兒童的。

如未設定這個方法，或將這個方法設為 TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED，廣告請求就不會指明應如何依據 COPPA 處理應用程式。

設定此方法，即表示您確認這項通知正確無誤，且您有權代表應用程式擁有者採取行動；同時您也瞭解如果濫用這項設定，可能導致 Google 帳戶遭到終止。

注意：這項指定操作可能需要經過一段時間才會在適當的 Google 服務中全面生效。

參數
@RequestConfiguration.TagForChildDirectedTreatment int tagForChildDirectedTreatment

設為 true，表示應用程式應視為針對兒童的。設為 false，表示應用程式不應視為針對兒童的內容。

setTagForUnderAgeOfConsent

@CanIgnoreReturnValue
public RequestConfiguration.Builder setTagForUnderAgeOfConsent(
    @RequestConfiguration.TagForUnderAgeOfConsent int tagForUnderAgeOfConsent
)

這個方法可讓您標記應用程式，針對歐洲經濟區境內未滿規定年齡的使用者，套用適當模式。這項功能的立意是協助發布商遵守《一般資料保護規則》(GDPR)。請注意，您可能還有 GDPR 所衍生的其他法律義務。請查看歐盟發布的指南並諮詢您的法律顧問。提醒您，Google 提供工具的用意是協助發布商遵守規定，而非方便發布商規避法定義務。

使用這項功能時，所有廣告請求都會包含歐洲使用者適用的未滿規定年齡標記 (TFUA) 參數。這個參數會針對特定廣告請求，停用個人化廣告功能 (包括再行銷)，也會停止向第三方廣告供應商 (例如廣告評估像素和第三方廣告伺服器) 提出其他請求。

如果將這個方法設為 TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE，表示您希望以適合未滿規定年齡使用者的方式處理應用程式。

如果將這個方法設為 TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE，表示您不希望以適合未滿規定年齡使用者的方式處理應用程式。

如未設定這個方法，或將這個方法設為 TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED，應用程式就不會指出您希望以適合未滿規定年齡使用者的方式處理應用程式。

setTestDeviceIds

@CanIgnoreReturnValue
public RequestConfiguration.Builder setTestDeviceIds(@Nullable List<String> testDeviceIds)

設定與測試裝置相應的測試裝置 ID 清單，這些裝置一律會要求測試廣告。發出第一個廣告請求時，系統會在 Logcat 中記錄目前裝置的測試裝置 ID。

參數
@Nullable List<String> testDeviceIds

測試裝置 ID 清單。傳遞 null 即可清除清單。
傳回
RequestConfiguration.Builder

Builder