迁移到转化跟踪 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 值。

商家更改价值 要求
1 如果用户离开原始商家的网站,并通过您的平台与其他商家完成了购买交易,则应使用此值
2 如果客户通过原始实体(商家)完成了交易,则应使用此值。

您必须在发送转化事件时提供有效的 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 中),则您不应提供跨设备归因。在这种情况下,如果用户在相应设备上点击了操作链接,则每部设备都会保留一个单独的令牌,并且每部设备都会单独遵循归因规则。