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

了解如何通过为 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 用于指定一个 Web 服务器，该服务器返回用于定义兴趣群体属性的 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 说明信息还详细介绍了功能支持和限制条件。