第 3 步：转化跟踪

实现

摘要

转化跟踪的实施分为以下三部分：

1. 收集 rwg_token 从着陆页 / 应用入口点开始收集。
2. 保留 rwg_token （针对适当的归因回溯期）
3. 在结账时发送转化事件

这种转化跟踪实现不需要您使用 Google Analytics 或任何其他第三方 JavaScript。

在开始实施转化跟踪之前，您应先决定 如果您打算在设备一级或用户一级跟踪转化情况：

• 设备级别包括使用浏览器 Cookie、本地 应用本地存储或任何其他可在外部存储 令牌的 30 天归因回溯期。因为这个词元 会存储在用户设备本地 清除其本地存储/Cookie，或者 转化事件是在无痕浏览还是无痕模式下使用 可能无法正确归因。使用设备级别时 因此您必须在每次 支持的平台（包括移动设备）。
• 用户级别包括将其保留在您的应用中 通过服务器端分析系统或其他 服务器端系统由于令牌将存储在 如果用户更换了其使用的设备， Cookie 或使用无痕浏览模式 在无痕模式下，转化事件仍会归因一次 当用户重新登录时。使用用户级转化跟踪时 您或许能够 在服务器端实施一次，然后在所有服务器中重复使用 支持的表面。

收集 rwg_token

每次 Google 显示action_link您通过 供稿，该网址将修改为包含唯一查询 参数：rwg_token。rwg_token value 是一个编码字符串，其中包含有关 用户点击的链接。您将存储此令牌，并将其作为 是转化事件的一部分。

在每个着陆页 / 应用入口点上，您必须解析设置的值 为 rwg_token 查询参数指定并存储它。相关要求 有关存储此参数的说明，请参见持久保留 rwg_token。

说明如何解析此令牌以进行设备级跟踪的示例 浏览器如下所示。或者，您也可以在 在服务器端：

<script>
  var query = location.search.substring(1);
  var params = query.split('&');
  var rwgToken = undefined;
  for (var i = 0; i < params.length; ++i) {
    var pair = params[i].split('=');
    if (pair[0] == 'rwg_token') {
      rwgToken = decodeURIComponent(pair[1]);
      break;
    }
  }
</script>

保留 rwg_token

您需要保留 rwg_token 网址参数， 都会附加到您提供的所有操作链接中， 有效期为 30 天rwg_token 的值应为 存储并返回，而不进行任何修改。 如果上一次访问中仍然存在存在的令牌， 并保留 30 天的存储期限 。

保存令牌时，您可以将令牌存储在 设备级或用户级：

• 设备级使用浏览器 Cookie、本地存储、 应用本地存储空间，或任何其他可以保留令牌的方法 30 天的归因回溯期
• 用户级别包括将其保留在您的应用数据库中， 通过服务器端分析系统或其他服务器端系统进行分析。

以下是设备一级的转化跟踪示例 在网络浏览器中 Cookie。此示例假定您已解析令牌值 转换为变量，如上例所示。要使用此示例 您需要将“rootdomain”更新为您的域名。

<script>
  if (typeof rwg_token !== 'undefined') {
    document.cookie =
    "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
  }
</script>

使用用户级转化跟踪时，rwg_token应 必须存储在服务器上并与用户关联

发送转化数据

当用户完成归因于特定买方的交易时 Google 商家信息操作链接，您必须向 转化端点。有两个端点，一个用于生产环境 一个环境用于沙盒环境

• 正式版：https://www.google.com/maps/conversion/collect
• 沙盒：https://www.google.com/maps/conversion/debug/collect

POST 正文应是一个采用以下格式的 JSON 编码对象：

{
  'conversion_partner_id': partnerId,
  'rwg_token': <rwg_token_val>
}

在测试区和生产环境中，您都需要 请在发送转化事件时提供有效的 rwg_token。 若要在沙盒环境中进行测试，您可以使用以下代码 测试令牌。

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

设备级转化跟踪的完整示例（在 （例如，用户设备）中有关如何发出此发布请求的 JavaScript 中 包括：

const partnerId = XXXXXXXXXX;
const endpoint = `https://www.google.com/maps/conversion/collect`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal
    })
  });
}

使用用户级转化跟踪时，您应该获取 与用户关联的令牌（无论 ）并将这些文件发送到服务器端存储机制，并将 令牌。

转化归因要求

Google 要求的转化归因标准为 30 天 无论何时与地点链接互动的归因回溯期， 商店。

这个归因回溯期意味着，我们预计会发生转化 事件：

• 用户前往地点操作链接，在 同一会话
• 用户点击地点操作链接，然后从 其他渠道下单。
• 用户点击地点操作链接，然后在 （无论是在同一会话中，还是在不同商店中） 会话。

此外，我们希望所有 用户可从地点操作链接进入的界面。其中包括：

• 桌面版或移动版 Web 应用
• 移动应用，无论是通过应用深层链接，还是通过已注册的 您的网域的 app-intent

如果令牌存储在用户级别 （请参阅保留令牌）， 提供跨设备归因数据也就是说， 点击桌面上的操作链接，然后完成 交易）应触发 转化事件。

如果令牌仅存储在设备级别（例如 浏览器 Cookie，我们不要求提供跨设备 归因。在这种情况下，每台设备都有一个单独的令牌 如果用户点击了该设备上的操作链接，则会保留；并且 就会分别遵循归因规则