Conversions API (CAPI) su Shopify: come configurare il tracciamento server-side per Meta, Google e TikTok

La Conversions API, comunemente chiamata CAPI, è la controparte server-side dei pixel pubblicitari basati sul browser. Invece di affidarsi a JavaScript in esecuzione nel browser del visitatore per segnalare le conversioni, CAPI invia i dati degli eventi direttamente dal tuo server al server della piattaforma pubblicitaria. Per i proprietari di negozi Shopify, questo è ormai essenziale: ad blocker, restrizioni sulla privacy di iOS e limitazioni sui cookie del browser fanno sì che i tuoi pixel perdano dal 20 al 40 percento delle conversioni effettive. CAPI recupera quei dati persi.

Questa guida copre come funziona la Conversions API, quali piattaforme la offrono e come configurarla sul tuo negozio Shopify per Meta (Facebook e Instagram), Google, TikTok e Pinterest.

Cos'è la Conversions API (CAPI)?

La Conversions API è un'interfaccia server-side fornita dalle piattaforme pubblicitarie che ti permette di inviare eventi di conversione (acquisti, aggiunte al carrello, checkout, visualizzazioni di pagina) direttamente dal tuo server. Il termine "CAPI" ha origine dalla Conversions API di Meta per le inserzioni su Facebook e Instagram, ma il concetto esiste ora su tutte le principali piattaforme con nomi diversi:

• Meta: Conversions API (CAPI)
• Google: Enhanced Conversions e Measurement Protocol
• TikTok: Events API
• Pinterest: Conversions API
• Snapchat: Conversions API
• Reddit: Conversions API

Funzionano tutte sullo stesso principio: il tuo server invia un payload evento strutturato all'endpoint API della piattaforma, includendo il tipo di evento, i dettagli della transazione e gli identificatori cliente con hash per il matching. La piattaforma utilizza questi dati per attribuire la conversione alla campagna pubblicitaria corretta, esattamente come se il pixel si fosse attivato nel browser.

Perché il tuo negozio Shopify ha bisogno di CAPI

Se stai facendo pubblicità a pagamento su qualsiasi piattaforma e ti affidi esclusivamente ai pixel del browser per il tracciamento delle conversioni, stai operando su dati incompleti. Ecco esattamente cosa sta succedendo:

Il tuo pixel sta perdendo conversioni

Gli ad blocker (utilizzati dal 30 al 42 percento degli utenti internet) bloccano gli script di tracciamento di Meta, Google, TikTok e altre piattaforme. L'Intelligent Tracking Prevention di Safari limita la durata dei cookie JavaScript a 7 giorni. La Protezione antitracciamento avanzata di Firefox blocca i tracker noti per impostazione predefinita. Il browser Brave rimuove completamente gli identificatori di clic dagli URL. Ogni evento bloccato è una conversione che la tua piattaforma pubblicitaria non può vedere.

I dati mancanti compromettono le performance delle campagne

Le piattaforme pubblicitarie utilizzano il machine learning per ottimizzare chi vede le tue inserzioni. Quando il 30 percento delle conversioni manca, l'algoritmo ha una visione distorta del tuo cliente ideale. Non può ottimizzare correttamente le offerte, il targeting o la selezione dei creativi. Il risultato: CPA più alti, ROAS peggiore e spreco di budget pubblicitario. CAPI fornisce i dati di conversione completi di cui l'algoritmo ha bisogno per performare al meglio.

Le piattaforme privilegiano gli inserzionisti con dati server-side

Meta è stata esplicita: gli inserzionisti che implementano CAPI insieme al pixel ottengono una migliore distribuzione degli annunci e costi per risultato inferiori. Google premia una maggiore qualità dei dati con performance migliori dello Smart Bidding. Il motore di ottimizzazione di TikTok funziona meglio con i dati dell'Events API. Configurare CAPI non riguarda solo il recupero dei dati. È un vantaggio competitivo nelle aste pubblicitarie.

Meta Conversions API (CAPI) per Shopify

La Conversions API di Meta è la soluzione di tracciamento server-side più diffusa per i negozi Shopify, dato che la pubblicità su Meta (Facebook e Instagram) è il canale a pagamento principale per la maggior parte dei brand DTC.

Cosa invia Meta CAPI

La Conversions API invia a Meta eventi che includono:

• Nome dell'evento: Purchase, AddToCart, InitiateCheckout, PageView, ViewContent
• Dati dell'evento: Valore dell'ordine, valuta, ID prodotto, nomi dei prodotti, quantità
• Parametri del cliente: Email con hash, numero di telefono con hash, ID esterno, fbclid (identificatore di clic), cookie fbc e fbp, indirizzo IP del cliente, user agent

Più parametri del cliente includi, più alto sarà il tuo punteggio di Event Match Quality (EMQ) in Events Manager. Un EMQ più alto significa che Meta può abbinare più conversioni agli utenti e alle campagne pubblicitarie corrette. I negozi Shopify hanno un vantaggio naturale in questo senso, perché i clienti forniscono email e numero di telefono al checkout.

Come configurare Meta CAPI su Shopify

Ci sono tre approcci principali:

1. Integrazione nativa di Shopify con Meta: Shopify offre un canale Meta nativo che include un supporto CAPI di base. Tuttavia, ha delle limitazioni: la qualità del matching degli eventi è spesso inferiore perché non cattura e inoltra tutti i parametri cliente disponibili, e si basa sull'integrazione del checkout di Shopify che non copre tutti i tipi di evento.
2. Implementazione manuale dell'API: Puoi costruire un'integrazione server-side personalizzata utilizzando la documentazione della Conversions API di Meta. Questo richiede risorse di sviluppo, la gestione dell'autenticazione, la formattazione degli eventi, l'hashing dei dati del cliente, la logica di deduplicazione e la manutenzione continua quando Meta aggiorna l'API.
3. Converlay (consigliato): Installa l'app Converlay per Shopify, collega il tuo Meta Pixel ID e il token di accesso alla Conversions API, e gli eventi iniziano a fluire in pochi minuti. Converlay gestisce automaticamente l'hashing dei parametri del cliente, la deduplicazione degli eventi, la cattura dei click ID e tutta la formattazione degli eventi. La maggior parte dei merchant raggiunge un punteggio di Event Match Quality "Good" o "Great" entro pochi giorni.

Best practice per Meta CAPI

• Esegui il pixel e CAPI contemporaneamente. Meta lo consiglia per la massima copertura e utilizza gli ID evento per la deduplicazione.
• Monitora il tuo punteggio di Event Match Quality in Events Manager. Punta a "Good" (6+) o "Great" (8+).
• Assicurati di inviare il parametro fbclid. È il singolo parametro più importante per l'attribuzione basata sui clic.
• Invia tutti gli eventi e-commerce standard: PageView, ViewContent, AddToCart, InitiateCheckout e Purchase.

Google Enhanced Conversions e Measurement Protocol per Shopify

Google offre due approcci server-side per i dati di conversione: le Enhanced Conversions per Google Ads e il Measurement Protocol per GA4. Entrambi migliorano l'accuratezza dei dati per i negozi Shopify.

Google Enhanced Conversions

Le Enhanced Conversions ti permettono di inviare dati first-party del cliente con hash (email, telefono, indirizzo) insieme ai tuoi tag di conversione. Google utilizza questi dati per abbinare le conversioni agli utenti connessi a Google, recuperando conversioni che sarebbero andate perse a causa delle restrizioni sui cookie. Per i negozi Shopify, questo significa che Google Ads può attribuire più acquisti alle campagne corrette, specialmente per le conversioni cross-device dove un utente ha cliccato un annuncio da mobile ma ha acquistato da desktop.

GA4 Measurement Protocol

Il Measurement Protocol ti consente di inviare eventi direttamente a Google Analytics 4 dal tuo server. Questo è prezioso per i negozi Shopify perché gli eventi GA4 inviati tramite il pixel (gtag.js) vengono bloccati dagli ad blocker. Gli eventi server-side attraverso il Measurement Protocol garantiscono che i tuoi report GA4 riflettano l'attività reale del negozio, non solo l'attività dei visitatori senza ad blocker.

Configurare il tracciamento server-side di Google su Shopify

Con Converlay, collega il tuo Conversion ID di Google Ads e il Measurement ID di GA4. Converlay invia eventi di acquisto ed e-commerce sia a Google Ads (per l'ottimizzazione delle conversioni e lo Smart Bidding) che a GA4 (per analytics e reportistica). L'identificatore di clic gclid viene catturato e inoltrato automaticamente per un'attribuzione accurata basata sui clic.

TikTok Events API per Shopify

L'Events API di TikTok è l'equivalente server-side del TikTok Pixel. Per i negozi Shopify che fanno pubblicità su TikTok, l'Events API è fondamentale perché il pixel di TikTok (analytics.tiktok.com) viene bloccato praticamente da ogni ad blocker.

Cosa invia TikTok Events API

L'Events API invia dati evento strutturati a TikTok, tra cui:

• Tipi di evento: PageView, ViewContent, AddToCart, InitiateCheckout, CompletePayment
• Parametri del contenuto: ID prodotto, tipo di contenuto, valore, valuta
• Parametri utente: email con hash, telefono con hash, ttclid (TikTok click ID), indirizzo IP, user agent

Configurare TikTok Events API su Shopify

In Converlay, aggiungi il tuo TikTok Pixel ID e il token di accesso all'Events API. Converlay mappa gli eventi Shopify nel formato previsto da TikTok e include il ttclid per l'attribuzione. L'Events Manager di TikTok mostrerà gli eventi in arrivo etichettati come "Server" accanto agli eventuali eventi pixel etichettati come "Browser".

Pinterest Conversions API per Shopify

La Conversions API di Pinterest segue lo stesso schema. Per i negozi Shopify che pubblicano inserzioni su Pinterest, la Conversions API recupera i dati di conversione che il Pinterest Tag perde a causa degli ad blocker e delle restrizioni del browser.

Collega il tuo Pinterest Tag ID e il token di accesso alla Conversions API in Converlay. Gli eventi, inclusi visualizzazioni di pagina, aggiunte al carrello, checkout e acquisti, vengono inviati all'API di Pinterest con identificatori cliente con hash per il matching. Pinterest utilizza questi dati per ottimizzare le tue campagne pubblicitarie e attribuire le conversioni in modo accurato.

Configurare CAPI per tutte le piattaforme contemporaneamente con Converlay

L'approccio più efficiente è configurare il tracciamento server-side per tutte le tue piattaforme pubblicitarie simultaneamente. Ecco il processo con Converlay:

1. Installa Converlay dallo Shopify App Store.
2. Aggiungi le credenziali di ciascuna piattaforma nella dashboard di Converlay: Pixel ID, token API e Conversion ID per Meta, Google, TikTok, Pinterest e qualsiasi altra piattaforma che utilizzi.
3. Abilita l'inoltro degli eventi per ogni piattaforma. Converlay cattura gli eventi Shopify una sola volta e li distribuisce a ogni piattaforma connessa simultaneamente.
4. Verifica su ciascuna piattaforma che gli eventi server stiano arrivando. Controlla il Meta Events Manager, lo stato delle conversioni di Google Ads, il TikTok Events Manager e la diagnostica dei tag di conversione di Pinterest.
5. Monitora l'impatto nelle prime 2 settimane. Traccia l'aumento delle conversioni riportate e il miglioramento della qualità del matching degli eventi su tutte le piattaforme.

Il vantaggio di questo approccio è che un singolo evento di acquisto sul tuo negozio Shopify viene inviato a ogni piattaforma connessa contemporaneamente. Un cliente acquista un prodotto, e Meta, Google, TikTok e Pinterest ricevono tutti i dati di conversione attraverso le rispettive API. Nessuna dipendenza dal browser per nessuna piattaforma.

CAPI vs. Pixel: servono entrambi?

Sì. Tutte le piattaforme pubblicitarie consigliano di eseguire sia il pixel che CAPI contemporaneamente. Ecco perché:

Aspetto	Solo Pixel	Solo CAPI	Pixel + CAPI
Visitatori senza ad blocker	Tracciati	Tracciati	Tracciati
Visitatori con ad blocker	Persi	Tracciati	Tracciati
Eventi in tempo reale	Sì	Leggero ritardo	Sì (pixel) + backup (CAPI)
Eventi del browser (scroll, tempo sulla pagina)	Sì	No	Sì
Deduplicazione	N/A	N/A	Automatica tramite ID evento
Completezza dei dati	60-70%	85-90%	95-99%

Utilizzare entrambi ti offre la velocità degli eventi pixel per i visitatori non bloccati più l'affidabilità degli eventi server-side per tutti gli altri. Le piattaforme gestiscono la deduplicazione, quindi non c'è doppio conteggio.

Domande frequenti

Qual è la differenza tra CAPI e un pixel?

Un pixel è uno snippet JavaScript che viene eseguito nel browser del visitatore e invia eventi alla piattaforma pubblicitaria. CAPI (Conversions API) invia gli stessi eventi dal tuo server direttamente al server della piattaforma pubblicitaria. Il pixel può essere bloccato dagli ad blocker e dalle funzionalità di privacy del browser. CAPI non può essere bloccata perché bypassa completamente il browser.

CAPI è gratuita?

Le API stesse sono gratuite. Meta, Google, TikTok e Pinterest non addebitano costi per la ricezione di eventi server-side. Il costo deriva dall'implementazione: il tempo di sviluppo per costruire e mantenere un'integrazione personalizzata, oppure il costo dell'abbonamento a uno strumento come Converlay che gestisce l'integrazione per te.

CAPI risolverà il mio ROAS basso?

Se il tuo ROAS basso è causato da dati di conversione mancanti (il che è estremamente comune), CAPI migliorerà direttamente il tuo ROAS riportato recuperando le conversioni invisibili. Cosa ancora più importante, i dati completi aiutano gli algoritmi delle piattaforme pubblicitarie a ottimizzare meglio, il che può migliorare le performance effettive delle campagne nel tempo.

Come faccio a sapere se CAPI funziona correttamente?

Controlla la dashboard di gestione degli eventi di ciascuna piattaforma. Il Meta Events Manager mostra gli eventi etichettati come "Server" accanto agli eventi "Browser". Google Ads mostra lo stato dell'azione di conversione. Il TikTok Events Manager etichetta gli eventi per origine. Dovresti vedere un mix di eventi browser e server, con le conversioni totali superiori a quelle che vedevi con il solo pixel.

Shopify ha un supporto CAPI integrato?

Shopify offre un canale Meta nativo con funzionalità CAPI di base. Tuttavia, copre solo Meta e ha una qualità limitata nel matching degli eventi. Per un tracciamento server-side completo su Meta, Google, TikTok, Pinterest e altre piattaforme, una soluzione dedicata come Converlay offre una copertura e una qualità dei dati significativamente migliori.

Posso configurare CAPI senza uno sviluppatore?

Sì. Con Converlay, configurare CAPI su Shopify non richiede alcuna competenza di programmazione. Installi l'app, inserisci le credenziali delle tue piattaforme e gli eventi server-side iniziano a fluire. L'intero processo di configurazione richiede minuti, non giorni o settimane di lavoro di sviluppo.

Come gestisce CAPI la privacy dei dati dei clienti?

Le implementazioni CAPI eseguono l'hash dei dati del cliente (email, numero di telefono) utilizzando SHA-256 prima di inviarli alle piattaforme pubblicitarie. Le piattaforme non ricevono mai dati grezzi del cliente attraverso CAPI. Inoltre, CAPI dovrebbe inviare dati solo per i visitatori che hanno fornito il consenso dove richiesto (GDPR, CCPA). Converlay supporta il filtraggio degli eventi basato sul consenso.

Configura CAPI sul tuo negozio Shopify con Converlay e inizia a recuperare le conversioni che i tuoi pixel stanno perdendo. Collega tutte le tue piattaforme pubblicitarie in pochi minuti.