Skip to content

第三方广告监测及回调

white-shiro-bai edited this page Jul 21, 2020 · 5 revisions

监测

2020年7月之后的鬼策版本开始支持第三方广告监测,标记用户来源和回调。 如果是从官方神策转过来的,那不需要做什么调整,鬼策兼容神策原有的配置。

如果是从头开始使用鬼策项目,建议找前端做个管理界面,接口文档是

1.查询第三方监测地址(很多联调文档里写做 点击接口,实际是一回事)

查询已创建的第三方监测地址列表:https://github.com/white-shiro-bai/ghost_sa/blob/master/docs/%E7%AC%AC%E4%B8%89%E6%96%B9%E5%B9%BF%E5%91%8A%E7%9B%91%E6%B5%8B/%E6%9F%A5%E8%AF%A2%E5%B9%BF%E5%91%8A%E7%9B%91%E6%B5%8B%E9%93%BE%E6%8E%A5%E6%8E%A5%E5%8F%A3.png

第三方监测地址接口的说明(解释上面接口返回的参数的意义):https://github.com/white-shiro-bai/ghost_sa/blob/master/docs/%E7%AC%AC%E4%B8%89%E6%96%B9%E5%B9%BF%E5%91%8A%E7%9B%91%E6%B5%8B/%E7%AC%AC%E4%B8%89%E6%96%B9%E5%B9%BF%E5%91%8A%E7%9B%91%E6%B5%8B%E6%8E%A5%E5%8F%A3.png

2.第三方排重接口(ASO供应商特殊要求的接口,神策官方版目前无此接口) https://github.com/white-shiro-bai/ghost_sa/blob/master/docs/%E7%AC%AC%E4%B8%89%E6%96%B9%E5%B9%BF%E5%91%8A%E7%9B%91%E6%B5%8B/%E7%AC%AC%E4%B8%89%E6%96%B9%E5%B9%BF%E5%91%8A%E6%8E%A8%E5%B9%BF%E6%8E%92%E9%87%8D%E6%8E%A5%E5%8F%A3.png

3.创建第三方监测链接(创建1里的链接): 查询项目列表(用来向创建接口拼接参数project):https://github.com/white-shiro-bai/ghost_sa/blob/master/docs/%E9%A1%B9%E7%9B%AE%E6%9F%A5%E8%AF%A2%E6%8E%A5%E5%8F%A3.png

查询已支持的广告平台和默认的推荐参数:https://github.com/white-shiro-bai/ghost_sa/blob/master/docs/%E7%AC%AC%E4%B8%89%E6%96%B9%E5%B9%BF%E5%91%8A%E7%9B%91%E6%B5%8B/%E8%8E%B7%E5%8F%96%E5%88%9B%E5%BB%BA%E6%BA%90%E5%88%97%E8%A1%A8.png

创建第三方链接接口(把上两个接口得到的信息,加上用户想要自定义的信息,提交到这个接口):https://github.com/white-shiro-bai/ghost_sa/blob/master/docs/%E7%AC%AC%E4%B8%89%E6%96%B9%E5%B9%BF%E5%91%8A%E7%9B%91%E6%B5%8B/%E9%93%BE%E6%8E%A5%E5%88%9B%E5%BB%BA%E6%8E%A5%E5%8F%A3.png

如果不想做前端,也可以用postman自己递接口完成这个过程,如果不是有很多的运营需求,前端不是必须的。

广告平台调整或增加广告平台支持的种类的时候,可以单独下载https://github.com/white-shiro-bai/ghost_sa/blob/master/configs/mobile_ad_src_list.csv 文件替换目录下的同名文件。然后执行component/setup.py 里的update_mobile_ad_src() 方法,即可更新创建源。更新创建源只会影响新创建的跟踪链接,不会影响已经创建的历史链接。 支持的广告平台通常是联调过后增加的,或者有的无法联调的,会根据对方的接口文档进行配置。这些文档都放在docs/下了,可以自行阅读。

上面的部分就是跟踪的部分。如果需要回调,如ASO和大部分DSP都要求必须有回调才能进行效果计费的方式投放。可以在这里控制回调: configs/admin.py 下 这些参数是控制回调的。

介于神策SDK的distinct_id识别方式比较特殊,建议在iOS端增加全局属性 idfa,在Android端增加全局属性 imei 来增加回调的可靠性(imei不用进行md5加密)。鬼策支持在触发回调动作时,会在distinct_id,device_id,idfa,imei,以及他们的md5加密共八个参数中寻找不重复的识别id进行回调。

回调

无论是否开启回调,都可以正常在device表里标记广告来源

aso_dsp_callback = True #Ture时,开启移动广告回调,False时,下面的配置都不会生效

aso_dsp_callback_event = '$AppStart' #触发广告的事件,默认为APP启动后触发

aso_dsp_callback_interval_days = 3 #回调追溯期,单位为3天,会查找对应设备3天内是否有广告记录,如果有则会回调最近的一条记录。

aso_dsp_callback_repeat = False #是否允许重复回调,默认为不允许。有的触发事件可能会重复出现,如果该值为True,则每次触发都会发生回调,如果为False,则只有在第一次触发该事件时回调。

aso_dsp_callback_history = False #是否允许回调非首日用户。记是否判断['properties']['$is_first_day']这个值。默认为False,即用户只有在第一天安装并启动APP的时候,才会进行回调。如果这个值改为True,那无论是否首日,用户启动APP都会取寻找追溯期内的地址进行回调,对数据库压力较大。

最后一张图说明一下监测和回调的原理:

Clone this wiki locally