关于android:如何获取广告服务流量变现数据助力广告效果分析

7次阅读

共计 2380 个字符,预计需要花费 6 分钟才能阅读完成。

广告服务(Ads Kit)提供流量变现服务,通过该服务开发者能够在本人的 App 中向用户展现 Banner、原生、激励广告等多种形式的广告内容。而对于利用中已上线的广告位来说,因为波及到支出,所以日常的数据监控显得尤为重要。

为此广告服务也提供了流量变现服务报表 API(Publisher Service Reporting API),通过接入该 API,开发者能够获取利用内广告变现相干数据,包含广告申请量、返回量、展现率、点击率等,让开发者能够根据数据对广告成果进行剖析,从而及时调整投放策略。

开发者可依据返回的数据实现本人的报表展现成果

那么如何获取流量变现数据呢? 以下是具体的集成步骤。

一.获取客户端 ID 和密钥

在获取变现数据前,咱们要先有 OAuth 2.0 客户端 ID 和密钥,用于生成调用报表 API 时传入的 access_token,须要留神的是此处的客户端 ID 和密钥并不是指 APPGallery Connect 中利用的 ClientID,而是通过在华为开发者联盟 -> 凭证中创立的服务器利用的客户端 ID。

  1. 注册成为开发者,实现实名认证。登录华为开发者联盟,点击右上角“管理中心”进入主页面。
  1. 进入“凭证”页面,创立我的项目,如果已有我的项目请跳过【步骤 a】。

a. 抉择“凭证”,依据下图标记程序填入“项目名称”和“我的项目别名”新建我的项目。

b. 选中创立的我的项目,点击“确定”。

  1. 抉择“OAuth 2.0 客户端 ID”创立客户端 ID。

阐明:

如果我的项目下曾经存在“OAuth 2.0 客户端 ID”凭证,须要查看产品类型是否为服务器利用,如果是服务器利用能够跳过【步骤 4】。

查看形式:点击操作一栏下的“编辑”按钮,查看“产品类型”。

如果不是“服务器利用”类型,须要从新创立“OAuth 2.0 客户端 ID”:

  1. 抉择“服务器利用”,输出“产品名称”,抉择“利用类型”和“默认语言”,点击“创立”;提醒“客户端 ID”和“密钥”,点击“确定”。
  1. 进入“我的 API”页面,确认选中的我的项目,点击“申请新的 HMS API 服务”。
  1. 下拉找到“App Services”,点击“流量变现服务报表 API”。
  1. 点击“启用”,开启流量变现服务报表 API,之后就能够调用流量变现报表 API 了

在“停用”后,再次“启用”时,因为页面缓存等起因,失效工夫是非实时失效的,须要期待大略 6~10 分钟。如果 10 分钟后没有失效,请从新进行尝试。

二.调用流量变现报表 API

  1. 在调用流量变现报表 API 前须要先获取 access_token 鉴权信息。

调用接口:

POSThttps://oauth-login.cloud.hua…

申请示例:

POST /oauth2/v3/token HTTP/1.1
Host: oauth-login.cloud.huawei.com
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials&
        client_id=< 客户端 ID >&
        client_secret=< 客户端密钥 >

申请示例截图:

须要留神的是,客户端 ID 和密钥,是在开发者联盟界面获取的服务器利用的客户端 ID 和密钥,而不是在 APPGallery Connect 中创立的挪动利用的客户端 ID 和密钥。

  1. 拿到 access_token 鉴权信息后,调用报表 API。

调用接口:

POST https://ads.cloud.huawei.com/…

俄罗斯站点须要调用以下接口:

POST https://ads-drru.cloud.huawei…
申请示例:

POST /openapi/monetization/reports/v1/publisher HTTP/1.1
Content-Type: application/json
Authorization: Bearer ***
        Accept: application/json
Content-Length: 233

{
    "start_date": "2022-06-01",
    "end_date": "2022-06-28",
    "filtering": {"currency": "CNY"},
    "time_granularity": "STAT_TIME_GRANULARITY_DAILY",
    "page": 1,
    "page_size": 10
}

申请示例截图:

从截图中能够看到,数据已胜利返回。具体申请参数,和响应参数能够参考文档链接

调用 API 获取变现报表数据后,开发者能够依据本人的需要去实现数据的展示模式。

三.接入流量变现报表时的常见问题

调用流量变现服务报表 API 时返回 access forbidden?

起因剖析:

1. 在开发者联盟界面“API”栏目中没有开启对应我的项目的流量变现报表 API 开关。

2. 流量报表 API 开关“启用”后,还没有等到权限失效,就调用报表 API 接口。

3. 获取 access_token 鉴权信息时,传入的客户端 ID 和密钥,不是开发者联盟界面“凭证”中服务器利用的 ID 和密钥。

解决办法:

  1. 开启流量报表 API 开关,在开发者联盟界面 -> 我的 API-> 抉择对应的我的项目 -> 点击“申请新的 HMS API 服务”,找到“流量变现服务报表 API”权限,点击“启用”。

  2. 流量报表 API 开关“停用”后,再次“启用”时,并非实时失效,须要期待大略 6~10 分钟。
  3. 查看获取 access_token 鉴权信息时,传入的客户端 ID 是否是服务器利用的。在开发者联盟界面 -> 凭证 -> 找到对应的我的项目 -> 点击我的项目下利用的编辑按钮,即可在产品类型一行看到利用类型。如果不是服务器利用,请更换服务器利用的客户端 ID 和密钥后重试。

理解更多详情 >>

拜访广告服务官网

拜访华为开发者联盟官网
获取开发领导文档
华为挪动服务开源仓库地址:GitHub、Gitee

关注咱们,第一工夫理解 HMS Core 最新技术资讯~

正文完
 0