Un ordine è stato effettuato nel negozio online, ma Meta non lo vede. Altre volte lo vede due volte. Il team ottimizza quindi le campagne usando numeri di cui non si fida e la prima idea è: implementiamo CAPI e risolverà tutto.
Conversions API può rendere la misurazione più accurata perché invia alcuni eventi di marketing dal server, dal CRM o dalla piattaforma direttamente ai sistemi Meta. Ma non recupererà dati che l'azienda non crea mai e non correggerà conversioni denominate male. Prima serve un piano di misurazione. Solo dopo viene il trasferimento dei dati.
CAPI non sostituisce il Pixel o il consenso
Meta descrive Conversions API come un collegamento più diretto tra i dati di marketing di un'azienda e i suoi sistemi per misurare e ottimizzare gli annunci. Per gli eventi web consiglia di valutare CAPI insieme al Meta Pixel. I percorsi lato browser e lato server possono completarsi a vicenda.
Questo non significa che il server possa inviare tutto ciò che il browser non ha inviato. Meta afferma esplicitamente che CAPI non è progettata per aggirare le regole sulla privacy, le normative europee o le limitazioni della piattaforma. Gestisci il consenso e la liceità del trattamento in base ai dati specifici, alla regione e alla valutazione giuridica. Un'email con hash è ancora un dato derivato da una persona, non una cortina fumogena.
Decidi prima quali eventi hanno valore commerciale
Per un negozio online, di solito ha senso monitorare il percorso dalla visualizzazione di un prodotto al carrello e al checkout fino all'acquisto. Per un sito di lead generation può essere più importante un modulo inviato o un lead qualificato. Non invierei ogni clic come conversione solo perché è possibile.
Per ogni evento, annota:
- che cosa deve accadere esattamente nel mondo reale,
- se è il risultato commerciale principale o soltanto un segnale diagnostico,
- quale sistema rappresenta la fonte di verità,
- quale identificativo univoco utilizzerai,
- quali parametri servono alla pubblicità e ai report,
- a quali condizioni puoi inviare i dati.
Per un acquisto, la fonte di verità è spesso l'ordine confermato nel negozio online o nel backend, non la semplice apertura della pagina di ringraziamento. Per un lead, il modulo può essere il primo segnale, ma solo il CRM conferma la qualità del contatto.
La deduplicazione determina se la doppia misurazione è utile
Quando invii lo stesso evento sia dal Pixel sia dal server, Meta deve riconoscerlo come un unico evento. Servono lo stesso nome dell'evento e lo stesso event_id in entrambi i percorsi.
Per un acquisto, un ID ordine stabile può essere una base adatta. Per un evento senza un proprio ID commerciale, crea un identificativo univoco quando si verifica l'azione e passalo sia al browser sia ai livelli server. Un identificativo casuale generato separatamente su ciascun lato non aiuterà: i valori non coincideranno.
La deduplicazione non è un dettaglio per sviluppatori. Se fallisce, le campagne possono ricevere un segnale doppio e i report inizieranno a mentire.
Quattro percorsi di implementazione hanno costi diversi
Un partner o una funzione della piattaforma e-commerce
Per un negozio online tipico, questa è spesso la prima scelta. La piattaforma mantiene continuamente l'integrazione e l'azienda non deve gestire codice API. Controlla comunque quali eventi invia, se gestisce deduplicazione e consenso e se consente di esaminare i parametri.
Un servizio gestito o un gateway
Un provider si fa carico di parte dell'infrastruttura e degli aggiornamenti. Paghi operatività e dipendenza, ma riduci la manutenzione tecnica interna. Ha senso se il servizio supporta il tuo stack e hai accesso chiaro alla diagnostica.
Google Tag Manager lato server
Un container server può unificare diversi trasferimenti di dati di marketing e offrire all'azienda un maggiore controllo. Allo stesso tempo aggiunge hosting, template, autorizzazioni e un altro punto da testare. Non lo sceglierei solo per avere un bel diagramma architetturale.
Un'integrazione diretta personalizzata
Offre la massima flessibilità e anche la massima responsabilità. Servono gestione sicura dei token, validazione degli input, logging senza divulgare dati sensibili, recupero dagli errori, gestione delle versioni API e qualcuno che mantenga l'integrazione.
L'articolo originale offriva un breve script PHP e un endpoint accessibile pubblicamente. Non consiglio più questa soluzione come guida generale. Conteneva una vecchia versione dell'API e troppe ipotesi di sicurezza e operatività. Il codice che funziona oggi dopo essere stato copiato potrebbe scartare silenziosamente gli eventi domani. Per un'integrazione diretta, lavora sulla documentazione aggiornata di Meta e fai sviluppo normale, non marketing basato sul copia-incolla.
La qualità degli eventi conta più del numero di parametri
Un evento lato server in genere richiede un nome, un'ora, una fonte dell'azione e un URL o altro contesto, a seconda della fonte. Per un evento commerciale, aggiungi valore, valuta, articoli e ID stabile pertinenti. Invia gli identificativi utente solo quando sei autorizzato a utilizzarli, sono normalizzati correttamente e nel formato richiesto.
Più identificativi possono migliorare il matching, ma il principio «di più è meglio» non vale senza limiti. Non inviare valori vuoti, inventati o obsoleti. E, soprattutto, non creare un'impronta digitale per aggirare la scelta dell'utente.
Il test deve coprire l'intero percorso
- Avvia la modalità di test in Meta Events Manager.
- Completa uno scenario reale dall'ingresso nel sito fino a un ordine o a un lead.
- Verifica gli eventi lato browser e lato server, i relativi parametri e gli ID corrispondenti.
- Controlla che Meta deduplichi la coppia e non mostri un errore diagnostico.
- Confronta valore, valuta e ID con il backend o il CRM.
- Testa sia la concessione sia il rifiuto del consenso secondo la tua soluzione.
- Dopo la pubblicazione, monitora nel tempo diagnostica e perdite, non soltanto un singolo test verde.
Test Events conferma che il messaggio tecnico è arrivato. Non conferma che hai selezionato la conversione corretta o che l'integrazione sia conforme alla legge.
CAPI e GA4 sono due livelli diversi
CAPI invia eventi a Meta per la sua misurazione e ottimizzazione pubblicitaria. GA4 analizza il sito e l'app tra diverse fonti. I numeri possono differire per attribuzione, consenso, identità e trattamento. Non cerco di forzarli a coincidere perfettamente; prima verifico che ogni sistema riceva dati tecnicamente corretti e che li usiamo per la decisione giusta.
Se ti serve una panoramica condivisa di costi e risultati del sito, leggi anche come collegare Meta Ads a GA4. La guida a Google Tag Manager tratta l'implementazione dei tag, mentre la guida a GA4 spiega il significato degli eventi.
Quando non implementerei ancora CAPI
Se l'azienda non ha definito le proprie conversioni, non sa quale ordine sia valido o non riesce a mantenere il Pixel attuale, aggiungere un percorso lato server aumenterà il caos. Prima correggi i dati sorgente e il piano di misurazione. CAPI ha senso quando sai quale segnale vuoi inviare, perché Meta ne ha bisogno e chi sarà responsabile dell'integrazione.
Se vuoi scegliere la soluzione minima ragionevole per il tuo negozio online o sito di lead generation, inviami la piattaforma, la configurazione di misurazione attuale e l'evento più importante per la tua attività tramite contattami.