Protected Audience（以前称为 FLEDGE）集成指南（面向衡量服务提供商）

作为 Privacy Sandbox 的一部分，Chrome 提议 Protected Audience API - 一种浏览器内 API 可让广告主和广告技术公司展示针对用户兴趣群体的广告 不依赖第三方 Cookie，同时保护用户免受跨网站攻击 跟踪。

在 Protected Audience API 中，当再营销广告赢得竞价时， 广告的网址将被发送到 Fenced Frame： 呈现。围栏框架是一种提议用于嵌入内容的 HTML 元素， 与 iframe 类似与 iframe 不同，围栏框架会限制 及其嵌入上下文，以允许框架访问跨网站数据， 将其与嵌入上下文共享。有关详情，请参阅 Fenced Frames 应用场景 铺垫消息。

展示广告与Video 360 支持一系列 用于衡量效果的宏 用于跟踪展示和点击跟踪的提供商。只有一小部分 宏可以在广告素材呈现过程中进行替换， 和竞价信号。例如，如果不进行任何更改，${PUBLISHER_ID} 将会中断 衡量服务提供商代码

本指南面向跟踪 事件 使用展示广告系列和Video 360。

注册

从 2023 年 8 月开始，衡量服务提供商可能需要按以下步骤操作 下方进行注册，以便在 Protected 中使用 Fenced Frame Reporting API Audience API。

详细说明哪些人需要 注册

集成

衡量服务提供商展示代码

设置说明：

脚本标记 示例 
<script src='https://tracking.com/a.js'>xxx</script>
 责任：衡量服务提供商更新要使用的脚本代码 reportEvent API 用于展示跟踪（请参阅指南 ）。
图片代码 示例 
<img src='https://tracking.com/'>
 责任：展示广告与Video 360：更新要使用的 img src 标记 用于展示跟踪的 reportEvent API。

reportEvent API

此 API 建议用于 呈现后跟踪该 API 包含两个部分：registerAdMacro 和 reportEvent。

  • 展示广告与Video 360 拥有 reportWin 中的 registerAdMacro 函数。通过 函数会先在浏览器中注册宏键值对，然后再 渲染调用。
  • 根据代码类型，展示广告和Video 360 或衡量服务提供商拥有 更改了第三方广告跟踪标记，以使用 reportEvent API。

reportEvent 仅接受 1 个输入“destination网址”， 衡量服务提供商服务器它可以包含 展示广告与Video 360 帮助 中心。例如：

window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

当 Chrome 在函数中触发网址 ping 时，它会查找已注册 宏，并在向 https://adtech.example。

更新脚本标记的步骤

现有的广告素材代码不会有任何变化。展示广告与360 度视频静态图 将衡量服务提供商代码无需修改即可作为广告素材的一部分呈现 载荷。当衡量服务提供商收到来自受保护的 Audience API 上下文，则需要按照以下步骤跟踪展示 跟踪：

  1. 准备衡量服务提供商展示跟踪网址，以接受展示 ping。 例如：

    https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123

  2. 在响应 Protected 脚本时添加 reportEvent JS Audience API。例如：

    window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

  3. 从在以下位置配置的展示跟踪网址接收 ping 时记录展示次数： 第 1 步：

衡量服务提供商点击代码

现有的衡量服务提供商点击代码将继续适用于 Protected Audience 展示。展示广告与 Video 360 将使用 Fenced Frames Ads Reporting API 的 reserved.top_navigation 个信标来记录点击，这会将所有 衡量服务提供商的点击跟踪广告代码作为重定向。如需了解详情，请参阅 有关 Fenced Frame 广告报告的 Chrome 文档 API。