入門

本文件適用於想要透過 AdSense Management API 取得 AdSense 帳戶相關資訊的開發人員,我們假設本文的讀者對網頁程式設計概念和網頁資料格式都非常熟悉。

內容

事前準備

取得 AdSense 帳戶

您需要測試用的 AdSense 帳戶。如果已有測試帳戶,就可以前往 AdSense 使用者介面設定、修改或查看測試資料。

熟悉 AdSense

如果您還不熟悉 AdSense 相關概念,請先參閱 AdSense 簡介資訊並測試使用者介面,再開始撰寫程式碼。

選擇您的用戶端程式庫

用戶端程式庫與範例網頁上,您可以找到可用的程式庫與範例。按一下所選語言的分頁,然後前往以下連結下載來源。用戶端程式庫會為您處理下列項目:

  • 驗證
  • 發現服務
  • 為 API 建立請求
  • 回應剖析

請參閱安裝和設定所選用戶端程式庫的指示,這些指示一般可在存放空間根目錄的 README 檔案中找到。

如果您在導入時有特別需求 (例如使用不支援的語言),您可以向 API 直接提出請求,取代使用用戶端程式庫。

註冊應用程式

如果要使用 AdSense Management API,您必須向 Google 註冊要開發的應用程式:

  1. 前往 API 主控台
  2. 登入 Google 帳戶或建立一個。
  3. 新建專案。
  4. 在新建的專案中,按一下 AdSense Management API 底下的 [啟用] 按鈕。
  5. 前往「API 存取」區段。
  6. 建立用戶端編號:
    1. 網路應用程式 (如果您在網路伺服器中導入)。
    2. 已安裝應用程式 (其他所有類別)。

    注意事項:不支援服務帳戶,因為這些會存取受到保護的資料。

  7. 使用您剛才建立的新憑證,編輯用戶端程式庫專案的設定檔案。如需更多詳細資訊,請參閱用戶端程式庫說明文件。

注意事項:用於註冊的 Google 帳戶應該是您的開發人員帳戶,也就是說,您希望應用程式使用者看到的應用程式開發人員帳戶。這個帳戶不需要與 AdSense 登入資訊連結,因為使用者會在使用應用程式時獲得本身帳戶的存取權。

快速入門教學課程

請按照下列步驟來提出第一個請求,請注意,視您使用的程式庫或語言而定,這些步驟可能有些差異:

  1. 使用適合的範例擷取 AdSense 帳戶中的廣告用戶端清單。這個請求會初始一次性的程序,由 AdSense 使用者驗證和授權您的專案。

    廣告用戶端代表 AdSense 帳戶與 AdSense 產品之間的關聯,例如多媒體廣告聯播網廣告或搜尋廣告。AdSense 帳戶可以有一或多個廣告用戶端。

    1. 如果是網路應用程式,系統會將使用者帶往他們可以選擇授予存取權限的網站。取得授權後,系統會將使用者帶往在 API 主控台中定義的回呼網址。
    2. 已安裝的應用程式以類似的方式運作。用戶端程式庫將會試著開啟瀏覽器視窗,並使用授權代碼。如果是 Android、Chrome 和 iOS 應用程式,這個方法會指定平台。
  2. 使用 reports.generate 中的 API 多層檢視提出下列報表的請求:
    • startDate: today-1m
    • endDate: today
    • dimensions: DATE
    • metrics: EARNINGS

    報表可讓您查看收益資料,以及這些收益的影響因素。使用管道,您就能針對整個帳戶或一小部分的廣告單元執行報表。

  3. 試著在應用程式中請求同一份報表。
  4. 您可以按廣告單元篩選報表。使用 adunits.list 擷取廣告單元清單。請注意,您需要使用廣告客戶編號 (從步驟 1 取得)。選擇廣告單元後,請在 reports.generatefilter 參數中使用其編號:

    廣告單元是指使用者為廣告設定的預留位置,其定義了顯示廣告的部分屬性 (如大小與形狀)。

    • startDate: today-1m
    • endDate: today
    • dimensions: DATE
    • metrics: EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. 試著按自訂或網址管道篩選,或混合多個篩選器。

    您可以使用管道這項工具來追蹤一小部分廣告單元的成效,管道共有兩種類型:網址和自訂。前者可讓您追蹤某個網頁或網域的成效,後者則可讓您追蹤使用者所有廣告單元群組的成效。

  6. 或者,您可以加入 AdSense API 公告群組

請瀏覽在參考文件中其他可用的呼叫和資源,即可開始導入。

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

這個網頁
AdSense Management API
AdSense Management API