Reporting API介紹，API接入流程介紹

API是一種應(yīng)用程序接口，通過API可提供傳輸數(shù)據(jù)和服務(wù)功能?？焓趾Ｍ馍虡I(yè)平臺提供Reporting API開放能力，可為廣告主/代理商在自有平臺本地完成獲取廣告數(shù)據(jù)的功能。通過Reporting API功能客戶可以獲取廣告平臺的報表查詢功能，包括但不限campaign、ad sets、ads層級下的消耗、曝光、點擊、轉(zhuǎn)化等數(shù)據(jù)。

API接入流程：您（開發(fā)者）可以通過以下流程，進入賬號注冊平臺，創(chuàng)建開發(fā)者賬號、管理員為您添加開發(fā)者權(quán)限、申請應(yīng)用并向客戶申請授權(quán)后，才可以通過API方式獲取相關(guān)數(shù)據(jù)。具體操作步驟如下：

Step 1: 開發(fā)者申請開發(fā)者賬號進入注冊頁面，點擊注冊，可創(chuàng)建開發(fā)者賬號。

Tips:

1、建議使用公司郵箱注冊，并妥善保管賬號及密碼

2、如當(dāng)前已有kwai賬號，且非開發(fā)者角色（如當(dāng)前賬號是優(yōu)化師角色），暫時無法新增開發(fā)者角色

Step 2:

 管理員為開發(fā)者創(chuàng)建角色第一步完成后，管理員進入Business Center后，選擇添加人員，完善人員信息，選擇開發(fā)者角色后，即完成了開發(fā)者身份注冊

Tips：

1、綁定的郵箱需與第一步中開發(fā)者申請的郵箱保持一致。

2、管理員為開發(fā)者選擇的團隊需與管理員所在團隊保持一致。

3、開發(fā)者角色和其他角色無法互換，也就是說開發(fā)者無法變更為其他角色，其他角色也無法表更為開發(fā)者角色，因此管理員在分配時需注意。

Step 3：開發(fā)者申請成為開發(fā)者第二步完成，即獲得開發(fā)者角色，進入business center申請成為開發(fā)者，需填寫以下信息。

● API Role：指開發(fā)者身份，廣告主or 代理商。

● Access Level：權(quán)限范圍。系統(tǒng)會根據(jù)開發(fā)者Role鑒權(quán)判定所擁有的API賬戶范圍。

● APP Name：開發(fā)者自定義

● Callback URL：回調(diào)地址，開發(fā)者自定義，用于授權(quán)成功后將授權(quán)碼回調(diào)給開發(fā)者，本期不支持更改，請務(wù)必填寫正確。

Tips：

1、開發(fā)者需要確?；卣{(diào)地址能夠成功接收回調(diào)信息。

2、本期僅支持一個開發(fā)者創(chuàng)建一個APP ID。

Step 4: 獲得應(yīng)用（APP ID）平臺審核通過后，會返回APP ID信息：

● APP ID：開發(fā)者應(yīng)用ID。每個開發(fā)者只允許創(chuàng)建一個APP ID，利用APPID和其他參數(shù)組合成授權(quán)URL，您就可以向廣告主發(fā)起授權(quán)申請了。

● Secret ID：應(yīng)用密鑰。每個APPID都對應(yīng)唯一密鑰，secret用于獲取access token以及獲取授權(quán)賬戶。

● Authorization URL：授權(quán)URL，授權(quán)鏈接的回調(diào)地址。

Step 5：獲得授權(quán)

● 復(fù)制授權(quán)url，在同一個瀏覽器打開新的tag 頁，將授權(quán)url（包含自定義參數(shù)）在地址欄中執(zhí)行

● 瀏覽器按預(yù)留【回調(diào)地址】進行跳轉(zhuǎn)，并在跳轉(zhuǎn)后的url上拼接上【授權(quán)碼】和透傳的【自定義參數(shù)】

Step 6：獲取Acces Token

● 使用上一步獲得的授權(quán)碼，拼接獲取token請求：https://developers.kwai.com/oauth/token?grant_type=authorization_code&code={your auth code}&client_id={your client id}&client_secret={your secret key}&redirect_uri={your redirect url}

● 代碼中使用http client或類似http工具以GET請求方式觸發(fā)

● 如果所有參數(shù)參數(shù)正確，認(rèn)證服務(wù)會返回一組token信息，

Step 7：獲取數(shù)據(jù)萬事俱備，接下來就通過API接口獲取數(shù)據(jù)吧

Step 8：刷新token

● refresh_token有效期默認(rèn)半年

● 需要開發(fā)者自行判斷token過期時間，提前使用refresh_token換取新的token，才能繼續(xù)請求海外開放平臺接口，注意:請求里的參數(shù)必須和app 詳情里的內(nèi)容一致，否則請求失敗

● refresh_token沒有失效的情況下，拼接刷新token請求，使用refresh_token重新獲取一組token即可

● refresh_token如果過期，只能重新走Step5 - 6獲取新的token、refresh_token

相關(guān)文章推薦：什么是Pixel，怎么創(chuàng)建Pixel

（來源：出海記事本）

以上內(nèi)容屬作者個人觀點，不代表雨果跨境立場！如有侵權(quán)，請聯(lián)系我們。