“参与调查”模块供客户用来选择是否参与 Google 顾客评价计划,并且可以向 Google 传输必要的交易信息。您必须在所有订单确认页面上添加该模块才能参与 Google 顾客评价计划。如果您在集成“参与调查”模块时遇到问题,请尝试排查问题。
本部分包含以下主题:
如果用户选择参与调查,Google 会在其所订商品的预计送达日期后向其发送一份调查问卷。如需了解详情,请参阅 Google 顾客评价调查问卷。
“参与调查”模块在桌面设备和移动设备上都可运行。请确保在您的桌面版网站和移动网站上均添加“参与调查”模块的代码段。
集成说明
要在订单确认页面上添加“参与调查”模块,您必须:
“参与调查”模块的代码应放入结账流程的订单确认页面上。所有确认页面都必须使用 HTTPS(而非 HTTP)。
由于该模块会触发系统询问是否参与 Google 顾客评价 (GCR) 调查问卷,因此您必须尽可能确保该模块中的订单详情准确无误。
如果您的结账流程使用第三方处理服务,它必须重定向回您网域中的确认页面。
供客户选择是否参与 GCR 调查的模块不得被订单确认页面上的任何其他内容遮挡。
更新 DOCTYPE
请确保确认页面使用的是 HTML5 DOCTYPE:
<!DOCTYPE html>
此 DOCTYPE 必须是页面上 HTML 代码中的首个专列项。使用 HTML5 DOCTYPE 可确保网络浏览器将以标准模式(而不是怪异模式)呈现您的网页。怪异模式是一项技术,某些网络浏览器使用这项技术与专为旧版浏览器设计的网页保持向后兼容,而不是严格遵循标准模式下的 W3C 和 IETF 标准。
添加“参与调查”模块的代码
如果想让您的客户能够针对在您网站中的购物体验提交评价,可以向您的订单确认页面添加“参与调查”模块。
要向您的订单确认页面添加“参与调查”模块,请按以下步骤操作:
1. 将以下 HTML 代码段粘贴到您的订单确认页面中:
<!-- BEGIN GCR Opt-in Module Code -->
<script src="https://apis.google.com/js/platform.js?onload=renderOptIn"
async defer>
</script>
<script>
window.renderOptIn = function() {
window.gapi.load('surveyoptin', function() {
window.gapi.surveyoptin.render(
{
// REQUIRED
"merchant_id": "
MERCHANT_ID",
"order_id": "
ORDER_ID",
"email": "
CUSTOMER_EMAIL",
"delivery_country": "
COUNTRY_CODE",
"estimated_delivery_date": "
YYYY-MM-DD",
// OPTIONAL
"products":[{"gtin":"
GTIN1"}, {"gtin":"
GTIN2">}],
"opt_in_style": "
OPT_IN_STYLE”
});
});
}
</script>
<!-- END GCR Opt-in Module Code -->
请在 </BODY> 结束标记的前面、紧挨着该标记粘贴此代码段。如果将调查问卷模块代码与徽章代码放在一起,那么这两种代码的顺序无关紧要,调查问卷模块代码放在徽章代码前后均可。
2. 将变量替换成您网站的具体动态值。下表介绍了可用的设置:
变量 |
是否必需? |
说明 |
MERCHANT_ID (商家 ID) |
必需 |
您的 Merchant Center ID。您可以从 Google Merchant Center 中获得此值。 |
ORDER_ID (订单 ID) |
必需 |
订单的唯一 ID。 |
CUSTOMER_EMAIL (客户电子邮件地址) |
必需 |
客户的电子邮件地址,格式为 <名称>@<域名>.com。 |
COUNTRY_CODE (国家/地区代码) |
必需 |
由两个字母组成的国家/地区代码,用于指定客户订单的配送区域。此值必须采用 ISO 3166-1 alpha-2 格式。此字段请勿使用“ZZ”格式。例如,"US"。 |
ESTIMATED_DELIVERY_DATE (预计送达日期) |
必需 |
订单的预计送达日期,其中“YYYY”表示年,“MM”表示月,“DD”表示日。例如,"2016-09-13"。 |
GTIN1、GTIN2 (GTIN) |
可选 |
数值形式的 GTIN 值。 |
OPT_IN_STYLE (“参与调查”模块的样式) |
可选 |
用于指定“参与调查”模块的对话框的显示方式。可取的值有: "CENTER_DIALOG":显示为视图中心的对话框。 "BOTTOM_RIGHT_DIALOG":显示为视图右下角的对话框。 "BOTTOM_LEFT_DIALOG":显示为视图左下角的对话框。 "TOP_RIGHT_DIALOG":显示为视图右上角的对话框。 "TOP_LEFT_DIALOG":显示为视图左上角的对话框。 "BOTTOM_TRAY":显示在视图底部。 默认值是“CENTER_DIALOG”。 |
(可选)将以下代码段粘贴到您的网页中,以指定“参与调查”模块应使用的语言。如果您没有指定 lang
参数的值,则徽章将根据用户的浏览器设置自动选择语言。
<!-- BEGIN GCR Language Code -->
<script>
window.___gcfg = {
lang: '
LANGUAGE'
};
</script>
<!-- END GCR Language Code -->
请在页面上 </BODY> 结束标记的前面、紧挨着该标记粘贴此代码段。如果将此代码段与“参与调查”模块的代码放在一起,那么这两种代码的放置顺序无关紧要。
只需将 LANGUAGE 替换为以下某种受支持的语言,即可设置 lang
参数的值:
代码 |
语言名称 |
af |
南非荷兰语 |
ar |
阿拉伯语 |
cs |
捷克语 |
da |
丹麦语 |
de |
德语 |
en |
英语 |
en-AU |
英语(澳大利亚) |
en-GB |
英语(英国) |
en-US |
英语(美国) |
es |
西班牙语 |
es-419 |
西班牙语(拉丁美洲) |
fil |
菲律宾语 |
fr |
法语 |
ga |
爱尔兰语 |
id |
印度尼西亚语 |
it |
意大利语 |
ja |
日语 |
ms |
马来语 |
nl |
荷兰语 |
no |
挪威语 |
pl |
波兰语 |
pt-BR |
葡萄牙语(巴西) |
pt-PT |
葡萄牙语 |
ru |
俄语 |
sv |
瑞典语 |
tr |
土耳其语 |
zh-CN |
中文(简体) |
zh-TW |
中文(繁体) |
“参与调查”模块代码示例
这些变量的值通常会在您的订单确认页面上替换成服务器端代码。下例展示了如何使用 PHP 实现“参与调查”模块代码:
<!-- BEGIN GCR Opt-in Module Code -->
<script src="https://apis.google.com/js/platform.js?onload=renderOptIn"
async defer>
</script>
<script>
window.renderOptIn = function() {
window.gapi.load('surveyoptin', function() {
window.gapi.surveyoptin.render(
{
"merchant_id": 42,
"order_id": "<?php echo $order_id ?>",
"email": "<?php echo $email_address ?>",
"delivery_country": "<?php echo $user_country ?>",
"estimated_delivery_date": "<?php echo $delivery_date ?>",
"products": [{"gtin":"<?php echo $gtin_1 ?>"}, {"gtin":"<?php echo $gtin_2 ?>"}],
"opt_in_style": "BOTTOM_LEFT_DIALOG"
});
});
}
</script>
<!-- END GCR Opt-in Module Code -->
<!-- BEGIN GCR Language Code -->
<script>
window.___gcfg = {
lang: 'en_US'
};
</script>
<!-- END GCR Language Code -->
如果您的网页上未显示“参与调查”模块,或者您在加载相应网页时遇到错误,请尝试进行问题排查。