← Documentație

Google Ads: conversii offline (Data Manager API)

Ce face: Edge trimite evenimentele care au o acțiune de conversie configurată direct în Google Ads, prin Data Manager API (events:ingest), fără containerul server. Potrivirea se face după gclid (sau gbraid/wbraid), iar când click id-ul lipsește, după email/telefon hash („enhanced conversions for leads”). La refund (anulare/retur după ce profitul a plecat) trimite o retractare după order id, prin Google Ads API (Data Manager nu are încă ajustări). Echivalentul la Stape: tag-urile „Google Ads Offline Conversion”, „Conversion Adjustments” și power-up-ul „Google Service Account”.

Cele trei feluri de conexiune (în ordinea în care le încearcă Edge)

#ConexiuneCine face ceCând
1Contul Google al clientului (recomandat)Clientul apasă „Connect Google Ads” în Settings și se loghează cu utilizatorul Google care are deja acces la contul lui de reclame. Salvăm doar refresh token-ul, criptat, pe clientul respectiv.implicit
2Contul Google al Bigconvert (ads@bigconvert.com, membru în MCC)Adminul îl conectează o singură dată din Infrastructure. Clientul adaugă e-mailul ca utilizator Standard sau acceptă link-ul la MCC.când clientul nu a conectat contul propriu și „Allow Bigconvert's accounts as fallback” e bifat
3Conturi de serviciu (Advanced)JSON-ul clientului (proiectul lui Google Cloud) sau cheia platformei de pe node1. E-mail tehnic @…iam.gserviceaccount.com.doar când nimic de mai sus nu e conectat

Câmpul *Customer ID* se completează singur după conectarea cu contul clientului dacă acel utilizator vede un singur cont Google Ads; altfel apare o listă cu conturile vizibile. Header-ul login-customer-id se pune automat cu MCC-ul platformei la conexiunea 2 (sau cu „Manager (MCC) ID” din card, dacă e completat).

De ce Data Manager API (verificat 17.09.2026)

  • Din 15 iunie 2026 Google Ads API nu mai acceptă integrări noi pe ConversionUploadService.UploadClickConversions și pe enhanced conversions for leads:

developer token-urile fără trafic pe această metodă între decembrie 2025 și mai 2026 primesc CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE. Token-ul nostru e nou, deci calea veche nu ar fi mers niciodată live.

  • Data Manager API este „API-ul principal pentru importul conversiilor offline”: un singur endpoint pentru conversii și audiențe (Customer Match), fără developer token,

scope https://www.googleapis.com/auth/datamanager, model de eroare fast-fail (request-ul e acceptat sau respins întreg, cu motiv), validateOnly, fieldWarnings, max 2000 evenimente / request.

  • Ce rămâne pe Google Ads API: listarea conturilor și a acțiunilor de conversie (GAQL) și retractările (uploadConversionAdjustments) — acolo header-ul developer-token e încă necesar (token-ul platformei, configurat o singură dată de Bigconvert).
  • Diferențe față de calea veche: operatingAccount trebuie să fie contul care deține acțiunea (nu MCC-ul; MCC-ul merge în loginAccount), eventSource e obligatoriu (WEB implicit; APP / IN_STORE / PHONE / OTHER din card),

identificatorii hash se trimit cu encoding: HEX, ora conversiei în RFC 3339 UTC.

  • Calea veche rămâne în cod doar pentru token-uri allowlisted (Upload through: Google Ads API (legacy) în Advanced).

Surse: Google Ads Developer Blog, 15.05.2026, Data Manager API: Send events, events.ingest, Field mappings Google Ads API → Data Manager.

Ce face clientul (2 minute)

  1. Settings → Google Ads direct upload → Connect Google Ads → se loghează cu Google și bifează ambele permisiuni (Google Ads și Data Manager). Conexiunile făcute înainte de scope-ul Data Manager arată „reconnect needed” în card până la o nouă conectare.
  2. Alege Customer ID-ul din listă (sau îl scrie), Save, „Test connection & list conversion actions”.
  3. Acțiunea de conversie se creează în Google Ads ca Import → Other data sources / CRM → Track conversions from clicks; pentru potrivire fără gclid bifezi *enhanced conversions for leads*.
  4. Rândul eveniment → id acțiune (ex. profit), *Event source* (WEB pentru comenzi/lead-uri de pe site, IN_STORE pentru POS, PHONE pentru vânzări telefonice), prima trimitere cu Validate only bifat, apoi debifezi.

Deconectare: butonul „Disconnect” din card revocă token-ul la Google și șterge conexiunea; clientul poate oricând să retragă accesul și din myaccount.google.com → Security → Third-party access.

Reguli

  • Matricea Events are coloana Google Ads (API); profit și refund merg implicit pe API, restul evenimentelor doar dacă au acțiune și sunt bifate.

Nu bifa același eveniment și pe „Google Ads (server)” și pe API, ca să nu numeri dublu.

  • Semnalele de consimțământ ale vizitei pleacă în upload (consent.adUserData, adPersonalization).
  • Retractarea funcționează și pentru conversiile înregistrate de tag-ul din containerul server, dacă au avut transaction_id (îl trimitem mereu).
  • Ora conversiei se trimite în UTC: RFC 3339 în Data Manager (2026-09-16T10:30:05.000Z), yyyy-MM-dd HH:mm:ss+00:00 la retractări.
  • Răspunsul Data Manager e tot-sau-nimic: în Events, o linie googleads cu error înseamnă că evenimentul nu a fost înregistrat (motivul e în paranteză, ex. INVALID_GCLID); warning înseamnă înregistrat, dar cu un câmp ignorat.
  • 403 de la Data Manager = API-ul nu e activat în proiectul Cloud sau contul conectat nu e utilizator al contului Google Ads respectiv.
  • GADS_API_VERSION (implicit v23) se ridică atunci când Google retrage versiunea; butonul „Test connection” arată eroarea.