JavaScript SDK 提供了一种无需 cookie 即可管理会话和转换的简单方法。广告主可自行调用我们提供的JavaScript SDK,通过调用用JavaScript SDK,无cookie的跟踪将获得服务器端回发的准确性。本教程将引导你完成设置offer、如何让广告主将SDK添加到页面以启动和存储会话,然后下发转化的步骤。
第1步:添加代码
添加Javascript SDK 很简单。将以下代码提供给你的广告主,让广告主把此代码粘贴到广告站点的head以添加 SDK 的功能:
<script>
!function(){var o=window.tdl=window.tdl||[];if(o.invoked)window.console&&console.error&&console.error("Offerslook snippet has been included more than once.");else{o.invoked=!0,o.methods=["init","recognize","transform"],o.factory=function(n){return function(){var e=Array.prototype.slice.call(arguments);return e.unshift(n),o.push(e),o}};for(var e=0;e<o.methods.length;e++){var n=o.methods[e];o[n]=o.factory(n)}o.init=function(e){var n=document.createElement("script");n.type="text/javascript",n.async=!0,n.src="https://common-files.offerstrack.net/ol-sdk.js";var t=document.getElementsByTagName("script")[0];t.parentNode.insertBefore(n,t),o.domain=e}}}();tdl.init({"network_name": "tracking domain"});
</script>
通过在生成tracking的面板选择affiliate,找到你的tracking 域名。
除非你设置了自定义域名,否则它将看起来像这样:
http://yournetwork.offerstrack.net
上面的代码将异步加载其他方法,以免影响页面的加载时间。一旦代码加载完毕,广告主就可以调用其他方法来跟踪会话或下发转化。广告主可以通过调用其他两种方法之一来实现:识别或转换。
使用同一个 JS SDK 支持多个渠道
如果广告主使用多个不同的offerslook渠道,Javascript SDK 可以同时支持所有这些渠道。在这些情况下,设置如下:
JS SDK 的“init”调用应反映广告主与之合作的所有合作伙伴。在这些情况下,初始化调用的结构是这样的:
tdl.init({
'[Network Name]':'[Tracking Domain for NetworkA]',
'[Network Name]':'[Tracking Domain for NetworkB]',
...
});
network_name在我们平台的Setting->Customization->Appearance->Network Name
例如:
一个成功的“init”调用示例如下:
tdl.init({
'other1':'https://testnet1.offerstrack.net' ,
'othernet2':'https://othernet2.offerstrack.net'
})
如果你与多个使用 Offerslook Javascript SDK 的广告主合作,你需要确保该广告主的offer的destination URL 中包含你的Network Name。此Network_Name与OL平台的Setting->Customization->Appearance的Network Name必须相同。Network Name应包含在Destination URL 的末尾,如下所示:
...&network_name=[NETWORK NAME FOR THIS NETWORK]
Destination URL示例如下,附加参数以粗体突出显示:(click_id和network_name是必备参数)
https://offer.advertiser.com?click_id={click_id}&network_name=demo1
第2步:识别recognize
注意:以下部分假设广告主已如上所述在广告的页面上安装了 SDK 的基本代码。
当广告主想要存储或生成用户会话时,将调用识别方法。如果熟悉广告主我们的传统tracking链接,此方法在很大程度上对应于“点击”。
更基础的是,可以像这样调用识别方法:
tdl.recognize();
这将从 URL 的查询字符串中提取 click_id 参数并将其存储在用户浏览器的本地存储中。
我们建议使用后端模板或主题来帮助将调用注入用户可能首次访问的网站每个页面的页脚或页眉。这样,无论用户首先登录哪个页面或产品,他们都将始终存储他们的会话。
通过将可选参数传递给方法本身,recognize函数还可用于在存储之前生成会话。
第3步:调用转化
transform方法使广告主能够使用用户当前存储的会话记录转换。由于会话的click ID 具有关联的affiliate id 和offer id,因此广告主无需在调用 transform 方法时包含这些 id。
在最基本的情况下,transform 方法很简单:
tdl.transform();
transform 函数完全能够处理event和其他postback参数。 包括这些可选字段将允许广告主在转换过程中记录附加信息。如果我们想记录包含附加参数的目标转化,示例如下:
tdl.transform({
'event_token':'purchase',
'adv_sub1':'abc123'
})
还可以以类似的方式传递event id:
tdl.transform({
'event_id':'4',
'adv_sub1':'abc123'
})
如果offer是单事件就不需要加event_token或event_id参数,示例如下:
tdl.transform({'adv_sub1':'abc123'})
第4步:offer配置
Destination URL必须包含参数:click_id、network_name。
https://offer.advertiser.com?click_id={click_id}&network_name={network_name}
Conversion Protocol要选择Postback URL。
上下游协议要保持一致,如果Destination URL 采用https,那么 Tracking Link 也需要使用https,否则无法完成点击转化操作。
!注意
跳转到埋SDK的页面时,触发转化的URL需要带上click_id 参数,否则无法正常产生转化。