admob广告开发者报表api

广告是移动应用非常好的变现模式&＃xff0c;作为开发者经常会接很多家的广告平台&＃xff0c;每个广告平台都有自己的报表系统&＃xff0c;就会有一个各个平台数据汇总分析的需求&＃xff0c;首先第一步就需要从各个广告平台获取数据&＃xff0c;除了在web页面提供基本的数据导出功能&＃xff0c;基本上各个平台都会提供 api 来方便数据拉取的自动化。

admob 是 google 的移动开发者广告平台&＃xff0c;同样也提供了完备的 api 来获取报表数据

创建 API 凭证

报表 api 使用 oauth 2.0 授权&＃xff0c;需要先开通云平台账号&＃xff0c;需要填一下账单信息。开通账号后&＃xff0c;在平台上创建一个 oauth 2.0 的凭证

google oauth 授权

创建完成后&＃xff0c;下载JSON 秘钥文件&＃xff0c;保存为 client_secrets.json

使用 google api 的 python 库

sudo pip3 install google-api-python-client sudo pip3 install oauth2client

初始化服务

from apiclient import sample_toolsscope &＃61; [&＃39;https://www.googleapis.com/auth/adsense.readonly&＃39;] client_secrets_file &＃61; &＃39;client_secrets.json&＃39;service, _ &＃61; sample_tools.init(&＃39;&＃39;, &＃39;adsense&＃39;, &＃39;v1.4&＃39;, __doc__,client_secrets_file,parents&＃61;[], scope&＃61;scope )

调用服务 api

results &＃61; service.accounts().reports().generate(accountId&＃61;&＃39;pub-131xxxxxxxxxxxxx&＃39;,startDate&＃61;start.strftime(&＃39;%Y-%m-%d&＃39;),endDate&＃61;end.strftime(&＃39;%Y-%m-%d&＃39;),metric&＃61;metric,dimension&＃61;dimension,useTimezoneReporting&＃61;True, ).execute()

accountId: 在 admob 平台的首页上 https://apps.admob.com/v2/home 点击自己的头像&＃xff0c; 发布商 ID 就是 accountId
metric: 指标项&＃xff0c;点击、展示、收入等
dimension: 维度&＃xff0c;日期、app、广告位、国家等
startDate: 开始日期&＃xff0c;yyyy-mm-dd 格式
endDate: 结束时间&＃xff0c;yyyy-mm-dd 格式
useTimezoneReporting: 使用账户所在的时区

参考代码

代码依赖了一个 client_secrets.json 的授权文件

import json import datetime import argparse from apiclient import sample_toolsdef collect(start&＃61;None, end&＃61;None):if not start:start &＃61; datetime.datetime.now() - datetime.timedelta(days&＃61;1)if not end:end &＃61; startscope &＃61; [&＃39;https://www.googleapis.com/auth/adsense.readonly&＃39;]client_secrets_file &＃61; &＃39;client_secrets.json&＃39;service, _ &＃61; sample_tools.init(&＃39;&＃39;, &＃39;adsense&＃39;, &＃39;v1.4&＃39;, __doc__,client_secrets_file,parents&＃61;[], scope&＃61;scope)dimension &＃61; ["DATE", "APP_NAME", "APP_PLATFORM", "AD_UNIT_NAME", "AD_UNIT_ID", "COUNTRY_CODE"]metric &＃61; ["AD_REQUESTS", "CLICKS", "INDIVIDUAL_AD_IMPRESSIONS", "EARNINGS", "REACHED_AD_REQUESTS_SHOW_RATE"]results &＃61; service.accounts().reports().generate(accountId&＃61;&＃39;pub-131xxxxxxxxxxxxx&＃39;,startDate&＃61;start.strftime(&＃39;%Y-%m-%d&＃39;),endDate&＃61;end.strftime(&＃39;%Y-%m-%d&＃39;),metric&＃61;metric,dimension&＃61;dimension,useTimezoneReporting&＃61;True,).execute()headers &＃61; [i.lower() for i in dimension &＃43; metric]datas &＃61; []for row in results.get(&＃39;rows&＃39;):data &＃61; {}for i in range(len(row)):data[headers[i]] &＃61; row[i]datas.append(data)return datasdef transform(datas):for data in datas:# 数据转化passreturn datasdef serialize(datas):for data in datas:print(json.dumps(data))def main():parser &＃61; argparse.ArgumentParser(formatter_class&＃61;argparse.RawDescriptionHelpFormatter,description&＃61;"""Example:python3 admob.py -s 20181025 -e 20181028""")parser.add_argument(&＃39;-s&＃39;, &＃39;--start&＃39;,type&＃61;lambda d: datetime.datetime.strptime(d, &＃39;%Y%m%d&＃39;),help&＃61;&＃39;start time&＃39;,default&＃61;None)parser.add_argument(&＃39;-e&＃39;, &＃39;--end&＃39;,type&＃61;lambda d: datetime.datetime.strptime(d, &＃39;%Y%m%d&＃39;),help&＃61;&＃39;end time&＃39;,default&＃61;None)args &＃61; parser.parse_args()serialize(transform(collect(args.start, args.end)))if __name__ &＃61;&＃61; &＃39;__main__&＃39;:main()

参考链接

google 广告平台报表 api: https://developers.google.com...
google 广告平台指标和维度:
https://developers.google.com...
google oauth 授权: https://developers.google.com...
How to use Google Adsense API to download Adsense data: https://009co.com/?p&＃61;389
google admob 平台: https://apps.admob.com/v2/home
google 云平台: https://console.cloud.google....
adsense 平台凭据: https://console.cloud.google....