疑難排解

管理轉換需要複雜的整合，通常涉及多個相互依賴的工具和程序。本指南提供詳細步驟，協助您排解遇到的問題，無論是 API 傳回不明錯誤，還是對使用者介面中顯示的指標或診斷資訊有疑問，都能迎刃而解。

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

在 Google Ads UI 中查看指標

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

待開發客戶強化轉換問題

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

常見錯誤

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

錯誤
NO_CONVERSION_ACTION_FOUND	指定的轉換動作未啟用，或要求中 customer_id 欄位指定的客戶帳戶無法存取。請確認上傳的轉換動作已啟用，且屬於傳送上傳要求的客戶。 如果要求中的 Google 點擊 ID 屬於客戶帳戶，但該帳戶無權存取要求中指定的轉換動作，也可能發生這項錯誤。您可以提交依 click_view.gclid 和 segments.date 篩選的查詢，使用 click_view 資源驗證 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 在 alerts 集合中包含 CLICK_NOT_FOUND 項目，方便您監控這項警告的頻率。 如果點擊並非來自 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 相符的轉換。確認轉換是 Google Ads 轉換，適用於要求 customer_id 中指定的 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 錯誤。如要進一步瞭解其他歸因模式的淘汰事宜，請參閱網誌文章。

• 對於 AD_CALL 和 WEBSITE_CALL 類型的轉換動作，click_through_lookback_window_days 欄位的允許範圍為 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，避免重複上傳先前上傳的轉換。
EXPIRED_EVENT	匯入的點擊發生在 click_through_lookback_window_days 欄位指定的時間範圍之前。變更click_through_lookback_window_days 只會影響變更後記錄的點擊，因此變更回溯期無法解決特定點擊的這項錯誤。視情況將conversion_action變更為回溯期較長的其他動作。
CONVERSION_PRECEDES_EVENT	conversion_date_time 早於點擊日期和時間。將 conversion_date_time 更新為較晚的值。
VALUE_MUST_BE_UNSET	ClickConversion 的 gbraid 或 wbraid (不含 gclid) 已設定值，且 custom_variables 或 cart_data 也有值，但 Google Ads 不支援 gbraid 或 wbraid。取消設定衝突的欄位。 注意：如果轉換同時設定 gbraid 和 wbraid，且同一轉換的其他欄位驗證檢查失敗，API 可能會傳回 GBRAID_WBRAID_BOTH_SET。修正轉換的其他驗證問題。您不需要移除點擊 ID。