用途:通过内置只读命令行脚本查询 AppsFlyer Master API 与 Aggregate Pull API 报表,适合需要拉取活动 KPI、数据新鲜度、合作伙伴、每日和地理聚合数据的场景。
主要能力:master-last-update 检查 Master 数据新鲜度;master-report 获取 Master 报表,支持分组、KPI 和以 calculated_kpi_ 开头的计算 KPI;pull 获取 Aggregate Pull 报表,支持 partners、partners-daily、daily、geo、geo-daily。
使用方式:需 Python 3.9 或更高版本,并在环境变量中设置 APPSFLYER_API_TOKEN,且账号需具备所请求报表和 App 的订阅权限。统一使用 scripts/appsflyer_reporting.sh,不要自行拼接 AppsFlyer URL。示例:bash <skill-path>/scripts/appsflyer_reporting.sh master-last-update;master-report 需提供 --app-id、--from、--to、--groupings、--kpis,可选 --format json 与 --calculated-kpi;pull 需提供 --report、--app-id、--from、--to,按报表类型补充参数。
限制:Master 报表最多覆盖 31 个自然日(含首尾),更长周期需分段运行;仅按日期分组的 Pull 报表(daily、partners-daily、geo-daily)可由脚本拆分合并,Master 及 partners、geo 分块不得自行合并。默认结果保存到 ./out/,路径打印到 stderr,仅在明确要求时用 --stdout 输出完整报表,--format json 仅在本地把 CSV 转为 JSON。401 视为凭证失效或被撤销,404 视为 App ID 无效或订阅功能不可用;429 与 5xx 按退避重试。不要打印、引用、保存或在命令行传入 token。