Conectează Meta cu un token (System User)

Pasul 1 — Deschide setările business

Intră în Business Manager de la Meta cu un cont de administrator.

Deschide Meta Business Settings

ℹ️ Dacă administrezi mai multe business-uri, verifică sus în stânga să fie selectat cel corect: cel care deține contul publicitar.

Pasul 2 — Creează un utilizator de sistem

Utilizatorul de sistem (System User) este un „utilizator tehnic" al business-ului, gândit exact pentru integrări.

1. În meniul din stânga, mergi la Utilizatori → Utilizatori de sistem.
2. Apasă Adaugă.
3. Dă-i un nume recognoscibil, ex. RoyLead Sync.
4. Rol: Employee (Angajat) — nu ai nevoie de Admin. Drepturile de scriere vin din resursele pe care i le atribui la pașii 3-5, nu din rol. Apasă Creează utilizator de sistem.

Pasul 3 — Atribuie conturile publicitare (cu scriere)

Tokenul vede doar resursele pe care le atribui explicit acestui utilizator.

1. Cu utilizatorul de sistem selectat, apasă Atribuie resurse.
2. Tip de resursă: Conturi publicitare → selectează conturile pe care vrei să le conectezi. Dacă folosești mai multe, selectează-le pe toate acum: RoyLead le conectează dintr-o singură mișcare.
3. La permisiuni, în Acces parțial, activează „Gestionează campaniile": este ads_management, permisiunea care permite crearea și lansarea. („Vizualizează performanța" se aprinde singură, e inclusă.)
4. Lasă stins „Gestionează conturile publicitare" (Control total): ar da și controlul asupra plăților și setărilor contului, de care RoyLead nu are nevoie.
5. Apasă Atribuie resurse.

⚠️ Doar cu „Vizualizează performanța" contul se conectează și cheltuiala ajunge, dar lansarea nu funcționează: Meta refuză crearea campaniei cu o eroare de permisiuni.

Pasul 4 — Atribuie pixelul

La lansare, setul de anunțuri declară pixelul ca obiectiv de conversie, iar apelul acela e făcut cu tokenul: dacă tokenul nu vede pixelul, Meta răspunde cu o eroare de permisiuni.

1. Tot în Atribuie resurse, alege tipul Seturi de date (în business-urile mai vechi se numește Pixeli).
2. Selectează pixelul pe care îl folosești pentru aceste campanii.
3. Permisiuni: activează „Folosește setul de date despre evenimente" (Acces parțial) — scrie explicit „creează reclame pentru conversii cu acest set de date". Lasă stins „Gestionează setul de date despre evenimente".
4. Apasă Atribuie resurse.

ℹ️ E diferit de tokenul CAPI pe care RoyLead îl folosește ca să trimită evenimentele la Meta. Aici e nevoie doar ca campania să poată ținti acel pixel.

Pasul 5 — Atribuie pagina de Facebook

Fiecare reclamă Meta are o pagină ca expeditor. Paginile se atribuie din altă secțiune, nu din fereastra „Atribuie resurse".

1. Meniul din stânga: Conturi → Pagini.
2. Selectează pagina pe care o vei folosi în reclame.
3. Apasă Atribuie persoane și alege utilizatorul de sistem RoyLead Sync.
4. Activează „Reclame" (creează și gestionează reclamele paginii) și „Statistici", apoi apasă Atribuie.

⚠️ Dacă la lansare vezi o eroare de permisiuni pe pagină, revino aici și urcă la Control total: legarea contului de Instagram o cere uneori.

Pasul 6 — Pregătește aplicația

Tokenul se generează printr-o aplicație a business-ului, iar utilizatorul de sistem trebuie să aibă un rol pe acea aplicație. Dacă ai deja o aplicație legată de utilizatorul de sistem, sari la Pasul 7.

Creează aplicația (dacă nu ai una)

Nu e nevoie de aprobarea Meta: aplicația e doar „containerul" tehnic al tokenului, și orice aplicație a business-ului cu Marketing API e bună.

1. Mergi la Setări business → Conturi → Aplicații → Adaugă → „Creează un ID de aplicație nou".

2. Numele aplicației: ex. RoyLead Sync (emailul de contact e deja al tău).

3. Cazuri de utilizare: lasă selectat „Creează și gestionează reclame cu Marketing API" (e prima opțiune, deja bifată implicit).

4. Companie: leagă aplicația de portofoliul tău business, ca să aparțină business-ului corect.
5. Verifică Prezentarea generală și apasă Creează aplicația. Marketing API e deja inclus datorită cazului de utilizare ales.

Leagă aplicația de utilizatorul de sistem

Nu e suficient să creezi aplicația: utilizatorul de sistem trebuie să aibă un rol pe aplicație, altfel pasul „Atribuie permisiuni" al tokenului rămâne gol.

1. Mergi la Conturi → Aplicații și selectează aplicația ta.
2. Apasă Atribuie persoane.

3. Selectează utilizatorul de sistem (ex. RoyLead Sync), activează comutatorul „Dezvoltă aplicația" și apasă Atribuie. Lasă stins „Gestionează aplicația".

Publică aplicația (necesar pentru lansare)

O aplicație abia creată e în mod dezvoltare: citește date, dar nu poate crea reclame. Lansarea se oprește la jumătate, pe creativ, cu „Creativul reclamei a fost creat de o aplicație în mod dezvoltare" (1885183).

1. Pe developers.facebook.com/apps deschide aplicația ta.
2. Setări aplicație → De bază: completează cele două câmpuri cerute de Meta pentru publicare — URL-ul politicii de confidențialitate și Categoria. Salvează.
3. În meniul din stânga, Publicare: trece aplicația din „Nepublicată" în publicată.

ℹ️ Nu e App Review de la Meta, de care nu ai nevoie: e doar comutatorul care scoate aplicația din modul dezvoltare.

Pasul 7 — Generează tokenul

1. Întoarce-te la Utilizatori → Utilizatori de sistem, selectează utilizatorul și apasă Generează token nou.
2. Selectează aplicația ta din listă (cea de la Pasul 6).
3. Expirarea tokenului: Niciodată, pentru o conexiune permanentă.
4. Bifează aceste permisiuni:

5. Apasă Generează token și copiază-l imediat.

⚠️ Dacă la pasul „Atribuie permisiuni" vezi „Nicio permisiune disponibilă", aplicația nu e legată de utilizatorul de sistem: fă Pasul 6 și încearcă din nou.

🔒 Meta arată tokenul o singură dată. Dacă îl pierzi nu e o problemă: generezi altul și îl lipești din nou în RoyLead.

Pasul 8 — Lipește tokenul în RoyLead

1. Deschide secțiunea Conturi publicitare a echipei tale din RoyLead.
2. Apasă Conectează cont și alege „Meta · conectează tot Business Manager-ul".
3. Lipește tokenul și confirmă.

Mergi la Conturi publicitare ↗

RoyLead verifică imediat tokenul la Meta, descoperă toate conturile publicitare atribuite acelui token, le ia automat numele și moneda și le conectează. La final îți spune câte conturi sunt noi și câte au fost actualizate.

ℹ️ Nu ți se cere niciun ID de cont: dacă un cont nu apare, nu e atribuit utilizatorului de sistem (înapoi la Pasul 3).

Pasul 9 — Importă pixelii în registru

În fișa campaniei, lista Pixel arată doar pixelii legați de acel cont publicitar. Un pixel adăugat manual în registru nu e legat de niciun cont, așa că lista rămâne goală și lansarea e blocată.

1. Deschide secțiunea Pixeli din RoyLead.
2. Apasă Importă din Meta.
3. Alege contul Meta pe care l-ai conectat și confirmă.

Mergi în Pixeli ↗

RoyLead importă pixelii acelui cont și îi leagă de conexiune. Un pixel manual cu același ID e suprascris, nu duplicat, iar tokenul lui CAPI devine cel al System User.

Pasul 10 — Verifică

Despre conexiune:

• contul apare în listă cu starea Conectat;
• sincronizarea automată rulează la câteva ore; o poți forța cu butonul Sincronizează;
• după primul sync, cheltuiala și ROI apar în Analytics lângă lead-uri.

Despre lansare, în fișa campaniei → Conturi de destinație, pentru fiecare cont trebuie să poți alege:

• pagina de Facebook expeditor (Pasul 5);
• pixelul (Pasul 9), obligatoriu cu obiectiv de conversie;
• beneficiarul (UE/DSA).

Apoi Validează și Lansează pe Meta.

⚠️ Din panou campania se publică activă (sau programată la data și ora alese, în fusul contului publicitar): începe să cheltuie de la lansare. Doar lansările făcute de un agent prin MCP se publică în pauză.

Doar tokenul lansează, accesul cu Facebook nu

Un cont conectat cu „Conectare cu Facebook" (OAuth) rămâne doar citire: importă cheltuiala și ROI, dar nu apare între conturile de destinație ale unei campanii. Motivul: aplicația RoyLead are doar permisiuni de citire a costurilor, nu ads_management.

Dacă încerci oricum, primești eroarea „Cont publicitar invalid sau nelansabil (e nevoie de un token System User)". Soluția e să conectezi același cont cu tokenul: conexiunea se actualizează pe loc, fără să pierzi istoricul cheltuielii.

ℹ️ Atenție la un lucru: tokenul e legat de aplicația Meta folosită ca să-l generezi. Dacă Meta suspendă acea aplicație, se opresc și tokenul și OAuth. Tokenul te apără de problemele fluxului de login, nu de o suspendare a aplicației.

Dacă tokenul expiră sau nu mai funcționează

Dacă generezi un token cu expirare și acesta expiră, sau îl revoci din Business Manager, RoyLead marchează contul cu o stare de eroare.

Cum repari: reconectează Business Manager-ul cu tokenul nou din aceeași fereastră ca la Pasul 8 (conturile existente se actualizează, nu se dublează), sau pe cardul contului folosește meniul ⋯ → Modifică credențialele. Nu trebuie să refaci nimic în Meta.

Rezolvarea problemelor

💡 Generează tokenul cu expirare Niciodată ca să eviți întreruperile: e cea mai comodă alegere pentru o sincronizare continuă.

Bune practici

• 🔑 Un utilizator de sistem dedicat RoyLead: dacă revoci tokenul, blochezi doar acea integrare.
• 🔒 Atribuie utilizatorului de sistem doar conturile publicitare, pixelii și paginile pe care vrei într-adevăr să le folosești.
• 🧱 Permisiuni minime: „Gestionează campaniile" și nu „Gestionează conturile publicitare", „Folosește setul de date" și nu „Gestionează setul de date".
• 🚨 Tratează tokenul ca pe o parolă: dacă crezi că a ajuns unde nu trebuie, regenerează-l din Business Manager și lipește-l pe cel nou.