API di conversione

1. Perché usare il server?

Prima di segnalare una conversione, un pixel nel browser deve superare tre ostacoli: ad blocker, prevenzione del tracciamento e chiusura della scheda prima dell’attivazione. Una chiamata server supera tutti e tre perché non avviene nel browser.

MousePlayer sa già quando viene raggiunto un obiettivo: è a questo che servono gli obiettivi. Le API di conversione inoltrano semplicemente questo fatto alla rete pubblicitaria dal nostro server.

2. Cosa inviamo e cosa non inviamo mai

L’unico elemento che identifica il visitatore in queste chiamate è il cookie o identificativo di clic impostato dalla rete stessa. Nessun altro dato personale lascia il nostro server.

Rete	Identificativo usato	Origine
Meta	_fbp, _fbc	Cookie di prima parte impostati dal pixel Meta
LinkedIn	li_fat_id	Cookie di prima parte impostato dal LinkedIn Insight Tag
TikTok	_ttp, ttclid	_ttp è un cookie, ttclid proviene dall’URL del clic pubblicitario
Google Ads	gclid, wbraid, gbraid	Dall’URL del clic pubblicitario o dal cookie _gcl_aw successivamente
Microsoft Advertising	msclkid	Dall’URL del clic pubblicitario o dal cookie _uetmsclkid scritto dal tag UET

Solo con consenso

Tutte queste chiamate sono soggette allo stesso controllo del consenso della registrazione. Una sessione senza consenso non produce segnalazioni di conversione, indipendentemente dall’interruttore nelle impostazioni del progetto.

3. Google Ads ha tre identificativi, non uno

Questo sorprende spesso, quindi è bene chiarirlo. Google usa gclid per un singolo clic pubblicitario. Quando la prevenzione del tracciamento di Apple impedisce di attribuirlo, Google invia wbraid oppure gbraid al suo posto, che rappresentano un gruppo di clic.

I tre si escludono a vicenda: Google rifiuta una conversione che ne contiene due. Ne inviamo esattamente uno e gclid ha la precedenza quando ne sono presenti diversi, perché è il più preciso.

Compaiono nell’URL una sola volta

L’identificativo compare nell’indirizzo solo sulla prima pagina dopo il clic pubblicitario. Il tag Google lo salva poi nel cookie _gcl_aw . Leggiamo il cookie come alternativa: senza di esso una conversione sulla terza pagina non troverebbe alcun identificativo.

4. Configurazione

Meta, LinkedIn e TikTok

Due campi ciascuno: l’ID del pixel o della regola di conversione e un token di accesso creato nell’interfaccia della rete. Entrambi sono conservati cifrati con AES-256-GCM e non vengono più mostrati dopo il salvataggio.

Google Ads ne richiede sei

Google è l’eccezione, e conviene sapere perché prima di iniziare: diversamente dalle altre tre reti, non rilascia un semplice token di accesso. L’accesso usa OAuth con un token di aggiornamento e l’Ads API richiede anche un token sviluppatore.

Campo	Dove trovarlo
ID cliente	In alto a destra in Google Ads. Solo cifre, senza trattini.
ID azione di conversione	Obiettivi e conversioni, poi l’azione a cui attribuirla.
Token sviluppatore	Nel suo account amministratore Google Ads, Centro API.
ID client e secret OAuth	Google Cloud Console, Credenziali, client OAuth di tipo «App desktop».
Token di aggiornamento	Lo genera una volta per l’ambito adwords.

LinkedIn ha due percorsi: scelga quello breve

In Campaign Manager: Dati, Gestione segnali, API diretta, Genera token di accesso. È il percorso per gli inserzionisti che inviano i propri dati: nessuna app sviluppatore o revisione. Il token non scade e Campaign Manager non lo mostrerà una seconda volta, quindi lo copi subito.

L’altro percorso, un’app richiesta dal portale sviluppatori LinkedIn, serve alle piattaforme che inviano dati per molti inserzionisti. Richiede verifica della pagina aziendale e approvazione del caso d’uso: qui non serve nulla di tutto ciò.

Microsoft Advertising è il più semplice

Dopo Google Ads ci si aspetta la stessa complessità: OAuth, token sviluppatore e approvazione. È il contrario: due campi. L’ID del tag UET già usato nel browser e un token copiato in Microsoft Advertising, sotto il tag UET, «Usa API di conversione», «Copia token». Nessuna richiesta da presentare.

Usi lo stesso ID del tag nel browser. È ciò che permette a Microsoft di riconoscere l’evento server e quello browser come una conversione anziché due.

5. Quando viene segnalata una conversione

Esattamente una volta per obiettivo e sessione. MousePlayer elimina i duplicati prima della chiamata e i dati includono un ID per consentire alla rete una seconda verifica. Un visitatore che aggiunge cinque articoli al carrello produce una conversione, non cinque.

Cosa vedrà nell’account pubblicitario

La conversione contiene il nome dell’obiettivo, valore e valuta se definiti, e l’ora in cui è avvenuta. Normalmente arriva entro un minuto.

Se non arriva nulla

• Nessun identificativo di clic. Il visitatore non è arrivato da un annuncio della rete o è arrivato prima che il pixel impostasse il cookie. Non viene inviato nulla: è previsto, non un errore.
• Nessun consenso. Il controllo del consenso è intervenuto prima.
• La rete ha accettato la chiamata ma rifiutato la conversione. Google, TikTok e altri rispondono HTTP 200 con un errore nel corpo. Leggiamo il corpo, non solo lo stato, e il motivo compare nel registro delle consegne.