此页面由 Cloud Translation API 翻译。

转化跟踪

实现

摘要

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

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

这种转化跟踪实现不需要您使用 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`

</ph> 注意：正确保留 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==

</ph> 注意：在正式版中，您不应发送归因于此集成。请务必检查未过期的 rwg_token 值。

设备级转化跟踪的完整示例（在（例如，用户设备）中有关如何发出此发布请求的 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
    })
  });
}

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

</ph> 注意：转化事件可以通过网站客户端或应用客户端发送，还是从服务器提取。您可以根据自己的以及令牌的存储位置，只要转化该事件只针对每次转化发送一次，并且包含有效的 rwg_token 值。

转化归因要求

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

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

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

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

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

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

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