本指南說明如何向廣告請求提供指定目標資訊。
必要條件
- 完成入門指南。
要求設定
RequestConfiguration
物件會收集每則廣告請求的全域設定,並透過呼叫 MobileAds.SetRequestConfiguration()
套用。
以下範例會使用含有測試裝置 ID 的 RequestConfiguration
物件設定 MobileAds
:
// Configure your RequestConfiguration with Test Device Ids.
MobileAds.SetRequestConfiguration(new RequestConfiguration
{
TestDeviceIds = TestDeviceIds
});
為確保所有廣告請求都套用請求設定變更,請在初始化 SDK 之前設定請求設定。
兒童導向內容設定
為遵守《兒童網路隱私保護法》(COPPA),我們提供「標記兒童導向內容」設定。設定這個標記即表示您確認這項通知正確無誤,而且您有權代表應用程式擁有者採取行動。您瞭解濫用這項設定可能會導致 Google 帳戶遭到終止。
如果您是應用程式開發人員,則可指明是否希望 Google 在您提出廣告請求時將內容視為兒童導向內容。如果您表示希望 Google 將內容視為兒童導向內容,SDK 就會採取相應措施,針對該廣告請求停用按照興趣顯示的廣告和再行銷廣告。
您可以透過 RequestConfiguration.TagForChildDirectedTreatment)
設定,讓所有版本的 Google Play 服務 SDK 都能使用這項設定:
請使用
TagForChildDirectedTreatment.True
設定TagForChildDirectedTreatment
,表示您希望系統將內容視為兒童導向內容並接受 COPPA 規範。這項設定可防止傳送 Android 廣告 ID (AAID)。使用
TagForChildDirectedTreatment.False
設定TagForChildDirectedTreatment
,表示您不希望系統將內容視為兒童導向內容,以符合 COPPA 規定。如果您不想在廣告請求中指出希望如何處理內容,請將
TagForChildDirectedTreatment
與null
一起設定。
以下範例表示您希望系統將內容視為 COPPA 適用的兒童導向內容:
MobileAds.SetRequestConfiguration(new RequestConfiguration
{
TagForChildDirectedTreatment = TagForChildDirectedTreatment.True
});
未滿法定同意年齡的使用者
您可以替廣告請求設定未滿法定同意年齡的歐洲經濟區使用者標記。這項功能的立意是協助發布商遵守《一般資料保護規則》(GDPR)。請注意,您可能還有 GDPR 所衍生的其他法律義務。請查看歐盟的指南,並諮詢您的法律顧問。請注意,Google 提供工具的用意是協助發布商遵守規定,不是幫忙任何發布商規避其法律義務。
使用這項功能時,廣告請求會包含「未滿法定同意年齡的歐洲使用者標記」(TFUA) 參數。這個參數會針對所有廣告請求停用個人化廣告功能 (包括再行銷),並且停止向第三方廣告供應商 (例如廣告評估像素和第三方廣告伺服器) 提出其他請求。
與兒童導向設定一樣,RequestConfiguration
中也有用於設定 TFUA 參數的方法:TagForUnderAgeOfConsent
,並提供下列選項。
使用
TagForUnderAgeOfConsent.True
設定TagForUnderAgeOfConsent
,表示您希望廣告請求針對歐洲經濟區 (EEA) 境內未滿法定同意年齡的使用者採用受限的資料處理模式。這項設定可防止傳送 Android 廣告 ID (AAID)。將
TagForUnderAgeOfConsent
與TagForUnderAgeOfConsent.False
搭配使用,表示您希望廣告請求「不」針對歐洲經濟區 (EEA) 境內未滿法定同意年齡的使用者採取相關處理模式。將
TagForUnderAgeOfConsent
設為null
,表示您尚未指定廣告請求是否應針對歐洲經濟區 (EEA) 境內未滿法定同意年齡的使用者採用受限的資料處理模式。
以下範例表示您希望在廣告要求中加入 TFUA:
MobileAds.SetRequestConfiguration(new RequestConfiguration
{
TagForUnderAgeOfConsent = TagForUnderAgeOfConsent.True
});
啟用兒童導向設定的標記和 TagForUnderAgeOfConsent
不得同時設為 true
。否則系統將以兒童導向內容設定為準。
廣告內容篩選
為遵守 Google Play 的不當廣告政策 (廣告內含相關優惠),應用程式內顯示的所有廣告和相關優惠都必須符合應用程式的內容分級,即使內容本身符合 Google Play 政策也不例外。
您可利用廣告內容分級上限這類工具,進一步掌控向使用者放送的廣告內容。您可以設定內容分級上限,以利遵守平台政策。
應用程式可以使用 MaxAdContentRating
欄位,為廣告請求設定廣告內容分級上限。在設定這項設定時傳回的 AdMob 廣告,其內容分級會與要求相同或更低。
這個網路額外資訊的可能值取決於數位內容標籤分類,且必須是下列字串之一:
MaxAdContentRating.G
MaxAdContentRating.PG
MaxAdContentRating.T
MaxAdContentRating.MA
以下範例會設定 RequestConfiguration
物件,指定傳回的廣告內容必須對應至數位內容標籤,且標籤等級不得高於 G
:
MobileAds.SetRequestConfiguration(new RequestConfiguration
{
MaxAdContentRating = MaxAdContentRating.G
});
進一步瞭解如何為每個廣告請求設定內容分級上限。
廣告請求
AdManagerAdRequest
物件會收集廣告請求的指定目標資訊。
自訂指定目標
您可以透過 AdManagerAdRequest.AddCustomTargeting()
傳遞自訂鍵/值組合,指定 Google Ad Manager 廣告活動委刊項:
以下範例會將自訂指定目標年齡傳遞為 25
:
// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest
{
CustomTargeting = new Dictionary<string, string>
{
{ "age", "25"}
}
};
以下範例指定 24 到 26 歲的使用者:
AdManagerAdRequest newRequest = new AdManagerAdRequest
{
CustomTargeting = new Dictionary<string, string>
{
{ "age", "24, 25, 26"}
}
};
類別排除
您可以使用 AdManagerAdRequest
CategoryExclusion
欄位,為要求新增版位層級類別排除條件:
AdManagerAdRequest newRequest = new AdManagerAdRequest
{
CategoryExclusions = new HashSet<string>
{
"automobile",
"boat"
}
};
發布商提供的 ID
您可以設定發布商提供的 ID (PPID),用於設定展示頻率上限、目標對象區隔和指定目標、廣告依序輪播,以及跨裝置的以目標對象為準廣告放送控制項。
以下範例會設定 PPID:
AdManagerAdRequest newRequest = new AdManagerAdRequest
{
PublisherProvidedId = "AB123456789"
};
發布商提供的信號
您可以在廣告請求中,以發布商提供的信號 (PPS) 的形式傳送目標對象和比對內容資料。透過 PPS,您可以使用使用者資料,透過標準分類方式,向所有交易類型的出價方傳達目標對象特徵,藉此改善程式輔助營利,而無須分享使用者 ID。目標對象特徵可包含行為和興趣相關資料 (IAB 目標對象分類 1.1) 和內容比對資料 (IAB 內容分類 2.2)。
以下範例會設定目標對象區隔:
AdManagerAdRequest newRequest = new AdManagerAdRequest
{
Extras = new Dictionary<string, string>
{
// Set the demographic to an audience with an "Age Range" of 30-34
// and an interest in mergers and acquisitions.
{ "IAB_AUDIENCE_1_1", "1, 2, 3, 4, 5"},
// Set the content to sedan, station wagon and SUV automotive values.
{ "IAB_AUDIENCE_2_2", "6, 7, 8, 9, 10"},
}
};