AppsFlyer Pull API

AppsFlyer Pull API 介绍

适用于 SA3.0.3 及以上版本

AppsFlyer Pull API 提供广告聚合数据，神策支持通过该接口拉取 Partner Daily 与 Geo Daily 数据。

接入说明

Partner Daily 与 Geo Daily 是 AppsFlyer 提供的两种类型的广告聚合数据。其中 Partner Daily 中包含广告 cost 数据，Geo Daily 中包含国家 / 地区信息，但不包含广告 cost 数据。详细信息可前往 AppsFlyer 官方文档查看：Pull API 汇总数据

通过配置 AppsFlyer Pull API 的数据拉取方案，神策可定期从 AppsFlyer 拉取广告平台的展点消聚合数据，将广告前链路数据与 App 内的用户行为数据一同进行分析。

接入前准备

调用 Pull API 接口需要通过 AppsFlyer 平台认证，请登录 AppsFlyer 后台，获取 API Token。

Token 获取路径：AppsFlyer 后台账号下拉 > 安全中心 > AppsFlyer Token

AppID 查看路径：AppsFlyer 后台 > 配置 > 我的应用 > AppID

方案配置

数据拉取方案以 App 为粒度，若客户有多个 App，需要针对每个 App 创建拉取方案

功能入口：渠道追踪 > 三方数据集成 > 选择 AppsFlyer Pull API 卡片 > 点击接入配置，进入方案列表页

创建方案时需要配置如下信息：

• 方案名称
• 生效状态：选择生效状态为开启或关闭，默认开启
•  数据拉取配置
  
  • 填写 API Token、APP ID，用于和 AppsFlyer 平台的鉴权
  • 选择拉取的数据类型：支持同时拉取 Partner Daily、Geo Daily 两种类型的数据
  • 定时拉取时间：
    • 默认在服务器时区下每 4 小时拉取过去 2 天数据，用户可配置拉取时间范围，最长可拉取过去10天的数据
    • 注：每次拉取均包含当天的数据
  •  数据统计时区：
    • 为了保证数据一致性，此处选择的时区需同 AppsFlyer 后台的设置的 APP 时区一致
  • 数据统计货币：
    • 为了保证数据一致性，此处选择的货币需同 AppsFlyer 后台的设置的 APP 货币一致
  •  进行连通性测试
    • 必须通过连通性测试，方可保存方案。在进行连通性测试时，系统会调用 Pull API 拉取 Partner Daily 与 Geo Daily 数据，调用成功和失败页面均会有提示
    • API Token、APP ID、拉取数据类型重新编辑后，需要进行连通性测试方可保存配置

方案保存成功后，查看页面能够看到数据入库说明、字段说明等信息，也可进行数据回溯操作。

数据回溯：最多可拉取过去任意时间长达 60 天的数据。请保持拉取时区、拉取货币与 AppsFlyer 后台一样。否则会造成数据不准确。

数据入库说明

Pull API 聚合接口获取到的数据，在神策平台进行入库时，将以事件方式入库。

• Partner Daily 的数据，事件入库名称为 mmp_af_aggregate_partner_daily，事件显示名称为 mmp_af_aggregate_partner_daily，显示名用户可于 数据接入 > 元数据管理 > 事件表 模块自行修改
• Geo Daily 的数据，事件入库名称为 mmp_af_aggregate_geo_daily，事件显示名称为 mmp_af_aggregate_geo_daily，显示名用户可自行修改
• 属性字段如下，入库后以 mmp_af 前缀标识

如何在分析模型中使用

通过 AppsFlyer Pull API 成功拉取数据后，可在事件分析、多维分析中，选择事件 mmp_af_aggregate_partner_daily，查看事件属性 mmp_af_partner_impressions、mmp_af_partner_clicks、mmp_af_partner_total_cost 的总和，以此分析广告的展示、点击、消费数据。

同时可添加 mmp_af_media_source、mmp_af_campaign 作为分组，分析不同媒体渠道、广告活动下的数据。