第三方广告监测及回调

监测

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都会取寻找追溯期内的地址进行回调，对数据库压力较大。

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