Collegare Meta con un token (System User)

Apri le Impostazioni del business

Vai sul Business Manager di Meta e accedi con un account amministratore.

Apri Meta Business Settings

ℹ️ Se gestisci più aziende, in alto a sinistra controlla di aver selezionato il business giusto, quello che possiede l'account pubblicitario.

Crea un utente di sistema

L'utente di sistema (System User) è un "utente tecnico" del business, pensato proprio per le integrazioni.

1. Nel menu a sinistra, vai su Utenti → Utenti di sistema.
2. Clicca Aggiungi.
3. Dai un nome riconoscibile, es. RoyLead Sync.
4. Ruolo: Employee (Dipendente) — non serve Admin. I permessi di scrittura arrivano dalle risorse che gli assegni ai passi 3-5, non dal ruolo. Clicca Crea utente di sistema.

Assegna gli account pubblicitari (in scrittura)

Il token vede solo le risorse che assegni esplicitamente a questo utente.

1. Con l'utente di sistema selezionato, clicca Assegna risorse.
2. Tipo di risorsa: Account pubblicitari → seleziona gli account che vuoi collegare. Se ne hai più di uno da usare, selezionali tutti adesso: RoyLead li collega in un colpo solo.
3. Nei permessi, sotto Accesso parziale, attiva "Gestisci campagne (inserzioni)": è ads_management, il permesso che permette di creare e lanciare. ("Visualizza le prestazioni" si accende da sé, è incluso.)
4. Lascia spento "Gestire gli account pubblicitari" (Accesso completo): darebbe anche il controllo su pagamenti e impostazioni dell'account, che a RoyLead non serve.
5. Clicca Assegna risorse.

⚠️ Con il solo "Visualizza le prestazioni" l'account si collega e la spesa arriva, ma il lancio non funziona: Meta rifiuta la creazione della campagna con un errore di permessi.

Assegna il pixel

Al lancio, l'ad set dichiara il pixel come obiettivo di conversione, e quella chiamata la fa il token: se il token non vede il pixel, Meta risponde con un errore di permessi.

1. Sempre in Assegna risorse, tipo di risorsa Dataset (nei business più vecchi si chiama Pixel).
2. Seleziona il pixel che usi per queste campagne.
3. Permessi: attiva "Usa dataset degli eventi" (Accesso parziale) — dice esplicitamente "crea inserzioni per le conversioni con questo dataset". Lascia spento "Gestisci dataset di eventi".
4. Clicca Assegna risorse.

ℹ️ Questo è diverso dal token CAPI che RoyLead usa per mandare gli eventi a Meta. Qui serve solo perché la campagna possa puntare a quel pixel.

Assegna la Pagina Facebook

Ogni inserzione Meta ha una Pagina come mittente. Le Pagine si assegnano da un'altra sezione, non dalla finestra "Assegna risorse".

1. Menu a sinistra: Account → Pagine.
2. Seleziona la Pagina che userai nelle inserzioni.
3. Clicca Assegna persone e scegli l'utente di sistema RoyLead Sync.
4. Attiva "Inserzioni" (crea e gestisce le inserzioni della Pagina) e "Insight", poi clicca Assegna.

⚠️ Se al lancio vedi un errore di permessi sulla Pagina, torna qui e alza a Accesso completo: il collegamento dell'account Instagram a volte lo richiede.

Prepara l'app

Il token si genera tramite un'app del business, e l'utente di sistema deve avere un ruolo su quell'app. Se hai già un'app collegata all'utente di sistema, salta al Passo 7.

Crea l'app (se non ne hai una)

Non serve l'approvazione di Meta: l'app è solo il "contenitore" tecnico del token, e una qualsiasi app del business con la Marketing API va bene.

1. Vai in Impostazioni business → Account → App → Aggiungi → "Crea un nuovo ID app".

2. Nome dell'app: es. RoyLead Sync (l'email di contatto è già la tua).

3. Casi d'uso: lascia selezionato "Crea e gestisci le inserzioni con l'API Marketing" (è la prima opzione, già spuntata di default).

4. Azienda: collega l'app al tuo portfolio business, così appartiene al business giusto.
5. Controlla la Panoramica e clicca Crea app. La Marketing API è già inclusa grazie al caso d'uso scelto.

Collega l'app all'utente di sistema

Non basta creare l'app: l'utente di sistema deve avere un ruolo sull'app, altrimenti lo step "Assegna autorizzazioni" del token resta vuoto.

1. Vai in Account → App e seleziona la tua app.
2. Clicca Assegna persone.

3. Seleziona l'utente di sistema (es. RoyLead Sync), attiva il toggle "Sviluppa l'app" e clicca Assegna. Lascia spento "Gestisci l'app".

Pubblica l'app (serve per lanciare)

Un'app appena creata è in modalità sviluppo: legge i dati ma non può creare inserzioni. Il lancio si ferma a metà, sulla creatività, con «La creatività delle inserzioni è stata creata da un'app che si trova in modalità sviluppo» (1885183).

1. Su developers.facebook.com/apps apri la tua app.
2. Impostazioni app → Di base, compila i due campi che Meta pretende per pubblicare: URL dell'Informativa sulla privacy e Categoria. Salva.
3. Nel menu a sinistra, Pubblicazione: da "Non pubblicata" pubblica l'app.

ℹ️ Non è la revisione di Meta (App Review), che invece non serve: è solo l'interruttore che porta l'app fuori dalla modalità sviluppo.

Genera il token

1. Torna su Utenti → Utenti di sistema, seleziona il tuo utente e clicca Genera nuovo token.
2. Seleziona la tua app dall'elenco (quella del Passo 6).
3. Scadenza del token: Mai, per un collegamento permanente.
4. Spunta questi permessi:

Permesso	A cosa serve
ads_management	creare campagne, ad set, creatività e inserzioni (include la lettura dei costi)
ads_read	spesa, click e impression per ROI e ROAS
pages_show_list	vedere la Pagina mittente delle inserzioni
pages_read_engagement	leggere i dati della Pagina (senza questo il lancio si fermava con l'errore #100)
pages_manage_ads	pubblicare le inserzioni a nome della Pagina e collegare l'account Instagram
business_management	scoprire quali account pubblicitari sono assegnati al token

5. Clicca Genera token e copialo subito.

⚠️ Se nello step "Assegna autorizzazioni" vedi "Nessuna autorizzazione disponibile", l'app non è collegata all'utente di sistema: completa il Passo 6 e riprova.

🔒 Meta mostra il token una sola volta. Se lo perdi non è un problema: ne generi un altro e lo reincolli in RoyLead.

Incolla il token in RoyLead

1. Apri la scheda Account Pubblicitari del tuo team in RoyLead.
2. Clicca Collega account e scegli "Meta · collega tutto il Business Manager".
3. Incolla il token e conferma.

Vai negli Account Pubblicitari ↗

RoyLead verifica subito il token con Meta, scopre tutti gli ad account assegnati a quel token, ne recupera nome e valuta in automatico e li collega. Al termine ti dice quanti account sono nuovi e quanti aggiornati.

ℹ️ Non ti viene chiesto nessun ID account: se un account non compare, non è assegnato all'utente di sistema (torna al Passo 3).

Importa i pixel nel registro

Nella scheda della campagna, la tendina Pixel mostra solo i pixel legati a quell'ad account. Un pixel inserito a mano nel registro non è legato a nessun account, quindi la tendina resta vuota e il lancio si blocca.

1. Apri la sezione Pixel di RoyLead.
2. Clicca Importa da Meta.
3. Scegli l'account Meta appena collegato e conferma.

Vai in Pixel ↗

RoyLead importa i pixel di quell'account e li lega alla connessione. Un pixel manuale con lo stesso ID viene sovrascritto, non duplicato, e il token CAPI passa a quello del System User.

Verifica

Sul collegamento:

• l'account compare nella lista con lo stato Connesso;
• la sincronizzazione automatica gira ogni poche ore; puoi forzarla dal pulsante Sincronizza;
• dopo il primo sync, spesa e ROI compaiono in Analytics accanto ai tuoi lead.

Sul lancio, nella scheda della campagna → Account di destinazione, per ogni account devi poter scegliere:

• Pagina Facebook mittente (dal Passo 5);
• Pixel (dal Passo 9), obbligatorio con obiettivo a conversione;
• Beneficiario (UE/DSA).

Poi Valida e Lancia su Meta.

⚠️ Dalla dashboard la campagna viene pubblicata attiva (o programmata alla data e ora che hai scelto, nel fuso dell'ad account): dal lancio inizia a spendere. Solo i lanci fatti da un agente via MCP vengono pubblicati in pausa.