Troubleshooting

This page covers common issues with the Google Ads conversion tracking integration and how to resolve them.

Checking Conversion Logs

All conversion uploads (successful and failed) are recorded in the conversion log. To review them:

1. Open Settings in the Pipedrive Utilities panel.
2. Go to Logs.
3. Select the Google Ads tab.

Each log entry shows the deal ID, conversion name, GCLID, value, status, and any error messages. Expand an entry to see the full request and response payloads sent to the Google Ads API.

Common Issues

Unauthorized (401)

Symptom: Webhook returns 401 Unauthorized.

Cause: The HTTP Basic Auth credentials in the Pipedrive Automation webhook are missing, incorrect, or do not match any configured company.

Resolution:

1. Go to Settings > Google Ads > Webhook section.
2. Verify the username and password shown match what is configured in your Pipedrive Automation.
3. If credentials were recently regenerated, update the Pipedrive Automation with the new values.

Unknown Conversion

Symptom: Conversion log shows Unknown conversion "X".

Cause: The conversion value in the webhook body does not match any configured conversion action name.

Resolution:

1. Check the Pipedrive Automation webhook body – ensure the conversion value exactly matches a configured conversion action name (case-sensitive).
2. If you renamed a conversion action, update the Pipedrive Automation to match.

GCLID Not Found

Symptom: Conversion log shows GCLID not found in configured deal field.

Causes:

• The GCLID Source Field in Google Ads settings does not match the actual Pipedrive deal field where the GCLID is stored.
• The deal field is empty – the GCLID was never captured for this lead.
• The field value is in an unexpected format that the parser cannot extract a GCLID from.

Resolution:

1. Verify the GCLID Source Field mapping in Settings > Google Ads.
2. Check the deal in Pipedrive to confirm the field has a value.
3. The parser accepts full URLs, query strings, and bare GCLID values. Ensure the field contains one of these formats.

GCLID Too New (Queued)

Symptom: Conversion log shows status queued with a message like GCLID too new — queued for retry.

Cause: This is expected behavior. Google Ads has not yet processed the ad click. The conversion has been queued and will be retried automatically every 30 minutes until the configured Retry TTL expires (default: 12 hours).

Resolution: No action needed. Monitor the Queues pane to track retry progress. See Retry Queue.

Google Ads Token Expired

Symptom: Conversion log shows Google Ads authentication expired or notification email with category gads_token_refresh_failed.

Cause: The Google OAuth token could not be refreshed. This happens when:

• The authorized Google account revoked access to the application.
• The Google account password was changed.
• The OAuth consent was removed from the Google account’s security settings.

Resolution:

1. Go to Settings > Google Ads.
2. Click Disconnect (if still showing connected).
3. Click Connect Google Ads and re-authorize.

MCC Account ID Not Configured

Symptom: Conversion log shows Google Ads MCC Account ID not configured.

Cause: The MCC (Manager) Account ID has not been entered in the Google Ads settings.

Resolution: Enter your MCC Account ID in Settings > Google Ads > MCC Account ID. The ID can be found in the top-left of Google Ads when logged into your manager account.

Google Ads API Upload Error

Symptom: Notification email with category gads_upload_failed, conversion log shows status error.

Cause: The Google Ads API rejected the upload. Common reasons include:

• Invalid GCLID format.
• Conversion action is disabled or deleted in Google Ads.
• The upload customer ID does not match the account where the click originated.
• Duplicate orderId (conversion already uploaded).

Resolution: Expand the log entry to view the full API error message and request/response payloads. The Google Ads error message usually indicates the specific issue.

Failure Notifications

The following notification categories are available for Google Ads. Subscribe to them in Settings > General > Notifications: