接口文档SDK业务专题开发者工具

Web转化数据JS接入文档

 
目录
 
一. 适用客户
二. 转化数据上报说明及示例
三. 确定行为类型
 

以下内容建议提供给将您的转化数据回传给腾讯广告的技术侧阅读,优化师及广告投手阅读 帮助中心-转化归因使用指南-Web落地页转化归因操作手册 ,在广告创建时进行归因设置。
登录 投放管理平台 → 上方工具箱 → 转化归因,可以找到网页转化中的JS设置。

 

一. 适用客户
对于需要接入网站行为数据的广告主,我们提供了JS这种开发成本较低的接入方式。该方式支持上报所有标准行为和自定义行为,可以为行为添加参数,支持全流量。

 

二. 转化数据上报说明及示例

广告主需要在创建转化规则时获取【密钥】,并在所推广的网页进行JS布码。我们提供的JS代码分为【基础代码】和【行为代码】两部分。

  • 在创建转化规则时获取【密钥】

  • 将【基础代码】布于页面头部,并将【密钥】填入【基础代码】中,从而追踪网页访客

  • 将【行为代码】分别布于触发行为的按钮上,从而追踪感兴趣的用户转化行为

布码位置如下图所示:

1. 在创建转化规则时获取【密钥】
在新建网页转化-JS界面中,填写有效的推广网页链接,如下图所示点击【获取密钥】。

选择上报密钥并点击确认,密钥会自动复制到剪贴板。注意一个账号只能使用一个密钥。

 
2. 在网站头部添加【基础代码】
您必须将基础代码部署在所有网页代码的头部,这样可以通过URL方式追踪所有访客。一般可以将基础代码部署在网页代码头部的最后,例如在</header>标签结束前。
基础代码:

<script>
    !function(g,d,t,e,v,n,s){if(g.gdt)return;v=g.gdt=function(){v.tk?v.tk.apply(v,arguments):v.queue.push(arguments)};v.sv='1.0';v.bt=0;v.queue=[];n=d.createElement(t);n.async=!0;n.src=e;s=d.getElementsByTagName(t)[0];s.parentNode.insertBefore(n,s);}(window,document,'script','//qzonestyle.gtimg.cn/qzone/biz/gdt/dmp/user-action/gdtevent.min.js');
    gdt('init','your_key');  //请务必将your_key替换为您的密钥,如 1234567890 。否则将联调不通过!
    gdt('track','PAGE_VIEW');
</script>
<noscript>
    <img height="1" width="1" style="display:none" src="https://a.gdt.qq.com/pixel?user_action_set_id=1105929547&action_type=PAGE_VIEW&noscript=1"/>
</noscript>

请务必将上一步骤获取的密钥替换到基础代码的注释字段中。
 
3. 在特定页面添加【行为代码】
您必须在用户发生感兴趣的转化行为的特定页面添加对应的行为代码,从而收集和上报对应的行为数据,实现转化归因。
不同的行为类型需要添加不同的行为代码,本节仅以“注册”为例,更多行为类型请继续阅读下节。
行为代码示例:

gdt('track', 'REGISTER', {' {'}'key1': 'value1', 'key2': 'value2'{'}'}); // 注册行为

在特定页面添加行为代码前,请确定已经在头部部署了上文所述的基础代码,基础代码必须在行为代码前被触发。

 

三. 确定行为类型
腾讯广告将一系列常见的用户转化行为定义为“标准行为”,可供直接使用。您也可以上报“自定义行为”来满足您的个性化需求。
此外,您还可以在上报转化行为的同时上报行为参数,来更细粒度地提取人群或者优化转化。参数的key-value对都是选填的,您可以根据自身需求决定是否填写。
现有标准行为类型及其对应的行为代码如下:

行为类型 说明 行为代码
SEARCH 请将SEARCH行为放置在发生搜索行为的页面(例如:商品搜索) gdt(‘track’, ‘SEARCH’,{‘key1’: ‘value1’, ‘key2’: ‘value2’});
VIEW_CONTENT 请将 VIEW_CONTENT 行为放置在发生浏览行为的页面(例如:商品页面,文章) gdt(‘track’, ‘VIEW_CONTENT’, {‘key1’: ‘value1’, ‘key2’: ‘value2’});
REGISTER 请将 REGISTER 行为放置在发生注册行为的页面(例如:完成账号的注册) gdt(‘track’, ‘REGISTER’,{‘key1’: ‘value1’, ‘key2’: ‘value2’});
ADD_TO_WISHLIST 请将 ADD_TO_WISHLIST 行为放置在发生收藏行为的页面(例如:点击商品收藏) gdt(‘track’, ‘ADD_TO_WISHLIST’,{‘key1’: ‘value1’, ‘key2’: ‘value2’});
CONSULT 请将 CONSULT 行为放置在发生咨询行为的页面(例如:点击咨询按钮) gdt(‘track’, ‘CONSULT’,{‘key1’: ‘value1’, ‘key2’: ‘value2’});
ADD_TO_CART 请将 ADD_TO_CART 行为放置在发生加入购物车行为的页面(例如:点击加入购物车) gdt(‘track’, ‘ADD_TO_CART’,{‘key1’: ‘value1’, ‘key2’: ‘value2’});
INITIATE_CHECKOUT 请将 INITIATE_CHECKOUT 行为放置在发生开始结算行为的页面(例如:点击结算按钮) gdt(‘track’, ‘INITIATE_CHECKOUT’,{‘key1’: ‘value1’, ‘key2’: ‘value2’});
COMPLETE_ORDER 请将 COMPLETE_ORDER 行为放置在发生下单行为的页面(例如:点击下单按钮) gdt(‘track’, ‘COMPLETE_ORDER’,{‘key1’: ‘value1’, ‘key2’: ‘value2’});
PURCHASE 请将 PURCHASE 行为放置在发生付费行为的页面(例如:用户支付完成的页面) gdt(‘track’, ‘PURCHASE’,{‘key1’: ‘value1’, ‘key2’: ‘value2’});
RESERVATION 请将 RESERVATION 行为放置在发生预约行为的页面(例如:用户注册页面) gdt(‘track’, ‘RESERVATION’, {‘key1’: ‘value1’, ‘key2’: ‘value2’});
SHARE 请将 SHARE 行为放置在发生分享行为的页面(例如:点击分享按钮) gdt(‘track’, ‘SHARE’, {‘key1’: ‘value1’, ‘key2’: ‘value2’});
APPLY 请将 APPLY 行为放置在发生申请行为的页面(例如:点击申请按钮) gdt(‘track’, ‘APPLY’, {‘key1’: ‘value1’, ‘key2’: ‘value2’});
CLAIM_OFFER 请将 CLAIM_OFFER 行为放置在发生领取卡券行为的页面(例如:点击领取优惠券按钮) gdt(‘track’, ‘CLAIM_OFFER’, {‘key1’: ‘value1’, ‘key2’: ‘value2’});
NAVIGATE 请将 NAVIGATE 行为放置在发生导航行为的页面(例如:点击跳转导航页按钮) gdt(‘track’, ‘NAVIGATE’, {‘key1’: ‘value1’, ‘key2’: ‘value2’});
PAGE_VIEW 请将 PAGE_VIEW 行为放置在发生网页访问行为的页面(例如:商品详情页,商品列表页) gdt(‘track’, ‘PAGE_VIEW’, {‘key1’: ‘value1’, ‘key2’: ‘value2’});
PRODUCT_RECOMMEND 请将 PRODUCT_RECOMMEND 行为放置在有商品推荐位的页面(例如:点击查看商品推荐页按钮) gdt(‘track’, ‘PRODUCT_RECOMMEND’, {‘key1’: ‘value1’, ‘key2’: ‘value2’});
DELIVER 请将 DELIVER 行为放置在查看发货详情的页面(例如:点击跳转已发货页面按钮) gdt(‘track’, ‘DELIVER’, {‘key1’: ‘value1’, ‘key2’: ‘value2’});
SIGN_IN 请将 SIGN_IN 行为放置在签收行为的页面(例如:点击跳转签收页按钮) gdt(‘track’, ‘SIGN_IN’, {‘key1’: ‘value1’, ‘key2’: ‘value2’});
CONFIRM_EFFECTIVE_LEADS 请将 CONFIRM_EFFECTIVE_LEADS 行为放置在有效综合线索的页面(例如:完成线索收集按钮) gdt(‘track’, ‘CONFIRM_EFFECTIVE_LEADS’, {‘key1’: ‘value1’, ‘key2’: ‘value2’});
CREDIT 请将 CREDIT 行为放置在授信行为的页面(例如:完成授信按钮) gdt(‘track’, ‘CREDIT’, {‘key1’: ‘value1’, ‘key2’: ‘value2’});

  
自定义行为类型及其对应的行为代码如下:
同样可以添加参数来帮助补充行为细节提取更细分的人群

gdt('track_custom',  'CUSTOM_ACTION_NAME', {'key1': 'value1', 'key2': 'value2'});