Configurare Meta Pixel e l'API Conversions
Vi mostriamo come aggiungere il Meta Pixel al vostro sito e definire gli eventi standard, come configurare l'API Conversioni lato server e come testare gli eventi.

Per la configurazione del Meta Pixel create una nuova origine dati web (pixel) in Meta Events Manager e aggiungete il codice base alla sezione head del sito o a Google Tag Manager. Poi definite gli eventi standard come acquisto e aggiunta al carrello, collegate l'API Conversioni per rafforzare la misurazione e verificate gli eventi nella schermata Test eventi.
Che cos'è il Meta Pixel e perché serve?
Il Meta Pixel (in precedenza pixel di Facebook) è un codice JavaScript aggiunto al vostro sito che segnala a Meta le azioni dei visitatori. È così che vedete quale vendita, modulo o iscrizione hanno portato i vostri annunci su Facebook e Instagram.
La vera forza del pixel va oltre la misurazione. Il sistema pubblicitario di Meta impara da eventi come gli acquisti e mostra il vostro annuncio alle persone che hanno maggiori probabilità di convertire. Anche i pubblici personalizzati per raggiungere di nuovo chi ha visitato il sito o guardato un prodotto si basano sui dati del pixel.
La misurazione basata sul browser può perdere alcuni eventi a causa di blocchi degli annunci, impostazioni di privacy del browser e cadute di connessione. Per colmare questa lacuna, il pixel si usa insieme all'API Conversioni, che invia gli eventi dal server.
Preparazione prima della configurazione
Aprite il pixel e l'account pubblicitario nel portfolio dell'azienda e date all'agenzia solo l'accesso come partner. In questo modo, anche se la collaborazione cambia, i dati di misurazione e i pubblici accumulati restano all'azienda. Il Meta Pixel non sostituisce GA4; per usare i due insieme, consultate anche la nostra guida alla configurazione di Google Analytics 4.
- Un portfolio aziendale Meta (Business Manager) e un account pubblicitario di proprietà dell'azienda
- Accesso al sito o al tag manager
- Un elenco degli eventi che volete misurare: visualizzazione prodotto, aggiunta al carrello, avvio del pagamento, acquisto, invio di un modulo
- Se la vostra configurazione del consenso ai cookie subordina i codici di misurazione al consenso
Creare il pixel e il codice base
Aprite Meta Events Manager, selezionate Web nel passaggio Connetti origini dati e date un nome al vostro pixel. Poi scegliete il metodo di configurazione: aggiunta manuale del codice, integrazione con un partner oppure installazione tramite Google Tag Manager.
Per la configurazione manuale, aggiungete il codice base fornito da Meta alla sezione head di ogni pagina. Il codice invia l'evento PageView a ogni caricamento della pagina. Nell'esempio seguente, al posto di PIXEL_ID va inserito il vostro ID pixel; copiate sempre il codice da Events Manager.
<!-- Meta Pixel Code --> <script> !function(f,b,e,v,n,t,s) {if(f.fbq)return;n=f.fbq=function(){n.callMethod? n.callMethod.apply(n,arguments):n.queue.push(arguments)}; if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0'; n.queue=[];t=b.createElement(e);t.async=!0; t.src=v;s=b.getElementsByTagName(e)[0]; s.parentNode.insertBefore(t,s)}(window, document,'script', 'https://connect.facebook.net/en_US/fbevents.js'); fbq('init', 'PIXEL_ID'); fbq('track', 'PageView'); </script> <noscript><img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id=PIXEL_ID&ev=PageView&noscript=1" /></noscript> <!-- End Meta Pixel Code -->Con Google Tag Manager
Se usate GTM, potete aggiungere il codice base con un tag HTML personalizzato e attivarlo su tutte le pagine. Collegare gli eventi ai trigger del data layer rende la misurazione resistente ai cambiamenti di design; i dettagli sono nel nostro articolo sulla configurazione di Google Tag Manager.
Dal pannello di amministrazione della piattaforma
Alcune piattaforme permettono di prendere l'ID del pixel dal pannello e di inviare gli eventi in autonomia. Nella piattaforma e-commerce di Aurora, la connessione Meta associa il catalogo prodotti e misura le conversioni senza doppi conteggi; i codici si aggiungono dal pannello.
Eventi standard e parametri
Usare i nomi degli eventi standard definiti da Meta permette all'ottimizzazione degli annunci e ai report di funzionare automaticamente. Nell'evento di acquisto sono obbligatori valore e valuta; gli ID dei prodotti aiutano gli annunci del catalogo a mostrare il prodotto giusto.
| Evento | Quando viene inviato? |
|---|---|
| ViewContent | Quando si apre la pagina di dettaglio di un prodotto o servizio |
| AddToCart | Quando un prodotto viene aggiunto al carrello |
| InitiateCheckout | Quando inizia la fase di pagamento |
| Acquisto | Quando un ordine viene completato |
| Lead | Quando viene inviato un modulo o una richiesta di preventivo |
| CompleteRegistration | Quando si completa una registrazione |
fbq('track', 'AddToCart', { content_ids: ['URN-12'], content_type: 'product', value: 1499.90, currency: 'TRY' }); // Purchase: eventID is required for deduplication fbq('track', 'Purchase', { value: 1499.90, currency: 'TRY', content_ids: ['URN-12'], content_type: 'product' }, { eventID: 'SIP-10045' });Configurare l'API Conversioni
L'API Conversioni invia gli eventi a Meta direttamente dal vostro server anziché dal browser del visitatore. Non è influenzata dai blocchi degli annunci e trasmette dati confermati, come gli ordini, direttamente dalla fonte. Meta consiglia di usare insieme pixel e API per i migliori risultati.
Per la configurazione, create un token di accesso nella scheda impostazioni del pixel in Events Manager. Questo token è una password: conservatelo solo sul server e non inseritelo mai nel codice del browser o in un repository pubblico. Poi il vostro server invia una richiesta all'endpoint eventi della Graph API per ogni evento importante.
Per i piccoli siti senza un server proprio esistono opzioni a basso contenuto di codice, come le integrazioni con i partner di Meta e il Conversions API Gateway. In un progetto di progettazione di landing page che riceve traffico dagli annunci, l'approccio più sano è verificare la configurazione di pixel e API in un ambiente di test prima che la pagina vada online; così non si perdono dati fin dal primo giorno della campagna.
- event_time è il timestamp Unix dell'evento (in secondi) e deve indicare il momento in cui l'evento è avvenuto.
- I dati personali come e-mail e numero di telefono vengono inviati con hash SHA-256; formattate prima il numero di telefono in sole cifre, incluso il prefisso internazionale.
- Controllate il numero di versione della Graph API nella documentazione per sviluppatori di Meta; le versioni più vecchie vengono ritirate nel tempo.
curl -X POST "https://graph.facebook.com/v<SURUM>/<PIXEL_ID>/events?access_token=<TOKEN>" \ -H "Content-Type: application/json" \ -d '{ "data": [{ "event_name": "Purchase", "event_time": 1767225600, "event_id": "SIP-10045", "action_source": "website", "event_source_url": "https://ornek.com/tesekkurler/", "user_data": { "em": ["<SHA256_ILE_KARMALANMIS_EPOSTA>"], "client_ip_address": "203.0.113.10", "client_user_agent": "Mozilla/5.0 ...", "fbp": "fb.1.1767225000000.1234567890" }, "custom_data": { "value": 1499.90, "currency": "TRY" } }], "test_event_code": "TEST12345" }'printf '%s' 'ornek@alanadi.com' | sha256sumDeduplicazione: perché gli eventi vengono contati due volte?
Quando lo stesso acquisto viene inviato sia dal pixel sia dall'API, Meta deve capire che si tratta di un unico evento. Questo processo si chiama deduplicazione e dipende da due condizioni: il nome dell'evento e l'ID dell'evento devono essere esattamente uguali in entrambe le fonti.
Notate che negli esempi precedenti lo stesso numero d'ordine è scritto in eventID lato browser e in event_id lato server. Se questa corrispondenza non è configurata, le vendite compaiono raddoppiate nei report e il sistema pubblicitario impara da dati sbagliati.
Potete vedere che la deduplicazione funziona nei dettagli dell'evento in Events Manager: lo stesso evento risulta ricevuto sia dalla fonte browser sia da quella server e deduplicato. Una piccola differenza di tempo tra le due fonti non è un problema.
Testare e verificare gli eventi
La scheda Test eventi in Events Manager mostra gli eventi in tempo reale. Per vedere gli eventi del browser, inserite l'indirizzo del vostro sito ed eseguite azioni nella finestra che si apre; per gli eventi del server, aggiungete il codice di test mostrato a schermo al campo test_event_code della vostra richiesta e rimuovete questo campo quando andate online.
Anche l'estensione del browser Meta Pixel Helper mostra quale evento viene eseguito su quale pagina e con quali parametri. Alcuni giorni dopo la configurazione, controllate il punteggio di qualità della corrispondenza degli eventi in Events Manager; se è basso, potrebbe essere necessario aggiungere più informazioni dei clienti, con hash, agli eventi del server.
| Problema | Causa probabile e soluzione |
|---|---|
| L'evento non compare | L'ID del pixel è sbagliato o il codice non è pubblicato; controllate con Pixel Helper. |
| Le vendite sono raddoppiate | event_id non corrisponde oppure il pixel è caricato due volte. |
| La richiesta API restituisce un errore | Il token non è valido, la versione è vecchia oppure event_time è troppo vecchio; leggete il messaggio di errore nella risposta. |
| Importo errato | value viene inviato come testo anziché come numero oppure manca currency. |
Privacy e consenso
Il pixel e l'API Conversioni trattano dati personali. I codici di misurazione pubblicitaria non devono essere eseguiti prima che il visitatore dia il consenso, i dati inviati devono essere descritti nell'informativa sulla privacy e devono essere condivise solo le informazioni necessarie. Per categorie sensibili come la salute, Meta applica restrizioni aggiuntive.
Questo articolo fornisce informazioni generali. Verificate le norme vigenti della KVKK (la legge turca sulla protezione dei dati, paragonabile al GDPR) e del GDPR e confrontatevi con il vostro consulente legale su flusso di consenso ai cookie, informativa sulla privacy e trasferimento dei dati all'estero. Se vi chiedete quali metriche usare per leggere le prestazioni degli annunci, il nostro articolo sulle metriche dei social media è un buon punto di partenza.
Domande frequenti
01Il pixel di Facebook e il Meta Pixel sono la stessa cosa?
Sì. Dopo che la società madre di Facebook ha assunto il nome Meta, lo strumento è stato chiamato anche Meta Pixel. Lo stesso pixel serve a misurare sia gli annunci su Facebook sia quelli su Instagram.
02Il pixel basta senza l'API Conversioni?
Il pixel funziona anche da solo, ma a causa della perdita di dati legata ai browser alcune conversioni potrebbero non comparire nei report. Quando il budget pubblicitario cresce e le vendite arrivano direttamente dal sito, aggiungere l'API migliora in modo sensibile l'affidabilità della misurazione.
03Serve una configurazione separata per tracciare gli annunci su Instagram?
No. Gli annunci su Instagram si misurano dallo stesso account pubblicitario e con lo stesso pixel. Nel gruppo di inserzioni basta scegliere il pixel giusto e l'evento da ottimizzare.
Quando pixel e API Conversioni sono configurati insieme con regole di deduplicazione, potete misurare con sicurezza il ritorno del vostro budget pubblicitario. Per impostare l'infrastruttura di misurazione e gestire le campagne con questi dati, scoprite il nostro servizio di marketing digitale e, per la gestione di contenuti e annunci su Instagram e Facebook, le nostre soluzioni social media. Potete anche usare il nostro supporto SEO e analisi per interpretare i report.


