疑難排解

如果您在使用 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. 展開左側欄中的 [API 與驗證]。接下來,按一下 [API]。在 API 清單中,確認 Search Ads 360 API 的狀態顯示為「開啟」

Invalid grant

您的更新憑證無效時,就會發生這個錯誤。只要叫用 Search Ads 360 公用程式指令碼,即可取得更新憑證,方法如下:

sa360Api.py --login

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

Invalid client
no application name

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

其他授權錯誤類型

登入 Google API 控制台時,請務必使用具備 Search Ads 360 存取權的 Google 帳戶,以便擷取用戶端 ID 和用戶端密鑰,並取得取得更新憑證。

轉換上傳錯誤

下表列出上傳轉換資料時可能發生的錯誤。請注意,十六進位碼是不可變更的,因此您可以在自己的指令碼中使用這些代碼來找出錯誤。

錯誤代碼 訊息 說明
0x00000101

Click ID '{ID}' is not found

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

  • 確認點擊 ID 是在產生轉換的 4 小時後產生。

  • 已啟用 API 轉換服務

  • 如果您要將轉換歸給特定造訪,請在造訪後等待至少 30 分鐘,再上傳轉換。如果您在造訪網站後 30 分鐘內才上傳,Search Ads 360 可能會無法辨識該次造訪的 clickID。在極少數的情況下,您最多可能需要等待 4 小時,Search Ads 360 才能識別 clickId。

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

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

  • 系統已經驗證您的點擊 ID 是在過去 90 天內產生的。

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

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

  • 名稱有大小寫之分,因此請確認您的要求與大小寫完全相符。
  • 請確定您未在 Floodlight 活動名稱中加入任何無法列印的萬國碼 (Unicode) 字元或雙空格。
  • 請確認您指定了 Floodlight 活動的名稱,而非 Floodlight 資料欄
  • 檢查您在 advertiserId 欄中指定的廣告客戶是否擁有該 Floodlight 活動。(您可能指定了錯誤的廣告客戶)。
  • 建立或編輯 Floodlight 活動之後,請稍候幾小時,再上傳該活動的轉換資料。
0x00000115 Custom dimension '{name}' is not found

請確認您為要進行轉換的 clickIdcriterionIdproductGroupId 所指定廣告客戶,已將指定的 Floodlight 自訂變數設定維度 (而非指標)。

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

請確認您為要進行轉換的 clickIdcriterionIdproductGroupId 所指定廣告客戶,已將指定的 Floodlight 自訂變數設定指標 (而非維度)。

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 是您產生的 ID,並在 conversionId 欄中指定。Search Ads 360 規定特定範圍中的 ID 不得重複。

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

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

回報回應代碼和錯誤訊息

如果您索取報告後收到回應的錯誤訊息,請參閱 Search Ads 360 API 中的回應代碼標準錯誤回應,以進一步瞭解這項錯誤。

Search Ads 360 使用者介面中的資料與 API 傳回的報表不相符

根據預設,Search Ads 360 使用者介面中的資料應與 API 傳回的資料相符。 如果您在報表要求中將 includeRemovedEntities 設為 true,請務必勾選 UI 中的 [顯示已移除的項目]includeRemovedEntities 核取方塊。