Aplikacja Meta - konfiguracja
Jak przygotować własną aplikację Meta, Użytkownika Systemowego i token dostępu, żeby połączyć OWLI z kontami reklamowymi - pojęcia, proces i najczęstsze pułapki.
Czym jest aplikacja Meta i po co OWLI jej potrzebuje
OWLI łączy się z Meta przez Twoją własną aplikację deweloperską, a nie przez wspólne konto. To ważne: dzięki temu Ty jesteś właścicielem połączenia, a każda operacja na koncie reklamowym idzie przez Twój token dostępu, na Twoich uprawnieniach. Nikt nie siedzi po środku.
Dla agencji to jedna aplikacja, która obsługuje wszystkich klientów - do jednego Użytkownika Systemowego przypisujesz kolejne konta reklamowe i OWLI pracuje na każdym z nich.
To jednorazowa konfiguracja. Robisz ją raz, a efektem jest token (ciąg zaczynający się od EAA...), który wklejasz podczas instalacji OWLI. Później już tylko korzystasz - token działa w tle.
Co przygotujesz
- Aplikacja Meta - łączy OWLI z Twoimi kontami reklamowymi. Tworzysz ją w panelu Meta Developers (developers.facebook.com).
- Użytkownik Systemowy - konto techniczne w Twoim Portfolio Firmowym. Przez nie OWLI wykonuje operacje na kontach klientów.
- Token dostępu (
EAA...) - klucz, który wklejasz podczas instalacji OWLI. Generujesz go przy Użytkowniku Systemowym.
Cała konfiguracja zajmuje zwykle 15-20 minut. Robisz ją raz.
Wymagane jest Portfolio Firmowe Meta
To standardowe narzędzie pracy, w którym przypisuje się konta reklamowe i inne zasoby firmowe. Tam też tworzy się Użytkownika Systemowego wraz z tokenem dostępu.
Kluczowe pojęcia
Zanim przejdziesz przez kroki, warto rozumieć, co jest czym. Te nazwy pojawią się w panelu Meta:
- Portfolio Firmowe (Business Portfolio, dawniej Menedżer Firmy) - Twoja przestrzeń w Meta, w której trzymasz konta reklamowe, strony i pixele. To tu mieszka aplikacja i Użytkownik Systemowy.
- Aplikacja Meta - "wtyczka", przez którą program taki jak OWLI dostaje prawo rozmowy z Meta. Tworzysz ją w Meta Developers.
- Marketing API - interfejs Meta do tworzenia i zarządzania reklamami. To jego OWLI używa, żeby czytać wyniki i zmieniać kampanie.
- Catalog API - interfejs do produktów i katalogów (przydatny przy reklamach produktowych).
- Użytkownik Systemowy (System User) - "robot-pracownik" w Twoim Portfolio. Nie jest osobą, nie loguje się hasłem - działa przez token. To on ma dostęp do kont klientów.
- Token dostępu (
EAA...) - hasło jednorazowego użytku, które udowadnia Meta, że to Ty. Wklejasz je raz, przy instalacji.
Dlaczego akurat tak
Meta celowo oddziela kto (Użytkownik Systemowy) od czym (aplikacja) i do czego (konkretne konta reklamowe). Dzięki temu możesz dać OWLI dostęp tylko do wybranych kont, a nie do całego Portfolio - i w każdej chwili ten dostęp odebrać.
Jak wygląda proces
Pięć kroków. Poniżej skrót z krótkim "po co" przy każdym - pełny przewodnik ze zrzutami ekranu jest w PDF (patrz niżej).
- Załóż konto na developers.facebook.com - zaloguj się tym samym Facebookiem, na którym masz konto reklamowe. Inaczej aplikacja nie zobaczy Twoich kont.
- Utwórz aplikację - w kreatorze zaznacz Marketing API, Measure ad performance data i Catalog API, i przypisz aplikację do Portfolio Firmowego. To decyduje, co OWLI będzie umiał.
- Opublikuj aplikację - uzupełnij link do polityki prywatności, dodaj ikonę (500x500 pikseli) i kliknij „Publish". Bez publikacji aplikacja nie zadziała - to najczęściej pomijany krok.
- Utwórz Użytkownika Systemowego - w Portfolio Firmowym dodaj nowego z rolą Admin i przypisz mu aplikację oraz konta reklamowe, które chcesz obsługiwać. Tu decydujesz, do czego OWLI ma dostęp.
- Wygeneruj token - przy Użytkowniku Systemowym kliknij „Wygeneruj token", wybierz aplikację i zatwierdź. Zapisz ciąg
EAA...w bezpiecznym miejscu. To Twój klucz do instalacji.
Pełna instrukcja ze zrzutami ekranu
Ten wpis daje Ci mapę i pojęcia - wystarczy, żeby zrozumieć proces i zacząć. Dokładny przewodnik ekran po ekranie (20 stron w PDF, z każdym kliknięciem pokazanym na zrzucie) jest osobno:
- Masz OWLI? Instrukcja przyszła mailem po zakupie. Sprawdź skrzynkę, także folder spam.
- Jeszcze nie masz OWLI? Pobierz ją za darmo na stronie Instrukcja Meta.
Jeśli utkniesz na którymś kroku albo panel Meta wygląda inaczej niż się spodziewasz - sięgnij po PDF. Tam każdy ekran jest pokazany, z zaznaczonym miejscem do kliknięcia.
Najczęstsze problemy
„Nie mam uprawnień do przypisania konta" - Twój token musi być administratorem w Portfolio Firmowym z zaawansowanym dostępem. OWLI nie nada sobie uprawnień sam - jeśli ich brakuje, pokaże instrukcję ręcznego przypisania zasobu (konto reklamowe, strona, pixel).
„Aplikacja nie działa / Meta odrzuca token" - najczęściej to brak publikacji aplikacji (krok 3) albo logowanie na innym Facebooku niż ten z kontem reklamowym (krok 1).
„Mało operacji, API się blokuje" - nowa aplikacja ma niski limit operacji. Żeby go podnieść, wykonaj przez jakiś czas około 500 operacji i przejdź recenzję w Meta. To normalne i jednorazowe. Szczegóły opisuje rozdział 4 pełnego PDF.
„Mam kilku klientów" - nie zakładasz osobnej aplikacji na każdego. Do jednego Użytkownika Systemowego przypisujesz kolejne konta reklamowe (krok 4) i jeden token obsługuje wszystkich.
Uprawnienia - zapamiętaj to jedno
Token musi już mieć prawo odczytu i zarządzania reklamami, zanim wkleisz go do OWLI. To jedyna rzecz, której program nie zrobi za Ciebie - resztą zajmuje się instalator.
Masz token? Wracaj do instalacji
Token (EAA...) wklejasz w jednym z kroków instalatora OWLI - kreator sprawdza go na żywo i od razu powie, czy Meta go akceptuje. Token można też pominąć i dodać później.
Przejdź do wpisu Instalacja OWLI i wklej token w kroku, w którym kreator o niego poprosi.
W skrócie
Aplikacja Meta → Użytkownik Systemowy → token EAA... → wklejasz przy instalacji. Ten wpis to mapa i pojęcia; pełne kroki ze zrzutami są w PDF (mailem po zakupie) oraz na stronie Instrukcja Meta.