Wielkie Kompendium Facebook & Meta Ads Studio PRO v2.0 w AI-MAX
Wszystko, co można zrobić przez API Facebooka (14 obszarów + 6 światowych systemów AdTech: Madgicx, Birch, Motion, Foreplay, AdCreative.ai, Marpipe), katalog 14 skilli dla Ciebie i dla Agenta AI oraz wizualna instrukcja krok po kroku z 10 oznaczonymi screenami (.webp) — od utworzenia aplikacji Meta, OAuth 2.0 i Tokenu System Usera, przez Planer AI, 6-osiowy audyt, Kreacje 4:5/9:16 Reels, matrycę 150 kombinacji DCO, aż po Motion Creative Analytics, Strażnika Budżetu i tryb dokowania obok czatu.
1. Wszystko, co można zrobić przez API Facebooka (14 Obszarów Graph API & Marketing API v22.0)
| Nr | Obszar API Facebooka | Główne Endpointy v22.0 | Możliwości w naszym systemie AI-MAX |
|---|---|---|---|
| 01 | Kampanie Reklamowe ODAX v22.0 | POST /act_<ID>/campaigns/adsets, /ads |
Tworzenie pełnych struktur kampanii w 6 celach ODAX (OUTCOME_LEADS, OUTCOME_SALES, OUTCOME_TRAFFIC, OUTCOME_ENGAGEMENT, OUTCOME_AWARENESS, OUTCOME_APP_PROMOTION), włączanie (ACTIVE), wstrzymywanie (PAUSED), archiwizacja i skalowanie budżetów w PLN/EUR/USD. |
| 02 | Advantage+ Shopping (ASC) & Advantage+ Audience | targeting_automation.advantage_audience = 1 |
Automatyczne poszukiwanie konwertujących klientów przez AI Mety poza sztywnymi zainteresowaniami. |
| 03 | Kreacje Reklamowe i Dynamic Creative (DCO) | POST /act_<ID>/adimages/adcreatives (asset_feed_spec) |
Wgrywanie obrazów (image_hash) i wideo, tworzenie reklam pojedynczych, karuzelowych (child_attachments) oraz wielowariantowych reklam dynamicznych (do 150 kombinacji: 5 obrazów × 5 tekstów × 3 nagłówki × 2 CTA). |
| 04 | Grupy Odbiorców: Custom & Lookalike Audiences | POST /act_<ID>/customaudiences/<AUD_ID>/users |
Tworzenie siatki 7 grup odbiorców (Madgicx Audience Launcher): remarketing WWW (30–180 dni), zahaszowane (SHA-256) bazy klientów z CRM oraz grupy podobnych odbiorców Lookalike 1%–5% w Polsce. |
| 05 | Wyszukiwarka Targetowania i Estymator Zasięgu | GET /search?type=adinterest/act_<ID>/reachestimate |
Wyszukiwanie oficjalnych zainteresowań Meta po polsku, geolokalizacji miast z promieniem km oraz interaktywny suwak budżetu szacujący dzienne kliknięcia, leady, CPA i ROAS. |
| 06 | Formularze Błyskawiczne Lead Ads i Webhooki | POST /<PAGE_ID>/leadgen_formsGET /<FORM_ID>/leads |
Tworzenie natywnych formularzy kontaktowych wewnątrz FB/IG (autouzupełnianie imienia, telefonu i e-maila) oraz natychmiastowy odbiór leadów przez Webhook z weryfikacją X-Hub-Signature-256. |
| 07 | Meta Pixel + Conversions API (CAPI Server-Side) | POST /<PIXEL_ID>/events |
Automatyczne wstrzyknięcie fbevents.js do index.html projektu oraz serwerowa wysyłka zdarzeń (Lead, Purchase, AddToCart, Contact) z haszowaniem SHA-256 i deduplikacją po event_id. |
| 08 | Facebook Pages API (Automatyzacja Fanpage'a) | POST /<PAGE_ID>/feed/photos, /videos, /video_reels |
Publikacja i planowanie (scheduled_publish_time) postów tekstowych, linków, zdjęć, albumów, wideo i Facebook Reels. |
| 09 | Instagram Graph API (Posty, Karuzele, Reels, Stories) | POST /<IG_ID>/mediaPOST /<IG_ID>/media_publish |
Automatyczna publikacja zdjęć, karuzel, rolek (Instagram Reels) i relacji (Stories) na powiązanym koncie firmowym Instagram oraz odczyt statystyk profilu. |
| 10 | Moderacja Komentarzy pod Postami i Reklamami | GET/POST /<OBJECT_ID>/comments |
Pobieranie komentarzy spod postów organicznych i reklam, automatyczne odpowiadanie przez AI, ukrywanie spamu (is_hidden=true) oraz wysyłanie odpowiedzi prywatnej (private_replies). |
| 11 | Messenger & Instagram Direct API | POST /<PAGE_ID>/messages |
Automatyczna obsługa wiadomości prywatnych od klientów (w tym z reklam Click-to-Messenger i Click-to-Instagram Direct). |
| 12 | WhatsApp Business Cloud API | POST /<PHONE_ID>/messages |
Wysyłka powiadomień szablonowych (potwierdzenia rezerwacji, statusy zamówień) i obsługa leadów z reklam Click-to-WhatsApp. |
| 13 | Katalogi Produktów E-Commerce (DPA) | POST /<CATALOG_ID>/items_batch |
Synchronizacja produktów ze sklepu WWW z katalogiem Meta pod dynamiczny remarketing oglądanych produktów (Advantage+ Catalog Ads). |
| 14 | Meta Ad Library API (/ads_archive) + Insights API |
GET /ads_archiveGET /act_<ID>/insights |
Legalne prześwietlanie aktywnych reklam konkurencji w Polsce (teksty, nagłówki, dokładny zasięg w UE eu_total_reach i płatnik DSA), zapis do lokalnego Swipe File oraz generowanie raportów wyników w .html, .md i .csv. |
2. Jak połączyć się, podpiąć i pracować w Studio PRO v2.0 — Instrukcja z 10 Screenami (.webp)
Krok 1 z 10: Meta for Developers — Tworzenie aplikacji „Firma (Business)" oraz pobranie App ID i App Secret
1 Wejdź na developers.facebook.com/apps, utwórz aplikację typu Firma (Business) i skopiuj Identyfikator aplikacji (App ID).
2 Kliknij „Pokaż" przy Kluczu tajnym aplikacji (App Secret) i skopiuj go (służy do podpisu bezpieczeństwa HMAC-SHA256 appsecret_proof).
3 Wpisz domenę app.maksbronk.pl i 4 przełącz aplikację w tryb Na żywo (Live).
Krok 2 z 10: Facebook Login for Business — Konfiguracja OAuth 2.0 Redirect URI i Uprawnień (Scopes)
1 Włącz Logowanie OAuth klienta i Logowanie OAuth w witrynie.
2 W polu Prawidłowe identyfikatory URI przekierowania OAuth wklej dokładnie: https://app.maksbronk.pl/api/meta-ads/oauth/callback.
3 Uprawnienia (ads_management, ads_read, business_management, pages_manage_posts, pages_read_engagement, leads_retrieval) pozwolą automatycznie pobrać 60-dniowy token i konta reklamowe.
4 Kliknij Zapisz zmiany.
Krok 3 z 10: Meta Business Suite — Bezterminowy Token System Usera (Rekomendowany na produkcję)
1 W business.facebook.com/settings/system-users dodaj użytkownika systemowego z rolą Administrator.
2 Kliknij Przypisz zasoby i nadaj mu pełną kontrolę nad kontem reklamowym (act_...), Fanpage'em oraz Pixelem.
3 Kliknij Wygeneruj nowy token, wybierz wygaśnięcie Nigdy (Never) i zaznacz uprawnienia reklamowe.
4 Skopiuj wygenerowany token EAAB....
Krok 4 z 10: Menedżer Zdarzeń (Events Manager) — Pobranie Pixel ID i Deduplikacja Conversions API (CAPI)
1 Skopiuj 15-cyfrowy Identyfikator zestawu danych (Pixel ID) z ustawień Menedżera Zdarzeń.
2 Nasz system wykorzystuje go zarówno w przeglądarce (fbevents.js), jak i na serwerze (Conversions API).
3 Wspólny identyfikator event_id gwarantuje pełną deduplikację zdarzeń Lead i Purchase.
Krok 5 z 10: AI-MAX Studio Meta Ads — Zakładka 1: Połączenie z Facebookiem, Stepper 4 Kroków i Wymogi DSA UE
1 Wybierz tryb pracy (Piaskownica 1:1 lub Produkcja LIVE) oraz walutę (PLN / EUR / USD).
2 Kliknij Zaloguj przez FB (OAuth 2.0) albo wklej bezterminowy Token System Usera.
3 Uzupełnij Ad Account ID, Page ID, Pixel ID oraz obowiązkowe w UE pola Beneficjent i Płatnik (DSA).
4 Kliknij Zapisz i Testuj Połączenie z Graph API — stepper połączenia potwierdzi gotowość wszystkich 4 warstw.
Krok 6 z 10: AI-MAX Studio Meta Ads — Zakładka 2: Planer Kampanii AI, Suwak Budżetu + 6-Osiowy Audytor (0–100 pkt)
1 Wybierz cel ODAX, dostosuj interaktywny suwak budżetu dziennego i kliknij Zaplanuj kampanię z AI — planer przeskanuje index.html projektu.
2 Otrzymasz podział budżetu 60% TOF / 25% MOF / 15% BOF oraz prognozę kliknięć, leadów, CPA i ROAS na żywo.
3 Sprawdź kołowy wskaźnik Health Score (0–100 pkt) i 6 osi audytu oraz 4 wyślij rekomendacje jednym kliknięciem do czatu AI.
Krok 7 z 10: AI-MAX Studio Meta Ads — Zakładka 3 i 4: Publikacja Kampanii PAUSED, Podgląd cURL + Pixel & CAPI
1 Kliknij Utwórz pełną kampanię z planu AI (Campaign → AdSet → AdCreative → Ad) lub skopiuj gotowe wywołanie cURL dla wybranego konta act_....
2 Przełączaj statusy ACTIVE / PAUSED i skaluj budżet dzienny.
3 Zainstaluj jednym kliknięciem Meta Pixel w index.html i 4 przetestuj wysyłkę zdarzeń CAPI Server-Side z haszowaniem SHA-256.
Krok 8 z 10: AI-MAX Studio Meta Ads — Zakładka 5: Dashboard Wyników Insights, Lejek Konwersji i Eksport CSV
1 Analizuj 8 kart KPI (Wydatki, ROAS, Zakupy/Leady, CPA, CTR, CPC, CPM, Frequency) z dziennym wykresem SVG.
2 Obserwuj Wizualny Lejek Konwersji (Impressions → Clicks → Landing Page Views → AddToCart → InitiateCheckout → Purchase).
3 Sortuj tabelę kampanii po dowolnej kolumnie i pobieraj raporty w 3 formatach (.html, .md, .csv) oraz 4 włącz cykliczną rutynę raportowania.
Krok 9 z 10: AI-MAX Studio Meta Ads — Zakładka 3 PRO: AI Creative Score (0–100), Symulator 4:5/9:16, Reels Storyboard i Matryca 150 Wariantów DCO
1 Wpisz lub wygeneruj teksty reklamowe (PAS, AIDA, Hook-Story-Offer) — wskaźnik AI Creative Score (0–100 pkt) ocenia na żywo siłę hooka, obietnicę, dowód społeczny i CTA.
2 Przełączaj podgląd na żywo między Mobile Feed 4:5 a pionowym Instagram/FB Reels 9:16.
3 Wygeneruj 3-sekundowe scenariusze wideo 9:16 UGC (Foreplay) z rozbiciem na ujęcia i napisy ekranowe.
4 Uruchom Generator 150 kombinacji DCO (Marpipe / asset_feed_spec) i wyeksportuj macierz wariantów do CSV.
Krok 10 z 10: AI-MAX Studio Meta Ads — Zakładka 6 PRO + Tryb Dokowania obok Czatu: Motion Analytics, Strażnik Budżetu i Szpieg Konkurencji
1 Analizuj wskaźniki wideo Motion Creative Analytics: Thumbstop Ratio (3s Hook Rate), Hold Rate (15s) oraz automatyczną detekcję zmęczenia kreacji (FATIGUE vs WINNER).
2 Skonfiguruj automatyczne reguły Strażnika Budżetu (Revealbot / Birch): Stop-Loss przy wysokim CPA i Surf Scaling +20% przy wysokim ROAS (z bezpiecznym testem Dry-Run).
3 Prześwietlaj reklamy konkurencji w Meta Ad Library Spy i zapisuj najlepsze kreacje do lokalnego Swipe File.
4 Kliknij „◫ Dokuj z boku" (klawisz D), aby przypiąć okno Studio PRO (580px) z prawej strony i jednocześnie rozmawiać z agentem AI w czacie!
3. Katalog 14 Skilli Modułu Facebook & Meta Ads (Zapisanych w Workspace, Globalnie i na Serwerze)
| Nr | Kod Skilla (wspolne/meta-ads/skille/ & .agents/skills/) | Przeznaczenie i zawartość |
|---|---|---|
| 01 | meta-ads | Główny przewodnik po module M13, 25 endpointach HTTP, narzędziu CLI meta-ads i zasadach bezpieczeństwa budżetu. |
| 02 | meta-ads-pelny-katalog-api-v22 | Encyklopedia 14 obszarów API Facebooka (Marketing API v22.0, Advantage+, DCO, Audiences, Lead Ads, Pixel+CAPI, Fanpage, Instagram Reels/Stories, Messenger, WhatsApp, Katalogi DPA, Ad Library, Insights). |
| 03 | meta-ads-oauth-tokeny | Szczegółowa instrukcja 3 metod autoryzacji: OAuth 2.0 (60-dniowy token), System User Token (Never Expire), appsecret_proof i Piaskownica 1:1. |
| 04 | meta-ads-planer-ai | Planer Kampanii AI: ekstrakcja oferty z index.html, 12 polskich benchmarków branżowych, lejek 60/25/15% i prognozy KPI w PLN/EUR/USD. |
| 05 | meta-ads-audytor-6-osi | 6-osiowy audytor kampanii AI (0–100 pkt) + wymogi prawne Unii Europejskiej (DSA: beneficiary i payor). |
| 06 | meta-ads-kreacje-i-dco | Tworzenie kreacji reklamowych: AdImage, AdVideo, karuzele i wielowariantowe Dynamic Creative (asset_feed_spec). |
| 07 | meta-ads-odbiorcy-custom-lookalike | Tworzenie grup remarketingowych Custom Audiences (WWW, CRM SHA-256, IG/FB) i Lookalike 1%–10% PL. |
| 08 | meta-ads-pixel-capi | Instalacja Meta Pixel w index.html, wysyłka zdarzeń CAPI Server-Side, deduplikacja event_id i haszowanie SHA-256. |
| 09 | meta-ads-lead-ads-webhooki | Formularze błyskawiczne Facebook/Instagram Lead Ads (leadgen_forms), Webhooki leadgen i pobieranie kontaktów. |
| 10 | meta-ads-fanpage-instagram-reels | Publikacja postów, zdjęć, karuzel, Reels i Stories na Fanpage'u FB oraz Instagramie + moderacja komentarzy AI. |
| 11 | meta-ads-biblioteka-reklam-i-katalogi | Prześwietlanie reklam konkurencji przez /ads_archive (zasięg UE DSA, płatnicy, teksty) oraz katalogi e-commerce DPA. |
| 12 | meta-ads-raporty-insights | Analityka Insights API, progi alarmowe (frequency, CTR, CPL, ROAS) i raporty .html, .md, .csv. |
| 13 | meta-ads-optymalizator-pro | Optymalizator PRO (6 światowych platform): Birch/Revealbot (reguły Stop-Loss i Surf Scaling), Motion (Hook Rate 3s i Hold Rate), Foreplay (scenariusze 9:16 UGC i Swipe File), Madgicx (faza uczenia 50 konw./tydz. i siatka 7 grup), AdCreative.ai (Pre-Launch Scoring) i Marpipe (150 kombinacji DCO). |
| 14 | meta-ads-studio-ui-i-debugging | Architektura UI Studio PRO v2.0 & Debugging: 7 zakładek, tryb dokowania obok czatu (580px), skróty klawiszowe (Alt+1..7, D, R, Esc), symulator 4:5/9:16, wielowalutowość PLN/EUR/USD, timingSafeEqual, walidacja CAPI i 33 testy E2E. |
4. Komendy CLI meta-ads, Skróty Klawiszowe oraz Własny Git Modułu
# Skróty klawiszowe w oknie Facebook & Meta Ads Studio PRO v2.0: Alt+1 .. Alt+7 -> Przełączanie między 7 zakładkami studyjnymi D -> Przełączenie trybu Pełny Modal (1180px) <-> Dokuj z boku czatu (580px) R -> Odświeżenie statusu konta i synchronizacja z Graph API Esc -> Zamknięcie okna Studio PRO (działa w obu trybach) # Narzędzie CLI w terminalu projektu użytkownika: meta-ads status meta-ads zaplanuj --budzet=150 --cel=OUTCOME_LEADS --miasto="Warszawa" meta-ads przeanalizuj meta-ads pixel --id=83920192837465 meta-ads utworz-pelna --budzet=150 --status=PAUSED meta-ads uruchom <ID_KAMPANII> meta-ads wstrzymaj <ID_KAMPANII> meta-ads post --tresc="Nowa realizacja już dostępna!" --link="https://twojadomena.pl" meta-ads capi --zdarzenie=Lead --email="klient@domena.pl" --telefon="+48500600700" --wartosc=250 meta-ads raport --preset=last_7d --harmonogram meta-ads szukaj-targetowania "architektura wnętrz" meta-ads biblioteka-reklam "fotowoltaika" --kraj=PL # Własny Git i własny commit modułu Facebook (synchronizuje Kasm-Workspaces i Meta-Ads-Facebook): node wspolne/meta-ads/narzedzia/status.js node wspolne/meta-ads/narzedzia/commit.js "Opis zmian w module Facebook" --push