请输入
菜单
自有归因对接文档
XMP 支持将客户自有数据以Postback 方式传给XMP，支持实时查看相关数据，包括 ROI、LTV、ROAS、留存等，并支持将归因数据&投放数据整合至同一报表查看。
此功能是高级付费功能，使用前请联系您的商务/运营经理确认对接方案。
XMP Postback地址
XMP的Postback地址：https://xmp-postback.mobvista.com/s2s/postback
用户向XMP Postback地址回传数据，Get方式请求
参数设置
需要回传的参数如下：
| 参数名 | 类型 | 是否必传 | 含义 |
| channel | string | 是 | 渠道来源， 见下表枚举值，请按规范传值否则无法匹配数据 |
| campaign_id | string | 是 | 广告系列 ID |
| adset_id | string | 是 | 广告组 ID |
| ad_id | string | 是 | 广告 ID |
| country | string | 是 | 国家码，两位大写的英文字母，如 CN、US。如无法确定地区，传空 |
| subsource_id | string | 否 | 子渠道 ID |
| activity_kind | string | 是 | Postback事件类型 安装：install 应用内事件：in-app-event |
| event_name | string | 否 | 事件的名称 |
| event_count | int | 否 | 事件的次数。该字段有传时，event_name必传 |
| event_value | numeric | 否 | 事件的数值，最多6位小数。该字段有传时，event_name必传 |
| event_unique_users | int | 否 | 事件的用户数。该字段有传时，event_name必传 |
| event_revenue_usd | numeric | 否 | 事件的美元收入金额，最多6位小数。该字段有传时，event_name必传 |
| event_time | int | 是 | 事件发生时间的秒时间戳，如1687881600 |
| active_time | int | 是 | 归因时间的秒时间戳，将事件归因到用户激活时间，必须在最近90天以内。如1687881600，该字段如不传，则无法匹配数据 |
| timezone | string | 否 | 数据时区， 见下表枚举值。若需要查看不同时区数据，请先联系您的运营经理开通权限 |
| request_id | string | 否 | 建议传，每一条数据的唯一标识，用于数据排重和修正，只去重最近14天内接收的数据。该id由请求方生成并保证唯一性，XMP将按request_id先排重取最新接收的记录后再汇总数据。如不传，则XMP直接汇总数据 |
| app_id | string | 是 | iOS格式：以id开头，如 id123456789；安卓格式：如 com.app.game |
| idfa | string | 是 | iOS 设备ID |
| idfa_md5 | string | 是 | iOS 设备ID-md5 |
| idfv | string | 是 | iOS 设备ID |
| gaid | string | 是 | 安卓设备ID |
| oaid | string | 是 | 安卓设备ID |
| oaid_md5 | string | 是 | 安卓设备ID-md5 |
| android_id | string | 是 | 安卓设备ID（原值） |
| android_id_md5 | string | 是 | 安卓设备ID（原值）-md5 |
| imei | string | 是 | 设备ID（原值） |
| mac | string | 是 | 设备ID（原值） |
| ip | string | 否 | 激活时的IP地址 |
| customer_user_id | string | 否 | 自定义用户id |
| customer_order_id | string | 否 | 自定义订单id |
渠道来源
| 渠道名称 | 枚举值 |
| Organic | organic |
| TikTok | tiktok |
| 快手（海外） | kwai |
| 华为（海外） | huawei_global |
| 苹果ASA | apple |
| Mintegral | mintegral |
| Applovin | applovin |
| Unity | unity |
| ironSource | ironsource |
| Vungle | vungle |
数据时区
| 时区 | 枚举值 | 时区 | 枚举值 |
| 0时区 | UTC+0 | - | - |
| +1时区 | UTC+1 | -1时区 | UTC-1 |
| +2时区 | UTC+2 | -2时区 | UTC-2 |
| +3时区 | UTC+3 | -3时区 | UTC-3 |
| +4时区 | UTC+4 | -4时区 | UTC-4 |
| +5时区 | UTC+5 | -5时区 | UTC-5 |
| +6时区 | UTC+6 | -6时区 | UTC-6 |
| +7时区 | UTC+7 | -7时区 | UTC-7 |
| +8时区 | UTC+8 | -8时区 | UTC-8 |
| +9时区 | UTC+9 | -9时区 | UTC-9 |
| +10时区 | UTC+10 | -10时区 | UTC-10 |
| +11时区 | UTC+11 | -11时区 | UTC-11 |
| +12时区 | UTC+12 | -12时区 | UTC-12 |
页面配置
一、授权平台
1.在 管理 > 平台管理 > 添加平台 中添加 自建归因 账号。
2.选择 归因平台 > 自建归因，输入账户名称。
二、绑定应用
1. 进入 管理 > 平台管理 > 应用绑定 页面
2. 单击【选择应用】，在弹出的对话框中选择需要绑定的一个或多个应用，绑定平台选择 自建归因，选择需要绑定的 自建归因 账号，安卓应用的输入应用的包名 ，iOS 应用输入商店 ID，如id387683439；点击确定提交。
三、事件管理
👇此步骤不完成则无法查看Roas、用户收入、留存等相关指标。
1. 进入管理 > 平台管理 >应用绑定页面，支持单个或批量管理自定义事件，如下图点击 事件管理的功能入口
2. 填写自归因统计为Revenue和留存的事件名称。
查看数据
1. 完成以上步骤后，1~2小时可查看数据
2. 查看数据的位置：推广 / 看板 / 流量池等 > 自定义列 > S2S
说明
•为提交数据时效性，建议实时上报数据到XMP侧
•为提高数据完整性，建议上报数据失败后，在一分钟内最多重试2次
•当天最新的报表数据每3小时更新一次
•此功能是高级付费功能，使用前请联系您的商务/运营经理
上一个
自有归因数据
下一个
自建归因数据接入说明文档（v2版本）
最近修改: 2025-07-01Powered by;}.cls-2{fill:%230868f7;}.cls-3{fill:url(%23未命名的渐变_44);}.cls-4{fill:%23333;}%3c/style%3e%3clinearGradient%20id='未命名的渐变_8'%20x1='33.73'%20y1='100.61'%20x2='-0.03'%20y2='-1.06'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20offset='0'%20stop-color='%237ae9fb'/%3e%3cstop%20offset='0.67'%20stop-color='%232b90f8'/%3e%3cstop%20offset='1'%20stop-color='%230868f7'/%3e%3c/linearGradient%3e%3clinearGradient%20id='未命名的渐变_44'%20x1='27.86'%20y1='18.67'%20x2='68.36'%20y2='22.22'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20offset='0'%20stop-color='%235ac7f2'/%3e%3cstop%20offset='1'%20stop-color='%230868f7'/%3e%3c/linearGradient%3e%3c/defs%3e%3cpath%20class='cls-1'%20d='M29,28.74V81.91l-9.51-3.68v0L8.52,74A7.17,7.17,0,0,1,4,67.32V24.54A3.76,3.76,0,0,1,9.08,21Z'/%3e%3cpath%20class='cls-2'%20d='M68.09,78.07a13.15,13.15,0,0,1-17.9,12.06L29,81.91h0V28.74L50.19,37A13.17,13.17,0,0,0,68.08,25.3h0Z'/%3e%3cpath%20class='cls-3'%20d='M68.08,25.3a13.19,13.19,0,0,1-6.73,10.87A13.09,13.09,0,0,1,50.19,37L29,28.74V6A3.76,3.76,0,0,1,34.1,2.52l25.59,9.91A13.22,13.22,0,0,1,68.08,25.3Z'/%3e%3cpath%20class='cls-4'%20d='M129.06,81.76a4.33,4.33,0,0,1-3.19-1.31,4.4,4.4,0,0,1-1.31-3.24V56.86H97.65V77.21a4.36,4.36,0,0,1-1.35,3.2A4.68,4.68,0,0,1,93,81.76a4.32,4.32,0,0,1-3.19-1.31,4.37,4.37,0,0,1-1.32-3.24V27.27A4.58,4.58,0,0,1,89.83,24a4.59,4.59,0,0,1,7.82,3.27V48.15h26.91V27.27A4.58,4.58,0,0,1,125.91,24a4.59,4.59,0,0,1,7.82,3.27V77.21a4.37,4.37,0,0,1-1.36,3.2A4.65,4.65,0,0,1,129.06,81.76Z'/%3e%3cpath%20class='cls-4'%20d='M163.77,81.66c-6.57,0-11.76-1.92-15.44-5.7s-5.54-9.07-5.54-15.74a26.76,26.76,0,0,1,2.09-10.43,17.72,17.72,0,0,1,6.67-8.06,19.15,19.15,0,0,1,10.68-2.95,19,19,0,0,1,10.46,2.8,18.7,18.7,0,0,1,6.55,7.36,22.53,22.53,0,0,1,2.36,10.28A4.51,4.51,0,0,1,177,63.77H152.23a10.8,10.8,0,0,0,3.49,6.65c2,1.68,4.88,2.52,8.66,2.52a22.25,22.25,0,0,0,7.54-1.21c.74-.3,1.55-.67,2.37-1.07a3.75,3.75,0,0,1,1.84-.4,4.09,4.09,0,0,1,3,1.15,4,4,0,0,1,1.12,3,4.38,4.38,0,0,1-2.58,3.82,32.34,32.34,0,0,1-6.36,2.61A28.67,28.67,0,0,1,163.77,81.66ZM172.4,55.9a9.72,9.72,0,0,0-1.63-4.56A9.9,9.9,0,0,0,167,48a10.38,10.38,0,0,0-4.64-1.14,12,12,0,0,0-4.77,1.06,9.54,9.54,0,0,0-4.89,5.66,11.78,11.78,0,0,0-.51,2.3Z'/%3e%3cpath%20class='cls-4'%20d='M193,81.64a4.49,4.49,0,0,1-4.51-4.55V27.28A4.58,4.58,0,0,1,189.84,24a4.48,4.48,0,0,1,3.28-1.36A4.36,4.36,0,0,1,196.35,24a4.46,4.46,0,0,1,1.31,3.31V77.09a4.34,4.34,0,0,1-1.35,3.2A4.67,4.67,0,0,1,193,81.64Z'/%3e%3cpath%20class='cls-4'%20d='M263.79,81.71a5.7,5.7,0,0,1-4.2-1.74,5.76,5.76,0,0,1-1.73-4.19V27.37a4.58,4.58,0,0,1,1.35-3.27A4.59,4.59,0,0,1,267,27.37V72.53h24a4.58,4.58,0,0,1,3.27,7.82A4.66,4.66,0,0,1,291,81.71Z'/%3e%3cpath%20class='cls-4'%20d='M424.48,81.74a4.71,4.71,0,0,1-2.71-.88,5.43,5.43,0,0,1-1-1l-.07-.09-12.41-17-5.41,5v9.44a4.31,4.31,0,0,1-1.36,3.19,4.66,4.66,0,0,1-3.3,1.36A4.29,4.29,0,0,1,395,80.42a4.36,4.36,0,0,1-1.32-3.23V27.37A4.58,4.58,0,0,1,395,24.1a4.52,4.52,0,0,1,6.58.12,4.54,4.54,0,0,1,1.24,3.15V56.31l17.72-16.38.05,0a4.8,4.8,0,0,1,2.94-1.11,4.4,4.4,0,0,1,3.27,1.2,4.57,4.57,0,0,1,1.2,3.27,4.44,4.44,0,0,1-.77,2.33,7.45,7.45,0,0,1-1.43,1.65l-11,9.64,13.34,17.68a5,5,0,0,1,1,2.71,4.12,4.12,0,0,1-1.36,3.24A4.64,4.64,0,0,1,424.48,81.74Z'/%3e%3cpath%20class='cls-4'%20d='M317.93,81.76a21.5,21.5,0,1,1,21.17-21.5A21.37,21.37,0,0,1,317.93,81.76Zm0-34.1a12.61,12.61,0,1,0,12.42,12.6A12.52,12.52,0,0,0,317.93,47.66Z'/%3e%3cpath%20class='cls-4'%20d='M212.18,101.22a4.12,4.12,0,0,1-3.05-1.26,4.17,4.17,0,0,1-1.26-3.1V43.34a4.37,4.37,0,0,1,1.3-3.14,4.26,4.26,0,0,1,3.13-1.3,4.19,4.19,0,0,1,3.1,1.26,4.32,4.32,0,0,1,1.26,3.16,20.77,20.77,0,0,1,13-4.54,21.51,21.51,0,0,1,0,43,20.51,20.51,0,0,1-13-4.57V96.86a4.15,4.15,0,0,1-1.3,3.06A4.5,4.5,0,0,1,212.18,101.22Zm17.43-53.63c-6.23,0-12.93,4.11-12.93,12.72a12.73,12.73,0,0,0,25.46,0A12.71,12.71,0,0,0,229.61,47.59Z'/%3e%3cpath%20class='cls-4'%20d='M365.76,81.76a21.5,21.5,0,1,1,21.18-21.5A21.37,21.37,0,0,1,365.76,81.76Zm0-34.1a12.61,12.61,0,1,0,12.42,12.6A12.52,12.52,0,0,0,365.76,47.66Z'/%3e%3c/svg%3e)
大纲