东风监测链接示例

东风监测代码将以邮件形式发送至媒体邮箱,其中包括曝光监测、点击监测、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回传,null00000000等;MAC获取到 02:00:00:00:00:00等均会被反作弊过滤

Copyright © 2017 Taobao.com. all right reserved,powered by Gitbook最后修订时间: 2021-07-17 18:10:38

results matching ""

    No results matching ""