疑難排解

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

重要事項： API 傳回的成功匯入回應，不一定代表系統已歸因轉換。如要進一步瞭解匯入成功後資料不一致的問題，請參閱「上傳成功後的資料不一致」一節。

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

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

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

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

常見錯誤

以下指引有助於診斷及修正待開發客戶強化轉換的常見錯誤。

錯誤
NO_CONVERSION_ACTION_FOUND	指定的轉換動作未啟用，或要求中 customer_id 欄位指定的客戶帳戶無法存取該動作。請確認上傳的轉換動作已啟用，且上傳要求是由擁有該動作的客戶傳送。 如果要求中的 GCLID 屬於無法存取要求中指定轉換動作的客戶帳戶，也可能發生這項錯誤。您可以使用 click_view 資源，提交依 click_view.gclid 和 segments.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 相符的點擊。 注意：除非大多數轉換都發生這個錯誤，否則請將這個錯誤視為警告。 如果轉換遇到這項警告，Google Ads API 會將其納入離線資料診斷的 successful_event_count。Google Ads API 的 CLICK_NOT_FOUND 集合中包含 alerts 項目，方便您監控這項警告的頻率。 如果點擊並非來自 Google Ads 廣告活動，就會發生這項錯誤。例如，可能來自 SA360 或 DV360。其他可能原因如下： 上傳的顧客與 Google Ads 轉換顧客不同。 代碼設定有誤，無法用於待開發客戶表單。 上傳的資料未正確 正規化及雜湊處理。 在極少數情況下，上傳客戶與 Google Ads 轉換客戶不同，這個錯誤可能表示上傳客戶已接受顧客數位資料條款，但放送客戶尚未接受。 如要判斷帳戶是否已接受顧客數位資料條款，請查詢 customer 資源並檢查 customer.conversion_tracking_setting.accepted_customer_data_terms 欄位。

指標有出入

請注意下列常見問題：

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

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

• 如果您使用待開發客戶強化轉換，但網頁上沒有 Google 代碼，則必須在轉換匯入中加入 Google 點擊 ID，方法是在每個轉換中設定 ClickConversion.gclid 欄位。

• 確認上傳內容中已正確指定同意聲明。如要這麼做，請為帳戶設定預設的同意聲明設定 (在 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_id 和 conversion_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_CLICK 或 GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN。如果選擇其他選項，系統會傳回 CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS 錯誤。如要瞭解詳情，請參閱我們宣布停用其他歸因模式的網誌文章。

• 「click_through_lookback_window_days」欄位的允許範圍為：轉換動作類型為 AD_CALL 時，1 至 60 天；轉換動作類型為 WEBSITE_CALL 時，1 至 60 天。對於大多數其他轉換動作，允許的範圍為 1 至 90 天。

• view_through_lookback_window_days 欄位的允許範圍為 1 至 30 天，適用於大多數轉換動作。對於類型為 AD_CALL 和 WEBSITE_CALL 的轉換動作，這個欄位必須取消設定。

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

• 建立 WEBSITE_CALL 或 AD_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_time和 conversion_action組合。從要求中移除重複的轉換。
CLICK_CONVERSION_ALREADY_EXISTS	先前已上傳點擊 ID、conversion_date_time 和 conversion_action 組合相同的轉換。如果您是重試上傳，且先前已成功上傳這項轉換，請忽略這項錯誤。如要新增轉換 (先前已上傳轉換)，請調整 ClickConversion 的 conversion_date_time，避免重複上傳先前已上傳的轉換。
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 的 gbraid 和 wbraid 都已設定值。更新轉換，只使用一個點擊 ID 或網址參數，並確保您不會將多個點擊合併為同一個轉換。每次點擊只會有一個點擊 ID 或網址參數。
VALUE_MUST_BE_UNSET	檢查 location 的 GoogleAdsError，判斷下列哪個問題導致錯誤。 ClickConversion 的 gclid 值已設定為 至少一個 gbraid 或 wbraid。更新轉換，只使用一個點擊 ID 或網址參數，並確保您不會將多個點擊合併為同一個轉換。每次點擊只會有一個點擊 ID 或網址參數。 ClickConversion 已為 gbraid 或 wbraid 設定值，且 custom_variables 有值。如果轉換含有 gbraid 或 wbraid 網址參數，Google Ads 就不支援該轉換的自訂變數。取消設定轉換的 custom_variables 欄位。