一、背景介绍
为满足搜狐广告主对广告效果的监测需求,本文档介绍如何把从搜狐渠道的转化效果数据回传给搜狐广告平台,帮助广告主跟踪转化效果。
本回调方案适用于Android和iOS的APP端以及使用ip+ua归因的WAP端,对接方式为API对接。
二、转化定义
2.1定义
广告点击:搜狐用户点击广告素材时触发点击事件，该事件被认为是一次有效的广告点击。
2.2数据流程
流程说明:
1)用户点击广告后触发点击事件。
2)喜户端将点击事件发送给搜狐服务器。
3)搜狐服务赣将点击事件上掖至攘狐广告服务最。
4)搜狐广告服务器通过广告主提供的点击监测接口(即接口一)将点击事件通知到广告主服务器。
5)广告主在收到接口一的请求后根据请求参数的用户信息.同自己的转化数据进行匹配。
6)广告主服务端通过转化上报接口(即接口二: callback url )将转化事件上报至搜狐服务器。
7)搜狐广告服务器将收到的转化数据与广告账户匹配。
8)搜狐投放前端呈现转化报表。
三、接口定义
3.1接口一
接口-是由广告主监测方提供的用于帮助广告主接收搜狐的广告点击信意的接口。
3.1.1接口-规范:
请求方:搜狐广告服务器
处理方:广告主监测方服务器
请求方式: HTTP GET
请求地址:广告主需提供点击监测url,监测url中。使用双下滑线的形式来设置所需返回的数据,如PARAM__ 。
3.1.2响应方式及内容
返回数据需要为json格式，例如: {"desc:"成功","status' :true}.表示广告主监测平台收到点击数据，异常情况desc字段可撞达失败原因。
说明
■宏格式必须全大写,必须使用双下滑线"_ _参数_ “的形式，否则会导致宏替换失败
■监测链接不能是下载链接
■_ CALLBACK_ 宏必填，其他宏可根据监测需要灵活配董,详细宏参数说明见下方4.1部分。
3.2接口二
接口二是由搜狐广告平台服务器以callback 参数的形式提供给广告主,广告主可通过接口二将转化数据回传给搜狐广告服务器,搜狐广告胶务最会将收到的转化数据与广告组关联,跟踪每-个广 告组的转化效果。广告主必须实现实时上报回传。以免出现统计无效的情况。
3.2.1接口二规范
请求方:广告主监测方服务器
处理方:搜狐广告服务器
请求方式: HTTP GET
请求地址：我们会在下发点击事件时通过宏_ CALLBACK_ _将转化 上报的接口提供给广告主广告主需按照callbackurl中的接口地址进行转化事件的上报，参数的详细说明见下方4.2部分。
3.2.3响应方式及内容
请求成功: success
四、参数说明
4.1接口一参数说明
点击监测支持的宏参数:
4.2接口二参数说明
转化上报参数:
4.2.1 EVENT TYPE字典
五、联调
5.1联调流程
在广告主完成对接后,需要在新品算后台创違转化跟踪对象并完成自助联调。
流程说明:
1)工具箱->转化跟踪->新建转化跟踪->移动应用转化跟踪;
2)输入必填信息;
a)其中下载地址需根据投放平台的不同输入安卓的apk下载地址或iOS的App Store地址,筹待获取应用信息。
b)点击监测地址请填写文档上面提到的接口-地址其中宏参数_ _CALLBACK_ 必填.其他参数根据监测需求填写。
3)进入下一步输入所需联调的设备id,请点击“查看设备id获取方法”查询设备id如何获取;
a)iOS请填写IDFA
b) Android 10以下请填写IMEI, Android 10及以上请填写OAID
4)点击开始联调后进入下一步,随后打开搜狐新闻客户端在信息流中查找“搜狐转化跟踪联调广告”;
5)点击联调广告并完成转化行为。如激活。注册等.待转化数据回传后完成联调;
6)联调通过后的转化跟踪对象即可在广告组中选择使用。
注:联调的有效期为60分钟,如60分钟内未返回转化数据霜要重新联调。
5.2自动联调
广告系统会根据广告主填写的下载地址获取应用信息,如应用已完成联调,则下次新提交的转化跟综会自动完成联调过程。
如需重新联调,在操作列中点击“重新联调” 即可。
六、常见问题
3.1联调失败
3.1.1广告主未收到点击数据
1)检在接口一是否可正常访问;
2)检查所需参数的宏是否正确填写;
3.1.2联调超时
1)在点击数据可以正常接变的情况下,检查是否匹配到转化并回调了callback url;
2)如回调了callbackurl,检查callbackurl里参数是否有缺失;
注:接口二中的参数。除event _type和timestamp以外。其他多数不可篡改。不可缺失,否则会造成联调失败
3.2正式投放时如何使用
创建广告组时,在投放目标中指定一个已创建的转化跟踪。
3.3 WAP端如何使用api的方式跟踪转化
评论列表