回传地址（Postback URL）
亦称回调地址（Callback URL），是三⽅或⼴告主在归因给 Mintegral 平台后，将转化相关数据通过指定参数传给 Mintegral 平台的⼀个链接地址。
一. 回传地址类型
Mintegral 平台回传地址有计费事件回调和非计费事件回调两种类型，可根据实际需求选择。
回调类型 | 请求方式 | 回调地址 | 描述 |
|---|---|---|---|
| 计费事件回调 | HTTP GET | http://postback.mintegral.net/install | 该地址回调的数据是广告主与Mintegral进行结算的依据，回调时机事件类型包括但不仅限于安装激活。 例如：在 App 安装激活并匹配归因后回传，⽤于统计 App 安装激活数据 |
| 非计费事件回调 | HTTP GET | http://postback.mintegral.net/event | 该地址回调的数据用于广告投放效果优化。在⽤户使⽤ App 触发特定事件并匹配归因后回传，⽤于统计 App 触发事件数据。⼀个回传地址只⽀持⼀个事件，可多次回传以便统计多个事件 |
二. 回传地址参数
| 参数 | 是否必传 | 描述 | 举例 |
|---|---|---|---|
| clickid | 是 | 点击id，是 Mintegral 平台定义的点击唯⼀标志 | mtg0a1b2c3d4e5f6g7h8i9j1x2y |
| campuuid | 是 | 广告单元id，是 Mintegral 平台定义的⼴告推⼴唯⼀标志 | game_ios_us_mtg |
| idfa | 特定场景必传 | 推⼴ iOS 应⽤时必传，Android 不传 | 3E0046F7-8BD4-4F3E-9F91-358B137D2BF0 |
| md5_idfa | 特定场景必传 | IDFA 原值进行 MD5 加密（32位小写）；推⼴ iOS 应⽤以 IDFA MD5 匹配归因时必传，Android不传 | 77d06cb28c1771e8019be4f4fb6e1938 |
| gaid | 特定场景必传 | 推⼴⾮中国地区 Android 应⽤时必传，iOS不传 | 7268ceb0-5411-4004-b7cb-bd1fee4b6277 |
| md5_gaid | 特定场景必传 | GAID 原值进行 MD5 加密（32位小写）；推⼴⾮中国地区 Android 应⽤时必传，iOS不传 | 7c687d7812ae6ca319aecea51d0d7750 |
| imei | 特定场景必传 | 推⼴中国地区 Android 应⽤时必传（Android 10以上获取不到IMEI可以不填），iOS不传 | 869634020728636 |
| md5_imei | 特定场景必传 | IMEI 原值进行 MD5 加密（32位小写）；推⼴ Android 应⽤以 IMEI MD5 匹配归因时必传（android10以上获取不到IMEI可以不传），iOS不传 | ed0427f06978ac06d73e2d6f2049aa9d |
| devid | 特定场景必传 | 推⼴ Android 应⽤以 Android ID 匹配归因时必传，iOS不传 | d0d4845ae4495a83 |
| md5_devid | 特定场景必传 | ANDROID ID 原值进行 MD5 加密（32位小写）；推⼴ Android 应⽤以 Android ID MD5 匹配归因时必传，iOS不传 | 1ebf70337adb6df4b70300edc27c24c8 |
| oaid | 特定场景必传 | 推广 Android 应用以 OAID 匹配归因时必传，iOS不传 | fdcfebbf-5ebb-4958-35fe-cbdf74fd2fb3 |
| md5_oaid | 特定场景必传 | OAID 原值进行 MD5 加密（32位小写）；推广 Android 应用以 OAID MD5 匹配归因时必传，iOS不传 | a27d1dda70b946cdb940ead82f01dd63 |
| mac | 特定场景必传 | 以 MAC 地址匹配归因时必传 | 10:2A:B3:D1:52:F4 |
| md5_mac | 特定场景必传 | MAC 原值进行 MD5 加密（32位小写）；以 MAC MD5 匹配归因时必传 | d53e994cce18ab87fdd25d155544532f |
| pl | 否 | 系统平台 | android |
| os | 否 | 系统版本 | 8.0.1 |
| device | 否 | 设备型号 | Mi-4c |
| ip | 否 | ⽤户 IP 地址 | 59.189.187.99 |
| country | 否 | ⽤户所在地区简码 | CN |
| app_version | 否 | 推⼴的应⽤版本 | 1.1.2 |
| type | 否 | 三⽅名称或⼴告主名称 | s2s |
| install_time | 是 | 计费转化事件触发时间戳，在回调所有事件（计费事件+非计费事件）时都必传，例如：安装激活时间戳 | 1486088825 |
| event_time | 是 | 非计费转化事件触发时间戳 | 1486088825 |
| event_name | 特定场景必传 | 事件类型，在调用非计费事件回调地址时必传，调用计费事件回调时选填 | 取值详见列表。如：Purchase |
| event_value | 特定场景必传 | 事件类型关联的数据值，在event_name为付费相关事件类型时必传（如event_name为purchase时），其他事件类型选填 | 1.90 |
| currency | 特定场景必传 | 货币类型，在event_name为付费相关事件类型时必传（如event_name为purchase时），其他事件类型选填。取值参⻅枚举说明 | USD |
三. 重要参数说明
1. event_name
说明：event_name指的是事件类型，是一个字符串类型枚举值。具体取值如下：
| 取值 | 事件名称 | 定义 |
|---|---|---|
| app_open | 激活APP | 用户下载安装完毕应用之后，打开应用 |
| reged | 注册 | 用户完成下载、安装并且打开应用后，完成注册账号信息提交 |
| login | 登录 | 用户完成下载、安装并且打开应用后，完成账号登录操作 |
| search | 搜索 | 用户完成下载、安装并且打开应用后，完成一次搜索操作 |
| content_view | 浏览 | 用户完成下载、安装并且打开应用后，完成一次浏览行为 |
| share | 分享 | 用户完成下载、安装并且打开应用后，完成一次分享操作 |
| purchase | 付费 | 用户完成下载、安装并且打开应用后，完成一笔付款行为 |
| first_purchase | 首次付费 | 用户完成下载、安装并且打开应用后，完成在该应用的第一次付费行为 |
| add_paymentinfo | 添加付款信息 | 用户完成添加付款信息操作，如选择选择付款方式/绑定付款方式等 |
| add_wish | 加入收藏夹 | 用户完成加入收藏夹/心愿单的操作 |
| add_Cart | 加入购入车 | 用户完成将商品加入购物车的操作 |
| fill_order | 填写订单 | 用户进行订单提交前，填写并提交订单信息的操作 |
| add_deliveryinfo | 添加快递信息 | 用户添加快递信息的操作，如收件人姓名/电话/地址等 |
| generate_lead | 带来潜力客户 | 用于在应用内提交用户信息等操作 |
| initiate_checkout | 退出登录 | 用户在应用内进行退出登录操作 |
| lv_complete_Xt | 游戏关卡 | 对于游戏类应用，用户完成下载、安装并且打开应用后，完成指定游戏关卡通关操作 |
| create_role | 创建游戏角色 | 对于游戏类应用，用户完成下载、安装并且打开应用后，完成创建游戏角色操作 |
| tutorial_begin | 进入新手指引 | 用户完成下载、安装并且打开应用后，完成进入新手指引操作 |
| tutorial_complete | 完成新手指引 | 用户完成下载、安装并且打开应用后，完成进入新手指引学习 |
| nextday | 次日留存 | 用户首日完成下载、安装并打开应用后，第二个自然日再次打开应用 |
| key_conversion | 关键行为 | 用户完成下载、安装并打开应用后，触发多重行为（自定义）后可被判定为高质量用户（主要用于IAA产品判断首日回收是否达标） |
注意：以上事件类型适⽤于 S2S 对接的⼴告主参考使用，三方平台广告主建议使用三方平台推荐使用的事件类型。
2. currency
说明：此枚举定义了支持的货币代码列表。每种货币代码代表一种特定的法定货币。
| 枚举值 | 描述 |
|---|---|
CNY | 人民币 - 中华人民共和国的法定货币 |
USD | 美元 - 美国的法定货币 |
EUR | 欧元 - 欧盟成员国的官方货币 |
JPY | 日元 - 日本的法定货币 |
GBP | 英镑 - 英国的法定货币 |
| ... | ... |
四. 回传地址配置⽅式
Mintegral 平台回传地址有多种配置⽅式，可根据实际需求选择。
配置⽅式 | 描述 | 示例 |
|---|---|---|
| 在追踪链接配置 | 适⽤于 S2S 对接和部分三⽅平台对接的⼴告主，通过协商在 追踪链接 上约定特定参数（如 install_callback 和 event_callback ）来接收追踪链接的宏参 {install_callback} 和 {event_callback}。在追踪上报时，展示点击监测链接会直接把计费事件回调接口和非计费事件回调接口的url生成出来一并上报给广告主，该url会包含回调地址中已知的参数值（如clickid、campuuid、设备号等信息）。广告主归因匹配成功后，可以调用url将转化相关数据回传给Mintegral 。 | 配置参考 追踪链接推荐示例 |
| 在⼴告主侧配置 | 适⽤于 S2S 对接的⼴告主 | 由⼴告主侧研发⼈员定义 |
| 在三⽅平台配置 | 适⽤于三⽅对接的⼴告主 | AppsFlyer、Adjust 等三⽅平台已经内置Mintegral 平台的回传地址，⽆需额外配置 |
五. 返回值
Http code 200 ，返回值如下：
| 回传类型 | 返回值格式 | 返回值说明 |
|---|---|---|
| 计费事件回调 | error值为0时，表示成功； error值不为0时，表示失败 | |
| 非计费事件回调 | 1. ret值为0时，表示成功； 2. ret值不为0时，表示失败 ，msg返回错误信息，错误信息枚举如下： （1）"Event Name Not Correct": 表示event_name参数不能为空 （2）"Campaign Not Correct": 表示uuid参数不能为空 （3）"Clickid Not Correct": 表示clickId参数格式不对 |