Installare Pixel Facebook e API Conversioni: guida

Molti vedono il Pixel Meta come un semplice strumento di misurazione. In realtà è il flusso di dati con cui l'algoritmo impara chi sono i tuoi clienti. Un Pixel pulito insieme all'API Conversioni (CAPI) abbassa il costo per risultato e mostra a Meta che dietro il dominio c'è un'azienda reale. Un'installazione trascurata fa l'opposto.

Questa guida ti mostra passo dopo passo dove inserire il codice e come verificare che tutto funzioni. Vale per i tuoi account e per un account agenzia Facebook usato con noi.

Perché la qualità del tracking influisce sulla salute dell'account

I sistemi di Meta valutano il quadro complessivo di un inserzionista. Un'azienda che invia con regolarità eventi di conversione di qualità da un dominio verificato appare per quello che è: un business reale con clienti reali. Un account che porta traffico su un dominio senza eventi, o con eventi difettosi, appare più rischioso.

Conta anche il costo: dati migliori significano ottimizzazione migliore e quindi CPA più basso. Tra i nostri clienti, passare da "solo Pixel" a "Pixel più CAPI deduplicata correttamente" riduce il CPA in media del 10–25 %.

Pixel o API Conversioni: cosa fa ciascuno

Servono entrambi: il Pixel rileva ciò che può nel browser, la CAPI invia gli stessi eventi dal server per non perdere nulla.

Passo 1: verifica il dominio

Nelle impostazioni dell'azienda apri Sicurezza del brand → Domini e aggiungi il tuo dominio. Verificalo con un record DNS TXT (consigliato) o un meta tag. Dimostra che il dominio è tuo ed è necessario per configurare gli eventi web.

Con un Business Manager noleggiato, verifica il dominio nel BM proprietario del Pixel, idealmente il tuo.

Passo 2: installa il Pixel nel punto giusto per la tua piattaforma

Il codice base è uguale ovunque, cambia solo dove lo incolli. Trova l'ID del Pixel in Gestione eventi → Origini dati → il tuo Pixel.

Sito su misura o HTML statico

Incolla il codice nel template condiviso da tutte le pagine, subito prima del tag di chiusura head. Sostituisci YOUR_PIXEL_ID con il tuo ID.

<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', 'YOUR_PIXEL_ID');
fbq('track', 'PageView');
</script>

WordPress

Usa il plugin ufficiale Meta for WordPress (Facebook for WordPress). Collega l'account Meta, scegli il Pixel e attiva l'API Conversioni. Se incolli il codice a mano, mettilo nell'header e non nel footer, così PageView parte prima che il visitatore se ne vada.

Shopify e WooCommerce

Installa il canale di vendita Facebook & Instagram (Shopify) o Facebook for WooCommerce. Scegli il Pixel, imposta la condivisione dei dati su Massimo e verifica che vengano inviati email e telefono. Purchase, AddToCart e ViewContent passano così sia dal browser sia dalla CAPI.

Next.js, React e altre app a pagina singola

Carica il codice base una sola volta nel layout radice e fai partire PageView a ogni cambio di route. Invia gli eventi di conversione dal componente che gestisce l'azione, per esempio il gestore del modulo.

// after the form is saved successfully
const eventId = crypto.randomUUID();
fbq('track', 'Lead', { content_name: 'contact-form' }, { eventID: eventId });
await fetch('/api/lead', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ ...formData, eventId }),
});

Google Tag Manager

Crea un tag HTML personalizzato con il codice base, attivalo su Tutte le pagine e aggiungi un tag per evento (Lead, Purchase) con il relativo trigger. Controlla in modalità Anteprima che ogni tag parta una sola volta. Non installare mai lo stesso Pixel sia tramite GTM sia nel codice, o ogni evento verrà contato due volte.

Gli eventi standard principali: ViewContent sulle schede prodotto, AddToCart all'aggiunta al carrello, InitiateCheckout all'inizio del checkout, Purchase nella pagina di ringraziamento con valore e valuta, Lead all'invio di un modulo. Usa i nomi standard: gli eventi personalizzati si ottimizzano peggio.

Passo 3: invia gli stessi eventi con l'API Conversioni

Il tuo server invia l'evento alla Graph API con un token di accesso generato in Gestione eventi, in Impostazioni → API Conversioni. Conservalo in una variabile d'ambiente, mai nel codice front-end.

import crypto from 'node:crypto';

const sha256 = (v) =>
  crypto.createHash('sha256').update(String(v).trim().toLowerCase()).digest('hex');

export async function sendLead({ email, phone, eventId, url, ip, userAgent, fbp, fbc }) {
  const body = {
    data: [{
      event_name: 'Lead',
      event_time: Math.floor(Date.now() / 1000),
      event_id: eventId,            // same value the browser sent
      action_source: 'website',
      event_source_url: url,
      user_data: {
        em: [sha256(email)],
        ph: [sha256(phone.replace(/\D/g, ''))],
        client_ip_address: ip,       // not hashed
        client_user_agent: userAgent, // not hashed
        fbp, fbc,                    // not hashed
      },
    }],
    // test_event_code: 'TEST12345', // only while testing
  };
  const res = await fetch(
    `https://graph.facebook.com/v21.0/${process.env.PIXEL_ID}/events?access_token=${process.env.CAPI_TOKEN}`,
    { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) }
  );
  return res.json();
}

I campi chiave sono event_name, event_time (secondi Unix), una event_id identica a quella del browser, action_source "website", l'URL della pagina e user_data.

Applicare l'hash ai dati personali nel modo giusto

Email, telefono, nome, cognome, città e ID esterno vanno normalizzati e sottoposti a SHA-256: email senza spazi e in minuscolo, telefono solo cifre con prefisso internazionale, nomi in minuscolo senza punteggiatura. IP, user agent, fbp e fbc non vanno sottoposti a hash. Leggi anche il fbclid dall'URL della landing page e salvalo in un cookie: serve a costruire fbc, con cui Meta collega il lead all'esatto clic sull'annuncio.

Passo 4: deduplica gli eventi browser e server

Se Pixel e CAPI inviano entrambi un evento Lead, Meta lo conta due volte senza deduplicazione. La regola: stesso event_name e stessa event_id da entrambe le parti. Genera l'ID nel browser all'invio del modulo, passalo al Pixel come eventID e invialo al server insieme ai dati del modulo, che lo riusa nella richiesta CAPI. In Gestione eventi comparirà "Deduplicato".

Passo 5: migliora la qualità di corrispondenza degli eventi

La qualità di corrispondenza (EMQ) indica quanto bene Meta riesce ad associare i tuoi eventi a persone reali. Invia più identificatori a ogni evento server: email con hash (impatto maggiore), telefono con hash, fbp e fbc, IP e user agent, ID esterno con hash. Molti clienti passano da EMQ 4–6 a oltre 8 in una settimana. Per il traffico iOS, ordina gli eventi per priorità nella misurazione aggregata degli eventi e metti in cima il più prezioso (Lead o Purchase).

Privacy e consenso nell'UE

Per gli utenti dello Spazio economico europeo, il Pixel installa cookie e invia dati personali a Meta. In pratica serve un banner cookie con consenso prima del caricamento del Pixel, in linea con il GDPR e con le linee guida del Garante per la protezione dei dati personali. Tecnicamente il codice base parte solo dopo l'accettazione, ad esempio con un trigger di consenso in Tag Manager o con la funzione di consenso di fbq. Anche la CAPI dovrebbe inviare solo i dati di chi ha acconsentito. Questa non è consulenza legale: fai verificare banner, informativa privacy e trasferimenti di dati da un professionista.

Cosa non inviare

• Categorie sensibili come condizioni di salute o situazione finanziaria in URL, parametri degli eventi o nomi dei contenuti.
• Dati personali senza hash in qualsiasi parametro, anche negli URL. Una pagina di ringraziamento come /grazie?email=mario@esempio.it passa l'email al Pixel in automatico.
• Eventi di pagine che non sono tue.

Test prima di spendere il primo euro

1. Apri Gestione eventi → Testa eventi, inserisci l'URL e avvia una conversione di prova.
2. L'evento Lead deve comparire due volte, come Browser e come Server, unite in una riga contrassegnata "Deduplicato".
3. Verifica nella panoramica che la qualità di corrispondenza di Lead sia almeno 6,0.
4. Installa l'estensione Chrome Meta Pixel Helper. Un'icona verde con un solo PageView per pagina indica che il codice base parte una volta.
5. Rimuovi il test_event_code prima di andare online, così gli eventi reali non vengono trattati come test.
6. Dopo 24 ore controlla la Diagnostica: parametri mancanti, eventi duplicati, dominio non verificato.

Problemi comuni e soluzioni

Usare il tuo Pixel con un account agenzia

Quando usi un account pubblicitario con noi, il Pixel resta nel tuo Business Manager e viene condiviso con l'account agenzia. Dati, pubblici e apprendimento restano tuoi. Se l'account dovesse essere sostituito, condividi il Pixel con quello nuovo e le campagne riprendono con tutto lo storico. Per questo l'installazione del Pixel è inclusa nei piani Growth e Scale: vedi servizi e prezzi. Abbina un tracking solido a un aumento graduale del budget e la fase di apprendimento si chiude molto prima.

Checklist

• Dominio verificato nel BM proprietario del Pixel
• Codice base su tutte le pagine, PageView a ogni cambio di route
• Eventi standard sulle azioni chiave
• CAPI che invia gli stessi eventi con event_id identica
• Email e telefono con hash SHA-256
• EMQ di 6 o più sull'evento principale
• Consenso raccolto prima del Pixel (UE)
• Nessun dato sensibile in URL o parametri

Leggi anche: Perché il tuo account pubblicitario Facebook viene bannato e Noleggio account pubblicitario Facebook: costi e rischi.

Preferisci non farlo da solo? HD Agency installa il Pixel, verifica il dominio e configura l'API Conversioni deduplicata. Scrivici su Telegram o WhatsApp, risposta in circa 5 minuti. Scopri anche le soluzioni per settore.