建立自訂目標對象時,您可以指定部分或全部自訂目標對象中繼資料。您可以在建立 CustomAudience
物件時,直接傳遞這項資訊。CustomAudience.Builder
也支援 dailyUpdateUri
欄位,可用於提供及更新中繼資料。平台會每隔 24 小時執行背景工作,從 dailyUpdateUri
擷取更新的中繼資料,如果自訂目標對象尚未擁有參與競價所需的 AdData
,則每隔四小時執行一次。平台可以更新下列自訂目標對象中繼資料:
- 使用者出價信號
- 受信任的出價資料
AdData
清單
為了更新這項中繼資料,每日背景更新程序會查詢自訂目標對象中定義的 dailyUpdateUri
,這項程序可能會傳回 JSON 回應。
- JSON 回應可能包含需要更新的任何受支援中繼資料欄位。
- 每個 JSON 欄位都會經過獨立驗證。用戶端會忽略任何格式錯誤的欄位,因此不會在回應中更新該特定欄位。
- 空白的 HTTP 回應或空白的 JSON 物件「
{}
」會導致無法更新中繼資料。 - 回應訊息的大小上限為 10 KB。
- 所有 URI 都必須使用 HTTPS。
trusted_bidding_uri
必須和買方使用相同的 ETLD+1。
範例:每日背景更新的 JSON 回應
{
"user_bidding_signals" : { ... }, // Valid JSON object
"trusted_bidding_data" : {
"trusted_bidding_uri" : "example-dsp1-key-value-service.com",
"trusted_bidding_keys" : [ "campaign123", "campaign456", ... ]
},
"ads" : [
{
"render_uri" : "www.example-dsp1.com/.../campaign123.html",
"metadata" : { ... } // Valid JSON object
},
{
"render_uri" : "www.example-dsp1.com/.../campaign456.html",
"metadata" : { ... } // Valid JSON object
},
...
]
}
請參閱這個模擬伺服器定義,瞭解回應中可能包含的資料類型。