疑難排解
如果在使用 Search Ads 360 API 時遇到問題,請參閱這個疑難排解專區。
如果您在閱讀本網站的資源後仍無法解決問題,請與支援團隊聯絡,並準備以下資訊:
授權錯誤
以下是常見的授權錯誤:
訊息 |
說明 |
Access Not Configured. Please use Google API Console to activate the API for your project.
|
如果您尚未為帳戶啟用 Search Ads 360 API,就會發生這個錯誤。請務必先完成下列幾件事:
前往 Google API 控制台。
選取所需的專案,如果您尚未建立專案,請參閱「為用戶端建立專案」一文。
在左側欄中展開「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 自訂變數已設定為與 clickId 、criterionId 或 productGroupId 相關聯的廣告主,並將其設為維度 (而非指標)。 |
0x00000116 |
Custom metric '{name}' is not found |
請確認您指定的 Floodlight 自訂變數已設定為與您要歸因轉換的 clickId 、criterionId 或 productGroupId 相關聯的廣告主指標 (而非維度)。 |
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 UI 中的資料與 API 傳回的報表不符
根據預設,Search Ads 360 UI 中的資料應與 API 傳回的資料相符。
如果您在報表要求中將
includeRemovedEntities
設為 true
,請確認 UI 中也選取了「Show removed」核取方塊。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-12-21 (世界標準時間)。
[null,null,["上次更新時間:2024-12-21 (世界標準時間)。"],[[["This page provides troubleshooting information for common issues encountered while using the Search Ads 360 API, including authorization and conversion upload errors."],["If the provided resources don't resolve your issue, contact support with specific information about your problem, including your Search Ads 360 and Google API Console credentials, code snippets, and JSON responses."],["The page lists common authorization errors such as `Access Not Configured`, `Invalid grant`, and `Invalid client`, with explanations and solutions."],["It also includes a table of conversion upload errors, detailing their hexadecimal error codes, descriptions, and troubleshooting steps."],["For report discrepancies, refer to the Response Codes and Standard Error Responses documentation and ensure the `includeRemovedEntities` setting in your request matches the \"Show removed\" checkbox selection in the Search Ads 360 UI."]]],[]]