True Conversionsby Nexopath

Connecting Google Ads

Google Ads connects via OAuth. After authorizing, you provide the Customer ID and conversion action so True Conversions knows where to send matched conversions via Enhanced Conversions for Leads.

Prerequisites

Do this before connecting — it's the most common cause of "I connected everything and nothing reaches Google":

  1. A Google Ads account with admin or standard access.
  2. A conversion action created, type Import → Other data sources or CRMs (see Step 2 below).
  3. "Enhanced conversions for leads" enabled + customer-data terms accepted (see below). Without this, every send fails with CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS.
  4. The conversion action must be exclusive to True Conversions — don't reuse an action your site tag (Google Ads Tag / GTM) already fires into. If the same action receives conversions from two sources, they add up and inflate your results.

Enabling "Enhanced conversions for leads"

  1. In Google Ads, go to Goals → Conversions → Settings.
  2. Enable "Enhanced conversions for leads".
  3. Accept the customer-data terms when prompted.

Google's UI (since Apr 2026) only offers the "Google tag / GTM" method on this screen — there's no separate "API" option anymore. Enabling it via the tag option is enough: Google accepts tag and API uploads together once the account has it enabled. You don't need to install anything beyond what's already here.

Step 1: Authorize Google Ads

  1. In your True Conversions dashboard, open the account (client).
  2. Click Integrações de anúncios (Ad Integrations).
  3. In the Google Ads card, click Conectar Google Ads (Connect Google Ads).
  4. Select the Google account with access to the Google Ads account you want to connect.
  5. Review the permissions and authorize.
  6. You'll be redirected back to True Conversions with a success message.

Step 2: Configure the integration

Customer ID

The Google Ads account ID, in the top-right corner of the Google Ads UI (format 123-456-7890, with or without dashes).

Manager Account ID (optional)

Only fill in if you access the Google Ads account through an MCC (Manager Account). Leave blank if you access it directly.

Conversion Action

Click Carregar ações (Load Actions) to fetch the available conversion actions on the account and select the right one from the list.

If no conversion action exists yet:

  1. In Google Ads, go to Goals → Conversions → Summary.
  2. Click New conversion action.
  3. Select Import → Other data sources or CRMs → Track conversions from clicks.
  4. Name it something that identifies it as True Conversions-only (e.g., "TC - CRM") — remember, this action needs to be exclusive (see Prerequisites).
  5. Configure value, count, and attribution window as needed.
  6. Save, return to True Conversions, and click Carregar ações to select it.

The Salvar configuração (Save Configuration) button only enables once both the Customer ID and conversion action are filled in. Until a conversion action is chosen, the account checklist's step 2 · Plataforma de anúncios (Ad platform) shows an amber "Conectado — falta configurar" ("Connected — needs configuration") state — Google is authorized, but nothing will send until you finish this part. A matching amber warning also appears on this page, below the conversion action field, until one is selected.

How it works

When True Conversions processes a conversion event:

  1. The contact's PII (email, phone, name) is hashed with SHA-256.
  2. If a gclid is mapped (see Field Mapping), it's included as the primary match signal — but it's not required: without it, Google still attempts matching on the hashed PII.
  3. The hashed data and conversion details (value, currency, timestamp) are uploaded via the Google Ads API.
  4. If the account uses Value Optimization, the value evolves as the deal moves through stages, and is automatically restated up to Closed-Won.

The delivery result is visible in Eventos recentes (Recent Events) on the account page, and summarized on Envios e qualidade (Delivery & Quality).

Re-authorizing

If the OAuth token expires, the status will show Expirada (Expired) with a banner on the Ad Integrations page ("Token expirado. Reautorize para restaurar a conexão." — "Token expired. Re-authorize to restore the connection."). Click Reautorizar (Re-authorize) — Customer ID and conversion action settings are preserved.

Disconnecting

Click Desconectar (Disconnect) on the Google Ads card. This removes the stored credentials and configuration from True Conversions. Nothing changes in your Google Ads account.

Common issues

See the delivery-error table in Troubleshooting — it includes the walkthrough for CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS and other Google errors.