摘要
转化跟踪功能旨在跟踪由 Google 发起的转化
通过我们的某个操作中心集成。这一点至关重要
来确保您的集成正常运行和运行,
页面。每当 Google 显示 action_link 时,都会修改该网址以添加唯一的查询参数:rwg_token
。您可以自行存储该令牌
在用户完成预订时返回相应的值。
如需完成集成,您需要完成以下操作:
- 收集和存储
rwg_token
。 - 收集和存储商家。
- 返回
rwg_token
和merchant_change
值。 - 测试和验证转化跟踪。
收集和存储 rwg_token
。
为了完成此集成,您必须收集并存储 rwg_token
从首次 Google 引荐开始后 30 天内。rwg_token
值是一个编码字符串,其中包含与链接和生成该操作链接的商家相关的一些元数据。请务必注意,令牌中不会存储或加密任何用户数据。
令牌收集
当用户被定向到您的预订页面时,系统会在所提供的网址中附加一个新的查询参数 rwg_token
。在预订页面中,您必须解析该值。关于此令牌的
进行解析,以便通过浏览器进行设备级跟踪。
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;
}
}
附加到网址的查询参数将是加密令牌,请参阅以下 rwg_token
示例。使用此示例令牌确保您的解析
包括“=”等所有特殊字符。以下
是一个典型令牌示例。
AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==
令牌存储
存储 rwg_token
时,您可以通过两种不同的级别实现转化跟踪:设备级和用户级。您决定在何处
存储令牌由您决定
您必须在初次推荐后将令牌存储 30 天。
下一个示例是设备级转化跟踪,将这些值存储在
使用第一方 Cookie 的网络浏览器。此示例假定您已将令牌值解析为变量(如令牌存储示例中所示)。请务必将 rootdomain.com
更新为您的网域。
if (typeof rwg_token !== 'undefined') {
document.cookie =
"_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
}
在决定 rwg_token
的存储位置时,请考虑以下因素。
设备级存储空间
设备级包括使用浏览器 Cookie、本地存储空间、应用本地存储空间或任何其他可在 30 天归因期内保留令牌的方法。因为该令牌将存储在用户的本地 如果用户更换当前使用的设备, 或使用无痕浏览或无痕模式 转化事件可能未正确归因。使用设备级别时 必须在所有受支持的 展示(包括移动设备)。
用户级存储空间
用户级别包括通过服务器端分析系统或其他服务器端系统将其持久保存在应用数据库中。由于令牌会存储在服务器端,因此即使用户更改所用设备、清除本地存储空间或 Cookie,或者使用了无痕式浏览或无痕模式,只要用户重新登录,系统仍会将转化事件归因于该用户。使用用户级转化跟踪时,您或许可以在服务器端实现一次,然后在所有受支持的平台上重复使用。具体取决于系统的架构。
每当 Google 显示您通过 Feed 提供的 action_link 时,
该网址已修改为包含唯一的查询参数:rwg_token
。通过
rwg_token
值是一个编码字符串,其中包含一些有关
用户点击的链接,但无用户数据。您应存储此令牌,并且
作为转化事件的一部分回传
收集和存储商家。
当用户被定向到您的预订页面时,您必须实现以下逻辑:
找到并捕获该商家。通常,合作伙伴会添加商家元数据或
merchant_id
,并使用此链接来识别和存储
商家。我们建议您存储 merchant_id
(或所选标识符)
与rwg_token
一起显示,以便在用户确认预订时,您可以参考
然后再发送已完成的转化请求。与令牌存储期限类似,在初始引荐后的 30 天内,系统必须将商家与令牌一起保存。
以下示例会调整之前存储的 rwg_token
。假设您是
从提供的网址中的元数据解析商家,并将其保存为
merchant_id
,或者将其与现有 merchant_id
匹配。
if (typeof rwg_token !== 'undefined') {
document.cookie =
"_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}
返回 rwg_token
和 merchant_change
值。
当用户完成由 Action Link 引荐发起的预订时,您必须 向转化端点发送 HTTP POST 请求。有两个端点 一个用于生产环境,另一个用于沙盒环境。
- 正式版:https://www.google.com/maps/conversion/collect
- 沙盒:https://www.google.com/maps/conversion/debug/collect
发送转化事件时,您必须包含存储的 rwg_token
和
merchant_change
值为 1
或 2
,有关 merchant_change
的更多详情
请参阅返回商家更改值。
POST 正文应为 JSON 编码对象,格式如下:
{
"conversion_partner_id": "<partnerId>",
"rwg_token": "<rwg_token_val>",
"merchant_changed": "1|2"
}
{
"conversion_partner_id": "XXXXXXX",
"rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
"merchant_changed": "2"
}
以下示例使用 JavaScript 编写,包含在用户设备上使用 Cookie 进行设备级转化跟踪:
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,
merchant_changed: merchantChanged
})
});
}
返回商家更改值
merchant_changed
值用于确定商家是否已从初始重定向商家更改。如果您的着陆页位于包含其他商家的平台中,更改商家是很常见的。在此示例中
如果用户被 Google 引荐到您的平台,并决定转到
并完成了预订,那么我们希望了解
但与单独的商家联系时,我们无需知道该商家
发生了转化事件,但商家与众不同,我们使用
用于标识商家是否已更改的布尔值。
在决定分配 merchant_change
的值时,您需要
原商家保存在收集并存储该商家中
并检查商家是否已更改,然后在设置
分配值。
如果您的预订页面不在平台内,或者用户无法转到其他商家,您可以将这些请求的值硬编码为 2
。对于将预订页面集成到商家网站或使用自定义着陆页处理预订的合作伙伴,这种情况很常见。
商家更改价值 | 要求 |
---|---|
1 | 该值应在用户离开 并完成了购买 通过您的平台与其他商家 |
2 | 如果客户需要 通过原始 Entity 完成交易 (Merchant)。 |
测试和验证转化跟踪。
为确保您实现的转化跟踪正确无误,您需要运行以下测试。务必使用与您的 Google 账号 并在私密或无痕式窗口中提出请求 确保清除了之前与该用户关联的所有令牌。
- 仅使用操作链接完成预订
- 没有引荐来源或之前存储的令牌的直接预订不应导致向 Google 发送任何请求。
- 使用附加了
rwg_token
的链接完成预订。- 确保请求成功发送,且
rwg_token
和merchant_change
值为2
- 确保将
rwg_token
存储 30 天
- 确保请求成功发送,且
- 使用新的
rwg_token
向同一商家完成新的预订。- 确保请求成功发送,并使用
2
的新rwg_token
和merchant_change
值发送 - 确保令牌的归因存储期刷新 30 天
- 确保请求成功发送,并使用
- 直接转到您一直在测试的商家的预订页面
重新预订,但未附加
rwg_token
。- 确保使用之前存储的
rwg_token
发送请求,merchant_change
值为2
- 确保使用之前存储的
如果您的平台允许用户使用其他商家结账,请测试以下内容。
- 使用附加了
rwg_token
的链接前往商家的预订页面,然后继续前往其他商家并进行预订。- 确保发送的请求的
rwg_token
和merchant_change
值为1
- 确保发送的请求的
测试时,请将 HTTP POST 请求发送到转化端点。还有 两个端点,一个用于生产环境,一个用于沙盒 环境
- 生产环境:https://www.google.com/maps/conversion/collect
- 沙盒:https://www.google.com/maps/conversion/debug/collect
您需要将以下令牌附加到操作链接或网址:
rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D
对于需要额外令牌的测试,请使用以下令牌。
rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D
发送成功的转化事件后,您可以看到这些事件经过汇总 转化跟踪信息中心下的“操作中心”。请注意,转化最多可能需要 1 小时才会显示在信息中心中。
转化归因要求
Google 要求的转化归因标准是 30 天归因 窗口。
此归因回溯期意味着 Google 预计转化事件为 会在以下任一情况下发送
- 用户点击地点操作链接,并在同一会话中向同一商家下单。(商家更改值 = 2)
- 用户点击地点操作链接,然后从其他渠道返回 为同一商家下单。(商家 更改值 = 2 )
- 用户点击某个地点操作链接,然后在 30 天内(同一会话或其他会话中)在其他商店下单。(商家更改值 = 1)
此外,Google 希望从用户可以通过地点操作链接到达的所有途径发送转化事件。包括:
- 桌面版或移动版 Web 应用
- 移动应用(通过应用深层链接或为您的网域注册的应用 intent)
如果令牌存储在用户级别(请参阅将令牌持久化),则您应提供跨设备归因。也就是说, 在桌面设备上点击操作链接,然后在移动设备上完成交易 )应触发转化事件。
令牌是否专门存储在设备级别(例如在浏览器中) Cookie,我们不应该提供跨设备归因。在本课中, 在这种情况下,如果用户遵循了 在该设备上有一个操作链接,每个设备都会遵循归因 规则。