接口规范只是搭好了骨架,真正让对接跑通的是一个个参数。宏填错了、漏了,数据就归因不到广告组上。这篇文章把接口一和接口二的参数逐个拆开讲清楚,并对转化事件类型做了梳理。
接口一是点击监测接口,广告主在监测链接里用双下划线的宏来接收搜狐下发的数据。设备标识类参数按端区分:Android 10 以下用 IMEI,取其 MD5 后的 32 位大写值;Android 10 及以上用 OAID,其中 OAID 是明文原值,OAID1 是 MD5 后的 32 位大写值;iOS 用 IDFA,IDFA 是明文,IDFA1 是 MD5 后的 32 位大写值。
归因关联类参数里,GID 是汇算广告组 id,AID 是汇算广告创意 id,CLICKTS 是广告点击时间戳(精确到毫秒),CLICKID 是搜狐生成的全局唯一点击 id。CALLBACK 是转化回调地址,属于必填项,需 urlencode 编码,也就是接口二的转化上报地址。
此外还有几个通用参数:IP 是用户 IP 地址,UA 是用户 User Agent 信息(需 urlencode 编码,APP 端与 WAP 端格式不同),OS 是操作系统,取值 ios 或 android。
接口二是广告主把转化回传搜狐的地址。它的核心参数有:meta(加密回传参数,用于数据归因)、clickid(点击唯一 id)、cvid(转化跟踪 id),三者均为必填;conid 是联调 id,仅在联调时使用;event_type 是转化事件类型,格式为宏 __EVENT__,需宏替换后上报;timestamp 是转化时间戳(13 位毫秒),格式为宏 __TS__,属于选填。
有一点要特别注意:接口二里除 event_type 和 timestamp 以外,其他参数不可篡改、不可缺失,否则会造成联调失败。
event_type 用数字编码代表不同的转化行为。基础事件包括:1001 激活(下载安装后打开应用)、1002 注册、1003 次留(激活后次日访问)、1004 付费、1005 关键行为(可按营销需求灵活定义)。
面向 DPA 广告的场景,还有一组事件:3001 app 访问、3002 到达指定页面、3003 添加购物车、3004 下单、3005 付费。广告主在搜狐广告投放里做转化跟踪时,按实际业务选择对应的事件类型即可,选错编码会导致转化数据归因错乱。