瞭解如何為 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()，系統會重設頻率限制。
自動更新
競價完成後，其中載入的所有興趣群組都會自動更新，適用頻率限制與手動更新相同。
對於每個至少有一個興趣群組參與競價的擁有者，「navigator.updateAdInterestGroups()」呼叫者等同於來源符合該擁有者的 iframe 呼叫。
所有 Protected Audience API 參考資料
可用的 API 參考指南如下：
- Protected Audience API 的開發人員指南。
- 廣告買方指南：Protected Audience 興趣群組與出價產生。
- Protected Audience 廣告競價的廣告賣方指南。
- 製作競價結果報表指南
- Protected Audience 廣告競價延遲的最佳做法
- 排解 Protected Audience 相關問題
Protected Audience API 說明也提供功能支援和限制的詳細資料。