Docs

Connect Google Ads

Org-level Google OAuth, then per-store conversion mapping. Profit Bid uploads click conversions (gclid / gbraid / wbraid) with product profit by default via uploadClickConversions — not a browser tag alone.

Catrinoiu Barna Alex AlinUpdated July 25, 2026

Steps

Open Google Ads settings. Go to /app/google-ads. Wizard steps: Connect → Account → Conversion.
Connect with Google. Authorize with scope adwords. Callback: /api/app/google-ads/callback. Select the customer (or MCC child) that should receive uploads.
Pick or create a conversion action. Only ENABLED Import from clicks (UPLOAD_CLICKS) actions appear. Use Create “WT - Gross Profit” if you need a dedicated action. Copy in-app: “Pick an Import from clicks conversion. Profit Bid sends product profit…”
Set value mode & consent fallback. Default value mode: Product profit (POAS). Alternatives: Profit + shipping (POAS), Order revenue (ROAS). Set store consent fallback (granted / denied / unspecified) used when an order has no CMP signal.
Confirm “Ready”. When mapping is complete you should see “Ready — product profit uploads enabled”. Then open Conversions sent to watch the log.

How uploads work

Orders with a Google click ID are queued for Google Ads API uploadClickConversions. Enhanced Conversions hashed userIdentifiers are attached only when ad user data consent is GRANTED. Adjustments use uploadConversionAdjustments (RETRACTION / RESTATEMENT) when order status mapping says so.

Statuses you will see: pending, sent, skipped, failed, retracted, adjusted. Retries: up to 10 attempts, base delay 30 minutes, max delay 6 hours.

Conversion value modes

Select labels match the product UI:

Product profit (POAS) — default; net product profit (revenue − COGS with VAT rules)
Profit + shipping (POAS) — product net + shipping net (uses My shipping cost)
Order revenue (ROAS) — uploads revenue; bidding becomes classic ROAS, not POAS

Per-store mapping & MCC

Google connection is org-level; conversion mapping is per store (google-ads-store-mapping). Agencies: use Agency Requests / Google Ads agency-requests so the manager account can upload for the client. Do not map two stores to conflicting primary purchase actions without a clear naming convention.

Where to verify

In-app: /app/google-ads/conversions (Conversions sent) and Orders → Conversions column (gads_upload_status / error). In Google Ads: the Import from clicks conversion diagnostics after Google processes the upload.

Pricing