發佈商註冊流程

本文說明在 AdSense Host API 4.x 版中建立 AdSense 發佈商帳戶,或將帳戶連至主機時,所需的步驟。帳戶必須經過連結,才能使用收益分成和報表等所有 AdSense Host API 功能,因此這是每個主機必經的流程。

總覽

帳戶的建立及連結是由 AdSense 網站處理,但主機必須負責將使用者重新導向至該處,並在這項程序完成時儲存識別碼。

申請的 4 個步驟如下:

  1. 主機呼叫 associationsessions.start 來請求新的連結工作階段。
  2. 主機將使用者重新導向至所傳回連結工作階段中提供的網址,以便他們在 AdSense 網站中完成所需步驟。
  3. 系統將使用者連同權杖一起重新導向回到主機的網站。
  4. 主機呼叫 associationsessions.verify 來驗證該權杖。如果連結成功,回應會包含發佈商帳戶編號,而主機應該會將這個編號儲存在本機上,以便在進行與此發佈商相關的所有 API 呼叫時使用。

步驟 1:啟動連結工作階段

若要將發佈商重新導向到申請網頁,您 (主機) 必須先請求新的連結工作階段。方法很簡單,只要呼叫 associationsessions.start 就行了。回應看起來就像這樣:

{
  'id': '00000000-0000-0000-0000-000000000000',
  'redirectUrl': '<redirect URL>',
  'websiteUrl': 'www.example.com',
  'productCodes': ['AFC'],
  'kind': 'adsensehost#associationSession'
}

此回應中要注意的欄位是 redirectUrlid (也就是工作階段的專屬識別碼)。您必須將 id 儲存在本機,以便之後進行回呼時識別特定使用者。

redirectUrl 是您在下個步驟中需要將使用者重新導向的目的地。

步驟 2:重新導向到 AdSense 網站

不論是建立帳戶還是連結現有的帳戶,都是在 AdSense 網站中的專用 API 申請網頁上進行。

帳戶的建立及連結是在 AdSense 網站上進行。
圖 1:在 AdSense 網站上申請

在這個步驟中,您只需要將使用者重新導向至您在上一個步驟獲得的 redirectUrl,剩下的就交給 Google!

步驟 3:取得回呼

在使用者填寫所有資訊並完成 AdSense 網站上的申請程序後,系統就會將他們帶回您代管帳戶所連結的預定回呼網址。

為了安全起見,連結詳情不會直接在回呼中傳送。不過,回呼請求會加入 token 這一個 HTTP 參數。無論連結是否成功,系統一定會設定這個參數。

GET http://your.callback.url/path?token=<associationtoken>

請務必登記並記錄所有回呼,以免系統多次要求使用者完成申請流程。

步驟 4:驗證權杖

如要取得連結工作階段詳情 (包括連結是否成功),您必須使用在上一個步驟獲得的權杖呼叫 associationsessions.verify

如果發生錯誤或使用者選擇拒絕連結,您就會收到類似於下面這樣的回應:

{
  'id': '00000000-0000-0000-0000-000000000000',
  'status': 'REJECTED',
  'kind': 'adsensehost#associationSession'
}

id 可讓您識別此連結工作階段所屬的使用者,方法是比較您先前在第 1 個步驟儲存的連結編號。

status 會指出工作階段是否成功;成功時會顯示 ACCEPTED,使用者選擇拒絕連結時會顯示 REJECTED,而如果在 AdSense 網站上進行申請的過程中發生某種錯誤,則會顯示 ERROR

如果使用者接受連結,您還會多看到一個欄位:

{
  'id': '00000000-0000-0000-0000-000000000000',
  'status': 'ACCEPTED',
  'accountId': 'pub-0000000000000000',
  'kind': 'adsensehost#associationSession'
}

accountId 欄位包含使用者的 AdSense 帳戶編號,您必須將這個編號儲存在本機中,以便進行與此使用者相關的所有 API 呼叫。

大功告成!

帳戶編號儲存完成後,您就取得了管理使用者時需要的所有資訊。現在,您可以利用這些資訊設定使用者專屬的 API 呼叫,例如使用 accounts.get 來查看他們的 AdSense 帳戶狀態,或是使用 accounts.adunits 集合來管理他們的廣告單元。

傳送您對下列選項的寶貴意見...

這個網頁
AdSense Host API
AdSense Host API