下面介绍了如何开始设置,包括设置和快速概览。
选择报告类型
您可以使用 Attribution Reporting API 生成两种类型的报告:事件级报告和摘要报告。与可汇总报告或摘要报告相比,事件级报告所需的设置更少,因此报告可能是不错的着手点。摘要报告需要与汇总服务集成;事件级报告则不然。
您可以为事件级报告和摘要设置报告。二者互为补充。
事件级报告
事件级报告:将(广告端)的特定广告点击或观看与转化端数据相关联。为了通过限制跨网站联接用户身份来保护用户隐私,转化端数据非常有限,并且数据非常嘈杂。
摘要报告
摘要报告分为 Attribution Reporting API 和 Private Aggregation API 两种报告类型。摘要报告包含汇总的用户数据,可以包含详细的转化数据,但添加了噪声。摘要报告由汇总报告组成。
实现
您可以尝试按以下步骤进行操作。
请注意,对于指定的事件来源,可以同时生成 事件级报告和可汇总报告。通过 demo 可以引导您完成整个流程。
生成事件级报告
以下是生成事件级报告所需遵循的最少步骤:
注册触发器。如需查看相关说明,请参阅注册归因触发器。
使用以下网址设置端点:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
。
请参阅 adtech.js 中的示例代码,了解POST
方法;如需详细了解.well-known
,请参阅 Wikipedia。
如需了解详情,请参阅事件级报告说明文档。
生成摘要报告
要生成摘要报告,请按以下简要步骤操作:
注册来源。如需查看相关说明,请参阅注册归因来源。请注意,点击次数和观看次数的步骤有所不同。如需了解更多详情,请参阅归因来源注册。
注册触发器。如需查看相关说明,请参阅注册归因触发器。
使用以下网址为可汇总报告设置端点:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
。
请参阅 adtech.js 中的示例代码,了解POST
方法;如需详细了解.well-known
,请参阅 Wikipedia。
如需了解详情,请参阅可汇总报告说明。
请参阅归因报告调试系列,了解如何设置调试报告。
“摘要”报告中的其他概念
除了了解此处的实施步骤外,以下概念也有助于您规划摘要报告策略:
可选步骤
- 设置过滤条件(可选):
<ph type="x-smartling-placeholder">
- </ph>
- 请按照 使用过滤条件定义自定义规则。
- 如需查看可汇总报告的过滤条件的专属详情,请前往 触发器部分 explainer。
不要忘记功能检测
使用该 API 之前,请使用权限政策检测该 API 是否未在网页上被屏蔽。 为此,请运行以下代码:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
如果此功能检测检查返回 true,则允许在运行检查的上下文(页面)中使用该 API。
请注意,仅执行此项检查并不能保证 API 可在该网页上使用;用户可能是通过其浏览器设置停用了 API,或者可能是其他设置导致 API 无法使用。为了保护用户隐私,您无法以编程方式进行检查。
后续步骤
如果您已准备好开始实施,请查看以下文档:
设置
背景
演示和工具
规划
如果您仍处于规划阶段,请参阅以下文档: