RequestConfiguration
物件會收集每項廣告要求的全域設定,並由 MobileAds.instance.updateRequestConfiguration()
套用。
為確保所有廣告請求都會套用請求設定變更,請先初始化 Mobile Ads SDK,再更新請求設定。
兒童導向內容設定
根據《兒童網路隱私保護法》(COPPA) 規定,我們提供「兒童導向內容」標記設定。
如果您是應用程式開發人員,則可指明是否希望 Google 在您提出廣告請求時將內容視為兒童導向內容。如果您表示希望 Google 將內容視為兒童導向內容,我們會採取措施,針對該廣告請求停用 IBA 和再行銷廣告。您可以透過 RequestConfiguration.tagForChildDirectedTreatment()
將此設定用於所有版本的 Google Play 服務 SDK:
- 使用
TagForChildDirectedTreatment.yes
引數,表示您希望系統依 COPPA 規範將內容視為兒童導向內容。 - 使用
TagForChildDirectedTreatment.no
引數,表示您不希望系統將內容視為兒童導向內容並接受 COPPA 規範。 - 如果您不想在廣告請求中指出希望如何處理內容,請使用
TagForChildDirectedTreatment.unspecified
引數或不設定這個標記。
以下範例表示您希望系統將內容視為 COPPA 適用的兒童導向內容:
final RequestConfiguration requestConfiguration = RequestConfiguration(
tagForChildDirectedTreatment: TagForChildDirectedTreatment.yes);
MobileAds.instance.updateRequestConfiguration(requestConfiguration);
未滿法定同意年齡的使用者
您可以替廣告請求設定未滿法定同意年齡的歐洲經濟區使用者標記。這項功能的立意是協助發布商遵守《一般資料保護規則》(GDPR)。請注意,您可能還有 GDPR 所衍生的其他法律義務。請查看歐盟發布的指南並諮詢您的法律顧問。提醒您,Google 提供工具的用意是協助發布商遵守規定,而非方便發布商規避法定義務。進一步瞭解 GDPR 對發布商的影響。
使用這項功能時,廣告請求會包含「未滿法定同意年齡的歐洲使用者標記」(TFUA) 參數。這個參數會針對特定廣告請求停用個人化廣告 (包括再行銷),並且停止向第三方廣告供應商 (例如廣告評估像素和第三方廣告伺服器) 提出其他請求。
使用 RequestConfiguration.tagForUnderAgeOfConsent()
設定標記:
- 使用
TagForUnderAgeOfConsent.yes
引數,表示您希望以適合未滿法定同意年齡的使用者的方式處理要求設定。 - 使用
TagForUnderAgeOfConsent.no
引數,表示您不希望以適合未滿法定同意年齡的使用者的方式處理要求設定。 使用引數
TagForUnderAgeOfConsent.unspecified
或不設定這個標記,表示您尚未指定廣告請求是否應針對歐洲經濟區 (EEA) 境內未滿法定同意年齡的使用者進行處理。以下範例表示您希望在廣告要求中加入 TFUA:final RequestConfiguration requestConfiguration = RequestConfiguration( tagForUnderAgeOfConsent: TagForUnderAgeOfConsent.yes); MobileAds.instance.updateRequestConfiguration(requestConfiguration);
啟用兒童導向內容設定的標記和 setTagForUnderAgeOfConsent
不得同時設為 true
。否則系統將以兒童導向內容設定為準。
廣告內容篩選
您可以使用 RequestConfiguration.maxAdContentRating()
設定廣告內容分級:
針對這些要求傳回的 AdMob 廣告,其內容分級會低於或等於該等級。這個聯播網額外資訊的可能值取決於數位內容標籤分類,可為下列 MaxAdContentRating
物件之一:
MaxAdContentRating.g
MaxAdContentRating.pg
MaxAdContentRating.t
MaxAdContentRating.ma
下列程式碼會設定 RequestConfiguration
物件,指定傳回的廣告內容對應至數位內容標籤,其等級不得高於 G
:
final RequestConfiguration requestConfiguration = RequestConfiguration(
maxAdContentRating: MaxAdContentRating.g);
MobileAds.instance.updateRequestConfiguration(requestConfiguration);
廣告請求
AdManagerAdRequest
物件會收集要隨廣告請求傳送的指定目標資訊。
自訂指定目標
您可以將自訂鍵/值組合傳遞至指定的 Google Ad Manager 廣告活動 (委刊項):
// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = AdManagerAdRequest(
customTargeting: {'age': '25'},
);
發布商提供的 ID
您可以設定發布商提供的 ID (PPID),用於設定展示頻率上限、目標對象區隔和指定目標、廣告依序輪播,以及其他以目標對象為準的跨裝置廣告放送控制項。
以下是設定 PPID 的範例:
AdManagerAdRequest adRequest = AdManagerAdRequest(
publisherProvidedId: 'AB123456789',
);
內容網址
如要為內容指定廣告和品牌安全提供內容網址,您可以在建立 AdManagerAdRequest
時傳遞 contentUrl
:
AdManagerAdRequest request = AdManagerAdRequest(
contentUrl: 'https://www.example.com',
);
品牌安全
針對不同目標對象顯示動態內容的應用程式,可在建構 AdManagerAdRequest
時提供 neighboringContentUrls
,藉此提供簡短的網址清單:
final neighboringContentUrls = [
'https://www.mycontenturl1.com',
'https://www.mycontenturl2.com',
'https://www.mycontenturl3.com',
'https://www.mycontenturl4.com',
];
AdManagerAdRequest request = AdManagerAdRequest(
neighboringContentUrls: neighboringContentUrls,
);
neighboringContentUrls
與 contentUrl
的不同之處在於,neighboringContentUrls
只用於維護品牌安全。