概览

如果用户在 Campaign Manager 360 获得广告投放后执行一项预定义操作，系统就会用代码来记录一次转化（称为 Floodlight 活动）。通常，标记的操作包括跟踪用户何时从网店购买商品或访问网页以通过在线表单请求更多信息。一般情况下，Google 跟踪的转化都是在线上开始并在线上完成的。

不过，某些广告客户的转化可能是在线开始，但在线下完成的。例如，用户开始在线研究产品，点击广告，然后在电话或零售店中完成购买。在这种情况下，Campaign Manager 360 拥有这次交易在线部分的相关数据，但却没有线下部分的相关数据，因此这次转化不会被记录。

为了解决此问题，Campaign Manager 360 API 的 Conversions 服务可让广告客户直接将这些转化的线下部分提供给 Campaign Manager 360。

前提条件

开始使用 Conversions 服务之前，您需要先完成以下步骤：

  1. 按照使用入门指南中所述，创建 API 项目并向其授权。

  2. 确保您的 Campaign Manager 360 用户个人资料具有必要的用户角色权限。如有必要，请与您的 Campaign Manager 360 帐号管理员联系，以启用这些权限。

    • 插入线下转化数据：允许使用 batchinsert 上传新的线下转化数据。

    • 更新线下转化数据：允许使用 batchupdate 修改现有的线下转化数据。

将转化与活动进行匹配

线下转化必须与 Campaign Manager 360 中对应的在线活动相匹配。您需要按其 floodlightActivityId 和对应的 floodlightConfigurationId 来引用这些 activity。

如果您还没有用于跟踪线下转化的活动，则可以使用 API 的 FloodlightActivities 服务创建一个。有关如何执行此操作的示例，请参阅常见的广告投放管理任务指南。强烈建议您为线下转化创建专用活动。

获取点击 ID、设备 ID 和用户 ID

线下转化还必须归因于点击、设备或用户 ID（一次只能使用其中一个）。下面介绍了获取这些 ID 的最常见方式。

使用展示广告点击 ID

可以通过使用展示广告点击 ID (DCLID) 将转化归因于广告点击。DCLID 可以从增强型归因中获取。

必须在 dclid 字段中传递展示广告点击 ID。

使用 Google 点击 ID

通过使用 Google 点击 ID (GCLID)，可以将转化归因于广告点击。您可以从 Google Ads 或 Search Ads 360 获取 GCLID。

Google 点击 ID 必须在 gclid 字段中传递。

使用匹配 ID

转化可通过您自己的第一方标识符进行归因，该标识符已通过 Floodlight 中的 match_id 功能与 Google 同步。

使用移动设备 ID

您可通过使用广告设备标识符将转化直接归因于移动设备或联网电视 (CTV) 设备。支持以下标识符：

  • 广告 ID
  • 广告标识符 (IDFA)
  • 下列来自 CTV 设备的广告标识符：
    • RIDA (Roku)
    • AFAI（ Fire TV）
    • AdID (Android TV)
    • IDFA（Apple TV）
    • MSAI (Xbox)
    • TIFA（三星）
    • VIDA（Vizio）

这些标识符必须通过 mobileDeviceId 字段传递。

使用 %m 匹配宏

%m 宏可插入广告素材的点击后到达网址或重定向网址。广告服务器会在点击事件发生后将此宏扩展到用户的加密用户 ID 中。然后，系统会直接从重定向网址或服务器日志捕获加密的用户 ID。

使用 %m 宏捕获的 ID 必须通过 encryptedUserId 或 encryptedUserIdCandidates[] 字段传递。

使用数据传输功能

数据传输是一项 Campaign Manager 360 功能，可提供对事件级广告服务器日志数据的访问权限。此类数据通过单独的 Feed 传送，每个 Feed 由一个数据传输文件组成。在这些文件中，每个记录的事件都与一个经过加密的用户 ID 相关联。

要利用数据传输文件中提供的用户 ID，您需要将线上广告服务器事件与线下系统中的某个事件进行匹配。这通常使用自定义 Floodlight 变量来完成，您可以使用能够唯一标识用户操作的值来动态填充该值。经过简化的工作流可能如下所示：

  1. Floodlight 活动代码触发，表示交易已开始。代码包含您提供的用于唯一标识相应交易的自定义变量值。

  2. 交易继续，并在线下完成，同时保留相同的标识符。

  3. 使用记录交易时记录的标识符，可在记录原始 Floodlight 活动的数据传输活动日志文件中找到匹配的条目。

从数据传输文件中检索到的 ID 必须通过 encryptedUserId 或 encryptedUserIdCandidates[] 字段传递。