疑難排解

如果在使用 Search Ads 360 API 時遇到問題,請參閱這個疑難排解專區。

如果您在閱讀本網站的資源後仍無法解決問題,請與支援團隊聯絡,並準備以下資訊:

  • 您嘗試存取的 Search Ads 360 代理商 ID 和廣告主 ID

  • Google API 控制台中的專案編號

  • 您用來存取 API 的 Google 帳戶使用者名稱。
    這是已授予 Search Ads 360 存取權的帳戶,也是您用來設定授權的帳戶。

  • 要求的程式碼片段

  • JSON 回應
    如果回應是錯誤,請務必加入錯誤訊息,而非僅提供數字錯誤代碼。

授權錯誤

以下是常見的授權錯誤:

訊息 說明

Access Not Configured. Please use Google API Console to activate the API for your project.

如果您尚未為帳戶啟用 Search Ads 360 API,就會發生這個錯誤。請務必先完成下列幾件事:

  1. 前往 Google API 控制台

  2. 選取所需的專案,如果您尚未建立專案,請參閱「為用戶端建立專案」一文。

  3. 在左側欄中展開「APIs & auth」。接著,按一下「API」。在 API 清單中,確認 Search Ads 360 API 的狀態為「開啟」

Invalid grant

當重新整理權杖無效時,就會發生這個錯誤。您可以呼叫 Search Ads 360 公用程式指令碼,如以下所示,取得重新整理權杖:

sa360Api.py --login

進一步瞭解建議的授權工作流程。

Invalid client
no application name

如果您在 Google API 控制台中設定專案時未指定產品名稱,就會發生這個錯誤。如要修正這個錯誤,請在 Google API 控制台的「同意畫面」中輸入產品名稱。

其他類型的授權錯誤

請務必使用已獲准存取 Search Ads 360 的 Google 帳戶登入 Google API 控制台,以便擷取用戶端 ID 和用戶端密碼,以及取得重新整理權杖。

轉換上傳錯誤

下表列出您在上傳轉換時可能會遇到的錯誤。請注意,十六進位錯誤代碼是不可變動的,因此您可以在自己的指令碼中使用這些代碼來識別錯誤。

錯誤代碼 訊息 說明
0x00000101

Click ID '{ID}' is not found

您在 update 要求中指定的 點擊 ID 無效。完成下列步驟後,請重新上傳轉換資料:

  • 確認點擊 ID 是在上傳轉換資料前 6 小時產生。

  • 啟用 API 轉換服務

  • 如果要 將轉換歸給特定造訪,請在該次造訪發生後等待至少 6 小時,再上傳轉換。如果您在造訪發生後的 6 小時內即上傳造訪,Search Ads 360 可能會無法辨識該次造訪的點擊 ID。在少數情況下,您可能需要等待最多 24 小時,Search Ads 360 才能辨識 clickId。

  • 確認點擊來自有效來源,如gclsrc 參數所示

  • 確認您已在 advertiserId 欄中指定正確的廣告主。

  • 確認點擊 ID 是在過去 90 天內產生。

0x0000010E Floodlight activity name '{name}' is not found

segmentationName 欄中指定的 Floodlight 活動名稱有誤,或尚未可用。如果您看到這則錯誤訊息,請檢查下列常見問題:

  • 名稱會區分大小寫,因此請務必確保要求與名稱完全一致。
  • 請確認 Floodlight 活動名稱中沒有任何無法列印的萬國碼字元或雙空格。
  • 請確認您指定的是 Floodlight 活動名稱,而非 Floodlight 欄
  • 請確認您在 advertiserId 欄中指定的廣告主有 Floodlight 活動。(您可能指定錯誤的廣告主)。
  • 建立或編輯 Floodlight 活動後,請等待幾小時再上傳活動的轉換資料。
0x00000115 Custom dimension '{name}' is not found

請確認您指定的 Floodlight 自訂變數已設定為與 clickIdcriterionIdproductGroupId 相關聯的廣告主,並將其設為維度 (而非指標)。

0x00000116 Custom metric '{name}' is not found

請確認您指定的 Floodlight 自訂變數已設定為與您要歸因轉換的 clickIdcriterionIdproductGroupId 相關聯的廣告主指標 (而非維度)。

0x0000011A The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}

有人已針對 conversionId 欄中指定的範圍和廣告主轉換 ID 上傳轉換資料。

「廣告主轉換 ID」是您產生的 ID。Search Ads 360 規定在特定範圍內,這組 ID 不得重複。 Search Ads 360 轉換 ID 是由 Search Ads 360 產生,保證不會重複。

0x0000011B Advertiser conversion ID '{ID}' is not found

您的 update 要求嘗試更新不存在的廣告客戶轉換 ID。請確認您指定的 ID 是否正確。

0x0000011D User does not have permission to view advertiser {advertiser ID}

客戶使用的 Google 帳戶沒有權限查看要求中指定的廣告主。

登入 Google API 控制台以擷取用戶端 ID 和用戶端密鑰,以及取得重新整理權杖時,請務必使用已授予指定廣告客戶存取權的 Google 帳戶。

0x0000011F Advertiser conversion ID is already specified in this request

要求中指定相同範圍和廣告主轉換 ID 的轉換次數為兩次以上。

廣告主轉換 ID 是您在「 conversionId」欄中產生及指定的 ID。Search Ads 360 規定在特定範圍內,這個 ID 不得重複。

0x0000011E The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)

您提供的 Floodlight 活動 ID 或名稱與指定的轉換類型不符。

回報回應代碼和錯誤訊息

如果您要求報表,但回應是錯誤訊息,請參閱「Search Ads 360 API 中的回應代碼」和「標準錯誤回應」,進一步瞭解錯誤。

Search Ads 360 UI 中的資料與 API 傳回的報表不符

根據預設,Search Ads 360 UI 中的資料應與 API 傳回的資料相符。 如果您在報表要求中將 includeRemovedEntities 設為 true,請確認 UI 中也選取了「Show removed」核取方塊