疑難排解

管理轉換需要複雜的整合作業,通常會涉及多個相互依存的工具和程序。本指南提供詳細步驟,協助您排解遇到的任何問題,無論是收到不瞭解的 API 錯誤,或是對使用者介面中顯示的指標或診斷結果感到困惑,都能派上用場。

在 Google Ads 使用者介面中讀取指標

Google Ads 使用者介面不會依匯入日期整理轉換指標,因此使用介面中的報表驗證匯入結果可能會造成誤導。如要驗證匯入健康資料,請先進行離線診斷。您也可以在 Google Ads 使用者介面中,進一步瞭解待開發客戶強化轉換網站強化轉換的診斷結果。

待開發客戶強化轉換功能問題

本節將著重於解決匯入待開發客戶強化轉換時的常見問題。

常見錯誤

錯誤
NO_CONVERSION_ACTION_FOUND

指定的轉換動作未啟用,或無法透過要求中 `client_id` 欄位指定的客戶帳戶存取。請確認上傳的轉換動作已啟用,且由傳送上傳要求的客戶擁有。

如果要求中的 GCLID 屬於無法存取要求中指定轉換動作的客戶帳戶,也可能發生這個錯誤。您可以使用 click_view 資源,提交依 click_view.gclidsegments.date 篩選的查詢,驗證 Google 點擊 ID 是否屬於客戶帳戶,其中日期是發生點擊的日期。

INVALID_CONVERSION_ACTION_TYPE 指定的轉換動作類型不適用於待開發客戶強化轉換。請確認上傳要求中指定的 ConversionAction 類型為 UPLOAD_CLICKS
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS 請確認已在轉換設定中啟用待開發客戶強化轉換。如需相關操作說明,請參閱必要條件指南。
DUPLICATE_ORDER_ID 匯入的事件包含具有相同訂單 ID 的多個轉換,因此無法處理。 請確認訂單 ID 並未重複,然後再試一次。
CLICK_NOT_FOUND 系統找不到與提供的使用者 ID 相符的點擊。只有在 debug_enabledtrue 時,Google Ads API 才會在 UploadClickConversionsRequest 上傳回這項錯誤。

如果轉換遇到這項警告,Google Ads API 會將其納入successful_event_count離線資料診斷。Google Ads API 的 alerts 集合中包含 CLICK_NOT_FOUND 的項目,方便您監控這項警告的頻率。

如果點擊並非來自 Google Ads 廣告活動,就會發生這項錯誤。例如來自 SA360DV360。其他可能原因如下:

如果上傳資料的客戶與 Google Ads 轉換客戶不同,這個錯誤可能表示上傳資料的客戶已接受客戶資料條款,但放送廣告的客戶尚未接受。

如要判斷帳戶是否已接受顧客數位資料條款,請查詢 customer 資源並檢查 customer.offline_conversion_tracking_info.accepted_customer_data_terms 欄位。

指標差異

請注意下列常見問題:

  • 處理管道可能會因各種原因捨棄轉換,這類轉換無法復原。詳情請參閱「上傳成功後的資料不一致」一文。

  • 請檢查網頁上的 Google 代碼是否設定正確,並在提交待開發客戶表單時觸發。如果代碼在表單提交時觸發,或傳送的資料不正確,上傳的轉換資料中可能就不會有歸因資料,或歸因資料偏低。請參閱說明中心文章,瞭解如何設定 Google 代碼設定 Google 代碼管理工具,以使用待開發客戶強化轉換。

  • 如果您在網頁上使用待開發客戶強化轉換,但沒有 Google 代碼,則ClickConversion.gclid 欄位,納入 Google 點擊 ID。

  • 確認上傳內容中已正確指定同意聲明。如要進行這項操作,請為帳戶設定預設同意聲明設定 (在 Google Ads 使用者介面中,依序點選「工具」->「資料管理工具」->「同意聲明設定」),或為每個上傳的轉換設定 ClickConversion.consent 欄位。

廣告活動成效問題

如果您上傳轉換資料時沒有遇到任何技術問題,且對顯示的指標感到滿意,但導入強化轉換後,廣告活動成效或「升幅」並未如預期提升,請與 Google Ads 產品支援團隊聯絡以尋求協助。

網站強化轉換功能的問題

本節重點在於解決匯入網站強化轉換時的常見問題。

常見錯誤

錯誤
CONVERSION_NOT_FOUND 找不到與提供的轉換動作和轉換 ID 組合相對應的轉換,或 order_id無法找到。確認轉換是要求 customer_id 中指定的 Google Ads 轉換客戶的 Google Ads 轉換。
此外,請確認轉換並非來自點擊,且該點擊填入的是 gbraid wbraid,而非 gclid。 Google Ads 不支援這些轉換的網站強化轉換。
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS 您尚未接受要求的customer_id顧客數位資料條款。如需相關操作說明,請參閱必要條件指南。
CONVERSION_ALREADY_ENHANCED 這項轉換已收到具有指定 order_idconversion_action 的調整項。請務必為每項轉換提供不重複的 order_id
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT 提供的 conversion_action 不符合網站強化轉換資格。在 Google Ads 使用者介面中,請務必勾選要求中參照的轉換動作「啟用強化轉換」方塊。如需相關操作說明,請前往說明中心

一般轉換管理問題

請注意下列常見問題:

  • 如果嘗試將任何列舉欄位設為 UNKNOWN,就會發生 RequestError.INVALID_ENUM_VALUE 錯誤。如果廣告主不確定是否已取得同意聲明,但仍指定 consent,就可能發生這個常見問題。如果 consent 的狀態不明,應設為 DENIED

  • 應用程式轉換Firebase 和第三方應用程式數據分析建立轉換動作時,您只能在建立時變更 app_id 欄位,轉換動作建立後就無法變更這個欄位。

  • 建立轉換動作時,您只能將ConversionAction.attribution_model_settings.attribution_model 欄位設為GOOGLE_ADS_LAST_CLICKGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN。其他選項會導致 CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS 錯誤。如要瞭解詳情,請參閱這篇網誌文章,瞭解其他歸因模式的淘汰事宜。

  • click_through_lookback_window_days 欄位的允許範圍為 [1, 60],適用於類型為 AD_CALLWEBSITE_CALL 的轉換動作。對於大多數其他轉換動作,允許的範圍為 [1, 30]

  • 大多數轉換動作的 view_through_lookback_window_days 欄位允許範圍為 [1, 30]。對於類型為 AD_CALLWEBSITE_CALL 的轉換動作,這個欄位必須未設定

  • 在轉換動作中設定或更新 include_in_conversion_metrics 欄位,會導致 FieldError.IMMUTABLE_FIELD 錯誤。請改為設定 primary_for_goal 欄位,詳情請參閱轉換目標指南

  • 建立 WEBSITE_CALLAD_CALL 類型的轉換動作時,value_settings.always_use_default_value 必須設為 true。如果指定 false 值,就會發生 INVALID_VALUE 錯誤。

常見錯誤

錯誤
INVALID_CONVERSION_ACTION_TYPE 指定的轉換動作具有不適合上傳點擊轉換的類型。確認上傳要求中指定的 ConversionAction 類型為 UPLOAD_CLICKS
NO_CONVERSION_ACTION_FOUND 指定的轉換動作未啟用,或上傳 customer_id 中找不到該動作。擷取轉換設定的相關資訊,確認上傳的轉換動作已啟用,且屬於上傳要求的 customer_id
TOO_RECENT_CONVERSION_ACTION 轉換動作是新建立的。建立動作後,請等待至少 6 小時,再重試失敗的轉換。
INVALID_CUSTOMER_FOR_CLICK 要求的 customer_id 與點擊時的 Google Ads API 轉換帳戶客戶 ID 不同。將要求更新為正確的客戶。customer_id
EVENT_NOT_FOUND Google Ads 找不到點擊 ID 和 customer_id 的組合。請詳閱customer_id的規定,並確認您是使用正確的 Google Ads 帳戶上傳。
DUPLICATE_CLICK_CONVERSION_IN_REQUEST 要求中的多個轉換具有相同的點擊 ID、conversion_date_timeconversion_action 組合。從要求中移除重複的轉換。
CLICK_CONVERSION_ALREADY_EXISTS 先前已上傳過含有相同點擊 ID、conversion_date_timeconversion_action 組合的轉換資料。如果您是重試上傳,且先前已成功上傳這項轉換,請忽略這則錯誤訊息。如要新增轉換 (先前已上傳轉換),請調整 conversion_date_timeClickConversion,避免重複上傳先前已上傳的轉換。
EVENT_NOT_FOUND Google Ads 找不到點擊 ID 和 customer_id 的組合。請詳閱customer_id的規定,並確認您是使用正確的 Google Ads 帳戶上傳。
EXPIRED_EVENT 匯入的點擊發生在 click_through_lookback_window_days 欄位指定的時間範圍之前。click_through_lookback_window_days 回溯期變更只會影響變更後記錄的點擊次數,因此變更回溯期無法解決特定點擊的錯誤。視情況將 conversion_action 變更為回溯期較長的其他動作。
CONVERSION_PRECEDES_EVENT conversion_date_time早於點擊的日期和時間。將 conversion_date_time 更新為較晚的值。
GBRAID_WBRAID_BOTH_SET ClickConversion 的值已設為 gbraidwbraid。更新轉換,只使用一個點擊 ID,並確保您未將多個點擊合併為同一個轉換。每次點擊只會有一個點擊 ID。
VALUE_MUST_BE_UNSET 請檢查 location,判斷下列哪個問題導致錯誤。 GoogleAdsError
  • ClickConversion 已為 gclid 設有值,且至少設有 gbraidwbraid 其中一個值。更新轉換,只使用一個點擊 ID,並確保您未將多個點擊合併為同一個轉換。每次點擊只會有一個點擊 ID。
  • ClickConversion 已為 gbraidwbraid 設定值,且具有 custom_variables 的值。如果轉換含有 gbraidwbraid 點擊 ID,Google Ads 就不支援自訂變數。取消設定轉換的 custom_variables 欄位。