測試帳戶

測試帳戶可讓您先試用新的 API 實作項目或帳戶設定,再於正式環境中實作變更。

正式帳戶放送的廣告會向使用者顯示,且需要付費;測試帳戶則沒有有效的帳單資訊,也不會向使用者放送廣告,因此在 Google Ads 使用者介面中會顯示為已取消的帳戶。

測試帳戶和正式帳戶無法以任何方式互動,因此您無法在現有的正式管理員帳戶下使用測試帳戶。如要使用測試帳戶,您需要新的帳戶階層,並以測試管理員帳戶做為根層級。

需要測試帳戶嗎?

建立獨立的測試帳戶階層前,請先確認哪種測試選項最符合您的用途:

  • 首次發出 API 呼叫或對實際帳戶進行測試 (每天最多 2,880 次作業):除非您要測試探索者存取權受限的功能 (例如建立帳戶、使用者管理、關鍵字規劃或帳單),否則不需要測試帳戶。在 Google Cloud 控制台的 Google Ads API 總覽頁面,申請自動Explorer 存取層級,即可直接查詢及管理正式版帳戶。
  • 驗證要求語法和政策遵循情形,不變更資料:在 GoogleAdsService.Search 或變更要求中設定 validate_only 欄位 (指定正式版帳戶時,至少需要探索者存取權)。
  • 使用測試存取權專案進行開發,或在免費沙箱中測試完整的廣告活動建立流程:請按照本頁步驟建立測試管理員帳戶和測試客戶帳戶。

為何要使用測試帳戶?

測試帳戶不會影響實際放送的廣告,也不會向帳戶收費。在積極開發期間,這些工具可提供下列好處:

  • 可設定階層,並像正式帳戶一樣進行管理。
  • 可透過 Google Ads 使用者介面查看及操作,就像正式版帳戶一樣。
  • Google Cloud 專案不需取得正式版 API 存取權核准,因此您可以在專案具備測試存取層級時,立即開始試用 API。(如果具有測試存取權的 Google Cloud 專案嘗試呼叫正式版帳戶,自 v25 起,API 會傳回 AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION,在 v24和更早版本中則會傳回 AuthorizationError.ACTION_NOT_PERMITTED)。
  • 無法放送廣告,或以任何方式與正式帳戶互動。這樣一來,您就能在安全的環境中測試程式碼或設定變更,不會影響放送帳戶。
  • 與正式版帳戶有相同的限制,包括頻率限制。

測試帳戶沒有預算,因此在管理員帳戶中建立測試子帳戶時,可能會看到錯誤訊息。您可以放心忽略這項錯誤。

建立測試帳戶和廣告活動

請按照下列操作說明,建立測試管理員帳戶、測試客戶帳戶,以及幾個廣告活動,用來填入測試客戶帳戶。如需這些帳戶類型的完整說明,請參閱「帳戶類型」。

  1. 按一下「Create a test manager account」,開啟 Google Ads 帳戶選取頁面。如果系統提示,請使用未連結至正式版 Google Ads 管理員帳戶的 Google 帳戶登入,或在登入提示中建立 Google 帳戶。

    建立測試管理員帳戶

  2. 在帳戶選取頁面上,按一下「新增 Google Ads 帳戶」(如果出現「要完成帳戶設定嗎?」對話方塊,請按一下「建立新帳戶」)。帳戶選取頁面不會顯示測試指標,但從「Create a test manager account」(建立測試管理員帳戶) 開啟該頁面,會設定註冊流程,建立測試管理員帳戶。

  3. 在「確認商家資訊」頁面,輸入「帳戶顯示名稱」,選取「帳戶主要用途」選項,然後選取國家/地區、時區和貨幣。確認右上角有紅色的「Test account」(測試帳戶) 標籤,然後依序點選「Submit」(提交) 和「Explore your account」(探索帳戶),開啟測試管理員帳戶資訊主頁。

  4. 在測試管理員帳戶中,建立測試客戶帳戶:依序點選「帳戶」> >「建立新帳戶」。輸入帳戶名稱,選取國家/地區、時區和貨幣,然後儲存帳戶。您透過測試管理員帳戶建立的任何客戶帳戶,都會自動成為測試帳戶。

  5. 在測試客戶帳戶下建立一或多個測試廣告活動,讓後續的報表查詢傳回樣本資料。

  6. 請從 Google Ads 使用者介面,記下兩個 10 位數客戶 ID (不含連字號),用於 API 設定:

    • customer_id (目標客戶帳戶):使用您建立測試廣告活動的新測試客戶帳戶的 10 位數客戶 ID (查詢或變更廣告活動的 API 呼叫必須指定客戶帳戶,而非管理員帳戶)。
    • login-customer-id (管理員帳戶):如果您使用連結至測試管理員帳戶的 Google 帳戶或服務帳戶進行驗證,請將 login-customer-id 設為測試管理員帳戶的 10 位數客戶 ID。
  7. 按照「發出第一個 API 呼叫」一文的說明,設定用戶端程式庫或 REST 憑證,並對新的測試客戶帳戶執行測試查詢。

查看測試帳戶

如要在 Google Ads 使用者介面中,查看測試管理員帳戶底下的測試客戶帳戶,請選擇查看已取消的帳戶,取消隱藏帳戶。

在管理員帳戶設定期間,以及部分 Google Ads 使用者介面檢視畫面中,測試帳戶會顯示紅色的「測試帳戶」標籤:

Google Ads 使用者介面顯示紅色的測試帳戶標籤

如要透過 API 檢查帳戶是否為測試帳戶,請使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 方法查詢 customer.test_account 欄位:

SELECT customer.id, customer.test_account
FROM customer
LIMIT 1

您可以對測試管理員帳戶或測試客戶帳戶執行這項查詢。透過測試管理員帳戶查詢測試客戶帳戶時,請在 login-customer-id 標頭中加入管理員帳戶 ID。測試管理員和測試客戶帳戶會針對 customer.test_account 傳回 true,而正式版帳戶則會傳回 false。

限制

使用測試帳戶時,請注意下列限制:

  • 測試帳戶無法放送廣告,也無法與正式版帳戶互動,因此曝光、轉換或費用資料等放送指標會是空白。
  • 您無法在測試帳戶中測試特定功能,包括出價模擬工具、轉換上傳和帳單。測試帳戶不會產生放送資料,因此其他功能 (包括最佳化建議) 在測試帳戶中的功能有限。
  • 測試管理員帳戶階層最多可包含 50 個測試帳戶。如需更多測試帳戶,可以建立其他測試管理員帳戶。
  • 如果測試帳戶持續產生大量要求,可能會在未經通知的情況下受到限制。

請參閱「測試最佳做法」,瞭解如何解決這些限制。