迁移到转化跟踪 v2

概览

实现转化跟踪包含两个部分：存储和返回 rwg_token。这些值保持不变，但为了符合转化跟踪 v2 的相关要求，您现在必须返回新值：merchant_change。

令牌持久化方面的变更

现在，在持久化令牌时，您需要存储与操作链接关联的商家。通常，这通过将商家与相应的 merchant_id 进行匹配来完成。

以下是设备级转化跟踪的示例，其中使用第一方 Cookie 将这些值存储在网络浏览器中。此示例假定您已将令牌值解析为变量，并实现了存储 merchant_id 的逻辑。如需使用此示例，您需要将 rootdomain 更新为您的网域。此建议方法可能不适用于所有人，因此合作伙伴可以根据需要调整或实现自己的逻辑。

<script>
  if (typeof rwg_token !== 'undefined') {
    merchant_id = // Write your own logic here assigning the merchant id value
    document.cookie =
    "_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
  }
</script>

发送转化数据方面的变更

当用户完成转化事件时，POST 正文应为 JSON 编码的对象，其中包含新的布尔值 merchant_change。

{
  "conversion_partner_id": <partnerId>,
  "rwg_token": <rwg_token_val>
  "merchant_changed": 1|2
}

之前存储的 merchant_id 用于确定触发转化事件的商家是否与原始商家不同。确定商家是否发生变化后，您需要使用下表返回适当的 merchant_change 值。

您必须在发送转化事件时提供有效的 rwg_token。为便于测试，请在两个环境中使用以下测试令牌，直到您准备好发布为止：

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

发出请求时，请使用与您的环境对应的以下端点：

• 生产环境：https://www.google.com/maps/conversion/collect
• 沙盒：https://www.google.com/maps/conversion/debug/collect

转化归因要求

对于任何实体店与任何地点链接的互动，Google 的转化归因要求标准是 30 天的归因时间范围。

此归因时间范围表示，Google 希望在以下任一情况下发送转化事件：

• 用户点击了地点操作链接，并在同一会话中为同一商家下单（商家更改价值 = 2）
• 用户点击某个地点操作链接，然后在 30 天内通过其他渠道返回，为同一商家下单。（商家更改值 = 2）
• 用户点击某个地点操作链接，然后在 30 天内（同一会话或其他会话中）在其他商店下单。（商家更改值 = 1）

此外，Google 希望从用户可以通过地点操作链接到达的所有途径发送转化事件。包括：

• 桌面版或移动版 Web 应用
• 移动应用（通过应用深层链接或为您的网域注册的应用 intent）

如果令牌存储在用户级别（请参阅将令牌持久化），则您应提供跨设备归因。也就是说，如果用户在桌面设备上点击操作链接，然后在移动设备上（使用同一用户账号）完成交易，则应触发转化事件。

如果令牌仅存储在设备级别（例如在浏览器 Cookie 中），则您不应提供跨设备归因。在这种情况下，如果用户在相应设备上点击了操作链接，则每部设备都会保留一个单独的令牌，并且每部设备都会单独遵循归因规则。