Google Ads primește conversii din apeluri prin Data Manager API

Google a adăugat pe 4 noiembrie conversiile din apeluri în Data Manager API. Versiunea 1.9 permite trimiterea către Google Ads a unui rezultat comercial asociat unui apel telefonic, cum ar fi o vânzare înregistrată ulterior. Actualizarea adaugă și pozițiile înregistrărilor afectate în diagnostice, astfel încât o integrare să poată identifica evenimentele care au generat fiecare eroare sau avertizare după trimiterea unui lot.

Ce legătură stabilește importul între apel și conversie

Importul folosește datele pe care firma le înregistrează despre apel și despre rezultatul lui. Google descrie cazul în care un sistem CRM păstrează numărul apelantului, ora de început și informația că discuția a dus la o vânzare. Rezultatul poate fi înregistrat când se produce. În rapoartele campaniei, măsurarea urmărește astfel rezultatul comercial pe care firma l-a definit drept conversie.

Pentru acest tip de import, Google Ads folosește numerele sale de redirecționare. România figurează pe lista de țări în care acestea sunt disponibile. Condițiile diferă după proveniența apelului. Pentru apeluri direct din anunț este necesar un element de apel sau un anunț pentru apeluri cu număr de redirecționare Google. Pentru apeluri de pe site, documentația prevede un element de apel aplicat campaniei urmărite.

Numerele de redirecționare sunt alocate de Google pentru măsurare și pot fi realocate. Dacă o persoană salvează numărul după primul apel, acesta continuă să redirecționeze către firmă timp de 60 de zile. Un nou apel în acest interval repornește perioada de 60 de zile. La expirarea ei, numărul salvat nu mai redirecționează către aceeași firmă. Acest interval privește conectarea apelului prin numărul Google.

Destinația din cererea API identifică acel cont Google Ads care deține acțiunea de conversie. Acțiunea trebuie să aibă tipul UPLOAD_CALLS, afișat în interfață ca sursă de conversie Call from Ads. Evenimentul conține atât ora conversiei, cât și ora de început a convorbirii în callInfo.startTimestamp. Momentul conversiei poate coincide cu începutul apelului sau îl poate urma. Valoarea conversiei și moneda sunt câmpuri opționale.

Numărul apelantului este transmis în datele de identificare ale evenimentului. Google cere normalizarea la formatul internațional E.164, cu semnul plus, prefixul de țară și cifrele numărului, urmată de calcularea unui hash SHA-256. Rezultatul se codifică în format hexazecimal sau Base64. Câmpul de codificare din cerere indică formatul utilizat, astfel încât serviciul să interpreteze corect valoarea primită.

Trecerea de la Google Ads API schimbă și felul în care sunt tratate duplicatele. Google Ads API returnează o eroare de duplicat pentru un apel deja importat. Data Manager API acceptă aceste evenimente în cerere, iar Google Ads le deduplică după procesare. Ghidul de migrare arată și diferența dintre numărul neprelucrat din vechiul câmp caller_id și identificatorul normalizat, transformat prin hashing și codificat în noua integrare.

Primirea lotului și procesarea înregistrărilor

O solicitare cu erori de structură sau cu un câmp obligatoriu invalid este respinsă integral la validarea inițială. Problemele din câmpuri opționale pot apărea ca avertizări. Opțiunea validateOnly efectuează această verificare fără import. Verificările care depind de prelucrarea ulterioară, cum ar fi asocierea evenimentului cu datele disponibile la destinație, sunt comunicate prin diagnostice după acceptarea cererii.

La acceptare, operațiunea events.ingest returnează un identificator al cererii. Integrarea îl folosește pentru a verifica ulterior starea la fiecare destinație. Google separă starea de procesare de rezultatele finale, care pot indica succes, succes parțial sau eșec. Pentru un lot cu mai multe destinații, fiecare are propriul rezultat. Într-un flux de raportare, confirmarea inițială arată că lotul a trecut validarea și a intrat în prelucrare.

Câmpul nou record_indices indică pozițiile din lista trimisă, cu numerotare de la zero. Același eveniment poate apărea în diagnosticele mai multor destinații sau sub mai multe motive pentru aceeași destinație. O eroare indică respingerea înregistrării. O avertizare arată că aceasta a putut fi procesată cu o parte dintre date ignorată. Indicii se raportează la ordinea inițială, inclusiv când lotul conține înregistrări care au fost prelucrate cu succes.

Versiunea 1.9 adaugă și motive distincte pentru probleme legate de timp sau de eligibilitatea apelului. Printre ele se află conversia înregistrată înaintea convorbirii, apelul prea recent, apelul expirat și apelul invalid. Există și un motiv pentru o destinație creată prea recent. Împreună cu poziția evenimentului în lot, aceste categorii arată care înregistrare necesită verificarea datelor și ce condiție a semnalat serviciul.

Identificatorii trimiși și atribuirea conversiei

Google a introdus și câmpul lead_id, pentru identificatorul generat când o persoană trimite un formular de client potențial. Acesta și câmpul existent match_id pot însoți evenimente offline sau din mai multe surse către Google Ads, Floodlight și Google Analytics. La data anunțului, atribuirea pe baza acestor doi identificatori nu era disponibilă. Asocierea evenimentelor continuă să folosească identificatori acceptați pentru destinația și tipul conversiei.

Google limitează o cerere de import la 2.000 de evenimente și zece destinații. Cotele sunt aplicate proiectului Google Cloud, cu limite separate pentru citire și scriere la serviciul de import. Astfel, lista de poziții din diagnostice aparține unei singure cereri, iar identificatorul cererii păstrează legătura cu lotul din care provin. Pentru firmele care transmit apeluri din mai multe conturi, aceeași integrare poate distinge destinația, înregistrarea și motivul raportat pentru fiecare problemă.