开发文档

开发文档时对接过程中的指导规范

广告对接文档
媒体对接文档

表单类后端数据对接(JS)

一、对接价值

表单类广告投放,用户进入广告主的落地页,是否进件、完件等后端数据,是广告主重点关注的数据,也是广告优化的核心关键点。跟踪广告的这些后端数据,能够帮助广告主更好的优化广告效果。
推啊平台为广告主提供人工投放、oCPC等智能投放策略,投放效果依赖广告主后端数据回收的及时性。为了提升数据回收的效率,减少广告主、推啊广告优化师的工作量,推啊为广告主提供了表单类广告后端数据接入的解决方案,实现后端数据自动回传。
推啊能够根据广告主后端数据的波动情况,及时调整广告投放策略,最大程度上稳定广告主的成本,甚至以最低的成本帮助广告主带来最大的收益。

二、产品形态

(一)产品路径

流程说明:媒体广告位点击 → 活动展示→ 抽奖 → 广告展示 → 点击领取→ 落地页展示; 例如:
说明: 推啊会在每个落地页的链接后面带上a_oId做为落地页的唯一标识。

(二)基本名词介绍

(1)曝光数据 页面PV/UV ,PV即页面浏览量,用户每1次对网站中的每个网页访问均被记录1次。用户对同一页面的多次访问,访问量累计。UV指根据PV去掉重复访问页面的用户数据。
(2)转化数据 用户进入页面后,根据广告需求,将某个特定的行为计算为转化,例如点击,长按,提交表单等。用户触发事件时,向数据服务器发送数据。
(3)常用参数含义 a_oId :唯一标识订单id a_cid :唯一标识用户id

三、技术实现

(一)对接原理

JS的作用:

实现流程如下:

  1. 推啊会在每个投放链接后面拼装上唯一标识的信息,例如:a_oId(唯一订单号),a_cid(唯一用户id)等等。
  2. 推啊服务器收到广告主的请求,会记录日志。推啊通过日志分析则知道是哪个订单,哪个广告,哪个用户发生了转化。

(二)对接流程图

(三)落地页部分对接 - JS对接(必选)

3.1 引入JS文件(必选)

在落地页页面的head中加入脚本:

<script type="text/javascript" src="//yun.tuisnake.com/h5-mami/log.js" id="send_log"></script>
                
3.2 点击事件转化(必选)

在需要统计点击转化的DOM元素上添加 data-setting-click属性。例如:

注意:切勿嵌套添加data-setting-XXX属性,此外若DOM元素动态渲染,会导致该方法无效。

3.3 长按屏幕转化(非必选)

备注:微信加粉类广告需要对接,因为需要长按复制公众号信息。 在需要统计屏幕长按转化的DOM元素上添加data-setting-press属性。例如:

在长按元素上添加data-setting-press元素,用户按800ms会计算一次转化。

3.4 点击复制到系统剪贴板(非必选)

背景:针对下载类落地页,会把唯一标识复制到剪贴版,以便下载完应用后,通过剪贴版拿到唯一标识。

在需要点击复制的元素上添加data-setting-copy属性。 若跳转到落地页链接为://www.tuia.cn?a_oId=taw-123&a_cid=taw-456 则data-setting-copy=”${a_oId}” 点击复制的剪贴版的值为taw-123; 例如:

注意:为了严格区分剪贴板是否包含推啊的内容,推啊在a_oId前会加上taw-的标识,所以希望在取值时判断剪贴板内容是否包含taw-这个标识,如果有则表示来自于tuia,如果没有则忽略

3.5 注意事项

广告主在按要求接入了JS后,广告主落地页在发生转化时,页面发生跳转,则转化请求会被中断,需要按以下方式进行跳转: 在转化发生时调用countLog.init(function,option)方法,方法含有两个参数,参数可以为空:

  • function是回调函数,需要将跳转行为通过回调函数执行,如function(){转化行为}。
  • option是标记位,当出现多个转化埋点时使用,是一个json键值对,如{locationName:valueName}, 键值和数值都可以自定义,用来区别不同的转化。