Configurazione Meta Pixel

Questa guida ti mostra come collegare il tuo Meta Pixel ad AdTarget per il tracciamento delle conversioni.

Prerequisiti

• Un account Meta Business
• Un Meta Pixel (ti mostreremo come crearne uno se necessario)
• Accesso da amministratore al tuo Business Manager

Passo 1: Trova il Tuo Pixel ID

Se Hai un Pixel Esistente

1. Vai a Meta Events Manager 
2. Seleziona il tuo Pixel dalla lista delle fonti dati
3. Il tuo Pixel ID è mostrato in alto (un numero di 15-16 cifre)

Se Devi Creare un Pixel

1. Vai a Meta Events Manager 
2. Clicca Connect Data Sources
3. Seleziona Web
4. Scegli Meta Pixel
5. Inserisci un nome per il tuo pixel
6. Clicca Create Pixel
7. Copia il Pixel ID

Passo 2: Crea un Token System User

Per inviare eventi lato server, hai bisogno di un token di accesso Conversions API.

Crea uno System User

1. Vai a Business Settings 
2. Clicca Users → System Users
3. Clicca Add
4. Inserisci un nome (es. “AdTarget CAPI”)
5. Imposta il ruolo su Admin
6. Clicca Create System User

Assegna l’Accesso al Pixel

1. Clicca sul tuo nuovo system user
2. Clicca Add Assets
3. Seleziona Pixels
4. Scegli il tuo pixel
5. Abilita il permesso Manage Pixel
6. Clicca Save Changes

Genera il Token di Accesso

1. Clicca Generate New Token
2. Seleziona la tua app (o creane una se necessario)
3. Seleziona questi permessi:
   • ads_management
   • ads_read
4. Clicca Generate Token
5. Copia il token immediatamente (non lo vedrai di nuovo)

Passo 3: Aggiungi il Pixel ad AdTarget

Ora che hai il tuo Pixel ID e il token di accesso, collegali in AdTarget:

1. Vai alla tua dashboard AdTarget 
2. Seleziona il tuo sito, poi apri le sue Settings
3. Clicca la scheda Pixels nella barra laterale
4. Clicca + Add pixel per aprire la finestra di configurazione
5. Inserisci un Name per il pixel (es. “Main Pixel”) — compilalo per primo, perché il pixel non può salvarsi automaticamente senza un nome
6. Incolla il tuo Pixel ID (il numero di 15-16 cifre)
7. Incolla il tuo Access Token

La validazione si attiva automaticamente quando il Pixel ID ha 15-16 cifre E l’Access Token ha 50+ caratteri. Vedrai uno spinner “Verifying credentials…” mentre AdTarget controlla le tue credenziali con l’API Meta.

Dopo che la verifica ha successo e appare “Credentials verified!”, il pixel si salva automaticamente solo quando tutti e tre i campi sono validi: Name, Pixel ID e Access Token. Se il campo Name è vuoto, il pixel non si salverà anche dopo la verifica delle credenziali — compila il campo Name e il salvataggio procederà immediatamente.

In caso di successo:

• Appare una conferma “Credentials verified!”
• Il pixel si salva automaticamente e viene impostato come predefinito per il tuo sito (richiede che tutti e tre i campi siano validi)
• La finestra si chiude e il tuo nuovo pixel appare nella lista

Verifica la Configurazione

Dopo che il tuo pixel è collegato:

1. Controlla la scheda Pixels — il tuo pixel dovrebbe apparire nella lista con un radio button selezionato, che indica che è il predefinito
2. Vai a Meta Events Manager  e apri la scheda Test Events
3. Cerca un evento di test con il codice ADTARGET_TEST inviato durante la validazione

Indicatori di successo:

• Il tuo pixel è elencato nella scheda Pixels
• Evento di test visibile in Events Manager
• Il punteggio di qualità dell’evento mostra “Good” o superiore

Gestione dei Pixel

Selezionare un Pixel Predefinito

Se hai più pixel, clicca su qualsiasi pixel nella lista per impostarlo come predefinito per il tuo sito. Il pixel predefinito viene usato per tutti gli eventi di conversione.

Eliminare un Pixel

Clicca l’icona cestino accanto a un pixel per rimuoverlo. Puoi aggiungere fino a 10 pixel per account.

Risoluzione dei Problemi

“Pixel ID must be a 15-16 digit number”

• Assicurati di aver copiato il numero completo di 15-16 cifre
• Il campo accetta solo caratteri numerici

“Access token appears to be incomplete”

• I token di accesso Meta sono stringhe lunghe (50+ caratteri)
• Assicurati di aver copiato l’intero token

“Invalid or expired access token”

• I token possono essere visualizzati solo una volta al momento della creazione
• Se perso, genera un nuovo token dalle Business Settings
• Assicurati che il token abbia i permessi richiesti

“Pixel ID not found or not accessible with this token”

• Verifica che lo system user abbia accesso al pixel
• Controlla i permessi degli asset nel Business Manager

“Access token lacks permission to send events to this pixel”

• Ricontrolla che allo system user sia stato assegnato il pixel con il permesso Manage Pixel
• Potresti dover generare un nuovo token con i permessi corretti

Gli eventi non appaiono in Events Manager?

• Aspetta 5-10 minuti perché gli eventi vengano elaborati
• Controlla la scheda “Test Events” per il debugging
• Verifica che nessun filtro stia nascondendo gli eventi

Punteggio di Qualità degli Eventi

Meta valuta i tuoi eventi in base alla qualità dei dati:

Per migliorare la qualità degli eventi:

• Assicurati che il fbclid venga catturato dai clic sugli annunci
• Usa nomi di eventi coerenti
• Invia gli eventi tempestivamente dopo le conversioni

Prossimi Passi

Ora che il tuo pixel è collegato, configura quali eventi CAPI inviare.