追踪链接（Tracking URL）
一. 简介
亦称跟踪链接、监测链接，包括展示链接（Impression URL）和点击链接（Click URL），分别⽤于追踪⼴告曝光和点击情况。
1. 作用
广告主在创建广告单元/设置追踪链接的时候，需要填写“展示追踪链接”和“点击追踪链接”，广告主可以通过此链接来接收由 Mintegral 发出的点击或展示上报信息。通过约定指定格式的字符串，用以代表将来将要替换的字段位置，这个格式我们统称为“宏”。
2. 格式
追踪链接主要由"https://***.***.com?"+"参数"+其他部分组成。具体格式如下：
(1) 监测链接的前缀格式为： https://***.***.com?
(2) 宏“参数”的格式为“{参数}”，其中：
- 参数必须全部小写，Mintegral支持宏参数请见下方
- “{参数}” 格式中参数两边为花括号
- 广告主可以根据自己的需要选择具体填写哪些参数，支持宏参数详见参数列表
3. 举例
(1) 广告主填写在广告单元上的追踪链接如下：
https://***.***.com/xxx?campuuid={uuid}&clickid={click_id}&affiliate_id={affiliate_id}&idfa_md5={idfa_md5}&idfa={idfa}这里的 “{idfa}”，就是一个宏，代表将来真实的idfa字段值会在这里填写。
用户在流量媒体上浏览广告并真实产生了广告点击的时候，Mintegral 会把相应的宏字段换成真实的广告信息，发送给广告主。
(2) 广告主收到的真实请求：
https://***.***.com/xxx?campuuid=ss_game_ios_us_mtg&clickid=mtg0a1b2c3d4e5f6g7h8i9j1x2y&affiliate_id=mtg1234567890&idfa_md5=77d06cb28c1771e8019be4f4fb6e1938&idfa=3E0046F7-8BD4-4F3E-9F91-358B137D2BF0其中花括号的部分，就是Mintegral替换后的真实广告信息
4. 异步点击
异步点击是指点击监测链接仅⽀持接收数据上报，无法在接收到点击数据上报后通过302的方式重定向到应用的下载地址或者落地页。异步点击流程如下图所示，即当用户在客户端点击⼴告，会直接跳转到应⽤下载地址或落地⻚，同时 Mintegral 平台将收集到的用户点击数据通过服务端上报广告主，该点击上报方式常⻅于 S2S 对接。通过这种⽅式点击追踪的⼴告主，需要在 Mintegral 平台配置正确的应⽤下载地址或落地⻚地址。 
二. 请求结构
1. 通信协议
为了获得更高的安全性，推荐您使用HTTPS通道。
2. 请求方法
支持HTTP GET方法发送请求，这种方式下请求参数需要包含在请求的URL中。
3. 字符编码
UTF-8
4. 返回数据
收到展示点击数据上报后，请正确返回 Http code 200
三. 宏参数列表
宏是⼀种⽤于特殊替换的占位符，指代特定的数据信息，在 Mintegral 平台配置的追踪链接所使⽤的宏形式如 {xxx}。以下是 Mintegral 平台⽀持的追踪链接常⽤的占位符。
| 宏 | 是否必传 | 描述 | 举例 |
|---|---|---|---|
| {click_id} | 是 | 点击id，是 Mintegral 平台定义的点击唯⼀标志 | mtg0a1b2c3d4e5f6g7h8i9j1x2y |
| {uuid} | 是 | 广告单元id，是 Mintegral 平台定义的⼴告推⼴唯⼀标志 | ss_game_ios_us_mtg |
| {offer_name} | 否 | ⼴告单元名称 | game_ios_us_mtg |
| {adv_offer_id} | 否 | ⼴告单元 ID | 246913 |
| {adv_campaign_id} | 否 | 广告 ID | 76776 |
| {creative_id} | 否 | 素材 ID | 1234567890 |
| {creative_name} | 否 | 素材名称 | app_icon_512x512 |
| {affiliate_id} | 推荐 | Mintegral 平台⼦渠道 ID，传递此值有利于后续投放质量优化 | mtg1234567890 |
| {idfa} | 特定场景必传 | 推⼴ iOS 应⽤时必传，Android 不传 | 3E0046F7-8BD4-4F3E-9F91-358B137D2BF0 |
| {idfa_md5} | 特定场景必传 | IDFA 原值进行 MD5 加密（32 位⼩写）， 推⼴ iOS 应⽤以 IDFA MD5 匹配归因时必传 | 77d06cb28c1771e8019be4f4fb6e1938 |
| {gaid} | 特定场景必传 | 推⼴⾮中国地区 Android 应⽤时必传，iOS不传 | 7268ceb0-5411-4004-b7cb-bd1fee4b6277 |
| {gaid_md5} | 特定场景必传 | GAID 原值进行 MD5 加密（32 位⼩写），以 GAID MD5 匹配归因时必传 | 7c687d7812ae6ca319aecea51d0d7750 |
| {imei} | 特定场景必传 | 推⼴中国地区 Android 应⽤时必传，iOS 不传 | 869634020728636 |
| {imei_md5} | 特定场景必传 | IMEI 原值进行 MD5 加密（32 位⼩写），以 IMEI MD5 匹配归因时必传 | ed0427f06978ac06d73e2d6f2049aa9d |
| {android_id} | 特定场景必传 | 以 Android ID 匹配归因时必传 | d0d4845ae4495a83 |
| {android_id_md5} | 特定场景必传 | Android ID 原值进行 MD5 加密（32 位⼩写），以 Android ID MD5 匹配归因时必传 | 1ebf70337adb6df4b70300edc27c24c8 |
| {mac} | 特定场景必传 | 以 MAC 地址匹配归因时必传 | 10:2A:B3:D1:52:F4 |
| {mac_md5} | 特定场景必传 | MAC 原值进行 MD5 加密（32 位⼩写），以 MAC MD5 匹配归因时必传 | d53e994cce18ab87fdd25d155544532f |
| {oaid} | 特定场景必传 | Android OAID，可⽤于 Android10 及以上版本 IMEI 的替代 特殊场景：指推⼴中国地区 Android 应⽤时必传，iOS 不传 | fdcfebbf-5ebb-4958-35fe-cbdf74fd2fb3 |
| {oaid_md5} | 特定场景必传 | OAID 原值进行 MD5 加密(32位小写)，以 OAID MD5 匹配归因时必传 | a27d1dda70b946cdb940ead82f01dd63 |
| {ua} | 特定场景必传 | UA即用户代理(User Agent)， 主要⽤于获取操作系统及版本、CPU类型、浏览器及版本、浏览器渲染引擎、浏览器语言、浏览器插件等设备信息。 以 IP + UA 匹配归因时必传。 | Mozilla/5.0 (Linux;Android 7.0; Mi-4cBuild/NRD90M; wv)AppleWebKit/537.36(KHTML, like Gecko)Version0 Chrome/79.0.3945.116 MobileSafari/537.36Mb2345Browser/12.0.1oem |
| {ip} | 特定场景必传 | 以 IP + UA 匹配归因时必传 | 59.189.187.99 |
| {os_platform} | 否 | 从设备 UA 获取的系统平台 | Android |
| {os_version} | 否 | 从设备 UA 获取的系统版本 | 7.0 |
| {device_model} | 否 | 从设备 UA 获取的设备型号 | Mi-4c |
| {install_callback} | 否 | 直接把 计费事件回调 接口的url生成出来，广告主归因匹配成功后，可以调用该Url将转化相关数据回传给Mintegral （注意：示例为url encode编码原值，广告主需要decode作为get请求url回传至Mintegral，发起调用前需在该URL上加上install_time、event_time等必要参数，详见 回传地址参数说明 ） | http%3A%2F%2Fpostback.mintegral.net%2Finstall%3Fcampuuid%3Dss_ios_offer_test_0616%26clickid%3Dmtg62a1d773bf6b500f9d1c5c8y%26type%3Ds2s%26md5_idfa%3D%26gaid%3D%26md5_gaid%3D%26imei%3D%26md5_imei%3D%26mac%3D%26md5_mac%3D%26oaid%3D%26md5_oaid%3D%26pl%3Dios%26os%3D8.0.1%26idfa%3D3E0046F7-8BD4-4F3E-9F91-358B137D2BF0 |
| {event_callback} | 否 | 直接把 非计费事件回调 接口的url生成出来，广告主归因匹配成功后，可以调用该Url将转化相关数据回传给Mintegral （注意：示例为url encode编码原值，广告主需要decode作为get请求url回传至Mintegral，发起调用前需在该URL上加上event_time、event_time、event_name、event_value等必要参数，详见 回传地址参数说明 ） | http%3A%2F%2Fpostback.mintegral.net%2Fevent%3Fcampuuid%3Dss_ios_offer_test_0616%26clickid%3Dmtg62a1d773bf6b500f9d1c5c8y%26type%3Ds2s%26md5_idfa%3D%26gaid%3D%26md5_gaid%3D%26imei%3D%26md5_imei%3D%26mac%3D%26md5_mac%3D%26oaid%3D%26md5_oaid%3D%26pl%3Dios%26os%3D8.0.1%26idfa%3D3E0046F7-8BD4-4F3E-9F91-358B137D2BF0 |
| 注意： |
- {install_callback}和{event_callback}服务器下发的是 url encode编码原值，直接摘取该字段内容。自归因数据上报时，将callback进行一次 url decode操作后作为 get 请求 url 回传至 Mintegral。
- 存在有些http库会自动进行一次url decode，故在回传数据的时候无需再操作一次decode编译，否则将报错。
四. 追踪链接推荐示例
- 推广 iOS 应用监测链接示例：
- 示例一：
- 示例二（ S2S 自归因推荐使用）：
- 推广中国地区 Android 应用监测链接示例：
- 示例一：
- 示例二（ S2S 自归因推荐使用）：
- 推广非中国地区 Android 应用监测链接示例：
- 示例一：
- 示例二（ S2S 自归因推荐使用）：