更新目標對象資料和重新整理廣告

瞭解如何為 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() 的興趣群組物件。

這項功能可讓群組擁有者定期更新興趣群組的屬性。在目前實作方式中，可以變更下列屬性：

  • biddingLogicUrl
  • biddingWasmHelperUrl
  • trustedBiddingSignalsUrl
  • trustedBiddingSignalsKeys
  • ads
  • priority

JSON 中未指定的任何欄位都不會遭到覆寫，只有 JSON 中指定的欄位會更新，而呼叫 navigator.joinAdInterestGroup() 則會覆寫所有現有的興趣群組。

更新是您做出的最大努力，且在下列情況下可能會失敗：

  • 網路要求逾時 (目前為 30 秒)。
  • 其他網路連線失敗。
  • JSON 剖析失敗。

更新次數設有限制，每天最多一次。

如果更新時間過長，系統可能會取消更新，但不會對取消 (剩餘) 的更新施加任何速率限制。如果更新因網路錯誤而失敗，系統會在 1 小時後重試；如果更新因網際網路連線中斷而失敗，系統會在重新連線後立即重試。

手動更新

您可以使用 navigator.updateAdInterestGroups() 手動觸發目前影格來源所擁有的興趣群組更新。

頻率限制可防止更新過於頻繁：重複呼叫 navigator.updateAdInterestGroups() 不會執行任何動作，直到頻率限制週期 (目前為一天) 結束為止。

如果針對相同興趣群組 owner 和 name 再次呼叫 navigator.joinAdInterestGroup()，系統就會重設速率限制。

自動更新

競價結束後，系統會自動更新為競價載入的所有興趣群組，但須遵守與手動更新相同的速率限制。

對於每個至少有一個興趣群組參與競價的擁有者，系統會從來源與該擁有者相符的 iframe 呼叫 navigator.updateAdInterestGroups()。

所有 Protected Audience API 參考資料

可用的 API 參考指南如下：

Protected Audience API 說明也提供功能支援和限制的詳細資料。