疑難排解

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

在 Google Ads UI 中讀取指標

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

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

常見錯誤

錯誤
NO_CONVERSION_ACTION_FOUND	指定的轉換動作未啟用，或是無法由要求中 `client_id` 欄位指定的客戶帳戶存取。請確認上傳資料中的轉換動作已啟用，且由傳送上傳要求的客戶擁有。 如果要求中的 GCLID 屬於無法存取要求中指定轉換動作的用戶端帳戶，也可能發生這個錯誤。您可以使用 click_view 資源，透過提交依 click_view.gclid 和 segments.date 篩選的查詢，確認 GCLID 是否屬於客戶帳戶。其中日期為點擊發生的日期。
INVALID_CONVERSION_ACTION_TYPE	指定的轉換動作類型不適用於待開發客戶強化轉換。請確認上傳要求中指定的 ConversionAction 為 UPLOAD_CLICKS 類型。
CLICK_CONVERSION_ALREADY_EXISTS	這個點擊已存在具有相同 conversion_date_time 的轉換資料。請確認 conversion_date_time 對每個事件皆不重複，然後再試一次。
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	請確認已在轉換設定中啟用待開發客戶強化轉換。如需相關操作說明，請參閱前置條件指南。
DUPLICATE_ORDER_ID	匯入的事件包含具有相同訂單 ID 的多個轉換，因此無法處理。請確認訂單 ID 並未重複，然後再試一次。
CLICK_NOT_FOUND	找不到與提供的使用者 ID 相符的點擊。只有在 debug_enabled 為 UploadClickConversionsRequest 上的 true 時，Google Ads API 才會傳回這項錯誤。 如果轉換遇到這項警告，Google Ads API 會將其納入離線資料診斷的 successful_event_count 中。Google Ads API 會在 alerts 集合中加入 CLICK_NOT_FOUND 項目，方便您監控這項警告的發生頻率。 如果點擊並非來自 Google Ads 廣告活動，就會發生這項錯誤。例如可能來自 SA360 或 DV360。其他可能的原因如下： 上傳客戶與 Google Ads 轉換客戶不同。 待開發客戶表單的代碼設定有誤。 上傳的資料未經過正確的 規格化和雜湊處理。 在極少數情況下，上傳客戶與 Google Ads 轉換客戶不同，這類錯誤可能表示上傳客戶已接受客戶資料條款，但放送客戶並未接受。 如要判斷帳戶是否已接受顧客數位資料條款，請查詢 customer 資源並檢查 customer.offline_conversion_tracking_info.accepted_customer_data_terms 欄位。

指標有落差

請注意下列常見問題：

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

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

• 如果您使用待開發客戶強化轉換，但網頁上沒有 Google 代碼，則必須在每個轉換中設定 ClickConversion.gclid 欄位，才能在匯入轉換時加入 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 UI 中，請務必勾選要求中參照的轉換動作的「啟用強化轉換」方塊。如需操作說明，請前往說明中心。

一般轉換管理問題

請注意下列常見問題：

• 如果嘗試將任何列舉欄位設為 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, 30]。

• 對於大多數轉換動作，view_through_lookback_window_days 欄位的允許範圍為 [1, 30]。如果轉換動作的類型為 AD_CALL 和 WEBSITE_CALL，則必須取消設定這個欄位。

• 在轉換動作上設定或更新 include_in_conversion_metrics 欄位會導致 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	請檢查 GoogleAdsError 的 location，判斷是哪一個問題導致錯誤。 ClickConversion 已為 gclid 設定值，以及至少一個 gbraid 或 wbraid。更新轉換，只使用一個點擊 ID，並確保不會將多個點擊合併為同一個轉換。每個點擊都只有一個點擊 ID。 ClickConversion 已設定 gbraid 或 wbraid 的值，並且有 custom_variables 的值。Google Ads 不支援含有 gbraid 或 wbraid 點擊 ID 的轉換自訂變數。取消設定轉換的 custom_variables 欄位。