Tracciamento server-side delle conversioni nel 2026: guida pratica alla Conversion API per Meta, Google e annunci ChatGPT

In breve: una Conversion API è l'interfaccia alla base del tracciamento server-side delle conversioni. Invia gli eventi di conversione, come una vendita, l'invio di un modulo o una registrazione, dal server della sua azienda a una piattaforma pubblicitaria, anziché dal browser del visitatore. In Meta si chiama Conversions API (CAPI). In Google lo stesso compito spetta alle conversioni avanzate (enhanced conversions) e alla Data Manager API, mentre gli annunci di ChatGPT usano la Conversions API di OpenAI. Meta consiglia di usare la CAPI insieme al Pixel, non al suo posto: lo stesso evento arriva sia dal browser sia dal server e un ID evento condiviso (event_id) permette di deduplicarlo. Il vero valore di una configurazione server-side è che i dati ricevuti dalle piattaforme provengono dai record degli ordini e del CRM, non dal browser.

Abbiamo scritto questa guida per i responsabili marketing e software di aziende e-commerce e B2B che investono regolarmente in pubblicità su Meta e Google e che hanno un sito web o un CRM sviluppato su misura (Laravel, Node.js, .NET) oppure chiudono le vendite offline. Se vende in Turchia o lavora con partner turchi, troverà utili anche le sezioni sui dati dei clienti turchi e sulla KVKK, la legge turca n. 6698 sulla protezione dei dati personali. Abbiamo verificato le informazioni sulla documentazione di Meta, Google e OpenAI e sulla normativa turca in materia di protezione dei dati; le fonti secondarie sono indicate separatamente. Articolo aggiornato al 31 ottobre 2026.

Che cos'è una Conversion API e in che cosa il tracciamento server-side delle conversioni differisce dal Pixel?

Il Pixel è un frammento di JavaScript che invia l'evento dal browser del visitatore. Un ad blocker, una restrizione del browser o una pagina che non finisce di caricarsi possono far perdere l'evento lungo il percorso. Con una Conversion API è il suo server a creare l'evento e a inviarlo direttamente all'API della piattaforma. Può così inviare anche eventi che il browser non vede mai, come una conferma di pagamento, una vendita conclusa in negozio o un lead contrassegnato come «qualificato» nel CRM.

Che cos'è Meta CAPI? È l'interfaccia server-side di Meta per gli eventi. Viene cercata anche come «Facebook Conversion API». Il Centro assistenza di Meta in lingua turca la chiama «Dönüşümler API'si», un dettaglio utile se il suo team o la sua agenzia in Turchia usa Meta in turco. Meta consiglia di usare la CAPI insieme al Pixel; la sua documentazione per sviluppatori parla di «redundant setup», cioè di configurazione ridondante. Se l'eventID del Pixel corrisponde all'event_id della CAPI e i nomi degli eventi sono uguali, le due copie contano come un solo evento. Questa deduplicazione tramite event_id funziona entro 48 ore dalla ricezione del primo evento con quell'ID e di solito Meta conserva la copia che arriva per prima. Il metodo alternativo, basato su fbp o external_id, in genere riesce ad abbinare gli eventi solo quando la copia del browser arriva prima di quella del server. Assegni quindi a ogni evento un event_id univoco.

In Google l'equivalente si compone di due parti: le conversioni avanzate, che inviano insieme alla conversione un indirizzo email e un numero di telefono sottoposti ad hashing, e la Data Manager API, ora la via principale per importare le conversioni offline. Per gli annunci di ChatGPT, la Conversions API di OpenAI funziona secondo lo stesso principio.

Plug-in pronto, configurazione con un clic o integrazione Conversion API su misura?

Non tutte le aziende hanno bisogno di una configurazione su misura. Il 15 aprile 2026 Meta ha annunciato una configurazione CAPI con un clic per gli eventi web, che non richiede competenze tecniche, costi né manutenzione; le configurazioni esistenti, tramite partner o su misura, non cambiano. Secondo PPC Land, questa configurazione copre solo il web e non consente di scegliere quali eventi e parametri inviare: tutto ciò che invia il Pixel parte anche dal server. Gli eventi da app e quelli offline richiedono un'integrazione separata. Altre opzioni pronte sono l'estensione «Facebook Conversion API» di ikas, una piattaforma e-commerce turca, e i livelli di condivisione dei dati di Shopify che usano la CAPI.

In una piattaforma e-commerce sviluppata su misura, l'approccio più pulito è creare l'evento dalla tabella degli ordini. Abbiamo discusso una scelta analoga tra soluzione pronta e su misura nel nostro articolo sul collegamento di un sito e-commerce a ERP e fatturazione elettronica.

Che cosa è cambiato nel 2026 in Meta, Google e OpenAI?

La maggior parte dei cambiamenti viene da Google. La riga del 12 novembre si basa su fonti secondarie.

12 novembre 2026: che cosa cambia con l'impostazione di Meta «misurazione delle conversioni sui dispositivi dei clienti»?

Nel Centro assistenza di Meta c'è un articolo intitolato «About measuring conversions on customer devices». I dettagli provengono da pubblicazioni di settore che citano il testo del pannello di Events Manager e l'email inviata da Meta agli inserzionisti. Secondo PPC Land, Events Manager mostra la dicitura «Measurement starting November 12, 2026» sotto l'opzione «Measure conversions on customer devices». L'opzione è attiva per impostazione predefinita nei dataset che inviano eventi. Si può disattivare per singolo dataset in qualsiasi momento e non richiede modifiche al codice. Secondo la stessa fonte, il rollout sarà graduale a partire dal 12 novembre. Secondo MetricMaven, che cita Meta, l'abbinamento avviene sul dispositivo del cliente. Meta viene a sapere soltanto che un acquisto è avvenuto e a quale campagna va attribuita la conversione. La finestra e il modello di attribuzione non cambiano.

Secondo MetricMaven e Stape, la funzione non è attiva per le persone che si trovano nell'UE e nel Regno Unito. Esistono inoltre condizioni di idoneità, come il fatto che il sito web richieda l'accesso con indirizzo email o numero di telefono. Se così fosse, i negozi online con checkout come ospite potrebbero restarne esclusi. I punti che Meta non ha ancora chiarito sono decisivi: come verranno deduplicati gli acquisti recuperati rispetto agli eventi CAPI, quale effetto avrà la funzione sulle offerte, se valore e valuta vengono trasmessi e come viene gestito il consenso. Anche la tempistica è delicata: il 12 novembre arriva subito dopo le campagne dell'11.11 (Singles' Day) e 15 giorni prima del Black Friday del 27 novembre. Il nostro consiglio è di decidere sulla base delle misurazioni, non di disattivare l'impostazione alla cieca. Ecco la nostra checklist, in linea con le fonti di settore:

1. Registri lo stato attuale: per ogni dataset annoti se l'impostazione è attiva o disattivata. Aggiunga un marcatore al 12 novembre nelle dashboard e nei report dell'11.11 e del Black Friday.
2. Stabilisca una baseline: per ogni giorno precedente al 12 novembre calcoli il rapporto «acquisti segnalati da Meta ÷ ordini effettivi». Poi monitori questo rapporto e gli eventuali picchi di doppio conteggio per quattro-sei settimane.
3. Imposti un test holdout: usi un gruppo di controllo per area geografica o per campagna e verifichi l'incremento riportato rispetto agli ordini effettivi.
4. Nei settori regolamentati, un'opzione è disattivare l'impostazione fino al completamento di una verifica legale e registrarne il motivo.

Configurazione della Conversion API: come implementare passo dopo passo il tracciamento server-side delle conversioni

Nella nostra architettura di riferimento, la fonte di verità è il record dell'ordine o del CRM. Meta, Google e, facoltativamente, OpenAI vengono alimentati da un unico flusso di eventi, generato da questo record e comprensivo dello stato del consenso. Generi il token di accesso (il token Meta CAPI) in Events Manager, nella sezione Conversions API della scheda Impostazioni del Pixel. Questo link è visibile solo agli utenti con accesso da sviluppatore all'azienda. Conservi il token in modo riservato sul server.

1. Crei l'evento a partire dal record. Un acquisto avviene quando la notifica di pagamento è verificata e l'ordine è confermato, non quando si carica la pagina di ringraziamento. Abbiamo trattato questo passaggio nella nostra guida ai webhook del POS virtuale (pagamento online con carta).
2. Acquisisca gli ID di clic. Per Meta: fbc, generato da fbclid (fb.${subdomain_index}.${creation_time}.${fbclid}), e fbp. Per Google: gclid, gbraid e wbraid. Per OpenAI: il cookie __obref, se le sue regole sul consenso lo consentono. Questi ID, l'indirizzo IP e lo user agent vengono inviati senza hashing.
3. Usi un unico ID evento. Impieghi il numero d'ordine come eventID del Pixel, event_id della CAPI, transactionId di Google e campo id di OpenAI.
4. Scriva il consenso nell'evento. Salvi insieme all'evento la scelta fatta dall'utente in quel momento. La Data Manager API prevede a questo scopo i campi adUserData e adPersonalization.
5. Normalizzi e applichi l'hashing (veda la sezione successiva).
6. Metta l'evento in coda e lo invii in modo idempotente. L'evento viene scritto in una coda, un processo worker lo invia e, se l'invio non riesce, ritenta a intervalli crescenti. I nuovi tentativi non generano doppi conteggi. Meta e OpenAI conservano la prima delle copie che arrivano con la stessa chiave. Google tratta un transaction ID già noto come una rettifica, non come una nuova conversione, e non aumenta il conteggio delle conversioni.
7. Esegua i test e riconcili i dati. Usi test_event_code su Meta (da rimuovere in produzione), validateOnly e requestStatus.retrieve su Google e validate_only su OpenAI. Una volta online, confronti ogni giorno il report della piattaforma con gli ordini effettivi.

Regole di invio per piattaforma

Le trappole di normalizzazione e hashing con i dati turchi

Tutte e tre le piattaforme richiedono indirizzi email e numeri di telefono sottoposti ad hashing con SHA-256. Un solo carattere diverso produce un hash completamente diverso. Un errore di normalizzazione è quindi una perdita silenziosa di corrispondenze, che non genera mai un messaggio di errore.

• I numeri di telefono non si scrivono ovunque allo stesso modo. Il numero di cellulare turco 0532 123 45 67, qui nel formato nazionale, viene normalizzato e sottoposto ad hashing come 905321234567 per le Conversions API di Meta e OpenAI (si elimina lo zero iniziale, si aggiunge il prefisso internazionale, nessun «+»). Per la Google Data Manager API e i caricamenti di audience di OpenAI diventa +905321234567 (E.164). La stessa OpenAI avverte di non dare per scontato che la regola sui numeri di telefono di un'API valga anche per un'altra.
• La conversione in minuscolo di İ e I turche cambia l'hash. Il turco ha una coppia di lettere con il punto (İ/i) e una senza punto (I/ı). Con la regola predefinita di Unicode, «İ» in minuscolo diventa «i̇», una sequenza di due caratteri (i + U+0307). Solo un locale turco trasforma «İ» in una «i» semplice e «I» in «ı». Nel nostro test, "İLKER".lower() di Python ha restituito «i̇lker» e il suo hash non corrispondeva a quello di «ilker». "IŞIK".lower() ha restituito «işik» anziché il turco «ışık». Dalla versione 8.2 di PHP, strtolower() converte in minuscolo solo le lettere ASCII, quindi lascia invariate «İ» e «Ş». mb_strtolower(), usata dall'helper Str::lower() di Laravel, trasforma «İ» in «i̇». Il caso opposto è altrettanto rischioso: con un locale turco (toLocaleLowerCase('tr') in JavaScript, ToLower() con la cultura tr-TR in .NET), «[email protected]» diventa «ılker@fırma.com».
• Regole separate per indirizzi email e nomi. Per gli indirizzi email usi una conversione in minuscolo indipendente dal locale e trasformi prima «İ» in «i». Quando una tastiera mobile rende maiuscola la prima lettera secondo la regola turca, l'indirizzo può essere salvato come «İlker@…». Per i nomi le regole divergono: Meta consiglia a–z ma accetta UTF-8, OpenAI chiede di mantenere gli accenti e Google vuole il minuscolo senza titoli. Non è documentato quale forma dei caratteri turchi produca più corrispondenze, quindi faccia una prova con i suoi dati.
• La regola di Gmail vale solo per Google: negli indirizzi gmail.com e googlemail.com elimini i punti prima della @ e il segno «+» con tutto ciò che lo segue fino alla @. Le regole di Meta e OpenAI non prevedono questo passaggio. OpenAI chiede esplicitamente di non rimuovere punti e tag con il segno più nei caricamenti di audience.
• Non confonda lire e kuruş. Google vuole che il valore caricato abbia lo stesso formato e la stessa unità del tag. Avverte che un'unità diversa, come i centesimi espressi in numeri interi (per la lira turca, i kuruş: 100 kuruş fanno 1 lira), provoca una «grave inflazione del valore delle conversioni» e che il sistema non converte l'unità da solo. Se 24990 kuruş vengono inviati così come sono, un ordine da 249,90 lire turche appare come 24.990 lire turche.

Manteniamo la normalizzazione in un'unica funzione coperta da unit test. Esempi di vettori di test: « İ[email protected]» → [email protected] e, per Google, «[email protected]» → [email protected].

Google Data Manager API, conversioni offline e qualità dei lead dal CRM

Google: conversioni avanzate e Data Manager API

Secondo il calendario di Google, da giugno 2026 le conversioni avanzate per il web e per i lead sono un'unica impostazione on/off, che si può disattivare per singole azioni di conversione. Google descrive la Data Manager API come la via principale per importare le conversioni offline, quindi avviamo direttamente su di essa i nuovi progetti. Punti a cui prestare attenzione durante la migrazione:

• Non serve alcun developer token (e dal 9 settembre 2026 anche la Google Ads API ignora il token). Le quote sono legate al progetto Google Cloud.
• operating_account deve essere l'account proprietario dell'azione di conversione. Gli account padre e figlio non sono accettati.
• Caricamenti e rettifiche passano dalla stessa chiamata IngestEvents. Inviare un transaction ID esistente con un nuovo valore equivale a una rettifica. Sulle ritrattazioni la documentazione è contraddittoria: la guida all'upgrade e la pagina sulle rettifiche dicono che si può soltanto dichiarare nuovamente il valore e che il conteggio delle conversioni non cambia, mentre la pagina sulle conversioni offline parla di ritrattazioni. Verifichi lo scenario dei rimborsi prima di andare online.
• Invii il GCLID con ogni evento, quando possibile. È obbligatorio se non raccoglie i dati utente con il tag.

La vera novità sono le conversioni multi-origine (beta). A una conversione web configurata manualmente con il tag Google o GTM può aggiungere come seconda origine il CRM o il database degli ordini. I record vengono deduplicati tramite transaction ID. Per gli eventi corrispondenti, l'origine aggiunta sovrascrive il valore del tag e diventa l'unica fonte di verità per il valore. Durante il primo periodo di prova di 14 giorni, gli aggiornamenti del valore sono disattivati e le nuove conversioni non vengono usate per le offerte.

Meta: reinviare alla piattaforma le fasi dei lead del CRM

Per ottenere i migliori risultati con l'integrazione Conversion Leads, Meta consiglia di salvare nel CRM il Meta Lead ID, lungo da 15 a 17 cifre. In sua assenza si inviano l'ID di clic, il numero di telefono o l'indirizzo email. I requisiti: almeno 200 lead al mese; la fase per cui si ottimizza deve verificarsi entro 28 giorni dal lead e convertire con un tasso compreso tra l'1% e il 40%; caricamenti almeno una volta al giorno. Meta stima il periodo di apprendimento tra 2 e 4 settimane. Nel B2B con cicli di vendita lunghi, la chiusura di un accordo può richiedere più di 28 giorni. Può quindi essere necessario ottimizzare per una fase precedente, come «lead qualificato» invece di «vinto». La stessa modifica di fase arriva a Google tramite la Data Manager API, con il GCLID e l'indirizzo email sottoposto ad hashing, come conversione avanzata per i lead. Nei nostri progetti CRM ed ERP impostiamo fin dall'inizio i campi delle fasi in base a questa esigenza.

KVKK e consenso: quali domande porre al suo ufficio legale?

Questa sezione non costituisce una consulenza legale. KVKK è l'abbreviazione comune della legge turca sulla protezione dei dati personali (legge n. 6698) e dell'autorità che ne garantisce l'applicazione. Il Consiglio dell'autorità emana decisioni di principio.

• Informativa e consenso esplicito sono separati? In base alla decisione di principio 2026/347 del Consiglio, l'informativa (aydınlatma) deve essere fornita prima del trattamento, qualunque sia la base giuridica. Se ci si basa sul consenso esplicito (açık rıza), i due testi vanno redatti separatamente, sotto titoli diversi. Se ci si basa su un'altra base giuridica, non si presenta alcun testo di consenso esplicito.
• Su quale base si trasferiscono i dati all'estero? L'articolo 9 della legge, nella versione in vigore dal 1° giugno 2024, richiede una condizione di trattamento e, in aggiunta, anzitutto una decisione di adeguatezza o, in sua assenza, garanzie adeguate come un contratto standard. Un contratto standard va notificato all'Autorità entro cinque giorni lavorativi dalla firma. Il consenso esplicito è solo una via eccezionale per i trasferimenti «occasionali» (arızi). Il regolamento di attuazione definisce occasionale un trasferimento che non è regolare, avviene una sola volta o poche volte, non è continuativo e non rientra nel normale svolgimento dell'attività. Un flusso di dati che si attiva a ogni ordine rientra in questa definizione?
• L'hashing è un'anonimizzazione? Lo scopo dell'hashing è abbinare la persona a un account sulla piattaforma; anche Google confronta i dati sottoposti ad hashing con gli account che hanno effettuato l'accesso. Noi consideriamo l'hashing una misura di sicurezza, non un'anonimizzazione.
• Qual è l'impostazione predefinita del consenso? Il Pixel di OpenAI inizializza per impostazione predefinita il consenso su true. Dove il consenso è richiesto, chiami oaiq('consent', false) prima di init.
• Fa pubblicità a utenti in Europa? Le norme di Google sul consenso degli utenti dell'UE riguardano gli utenti dello Spazio economico europeo, del Regno Unito e della Svizzera. Richiedono un consenso valido per raccogliere, condividere e usare i dati personali ai fini della personalizzazione degli annunci. Un esportatore con sede in Turchia che raggiunge utenti in Germania tramite i prodotti Google rientra nell'ambito delle norme per questi utenti. Per il traffico dalla Turchia, il quadro di riferimento è la KVKK.

Prima di progettare l'integrazione, chiarisca l'inventario dei dati e le misure di garanzia con una verifica di conformità KVKK e GDPR.

Come La aiuta Partnerfy

Non consideriamo la Conversion API una semplice installazione di tag, ma un progetto di integrazione che parte dai dati degli ordini e del CRM. Per prima cosa verifichiamo gli eventi Pixel e server esistenti. Poi mappiamo lo schema degli eventi su Meta, Google e, se necessario, OpenAI, e fissiamo con vettori di test la strategia event_id e le regole di normalizzazione. Costruiamo il livello di invio sul suo stack (ad esempio Laravel, Node.js o .NET) con coda, nuovi tentativi idempotenti e monitoraggio degli errori, e rendiamo lo stato del consenso parte dell'evento. Dopo il go-live predisponiamo anche una vista di riconciliazione e monitoraggio che confronta i report delle piattaforme con gli ordini effettivi. Trova i dettagli nella nostra pagina Integrazioni Conversion API. Per esaminare insieme la configurazione attuale, ci contatti.

Fonti

• Meta for Developers: deduplicazione, parametri delle informazioni sui clienti, uso dell'API, token di accesso, Conversion Leads
• Meta: annuncio del 15 aprile 2026; Centro assistenza per le aziende: informazioni sulla Conversions API, informazioni sulla misurazione delle conversioni sui dispositivi dei clienti
• Google Ads API: deprecazioni, developer token, Developer Blog, 15 maggio 2026
• Guida di Google Ads: conversioni avanzate per i lead, aggiornamenti alle impostazioni delle conversioni avanzate, conversioni multi-origine
• Google Data Manager API: guida all'upgrade, conversioni offline, rettifiche, events.ingest, modello di errore, formattazione, Consent; Google: norme sul consenso degli utenti dell'UE
• OpenAI Ads: Conversions API, Measurement Pixel, Custom Audiences, targeting, changelog, disponibilità di Ads Manager
• KVKK (in turco): annuncio sulla decisione di principio 2026/347, legge n. 6698; Gazzetta Ufficiale turca (Resmî Gazete, in turco): regolamento sui trasferimenti di dati personali all'estero
• Risorse tecniche: Unicode SpecialCasing, MDN, Microsoft Learn, PHP strtolower; piattaforme pronte: ikas, Shopify
• Fonti secondarie: PPC Land, 27 ottobre 2026, PPC Land, 27 aprile 2026, Stape, 22 ottobre 2026, MetricMaven, 19 ottobre 2026

Domande frequenti