乐趣区

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

jiezi

广告服务（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 最新技术资讯~

退出移动版