东风监测链接示例
东风监测代码将以邮件形式发送至媒体邮箱,其中包括曝光监测、点击监测、H5点击链接和deeplink链接:
曝光监测链接:用于监测广告展示数
https://ef-dongfeng.tanx.com/nim?e=S2q33UZrBysfrDt0lBRph7slJWk81sXfkf_eMNekqfOVDGDuLXnG7gY885Oh9VpgtrFmNWTJVVAA4y6c-R6YIbe-W8IoiGumBiuSdLusYp0&k=106&a1=__IP__&a2=__OS__&a3=__IDFA__&a4=__IMEI__&a5=__IMEI_MD5__&a6=__OAID__&a7=__MAC__&a8=__UA__&a9=__TS__&a17=__ANDROIDID__&a26=__ALI_AAID__&a27=__CAID__
点击监测链接:用于异步监测广告点击数
https://ef-dongfeng.tanx.com/ncm?e=rNbBTRFC9B4frDt0lBRph7slJWk81sXfkf_eMNekqfNWV_McYBwQ7AdAoXSLA2-0uWCcvqW3VDSI027ym2POp7jI0JtoQt44vUtHTEV45P4&k=106&a1=__IP__&a2=__OS__&a3=__IDFA__&a4=__IMEI__&a5=__IMEI_MD5__&a6=__OAID__&a7=__MAC__&a8=__UA__&a9=__TS__&a17=__ANDROIDID__&a26=__ALI_AAID__&a27=__CAID__
东风ef服务器收到来自媒体客端的曝光report串后,直接返回给client 200 ok和一个像素点
H5点击链接:用于同步监测广告点击数并跳转到广告落地页,此示例中落地页https://chaoshi.tmall.com
https://click.tanx.com/tfn?e=oNKsqT1agQMkoPZ6MF%2bEZnSYQN8l9GAeN8Bh8QcRFU423gb3ZyJLNffcc%2bI1X48dv4%2bevhsX7WZlldT4UtA2KJtTlZLXnB0RvLzFcHySLWjaqbyXlsJfv1Vu45s7CxpjcrhAqAraWgU%3d&u=https%3a%2f%2fchaoshi.tmall.com&k=140&ext=a%3d__IMEI__%26b%3d__IDFA__%26c%3d__MAC__%26d%3d__OAID__&%26a26%3d__ALI_AAID__%26a27%3d__CAID__
Deeplink点击链接:唤醒阿里系APP
以唤醒手淘为例:
tbopen://m.taobao.com/tbopen/index.html
Deeplink唤醒详见APP唤醒说明文档
[warning]请注意
点击监测链接根据实际落地页的长多有所变化,点击监测链接最大长度为500字符,请媒体确认直投系统可以支持.
宏参数说明
在媒体客户端支持向东风上报数据(向监测URL发送GET请求或Webview打开点击监测URL)前,需要对监测链接中的宏进行识别,并客户端设备号与宏进行替换,替换内容均包含下划线。
[warning]请注意
除宏替换外,请勿对监测链接中的其他字符做任何修改或转码,否则会影响代码加密校验,上报后视为无效数据。
监测宏参数说明
宏参数 | 参数含义 | 宏名称 | 是否必填 | 替换规则 |
---|---|---|---|---|
a1 | 客户端真实ip地址 | __IP__ |
是 | 用户终端的公网IP地址,支持IPv4和IPv6。 IPv6地址为128位长,但通常写作8组,每组为四个十六进制数的形式。例如:2001:0db8:85a3:08d3:1319:8a2e:0370:7344。有效格式说明:1)浏览IP为客户端IP,非服务器IP,应为公网IP,即不能是私有ip。私有ip举例A: 10.0.0.0~10.255.255.255 即10.0.0.0/8 B:172.16.0.0~172.31.255.255即172.16.0.0/12 C:192.168.0.0~192.168.255.255 即192.168.0.0/16 2)如果使用服务端转发请求,确认透传客户端IP到服务器 |
a2 | 客户端操作系统的类型,枚举值 | __OS__ |
移动端必填 | iOS:1,Android:2 |
a3 | iOS设备IDFA明文 | __IDFA__ |
ios端可获取时必填,不可获取时不填 | IOS6.0及以上的IDFA号明文,长度36位,样例:4FCFEFA1-096D-4176-B352-1870ED6DB777 |
a4 | 安卓设备IMEI原值 | __IMEI__ |
安卓端可获取时与imei md5值二选一,不可获取时不填 | 明文形式 |
a5 | Android设备用户终端的IMEI MD5值 | __IMEI_MD5__ |
安卓可获取时与原值二选一,不可获取时不填 | md5加密值,对原值进行标准32位MD5编码(大小写不限)。 |
a6 | Android Q 及更高版本的设备号, | __OAID__ |
可获取时必填,不可获取时不填 | 明文,样例:47befdff-fb1f-4b96-ddff-bf3fb77f744e |
a7 | 用户终端的网卡接口的物理MAC地址(无冒号) | __MAC__ |
OTT端必填 | 明文或MD5加密。加密前请先对mac值进行去分隔符转大写字母格式化 |
a8 | 数据上报终端设备User Agent | __UA__ |
是 | client user agent,反映真实客户端信息。 优先获取webview的UA,而非系统级UA,取不到则不回传,避免使用自定义UA。 示例: webView.getSettings().getUserAgentString() Mozilla/5.0 (Linux; Android 10; PCKM80 Build/QP1A.190711.020; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/77.0.3865.92 Mobile Safari/537.36 |
a9 | 时间戳 | __TS__ |
是 | 秒级,只支持整数 |
a17 | 安卓客户端AndroidID | __ANDROIDID__ |
否 | |
a26 | 阿里阿里巴巴匿名设备标识,需集成阿里 SDK 获取,具体咨询商务获取 SDK 信息。 | __ALI_AAID__ |
ios端可获取时必填 | 原值,示例660FA84D-3BE3-AA98-4D79-C078A878D7DC |
a27 | 中广协CAID | __CAID__ |
ios端可获取是必填 | 由于CAID有版本号(若无版本号请使用0)和值,需将版本号和值用'_'拼接后替换,如果有多个用','拼接,然后用URLEncode |
点击链接宏参数说明
宏名称 | 含义 | 是否必填 | 替换规则 |
---|---|---|---|
__IDFA__ |
iOS设备IDFA原值 | ios端必填,不可获取时不填 | IOS6.0及以上的IDFA号明文,长度36位,样例:4FCFEFA1-096D-4176-B352-1870ED6DB777 |
__IMEI__ |
安卓设备IMEI明文或IMEI MD5加密值 | 安卓端可获取时必填,不可获取时不填 | 明文或对明文进行标准32位MD5编码(大小写不限) |
__OAID__ |
Android 10及上版本的设备号 | 可获取时必填,不可获取时不填 | 明文,样例:47befdff-fb1f-4b96-ddff-bf3fb77f744e |
__MAC__ |
用户终端的网卡接口的物理MAC地址 | OTT端必填 | 明文或MD5加密。加密前请先对mac值进行去分隔符转大写字母格式化 |
__ALI_AAID__ |
阿里阿里巴巴匿名设备标识,需集成阿里 SDK 获取,具体咨询商务获取 SDK 信息。 | ios端可获取时必填 | 原值,示例660FA84D-3BE3-AA98-4D79-C078A878D7DC |
__CAID__ |
中广协CAID | ios端可获取是必填 | 由于CAID有版本号(若无版本号请使用0)和值,需将版本号和值用'_'拼接后替换,如果有多个用','拼接,然后用URLEncode |
[info]CAID替换示例
例如: CAID1值为:BFB405DC6C3B16E8B1BA40BCD3A7C7C4
CAID1版本号为:20201201
CAID2值为:E8B1BA40BCD3A7C7C4BFB405DC6C3B16
CAID2版本号为:20210101
CAID3值为:A40BCD3A7C7C4BFB405DC6C3B16E8B1B
CAID3版本号:缺失
则将a27=
__CAID__
替换成 (URLENCODE(20201201_BFB405DC6C3B16E8B1BA40BCD3A7C7C4,20210101_E8B1BA40BCD3A7C7C4BFB405DC6C3B16,0_A40BCD3A7C7C4BFB405DC6C3B16E8B1B))替换结果a27=20201201_BFB405DC6C3B16E8B1BA40BCD3A7C7C4%2C20210101_E8B1BA40BCD3A7C7C4BFB405DC6C3B16%2C0_A40BCD3A7C7C4BFB405DC6C3B16E8B1B
MAC加密格式化示意图
[warning]关于设备号无法获取时的处理说明
由于系统或用户隐私设置等原因,部分设备的设备号可能无法正常获取。当获取不到,或者获取到系统相同值时(请关注客户端获取设备号方法的返回值),请不要使用默认值填写,否则当做非法设备号被认为是无效流量。例如IMEI回传,
null
、0
、0000000
等;MAC获取到02:00:00:00:00:00
等均会被反作弊过滤