疑難排解

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

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

在 Google Ads UI 中查看指標

Google Ads 使用者介面不會依匯入日期整理轉換指標，因此在使用者介面中使用廣告活動報表來驗證匯入結果，可能會造成誤導。如要驗證 API 要求層級的匯入健康狀態，請先進行離線資料診斷。離線資料診斷不會評估非同步代碼比對，或強化轉換的使用者 ID 品質。如要驗證比對健康狀態，請查看 Google Ads 使用者介面診斷報告，瞭解待開發客戶強化轉換和網站強化轉換。如需疑難排解步驟，請參閱「成功上傳 API 後的使用者介面診斷快訊」。

待開發客戶強化轉換問題

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

常見錯誤

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

錯誤
NO_CONVERSION_ACTION_FOUND	指定的轉換動作未啟用，或要求中 customer_id 欄位的帳戶無法存取該動作。確認上傳的轉換動作已啟用，且擁有者是點擊的 Google Ads 廣告轉換客戶，或上傳帳戶轉換追蹤階層中的帳戶。 如果要求中的 Google 點擊 ID 屬於客戶帳戶，但該帳戶無權存取要求中指定的轉換動作，也可能發生這項錯誤。您可以透過 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 在 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 產品支援團隊尋求協助。

網站強化轉換問題

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

常見錯誤

以下指引可協助您診斷及修正網站強化轉換的常見錯誤。

錯誤
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS	要求的customer_id尚未接受顧客數位資料條款及細則。如需操作說明，請參閱必備條件指南。
CONVERSION_ALREADY_ENHANCED	這項轉換已收到ENHANCEMENT調整項，其中包含指定的order_id和conversion_action欄位。請務必為每項轉換提供不重複的 order_id 值。
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT	提供的 conversion_action 不符合網站強化轉換的使用資格。在 Google Ads 使用者介面中，請務必在要求中參照的轉換動作上，勾選「啟用強化轉換」方塊。如需操作說明，請前往說明中心。
INVALID_USER_IDENTIFIER	雜湊使用者 ID 欄位 (hashed_email、hashed_phone_number、hashed_first_name、hashed_last_name 或 hashed_street_address) 不是有效的 64 字元十六進位 SHA-256 摘要。請先對使用者提供的資料進行正規化和雜湊處理，再匯入資料。如需操作說明，請參閱「正規化及雜湊處理使用者提供的資料」。
CONVERSION_NOT_FOUND	Google Ads 找不到與提供的 conversion_action 欄位和轉換 ID (order_id 或 gclid_date_time_pair) 相符的轉換。這項錯誤僅適用於 RESTATEMENT 和 RETRACTION 調整項。詳情請參閱「匯入轉換調整項相關規定」。 對於 ENHANCEMENT 調整項，API 會接受要求，不會傳回 CONVERSION_NOT_FOUND 錯誤，並以非同步方式評估代碼與 API order_id 比對。如果 order_id 值不相符的比率過高，Google Ads 使用者介面的強化轉換診斷報告會觸發訂單 ID 不相符快訊。如需疑難排解步驟，請參閱「成功上傳 API 後的使用者介面診斷快訊」。

成功上傳 API 後的使用者介面診斷快訊

使用 ConversionAdjustmentUploadService 服務上傳ENHANCEMENT調整項時，API 會在擷取時驗證要求格式，並以非同步方式將強化資料與網站代碼事件進行比對。因此，API 要求可能會成功，partial_failure_error 欄位中不會出現錯誤，且離線資料診斷中會顯示 EXCELLENT 狀態。同時，Google Ads 使用者介面中的強化轉換診斷報告仍會顯示快訊。

如果 API 上傳成功後，使用者介面診斷頁面顯示診斷快訊，請檢查下列原因：

• 缺少必填地址欄位：address_info 欄位中的 OfflineUserAddressInfo 物件需要同一項目中的四個欄位：hashed_first_name、hashed_last_name、country_code 和 postal_code。hashed_street_address、city 和 state 欄位為選填 (如果填入 hashed_street_address 欄位，仍須為有效的 64 個字元 SHA-256 十六進位摘要)。API 接受非空白的部分 address_info 物件 (例如僅限名字和姓氏)，不會在 partial_failure_error 欄位中傳回錯誤。不過，下游比對會捨棄不完整的地址，並觸發缺少地址欄位的警示。如果缺少四個必要欄位中的任何一個，請省略 address_info 欄位的 UserIdentifier 物件。

• 網站代碼事件缺少交易 ID：在 API 中，如果 ENHANCEMENT 調整項缺少 order_id 欄位，系統會傳回同步 FieldError.REQUIRED 錯誤。如果 API 要求包含 order_id 欄位，使用者介面會顯示「轉換事件缺少交易 ID」快訊，表示網站代碼有問題。如果網站轉換代碼事件中，包含有效交易 ID 的比例低於 90% (或代碼傳送 "undefined" 或 "null" 等預留位置字串)，就會顯示這則快訊。請設定網站轉換代碼，為每個轉換事件傳送專屬交易 ID。

• 代碼和 API 訂單 ID 不一致或上傳時間過晚：如果是 ENHANCEMENT 調整項，API 不會在資料上傳時傳回 CONVERSION_NOT_FOUND 或 CONVERSION_EXPIRED 錯誤。相反地，如果 order_id 值不相符，使用者介面會觸發訂單 ID 不符快訊；如果強化資料在上傳時，距離轉換時間已超過 24 小時，則會觸發延遲上傳快訊。將 API order_id 欄位與網站轉換代碼傳送的確切交易 ID 字串進行比對，並在轉換事件發生後的 24 小時內上傳強化資料。

• 上傳前雜湊處理未正規化的使用者資料：雜湊處理未正規化的值 (例如大寫字母、開頭或結尾空白，或非 E.164 格式的電話號碼)，仍會產生有效的 64 個字元 SHA-256 十六進位摘要。API 會接受上傳，不會傳回 INVALID_USER_IDENTIFIER 錯誤，但下游比對會失敗，並回報格式或媒合率偏低的快訊。請按照「正規化及雜湊處理使用者提供的資料」一文中的正規化規則操作。

• API 強化資料量低於網站代碼資料量：使用者介面診斷功能會比較含有使用者 ID 的簡化 API 強化資料，以及已取得同意聲明的簡化網站代碼事件：

  • 同意聲明模式設定：Google 代碼的同意聲明模式發出 ad_storage='denied' 設定信號時，使用者介面診斷會將未同意的網站代碼事件排除在比較範圍之外，因此從 API 上傳中省略這些事件不會觸發低量快訊。不過，如果網站代碼和後端觸發條件的同意聲明處理方式不一致，系統會發出快訊：

    • 代碼缺少 ad_storage='denied'，後端略過上傳：使用者介面診斷會將代碼事件計為已同意，並回報低涵蓋率警示。
    • 代碼信號 ad_storage='denied'，後端上傳強化： 上傳的強化資料缺少相符的同意聲明代碼事件，導致訂單 ID 不符快訊。

    為網站代碼和 API 強化上傳資料套用相同的同意聲明狀態。

  • 匿名網站事件：如果網站代碼會針對匿名訪客觸發，請勿在漏斗前段轉換動作 (例如網頁瀏覽或商品瀏覽) 啟用強化轉換。如果伺服器只針對已登入且聯絡資料明確的使用者傳送 API 強化資料，不相符的匿名代碼事件就會觸發涵蓋率偏低的警示。請只在能持續取得使用者提供資料的轉換動作上，啟用強化轉換。

一般轉換管理問題

請留意下列常見問題：

• 如果嘗試將任何列舉欄位設為 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 欄位的帳戶無法存取。擷取轉換追蹤設定的相關資訊，確認轉換動作已啟用。轉換動作擁有者必須是點擊的 Google Ads 廣告轉換客戶，或上傳帳戶轉換追蹤階層中的帳戶。舉例來說，如果轉換動作屬於點擊後取消連結的前管理員帳戶，就會發生這項錯誤。
TOO_RECENT_CONVERSION_ACTION	轉換動作是新建立的。建立動作後，請等待至少 6 小時，再重試失敗的轉換。
INVALID_CUSTOMER_FOR_CLICK	要求中的 customer_id 欄位與點擊時的 Google Ads 轉換客戶不符。如果上傳帳戶也缺少轉換動作的跨帳戶存取權，就會發生這項錯誤。將要求的 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。