開始使用

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

事前準備

取得 AdSense 帳戶

註冊或登入 AdSense 帳戶即可開始。

熟悉 AdSense

如果您不熟悉 AdSense 概念，請參閱 AdSense 簡介資訊並試用 AdSense UI，再開始編寫程式碼。

選擇用戶端程式庫

在用戶端程式庫與範例頁面上，您可以找到可用的程式庫與範例相關資訊。按一下所選語言的分頁，然後前往點選連結下載來源。 用戶端程式庫會為您處理以下項目：

• 驗證
• 發現服務
• 建立對 API 的要求
• 回應剖析

請參閱安裝和設定所選用戶端程式庫的操作說明，通常可在存放區根目錄的 README 檔案中找到。

如果您的實作有特殊需求 (例如使用不支援的語言)，您可以向 API 直接提出要求，不必使用用戶端程式庫。

註冊應用程式

如要使用 AdSense Management API，您必須建立專案並產生用戶端 ID，以註冊正在開發的應用程式。

註冊應用程式

使用您剛建立的新憑證，編輯用戶端程式庫專案的設定檔。詳情請參閱用戶端程式庫說明文件。

注意：註冊使用的 Google 帳戶應為您的「開發人員」帳戶，也就是您希望應用程式使用者顯示為應用程式開發人員的帳戶。這個帳戶不需要與 AdSense 登入連結，因為使用者會在使用應用程式時獲得本身帳戶的存取權。

快速入門教學課程

請按照下列步驟提出第一個要求，請注意，視您使用的程式庫或語言而定，這些步驟可能會略有不同：

1. 使用正確的範例，從 AdSense 帳戶擷取廣告用戶端清單。這個要求會啟動一次性的程序，由 AdSense 使用者驗證及授權您的專案。

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

   1. 如果是網頁應用程式，系統會將使用者重新導向至他們可以選擇授予存取權限的網站。取得授權後，系統會將使用者重新導向至 API 控制台中定義的回呼網址。
   2. 已安裝的應用程式以類似的方式運作。用戶端程式庫會嘗試開啟瀏覽器視窗，並使用授權碼。如果是 Android、Chrome 和 iOS 應用程式，這個方法僅適用於特定平台。
2. 使用 reports.generate 的 API Explorer 要求下列報表：
   • date_range: YESTERDAY
   • dimensions: DATE
   • metrics: ESTIMATED_EARNINGS

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

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

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

   • date_range: YESTERDAY
   • dimensions: DATE
   • metrics: ESTIMATED_EARNINGS
   • filter: AD_UNIT_ID==ca-pub-123456789:987654321
5. 建議您根據自訂、網址管道或混合使用多個篩選器進行篩選。

   您可以使用管道這項工具來追蹤一小部分廣告單元的成效，管道分為兩種類型：網址和自訂。前者可讓您追蹤特定網頁或網域的成效，後者則能追蹤使用者選取的廣告單元群組的成效。

請瀏覽參考說明文件中其他可用的呼叫和資源，即可開始實作。