跳到主要内容

JS 开发指引


JS SDK全码接入



DataNexus JS SDK 全码接入要求将完整的基础代码和行为代码添加到需要追踪的网站, 适用于开发能力完备、有个性化上报需求的广告主。

  • 支持能力:支持上报所有标准行为和自定义行为,可以为行为添加参数,支持全流量。
  • 接入方式:在网页粘贴跟踪代码,跟踪代码由 2 部分组成
    • 基础代码:将基础代码布于页面头部,需要在所有页面上部署
    • 行为代码:在特定页面上部署行为代码,分别布于触发行为的按钮上


1 在网站头部添加【基础代码】

1.1. 您必须将基础代码部署在所有页面,这样可以通过 URL 方式提取所有访客

1.2. 将基础代码部署在网站头部,即 标签之内相对靠前的位置,切勿修改代码


<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', '//mp.zhls.qq.com/sdk/dmp-sdk-js/gdtevent.min.js');

gdt('init','1200xxxxxx'); // 填写 Web 数据源
gdt('track','PAGE_VIEW');
</script>

<noscript>
<img height="1" width="1" style="display:none" src="api.datanexus.qq.com/data-nexus-cgi/pixel?user_action_set_id=1200118316&action_type=PAGE_VIEW&noscript=1"/>
</noscript>

拷贝好的基础代码,参考下图示例,粘贴到网页头部。

js_01



2 在特定页面添加【行为代码】

在特定页面添加不同的行为代码,收集不同的行为数据和参数,这样可以通过行为方式提取人群。您需要将行为代码部署在发生了该行为的特定页面里。在添加特定页面代码前,请确定已经部署了上一章节中的头部代码,头部代码必须在行为代码前被触发。

标准行为是应用中一系列常见的标准化行为,你可以使用腾讯广告预先设置的标准行为来跟踪和优化转化。您可以在上报行为的同时上报参数来更细粒度地提取人群或者优化转化,参数的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请将 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’});

此外,还可以自定义行为,同样可以添加参数来帮助补充行为细节提取更细分的人群。自定义行为的代码如下:

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

拷贝好的行为代码,参考下图示例,粘贴到对应行为的页面当中。

js_02




该内容是否有帮助?