瞭解如何為 Protected Audience API 興趣群組設定更新網址，藉此更新目標對象資料。如要瞭解 Protected Audience API 完整生命週期，請參閱開發人員指南；如要深入瞭解瀏覽器記錄興趣群組的方式，請參閱 Protected Audience API 說明。
您不是開發人員嗎？請參閱「Protected Audience API 總覽」。
Protected Audience API 興趣群組
Protected Audience API 興趣群組代表一組與再行銷名單相關，有共同興趣的使用者。每個 Protected Audience API 興趣群組都有一個擁有者。
興趣群組擁有者是 Protected Audience API 廣告競價的買方。興趣群組成員資格是由瀏覽器儲存在使用者的裝置上，不會與瀏覽器供應商或任何人分享。
API 函式
使用案例：
下方範例說明如何定義目標對象資料，說明如何建立興趣群組並要求瀏覽器加入群組。
const interestGroup = {
owner: 'https://dsp.example',
name: 'custom-bikes',
biddingLogicUrl: ...,
biddingWasmHelperUrl: ...,
updateUrl: ...,
trustedBiddingSignalsUrl: ...,
trustedBiddingSignalsKeys: ['key1', 'key2'],
userBiddingSignals: {...},
ads: [bikeAd1, bikeAd2, bikeAd3],
adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};
navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);
updateUrl 會提供網址，用來傳回 JSON 來更新興趣群組屬性。這必須與 owner 具有相同來源。
更新屬性
updateUrl 會指定傳回 JSON 定義興趣群組屬性的網路伺服器，對應至傳送至 joinAdInterestGroup() 的興趣群組物件。
這樣群組擁有者就能定期更新興趣群組的屬性。在目前的實作中，您可變更下列屬性：
biddingLogicUrlbiddingWasmHelperUrltrustedBiddingSignalsUrltrustedBiddingSignalsKeysadspriority
系統不會覆寫 JSON 中指定的任何欄位，只會更新 JSON 中指定的欄位，呼叫 navigator.joinAdInterestGroup() 則會覆寫任何現有興趣群組。
系統會盡可能進行更新，在下列情況中可能會失敗：
- 網路要求逾時 (目前為 30 秒)。
- 其他網路故障。
- JSON 剖析失敗。
更新頻率的限制為每天一次。
如果更新的時間過多，可以取消更新作業。不過，取消 (剩餘) 更新時不會限制任何頻率限制。如果更新作業因網路錯誤而失敗，系統會在一小時後重新嘗試更新；如果更新作業因網際網路連線中斷而失敗，會在重新連線時立即重試。
手動更新
使用 navigator.updateAdInterestGroups() 即可手動觸發當前頁框來源擁有的興趣群組更新。
設定頻率限制可避免更新太頻繁：重複呼叫 navigator.updateAdInterestGroups() 在頻率限制期間 (目前為一天) 之前都不會執行任何動作。
如果系統針對同一個興趣群組 owner 和 name 再次呼叫 navigator.joinAdInterestGroup()，頻率限制就會重設。
自動更新
競價結束後，所有為競價載入的興趣群組都會自動更新，且頻率限制與手動更新相同。
對於至少有一個興趣群組參加競價的擁有者而言，就像從來源與該擁有者相符的 iframe 呼叫 navigator.updateAdInterestGroups()。
所有 Protected Audience API 參考資料
可用的 API 參考指南如下：
- Protected Audience API 的開發人員指南。
- 廣告買方指南：Protected Audience 興趣群組與出價產生。
- Protected Audience 廣告競價的廣告賣方指南。
- 製作競價結果報表指南
- Protected Audience 廣告競價延遲的最佳做法
- 排解 Protected Audience 相關問題
Protected Audience API 說明也提供功能支援和限制的詳細資料。