更新受众群体数据和刷新广告

了解如何通过为 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 解析失败。

更新的频率限制为每天最多一次。

如果更新花费了太多连续时间，则可以取消更新，但这不会对已取消（剩余）的更新施加任何速率限制。由于网络错误而失败的更新会在一小时后重试，而由于互联网连接中断而失败的更新会在重新连接时立即重试。

手动更新

您可以使用 navigator.updateAdInterestGroups() 手动触发对当前帧来源所拥有兴趣群体的更新。

速率限制可防止更新过于频繁：在速率限制期限（目前为一天）过去之前，重复调用 navigator.updateAdInterestGroups() 不会执行任何操作。

如果针对同一兴趣群体 owner 和 name 再次调用 navigator.joinAdInterestGroup()，则速率限制会重置。

自动更新

为竞价加载的所有兴趣群体会在竞价完成后自动更新，且遵循与手动更新相同的速率限制。

对于至少拥有一个参与竞价的兴趣群体的每个所有者，就像从来源与该所有者匹配的 iframe 中调用 navigator.updateAdInterestGroups() 一样。

所有 Protected Audience API 参考文档

以下是 API 参考指南：

Protected Audience API 说明信息还详细介绍了功能支持和限制条件。