疑難排解

如果在使用 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 的狀態為「ON」。

Invalid grant

如果更新權杖無效,就會發生這項錯誤。您可以叫用 Search Ads 360 公用程式指令碼,取得更新權杖,如下所示:

sa360Api.py --login

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

Invalid client
no application name

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

其他類型的授權錯誤

登入 Google API 控制台擷取用戶端 ID 和用戶端密鑰,以及取得更新權杖時,請務必使用已獲授予 Search Ads 360 存取權的 Google 帳戶。

轉換上傳錯誤

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

錯誤代碼 訊息 說明
0x00000101

Click ID '{ID}' is not found

您在 insert 或 update 要求中指定的點擊 ID 無效。請先完成下列事項,再重新上傳轉換資料:

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

  • 啟用 API 轉換服務。

  • 如果您將已歸因轉換歸因於特定造訪,請在造訪後等待至少 6 小時,再上傳轉換資料。如果您在上傳時,距離造訪時間不到 6 小時,Search Ads 360 可能無法辨識造訪的 clickID。在極少數情況下,Search Ads 360 最多可能需要 24 小時才能辨識 clickId。

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

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

0x00000106 Either a click ID or keyword ID is required

轉換未指定歸因對象。指定 clickId 欄,或指定用於識別關鍵字的 customerId、campaignId、adGroupId 和 criterionId 欄。

0x0000010C Either of Floodlight activity ID or Floodlight activity name is required

在 segmentationName 或 segmentationId 欄中指定 segmentationType: "FLOODLIGHT" 和 Floodlight 活動。

編輯 Search Ads 360 透過 Floodlight 代碼記錄的轉換時,必須提供 Floodlight 活動,才能識別轉換。

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

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

  • 名稱會區分大小寫,因此請務必確保要求的大小寫完全相符。
  • 請確認 Floodlight 活動名稱不含任何無法列印的 Unicode 字元或雙空格。
  • 請務必指定 Floodlight 活動名稱,而非 Floodlight 欄名稱。
  • 確認 Floodlight 活動存在於要求中點擊 ID 或關鍵字所屬的廣告主。
  • 建立或編輯 Floodlight 活動後,請等待幾小時,再上傳該活動的轉換資料。
0x00000115 Custom dimension '{name}' is not found

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

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

請確認您指定的 Floodlight 自訂變數已設定為指標 (而非維度),且該指標適用於與您要歸因轉換的 clickId、criterionId 或 productGroupId 相關聯的廣告主。

0x00000119 A conversion ID or advertiser conversion ID is required to modify an existing conversion

您的 update 要求未指定 conversionId 欄。您必須提供 conversionId,才能找出要編輯的轉換。請參閱「dsConversionId 淘汰」。

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

有人已上傳轉換,且該轉換與 conversionId 欄中指定的範圍和廣告主轉換 ID 相同。

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

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

您的 update 要求嘗試更新不存在的廣告主轉換 ID。請檢查下列常見問題:

  • 請確認您在 conversionId 欄中指定了正確的 ID。如果是透過 API 上傳的轉換,則為您在插入轉換時指定的 conversionId。如果是透過 Floodlight 代碼記錄的轉換,則為 Floodlight 訂單 ID。
  • 請確認 conversionTimestamp 是現有轉換的時間戳記 (以世界標準時間 Epoch 毫秒為單位)。從當地時區轉換而來的時間戳記,或以秒 (而非毫秒) 為單位的時間戳記,與現有轉換不符。
  • 如果是透過 Floodlight 代碼記錄的轉換,請務必在 segmentationName 或 segmentationId 欄中指定轉換的 Floodlight 活動,且轉換必須發生在過去 28 天內。
0x0000011D User does not have permission to view advertiser {advertiser ID}

您用戶端使用的 Google 帳戶沒有權限,無法查看要求中點擊 ID 或關鍵字所屬的廣告主。

登入 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 或名稱與指定的轉換類型不符。

0x00000124 Conversion timestamp is before click timestamp

conversionTimestamp 早於您在 clickId 欄中指定的點擊時間。請務必以 Epoch 毫秒世界標準時間指定時間戳記,而非以秒或當地時區指定。

0x00000125 Conversion age is older than the max supported age

您的 update 要求嘗試編輯的轉換太舊,無法編輯。 Search Ads 360 透過 Floodlight 代碼記錄的轉換,只能在conversionTimestamp後 28 天內編輯。

0x00000126 Service internal error

請稍後再重試要求。這可能是暫時性錯誤。如果這個錯誤持續發生,請與 SA360 支援團隊聯絡。

0x00000129 Invalid customer ID: {ID}

Search Ads 360 找不到您在 customerId 欄中指定的客戶 ID。指定包含關鍵字的客戶帳戶新版 Search Ads 360 客戶 ID,例如 123-456-7890。

0x0000012C Cannot find this keyword ID in Search Ads 360.

Search Ads 360 找不到 customerId、campaignId、adGroupId 和 criterionId 欄所識別的關鍵字。請確認這四個 ID 都是新版 Search Ads 360 ID,且關鍵字屬於您指定的廣告群組、廣告活動和客戶帳戶。

0x0000012E Please provide the full set of new Search Ads 360 IDs: {missing ID}

歸因於關鍵字的轉換必須指定 customerId、campaignId、adGroupId 和 criterionId。訊息會指出缺少的 ID。請參閱「將轉換僅歸因於關鍵字」。

0x0000012F Editing a click ID older than 60 days is not supported.

您的 update 要求指定了 60 天前產生的 clickId。您只能編輯點擊後 60 天內發生的轉換。

0x0000013C Conversion editing using integer DS conversion ID is deprecated. Please use conversion ID instead.

您的 update 要求指定了已淘汰的 dsConversionId 欄,或在 conversionId 欄中傳遞了 Search Ads 360 轉換 ID。請改用廣告主轉換 ID 識別轉換。請參閱「dsConversionId 淘汰」。

報表回應代碼和錯誤訊息

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

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

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