Získání Meta Ads API tokenu

Krok 1.

Vytvoření Facebook App – otevři Facebook for Developers: https://developers.facebook.com/apps

1. Klikni My Apps → Create App

2. Otázka „What do you want your app to do?“ → vyber Other (úplně dole) → Next

3. App type → Business → Next

4. Display name: např. „FameDash API“

5. Contact email: tvůj email

6. Business Account: vyber své Business Portfolio (důležité — propojí app s portfoliem)

7. Klikni Create App

Krok 2.

Po vytvoření tě stránka přesměruje do App Dashboardu.

V URL adrese najdeš App ID (cca 16 číslic), např.: https://developers.facebook.com/apps/1683022462731104/dashboard/

Tento App ID si poznamenej — budeme ho potřebovat v Kroku 3.

Krok 3.

Konfigurace Marketing API permissions – V App Dashboardu uvidíš sekci „App customization and requirements“ s první položkou: Customize the Create & manage ads with Marketing API use case.

1. Klikni na tento řádek (šipka vpravo)

2. Otevře se seznam Permissions — najdi sekci ads_read (lze vyhledat)

3. U ads_read by měl být status „Ready for testing“

Krok 4.

U ads_read by měl být status „Ready for testing“

Pozn.: Status „Ready for testing“ znamená, že permission funguje pro tvůj vlastní účet bez App Review. Nemusíš klikat na „Go to App Review“ — to spouští několika týdení schvalovací proces a není potřeba pro interní použití.

Důležité: Tohle je nejčastější kámen úrazu. Pokud ads_read u aplikace nenakonfiguruješ, při generování tokenu (Krok 7) ti wizard vyhodí „Nejsou k dispozici žádná oprávnění“ a token nepůjde vytvořit. Stačí jediné oprávnění ads_read — pokrývá čtení všech statistik (útrata, konverze, hodnota konverzí). Pokud v seznamu nenajdeš read_insights ani business_management, nevadí — nejsou potřeba.

Krok 5.

Propojení App s Business Portfolio: App vytvořená v Kroku 1 by měla být automaticky propojená s Business Portfoliem, ale pro jistotu to zkontroluj:

1. Otevři business.facebook.com → Nastavení (ikona ozubeného kola vlevo dole)

2. Vlevo Účty → Aplikace

3. Pokud aplikace v seznamu není: klikni Přidat → Připojit ID aplikace → vlož App ID z Kroku 1 → Přidat

Krok 6.

Vytvoření System User – System User je virtuální uživatel, který vydává long-lived token pro server-side aplikace (nelze přihlásit do FB UI). Doporučovaný způsob pro automatizované integrace.

1. V Business Settings vlevo Uživatelé → Systémoví uživatelé

2. Klikni Přidat (modré tlačítko vpravo nahoře)

3. Název: např. „FameDash API“

4. Role: Správce (Admin) — jednodušší pro nás, nebo Employee pro restrictnější přístup

5. Klikni Vytvořit systémového uživatele

Krok 7.

Přiřazení Ad Account k System User: System User musí mít explicitně přidělený přístup ke každému reklamnímu účtu, ze kterého chceme číst data.

1. Na detailu vytvořeného System User klikni Přidat zdroje (Add Assets)

2. V levém panelu vyber Účty pro reklamu (Ad Accounts)

3. Zaškrtni svůj reklamní účet

4. Vpravo nastav oprávnění — pouze Zobrazit výkon (View Performance)

5. Klikni Přiřadit položky

Krok 8.

Propojení App se System User (volitelné) – Ve většině případů se aplikace ke System Userovi „nainstaluje“ automaticky ve chvíli, kdy přes ni v Kroku 7 vygeneruješ token — nemusíš nic dělat ručně. Hlavní příčinou chyby „Nejsou k dispozici žádná oprávnění“ je nenakonfigurovaný ads_read u aplikace (Krok 2), ne chybějící propojení.

Pokud i po Kroku 2 token nejde vytvořit, propoj App se System Userem ručně:

2. Otevři App Dashboard (developers.facebook.com/apps/)

3. V levém menu App roles → Roles

4. Klikni Add People → vyber typ System User

5. Vyhledej name svého System User (např. „FameDash API“)

6. Role: Developer (nebo Admin pro plnou kontrolu)

7. Klikni na Add

Alternativní cesta: V některých UI variantách Meta Business je tato funkce přímo na detailu System User — v záložce „Nainstalované aplikace“ lze přidat App. Pokud nevidíš tlačítko v App Dashboardu, zkus tuto cestu.

Krok 9.

Vygenerování tokenu – Vrať se do Business Settings → Uživatelé → Systémoví uživatelé → klikni na svého System User (např. „FameDash API“).

Detail systémového uživatele s přiřazeným reklamním účtem (Zobrazit výkon) a tlačítkem Generovat token, kterým spustíš wizard

Klikni Generovat token

Krok 10.

Wizard, krok 1 — Vyberte aplikaci: zvol svou Meta aplikaci (zde „Equiduo x Famedash – api“)

Krok 11.

Wizard, krok 2 — Nastavte ukončení platnosti: vyber Nikdy (token nevyprší)

Krok 12.

Wizard, krok 3 — Přiřaďte oprávnění: zaškrtni ads_read a klikni Generovat token (aplikace se tím automaticky nainstaluje)

Pozor: Token se zobrazí pouze jednou. Zkopíruj ho okamžitě do bezpečného úložiště (např. password manageru). Pokud se ti ztratí, musíš vygenerovat nový.

Token má cca 200 znaků a začíná řetězcem EAA…, například: EAABwzLixnjYBO1ZBpZAvLW4mZAlGqOZBmH…

Krok 13.

Získání Ad Account ID

Nejrychlejší cesta — z URL Ads Managera:

1. Otevři https://adsmanager.facebook.com

2. Vyber správný reklamní účet (pokud máš více účtů)

3. V URL adrese hledej parametr act=XXXXXXXXXXXXX (10–16 číslic)

4. Toto číslo je tvoje Ad Account ID – Příklad URL: https://adsmanager.facebook.com/adsmanager/manage/accounts?act=147419882064303&…V tomto případě je Ad Account ID = 147419882064303.

Alternativní cesta — z Business Settings (pokud nechceš otvírat Ads Manager):

1. Otevři business.facebook.com/settings

2. Vlevo Účty → Účty pro reklamu

3. Klikni na svůj reklamní účet (např. „Equiduo – účet pro reklamu“)

4. V detailu vidíš pole ID účtu (vedle názvu) — 10–16 číslic

Pozor na záměnu ID: Během celého procesu narazíš na několik různých ID — nepleť si je. Ad Account ID je JINÉ než tato čísla: Business Portfolio ID (z URL nastavení firmy), System User ID (na detailu systémového uživatele) a App ID (z URL App Dashboardu). Do FameDashe patří POUZE Ad Account ID (act_…).

Formát pro FameDash: Do nastavení FameDashe vlož ID s prefixem act_, tedy act_147419882064303. Pokud zadáš jen číslo, systém si prefix doplní sám.

Krok 14.

Vyplnění ve FameDash

1. Ve FameDash otevři Moduly a vytvoř nový modul typu Marketing (nebo otevři existující modul k editaci).

2. V sekci Nastavení najdeš pole Meta Ads – Access Token (System User) a Meta Ads – Ad Account ID

3. Do pole Meta Ads – Access Token vlož token z Kroku 7

4. Do pole Meta Ads – Ad Account ID vlož act_… z Kroku 8

5. Ulož — u nového modulu tlačítkem Vytvořit, u existujícího přes ikonu ozubeného kola u daného řádku a Uložit

Krok 15.

Vyčistit cache (jinak může držet staré údaje): php artisan cache:clear

Refresh stránky /marketing/{id} — řádek Meta by se měl naplnit reálnými daty během několika sekund.

Krok 15.

Výsledné zobrazení ve FameDash