无论哪个广告平台,数据抓取整体可概括为以下两步:
- 申请接口;(访问令牌/密钥文件)
- 通过接口请求数据;
Facebook Ads
每个 BM 对应一个访问令牌,访问令牌由该 BM 下管理员权限的 system_user 生成,只要授权给该 system_user 的广告账户,其数据都可以通过该访问令牌请求。
接口申请方法
- 在 Facebook 开发者后台,创建一个
Business
类型的应用:- 方法见 Create an app ;
- 在 BM 创建一个管理员权限的
system_user
: - 将上述应用绑定至 BM,注意该 BM 需要作为该应用的所有者;
- 在 BM 中,使用 system_user 生成
access_token
即访问令牌,其中:- 点击
生成
按钮时,必须选择上述创建的那个应用; 勾选数据权限
时,必须至少包含以下两个权限:- ads_read
- ads_management
- 点击
- 只有已授权给 system_user 的广告账户,访问令牌才能访问到对应广告账户的数据;
- 每个 BM 对应一个访问令牌,有几个 BM 就需要申请几个访问令牌;
官方文档
- [Facebook] Marketing API
- [GitHub] Facebook Business SDK for Python
Google Ads
接口申请方法
见官方保姆级教程 Google Ads API快速上手指南 [2019]
官方文档
- [Google] Google Ads API
Apple Search Ads
接口申请方法
接口是物理的文件形式的密钥,见官方保姆级教程 Implementing OAuth for the Apple Search Ads API
官方文档
- [Apple] Apple Search Ads API
附:指标字典参考
编号 | 字段 | 定义 | 数据类型 | 数据来源 |
---|---|---|---|---|
1 | app_name | App标识 | varchar | 通过AdSet层级的AdPromotedObject对象的object_store_url或者application_id间接获得 |
2 | os_name | 设备类型,如android/ios | varchar | 同上 |
3 | store_type | 应用商店 | varchar | 同上 |
4 | media_source | 流量来源 | varchar | 通过 Token 配置进行判断 |
5 | account_id | 广告账户ID | varchar | API |
6 | account_name | 广告账户名称 | varchar | API |
7 | campaign_id | 广告推广计划ID | varchar | API |
8 | campaign_name | 广告推广计划名称 | varchar | API |
9 | date | 日期 | date | API |
10 | country | 国家,ISO 3166标准 | varchar | API |
11 | impressions | 广告展示量 | int | API |
12 | clicks | 广告点击量 | int | API |
13 | install | 广告安装量 | int | API |
14 | cost | 广告花费 | float | API |
15 | purchase_value | 广告带来的收入 | float | API |
16 | purchase | 付费次数 | int | API |
17 | purchase_unique | 付费人数 | int | API |
18 | optimizer | 优化师编号 | varchar | 通过正则 |
19 | data_source | 所属BM/MCC | varchar | 通过 Token 配置 |
20 | currency | 币种单位,需要统一为 USD | varchar | API |
21 | is_organic | 布尔值 | varchar | 通过映射配置 |
22 | attribution_setting | 归因窗口设置 | varchar | API |