廣告服務（Ads Kit）提供流量變現服務，通過該服務開發者可以在自己的App中向用戶展示Banner、原生、激勵廣告等多種形式的廣告內容，而對于應用中已上線的廣告位來說，因為涉及到收入，所以日常的資料監控顯得尤為重要，
為此廣告服務也提供了流量變現服務報表API（Publisher Service Reporting API），通過接入該API，開發者可以獲取應用內廣告變現相關資料，包括廣告請求量、回傳量、展示率、點擊率等，讓開發者可以依據資料對廣告效果進行分析，從而及時調整投放策略，
開發者可根據回傳的資料實作自己的報表展示效果
那么如何獲取流量變現資料呢？以下是具體的集成步驟，
一．獲取客戶端ID和密鑰
在獲取變現資料前，我們要先有OAuth 2.0 客戶端ID和密鑰，用于生成呼叫報表API時傳入的access_token，需要注意的是此處的客戶端ID和密鑰并不是指APPGallery Connect中應用的ClientID，而是通過在華為開發者聯盟->憑證中創建的服務器應用的客戶端ID，
- 注冊成為開發者，完成實名認證，登錄華為開發者聯盟，點擊右上角“管理中心”進入主頁面，
- 進入“憑證”頁面，創建專案，如果已有專案請跳過【步驟a】，
a． 選擇“憑證”，根據下圖示記順序填入“專案名稱”和“專案別名”新建專案，
b. 選中創建的專案，點擊“確定”，
- 選擇“OAuth 2.0 客戶端 ID”創建客戶端ID，
說明：
如果專案下已經存在“OAuth 2.0 客戶端 ID”憑證，需要檢查產品型別是否為服務器應用，如果是服務器應用可以跳過【步驟4】，
檢查方式：點擊操作一欄下的“編輯”按鈕，查看“產品型別”，
如果不是“服務器應用”型別，需要重新創建“OAuth 2.0 客戶端 ID”：
- 選擇“服務器應用”，輸入“產品名稱”，選擇“應用型別”和“默認語言”，點擊“創建”；提示“客戶端ID”和“密鑰”，點擊“確定”，
- 進入“我的API”頁面，確認選中的專案，點擊“申請新的HMS API服務”，
- 下拉找到“App Services”，點擊“流量變現服務報表API”，
- 點擊“啟用”，開啟流量變現服務報表API，之后就可以呼叫流量變現報表API了
在“停用”后，再次“啟用”時，由于頁面快取等原因，生效時間是非實時生效的，需要等待大概6~10分鐘，如果10分鐘后沒有生效，請重新進行嘗試，
二．呼叫流量變現報表API
- 在呼叫流量變現報表API前需要先獲取access_token鑒權資訊，
呼叫介面：
POSThttps://oauth-login.cloud.huawei.com/oauth2/v3/token
請求示例：
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和密鑰，
2. 拿到access_token鑒權資訊后，呼叫報表API，
呼叫介面：
POST https://ads.cloud.huawei.com/openapi/monetization/reports/v1/publisher
俄羅斯站點需要呼叫以下介面：
POST https://ads-drru.cloud.huawei.ru/openapi/monetization/reports/v1/publisher
請求示例：
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
}
請求示例截圖：
從截圖中可以看到，資料已成功回傳，具體請求引數，和回應引數可以參考[檔案鏈接 ](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-References/query-publisher-service-reports-0000001050933546#section20939514163519?ha_source=hms1)
呼叫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和密鑰后重試，
**了解更多詳情>>**
訪問[廣告服務官網](https://developer.huawei.com/consumer/cn/hms/huawei-adskit?ha_source=hms1)
訪問[華為開發者聯盟官網](http://developer.huawei.com/consumer/cn/hms?ha_source=hms1)
獲取[開發指導檔案](http://developer.huawei.com/consumer/cn/doc/development?ha_source=hms1)
華為移動服務開源倉庫地址：[GitHub](http://github.com/HMS-Core)、[Gitee](http://gitee.com/hms-core)
**關注我們，第一時間了解 HMS Core 最新技術資訊~**轉載請註明出處，本文鏈接：https://www.uj5u.com/yidong/500220.html
標籤：Android
下一篇：安卓系統使用USB轉串口