渠道上报监测 API

文档更新记录

版本作者时间备注
v1.0戚银2026-07-23创建
v1.1戚银2026-08-21增加 callback_url
v1.2戚银2026-09-10增加曝光、点击上报出价和成交价

接口说明

监测地址

曝光监测

曝光 CPM 成交模式

https://api.mobrtb.com/tracker/adx?et=7&mid=__XYMID__&advid=__XYADVID__&mrid=__REQUESTID__&auid=__AD_UNIT_ID__&os=__OS__&osv=__OS_VERSION__&imei=__IMEI__&imeimd5=__IMEI_MD5__&oaid=__OAID__&oaidmd5=__OAID_MD5__&androidid=__ANDROID_ID__&androididmd5=__ANDROID_ID_MD5__&gaid=__GAID__&gaidmd5=__GAID_MD5__&caid=__CAID__&caidmd5=__CAID_MD5__&caidv=__CAID_VERSION__&caid2=__CAID2__&caid2md5=__CAID2_MD5__&caid2v=__CAID2_VERSION__&idfa=__IDFA__&idfamd5=__IDFA_MD5__&model=__MODEL__&make=__MAKE__&brand=__BRAND__&mac=__MAC__&macmd5=__MAC_MD5__&ip=__IP__&ip6=__IPV6__&appb=__APP_BUNDLE__&appv=__APP_VERSION__&bidcpm=__BID_CPM__&cpm=__CPM__&ua=__UA__

曝光 CPC 成交模式

https://api.mobrtb.com/tracker/adx?et=7&mid=__XYMID__&advid=__XYADVID__&mrid=__REQUESTID__&auid=__AD_UNIT_ID__&os=__OS__&osv=__OS_VERSION__&imei=__IMEI__&imeimd5=__IMEI_MD5__&oaid=__OAID__&oaidmd5=__OAID_MD5__&androidid=__ANDROID_ID__&androididmd5=__ANDROID_ID_MD5__&gaid=__GAID__&gaidmd5=__GAID_MD5__&caid=__CAID__&caidmd5=__CAID_MD5__&caidv=__CAID_VERSION__&caid2=__CAID2__&caid2md5=__CAID2_MD5__&caid2v=__CAID2_VERSION__&idfa=__IDFA__&idfamd5=__IDFA_MD5__&model=__MODEL__&make=__MAKE__&brand=__BRAND__&mac=__MAC__&macmd5=__MAC_MD5__&ip=__IP__&ip6=__IPV6__&appb=__APP_BUNDLE__&appv=__APP_VERSION__&bidcpc=__BID_CPC__&cpc=__CPC__&ua=__UA__

点击监测

点击 CPM 成交模式

https://api.mobrtb.com/tracker/adx?et=8&mid=__XYMID__&advid=__XYADVID__&mrid=__REQUESTID__&auid=__AD_UNIT_ID__&os=__OS__&osv=__OS_VERSION__&imei=__IMEI__&imeimd5=__IMEI_MD5__&oaid=__OAID__&oaidmd5=__OAID_MD5__&androidid=__ANDROID_ID__&androididmd5=__ANDROID_ID_MD5__&gaid=__GAID__&gaidmd5=__GAID_MD5__&caid=__CAID__&caidmd5=__CAID_MD5__&caidv=__CAID_VERSION__&caid2=__CAID2__&caid2md5=__CAID2_MD5__&caid2v=__CAID2_VERSION__&idfa=__IDFA__&idfamd5=__IDFA_MD5__&model=__MODEL__&make=__MAKE__&brand=__BRAND__&mac=__MAC__&macmd5=__MAC_MD5__&ip=__IP__&ip6=__IPV6__&appb=__APP_BUNDLE__&appv=__APP_VERSION__&bidcpm=__BID_CPM__&cpm=__CPM__&ua=__UA__

点击 CPC 成交模式

https://api.mobrtb.com/tracker/adx?et=8&mid=__XYMID__&advid=__XYADVID__&mrid=__REQUESTID__&auid=__AD_UNIT_ID__&os=__OS__&osv=__OS_VERSION__&imei=__IMEI__&imeimd5=__IMEI_MD5__&oaid=__OAID__&oaidmd5=__OAID_MD5__&androidid=__ANDROID_ID__&androididmd5=__ANDROID_ID_MD5__&gaid=__GAID__&gaidmd5=__GAID_MD5__&caid=__CAID__&caidmd5=__CAID_MD5__&caidv=__CAID_VERSION__&caid2=__CAID2__&caid2md5=__CAID2_MD5__&caid2v=__CAID2_VERSION__&idfa=__IDFA__&idfamd5=__IDFA_MD5__&model=__MODEL__&make=__MAKE__&brand=__BRAND__&mac=__MAC__&macmd5=__MAC_MD5__&ip=__IP__&ip6=__IPV6__&appb=__APP_BUNDLE__&appv=__APP_VERSION__&bidcpc=__BID_CPC__&cpc=__CPC__&ua=__UA__

回传监测

https://api.mobrtb.com/tracker/adx?et=24&mid=__XYMID__&advid=__XYADVID__&mrid=__REQUESTID__&auid=__AD_UNIT_ID__&os=__OS__&osv=__OS_VERSION__&imei=__IMEI__&imeimd5=__IMEI_MD5__&oaid=__OAID__&oaidmd5=__OAID_MD5__&androidid=__ANDROID_ID__&androididmd5=__ANDROID_ID_MD5__&gaid=__GAID__&gaidmd5=__GAID_MD5__&caid=__CAID__&caidmd5=__CAID_MD5__&caidv=__CAID_VERSION__&caid2=__CAID2__&caid2md5=__CAID2_MD5__&caid2v=__CAID2_VERSION__&idfa=__IDFA__&idfamd5=__IDFA_MD5__&model=__MODEL__&make=__MAKE__&brand=__BRAND__&mac=__MAC__&macmd5=__MAC_MD5__&ip=__IP__&ip6=__IPV6__&appb=__APP_BUNDLE__&appv=__APP_VERSION__&cb=__CALLBACK__&ua=__UA__

宏参数

对于渠道不支持的宏，可以移除对应参数，或将宏替换为空值。

宏名称是否必须描述
__XYMID__是对接时新义分配
__XYADVID__是对接时新义分配
__REQUESTID__是请求 ID
__AD_UNIT_ID__否媒体广告位 ID
__OS__否系统类型：0 Android、1 iOS
__OS_VERSION__否系统版本
__IMEI__否IMEI 明文
__IMEI_MD5__否IMEI MD5
__OAID__否OAID 明文
__OAID_MD5__否OAID MD5
__ANDROID_ID__否Android ID 明文
__ANDROID_ID_MD5__否Android ID MD5
__GAID__否GAID 明文
__GAID_MD5__否GAID MD5
__CAID__否CAID 明文
__CAID_MD5__否CAID MD5
__CAID_VERSION__否CAID 版本
__CAID2__否CAID2 明文
__CAID2_MD5__否CAID2 MD5
__CAID2_VERSION__否CAID2 版本
__IDFA__否IDFA 明文
__IDFA_MD5__否IDFA MD5
__MODEL__否设备型号
__MAKE__否设备制造商
__BRAND__否设备品牌
__MAC__否MAC 地址明文
__MAC_MD5__否MAC 地址 MD5
__IP__否IPv4 地址
__IPV6__否IPv6 地址
__UA__否User-Agent
__APP_BUNDLE__否媒体应用包名
__APP_VERSION__否媒体应用版本
__BID_CPM__否广告主 CPM 出价，单位为分
__CPM__CPM 成交模式必填CPM 成交价，单位为分
__BID_CPC__否广告主 CPC 出价，单位为分
__CPC__CPC 成交模式必填CPC 成交价，单位为分
__CALLBACK__使用 callback_url 时必填按本文算法加密后的 callback_url

价格加解密算法

四个价格宏使用相同的价格加解密算法。

价格支持明文，也可以使用以下任一种加密方式。正式密钥由新义在对接时单独提供。

AES

  • 加密算法：AES/ECB/PKCS5Padding
  • 输出编码：Base64 Raw URL-safe，不包含末尾 =
测试密钥加密原值加密值
123456789abcdefghijklmnopqrstuvw100agFVCc6ZpMRQGW8-mUtzRA
123456789abcdefghijklmnopqrstuvw5008RNzQbVj6VvMOa_hRuzy3w
123456789abcdefghijklmnopqrstuvw1001Kiiv5UTOxlVha19mPlKT6g

Google DoubleClick

测试 e_key测试 i_key加密原值加密值
8f1dd415a672c54c1dd295201cb6334a0a4b74ad404e5c8ba961ec009af01c5d100AAABh3NrNQsW6ra4kzTreGXOUjS-qtQVwK7w-w
8f1dd415a672c54c1dd295201cb6334a0a4b74ad404e5c8ba961ec009af01c5d500AAABh3NrNQtTzyTNN1G42Wbwpreesy63ZPSUOQ
8f1dd415a672c54c1dd295201cb6334a0a4b74ad404e5c8ba961ec009af01c5d1001AAABh3NrNQtJm4-5rwyTYPED8M4B_TIERhj7Jw

DoubleClick 算法的 IV 包含时间戳和随机数，因此同一原值每次加密结果可能不同。对接验证以密文能正确解密为原值为准。

callback_url 加解密算法

  • 加密算法：AES/ECB/PKCS5Padding
  • 输出编码：Base64 Raw URL-safe，不包含末尾 =
  • AES 密钥支持 16、24 或 32 字节；正式密钥由新义在对接时单独提供
  • __CALLBACK__ 应替换为加密后的 callback_url；新义解密后向该地址发起回传请求
测试密钥加密原值加密值
0123456789abcdef0123456789abcdefhttps://example.com/callback?source=adxsMJ_lY9yQoK4kb6YfGJ1J4S1ztRcqhd4L1TfRiRwUEvIoBKEgWExyUfxMXQm7E5A