Troubleshoot Enhanced Conversions for Leads

Use this guide to help you troubleshoot issues in your enhanced conversions for leads integration.

Fix discrepancies in my uploads

There could be a number of reasons why your enhanced conversions for leads uploads are not processing successfully or are not appearing in the Google Ads UI as expected. Visit the Help Center for guidance around common setup issues that might lead to reporting discrepancies or uploaded conversions not appearing in the Google Ads UI.

Debug common errors

Error
NO_CONVERSION_ACTION_FOUND	The specified conversion action is either not enabled, or cannot be accessed by the client account specified by the `client_id` field in the request. Make sure the conversion action in your upload is enabled and is owned by the customer sending the upload request. This error may also occur if the GCLID in the request belongs to a client account that does not have access to the conversion action specified in the request. You can verify whether a GCLID belongs to a client account using the click_view resource, by submitting a query that filters by click_view.gclid and segments.date, where the date is the date the click occurred.
INVALID_CONVERSION_ACTION_TYPE	The specified conversion action has a type that is not valid for enhanced conversions for leads. Make sure the ConversionAction specified in your upload request has type UPLOAD_CLICKS.
CLICK_CONVERSION_ALREADY_EXISTS	A conversion with this conversion_date_time already exists for this click. Make sure the conversion_date_time is unique for each event and try again..
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	Make sure you've enabled enhanced conversions for leads in your conversion settings. Find instructions for this in the prerequisites guide.
DUPLICATE_ORDER_ID	Imported events include multiple conversions with the same Order ID and were not processed. Make sure Order IDs are unique and try again.
CLICK_NOT_FOUND	No click was found that matched the provided user identifiers. The Google Ads API only returns this error if debug_enabled is true on the UploadClickConversionsRequest. Note: Treat this error as a warning unless it occurs with the majority of your conversions. If a conversion encounters this warning, the Google Ads API includes it in the successful_event_count of your offline data diagnostics. The Google Ads API includes an entry for CLICK_NOT_FOUND in the alerts collection so you can monitor the frequency of this warning. This error is expected if the click is not from a Google Ads campaign. For example it may come from SA360 or DV360. Other possible causes are as follows: The uploading customer is different from the Google Ads conversion customer. Tagging is not correctly configured for your lead form. The uploaded data has not been correctly normalized and hashed. In rare instances where the uploading customer is different from the Google Ads conversion customer, this error can mean that the uploading customer has accepted the customer data terms, but the serving customer has not. You can determine if an account has accepted the customer data terms by querying the customer resource and checking the customer.offline_conversion_tracking_info.accepted_customer_data_terms field.

Additional troubleshooting support

If you have an issue that is not covered here, reach out through the Google Ads API technical support form and be sure to include Google Ads API request and response logs, plus any troubleshooting steps you've already attempted.