对接 AppsFlyer API 教程
XMP 对接了 AppsFlyer 的 Cohort API 和 Master API，支持将 AppsFlyer 数据接入并呈现在 XMP 报表中，可以同时在一个报表内查看广告平台侧和 MMP 侧的数据，数据支持 Campaign、Ad Set、Ad 等多个维度的数据，可轻松依据 ROI 进行广告优化决策。
一、授权平台
1.在 管理 > 平台管理 > 添加平台 中添加 AppsFlyer 账号
2.选择 归因平台 > AppsFlyer，输入账户名称和 API Token v2.0
✍️注意事项
1. API Token v2.0 是对应Cohort API和Master API的权限。可以在 AppsFlyer 我的套餐页面上，检查功能列表中是否包含对应 API 权限。如若没有此权限，可以跟 AppsFlyer 对接人沟通，或者使用 Postback 方式进行对接（Postback 方式涉及额外技术开发和数据储存成本，属于加购功能，有需要请联系您的运营经理）；
2. 账户名称是用来标识 AppsFlyer 的账号，可以使用 AppsFlyer 后台的名称，也可以自定义命名；
3. 数据的时区采用的是应用在 Appsflyer 上设置的时区；
AppsFlyer 的 API Token 需广告主管理员账号才可查看。 关于获取 API Token 的详细步骤，点击查看：如何在 AppsFlyer 后台找到 API Token
3. 保存信息并完成授权
二、绑定应用
1. 进入 管理 > 平台管理 > 应用绑定 页面
2. 单击【选择应用】，在弹出的对话框中选择需要绑定的一个或多个应用，绑定平台选择 AppsFlyer，选择需要绑定的 AppsFlyer 账号，安卓应用的输入应用的包名 ，iOS 应用输入商店 ID，如id387683439；
3. 选择每个应用的群组类型，然后点击“确定”提交。
✍️字段说明----群组类型
统一：包含拉新以及拉活的全部数据
再营销：仅拉活的数据
用户获取：仅包含拉新的用户数据
若在选择应用时，下拉列表无可选应用。则需先将产品授权给XMP，可在管理-产品管理页面添加产品。具体操作步骤可点此参考“产品管理”文档
三、添加自定义事件
此步骤不是必填项，如果有自定义事件需要查看，则需完成配置；配置步骤如下：
1. 进入管理 > 平台管理 >应用绑定页面，支持单个或批量管理自定义事件，如下图点击 事件管理的功能入口
2. 选择配置方式，填写需要拉取的自定义事件名称；事件名称需与 Appsflyer 后台完全一致，否则无法拉取；
3. 设置拉取首日数据以及SKAN 数据参数，点击“确定”提交。
✍️字段说明----拉取首日数据，拉取SKAN数据
拉取首日数据：勾选此项后支持查看该事件的首日用户数，首日次数，首日收入等指标；否则只能查看累计用户数，累计次数等
拉取SKAN数据：勾选此项后支持查看事件的次数 (SKAN)、收入 (SKAN) 等SKAN指标
四、查看数据
1. 完成以上步骤后，2 ~ 3小时可查看数据
2. 受三方API更新频率限制，Day N留存、收入等用户生命周期数据需要2-3天后才能与三方后台对齐
3. XMP拉取的事件指标统计口径与三方后台的群组报表一致，即用户自激活后的事件发生数据
4. 查看数据的位置：推广 / 看板 / 流量池等 > 自定义列 > AppsFlyer
五、常见问题及解答
Q：API Token v2.0 提示校验失败是什么原因
A：API Token v2.0 是对应 Cohort API 和 Master API 的权限。可以在 AppsFlyer 我的套餐页面上，检查功能列表中是否包含对应 API 权限。如若没有此权限，可以跟 AppsFlyer 对接人沟通，或者使用 Postback 方式进行对接（Postback 方式涉及额外技术开发和数据储存成本，属于加购功能，有需要请联系您的运营经理）
Q：XMP 对接的是 AppsFlyer 的哪个API
A：XMP 已经对接了 AppsFlyer 的 Cohort API 和 Master API，通过 Cohort API 拉取收益相关的数据，关联 XMP 上的 ROAS, LTV 等指标；通过 Master API 拉取的是基础数据和自定义事件，如展点消等
Q：部分产品缺少三方数据
A：每个 APP 都需要在 XMP 上进行应用绑定，才能查看回收数据。请确认这款产品是否在 XMP 完成了上文第二步的绑定应用步骤。
Q：没有自定义事件
A：请确认是否添加了自定义事件，以及事件的名称是否跟 AppsFlyer 上完全一致。可参考本文第三步
Q：数据更新频率是怎样的
A：XMP 会每小时更新一次 AppsFlyer 的数据，API 本身和 AppsFlyer 后台更新频率不一致，一般来说，Master API 基本是次日下午3点左右才会更新完整的昨日数据，延迟度高。Cohort API 数据更新较快，所以基础数据和自定义事件延迟较高（从 Master API 获取），而XMP 上 AppsFlyer的 ROAS 数据（从Cohort API获取）与 AppsFlyer 差异不大
Q：为什么和AppsFlyer 数据对不上
A：XMP 拉取的是 AppsFlyer 上同期群报表，确认是否校对的是 AppsFlyer 上的此报表
;}.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)