Topics API:集成指南

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

Topics API for Android 旨在支持针对用户兴趣投放广告,而无需依赖跨应用标识符。

广告主会尽力投放与用户兴趣相关的广告。例如,如果用户对与烹饪相关的信息感兴趣,他们可能会发现与烹饪相关的广告比与自己兴趣无关的广告更贴合自己的需求。

针对用户兴趣投放广告 (IBA) 是一种个性化广告,即根据用户兴趣选择广告。借助 Privacy Sandbox on Android,系统可以根据用户使用的应用来获取这些兴趣数据。这种广告不同于内容相关广告,后者仅根据用户当前所查看的内容来推测用户感兴趣的广告。与内容相关广告相比,IBA 让应用能够展示与内容更加相关且更具吸引力的广告。

IBA 通常涉及应用、卖方和买方之间的通信。本指南面向所有这些相关方,包括同时以买方和卖方身份运作的广告联盟和广告技术平台。

Topics API 可根据用户的应用使用情况来粗略推断设备上的兴趣信号。这些信号(称为“主题”)会与广告主共享,以支持 IBA,而无需跨应用跟踪单个用户。

使用 Topics API 实现针对用户兴趣投放的广告时,需要考虑一些重要的注意事项:

  • 用户兴趣推断处于将在设备上进行:与用户设备上安装了哪些应用相关的信息不会离开设备,从而保护用户隐私。与这种模型相比,目前常用的模型都在设备外部的广告技术平台服务器上发送和处理用户的跨应用数据。某些类型的处理将继续保留在广告技术平台服务器上,例如在个性化和广告优化模型中使用 Topics API 提供的信号进行广告选择。

  • 买方和广告主依赖于卖方:要获取主题,卖方应用和 SDK 必须要在至少 1 个周期中成为 Topics API 的观察者,从而建立足迹。

术语

  • 广告主:通过购买广告资源来吸引用户的公司
  • 发布商:拥有内容并销售这些内容旁边的可用广告资源的公司
  • 买方(或买家):协助广告主购买广告资源的广告技术公司
  • 卖方(或卖家):协助发布商销售广告资源的广告技术公司
  • 广告联盟:既是买方又是卖方的广告技术公司
  • 自有自营:既是发布商又是卖方和买方的公司

目标

如果 IBA 对于您的业务很重要,我们希望您使用在您的应用业务情境中运行的 Topics API 版本,以便我们获取反馈并帮助您改进 API。我们希望确保您能够取消屏蔽设计和开发,以便在 Beta 版发布时获取主题。

目前,Privacy Sandbox on Android 开发者预览版的集成计划目标包括执行以下操作:

适用于所有广告技术平台

  • 查看主题分类,并提供关于所包含主题的反馈。
  • 尝试使用 Topics API 示例应用,查看设备端分类器会返回哪些主题数据。
  • 更新应用和 SDK 流程以开始调用 Topics API。
  • 更新方案以开始在广告请求中发送主题。
  • 在 Privacy Sandbox 中注册您的广告技术平台

适用于卖方广告技术平台

  • 成为观察者,建立 Topics API 足迹。Topics API 是一个新信号,因此您应更新 SDK 以开始调用 Topics API。为了以一致的方式检索主题,应用必须每个周期至少调用一次该 API。系统最多要用 4 个周期来获取随广告请求一同发送的最大数量的主题(3 个主题)。
  • 在广告请求中包含 Topics API 信息。针对每个广告请求,开始与买方合作伙伴共享您的 Topics API 数据。Topics API 计划对其他信号(例如情境信号)进行补充,以帮助为指定访问者找到合适的广告。
  • 通过协作创建与您的买方合作伙伴共享主题的方案。Topics API 要求每个 SDK 与下游合作伙伴就如何共享 Topics API 数据达成一致。

适用于买方广告技术平台

  • 与卖方合作伙伴联系,确认他们观察主题并建立足迹的计划。若要接收主题,卖方提供者必须在每个周期至少调用一次 Topics API。
  • 通过协作创建从买方合作伙伴接收主题的方案。主题是一个新的信号,卖方合作伙伴将在广告请求中共享该信号。买方消费者需要确保与上游合作伙伴就如何分享主题开展合作。
  • 将主题整合到出价和优化模型中。Topics API 应对内容相关等其他信号进行补充,以便帮助为访问者找到合适的广告。

前提条件和设置

应用开发者、卖方和买方应按照这些步骤进行设置,以便开始使用 Topics API。

熟悉该 API

  1. 首先阅读设计方案,熟悉 FLEDGE API 及其功能。
  2. 阅读开发者指南,了解如何将您的用例需要的代码和 API 调用纳为己用。
  3. 查看分类,并提供关于列表中所包含主题的反馈。
  4. 提交与设计方案或文档相关的反馈
  5. 注册以接收 Topics API 的最新动态。这可以帮助您及时了解未来版本中引入的新功能。

设置并测试示例应用

  1. 请按照本页上的说明在 Android Studio 中设置 Privacy Sandbox on Android SDK。
  2. JavaKotlin 版本的示例应用的代码进行复刻并运行代码,以便熟悉如何在设备上检索主题。
  3. 测试时,尝试使用应用的名称和说明信息来更改设备端分类器会返回哪些主题。
  4. 在了解客户端 API 和设备端分类的工作原理后,请使用示例应用作为参照,引导您自行完成集成。

提示:请仔细查看针对您的应用返回的主题数据的实用性。找出您认为可以改进分类的方式,并针对如何改进分类提供相关反馈