Integracje
Tato podrobná stránka zatím není česky. Níže je původní polský obsah. Devět českých základních návodů najdete v navigaci.
zatím není popsáno
W Ustawienia → Integracje właściciel lub administrator klubu zarządza trzema osobnymi połączeniami. Karty występują w kolejności: Facebook Leads, Meta Pixel + Conversions API, API Klubownika. Uprawnienia do tej strony nie wynikają z samego dostępu do panelu trenera, rodzica lub uczestnika.
Niepotwierdzony odczyt ustawień
Dział zatytułowany „Niepotwierdzony odczyt ustawień”Komunikat Nie udało się potwierdzić ustawień integracji 1 oznacza, że aplikacja nie mogła sprawdzić aktualnej konfiguracji. W tej sytuacji pokazuje komunikat odzyskania zamiast kart połączeń, piksela i kluczy API. Nie oceniaj stanu połączeń na podstawie tej awarii.
Kliknij Ponów 2, aby odczytać ustawienia ponownie. Przycisk nie zapisuje konfiguracji, nie odłącza Facebooka ani nie wysyła zdarzenia testowego. Po poprawnym odczycie wracają trzy karty opisane poniżej. Jeżeli błąd się powtarza, przekaż klubowi lub obsłudze informację, że dotyczy wejścia w Ustawienia → Integracje.
Facebook Leads
Dział zatytułowany „Facebook Leads”Przygotowanie połączenia
Dział zatytułowany „Przygotowanie połączenia”Ta karta dotyczy zgłoszeń z formularzy reklam Facebook/Instagram Lead Ads, które mają trafić do Rekrutacji. Przed rozpoczęciem sprawdź listę Zanim zaczniesz — sprawdź, że masz: 1. Potrzebujesz Fanpage’a z rolą administratora lub edytora, konta reklamowego w Meta Business Suite oraz formularza Lead Ads albo planu jego utworzenia. Konto Facebook użyte do logowania musi mieć dostęp do strony.
Panel Co się stanie po kliknięciu: 2 opisuje kolejność: logowanie i uprawnienia w Meta, powrót do wyboru strony, podłączenie odbierania zgłoszeń oraz przekazanie nowych leadów do Rekrutacji. Sprawdź tę kolejność przed rozpoczęciem. Stan konkretnego zgłoszenia potwierdzisz dopiero po jego odczycie w Klubowniku.
Jeżeli Meta pokaże błąd uprawnienia leads_retrieval, sprawdź komunikat o trybie testowym 1 i dostęp konta do aplikacji Meta. W trybie testowym integracja jest dostępna dla kont dodanych jako testerzy. Sam komunikat na karcie nie potwierdza aktualnego statusu przeglądu aplikacji w Meta.
Kliknij Połącz z Facebook → 2. Logowanie i nadanie uprawnień odbywają się w serwisie Meta. Po powrocie do Klubownika sprawdź nazwę klubu, zanim wybierzesz stronę. Sam powrót z logowania nie oznacza jeszcze zapisania wybranej strony.
Wybór Fanpage’a
Dział zatytułowany „Wybór Fanpage’a”Widok Krok 2/3 — wybierz Fanpage zawiera pełną listę dostępnych stron z nazwami i identyfikatorami 1. Zaznacz właściwą stronę i kliknij Podłącz wybraną stronę 2. Przycisk Anuluj 3 opuszcza wybór i wraca do Integracji.
Podczas Zapisywanie… wybór strony i oba przyciski są nieaktywne. Poczekaj na potwierdzenie oraz ponowny odczyt Integracji. Nie uruchamiaj równolegle kolejnej próby w innym oknie. Połączenie dotyczy strony wskazanej na liście. Brak oczekiwanej strony wymaga sprawdzenia dostępu w Meta; wpisanie jej nazwy w innym miejscu panelu nie zastępuje tego kroku.
Wygasły lub wykorzystany wybór strony
Dział zatytułowany „Wygasły lub wykorzystany wybór strony”Wybór jest ważny przez 15 minut od powrotu z Facebooka i służy do jednej próby podłączenia. Jest przypisany do klubu i konta, które rozpoczęło łączenie. Nie kopiuj adresu wyboru do innego klubu ani konta. Komunikat o wygaśnięciu lub wykorzystaniu wyboru oznacza, że trzeba rozpocząć łączenie ponownie.
Gdy zobaczysz Nie udało się potwierdzić połączenia Facebooka, najpierw sprawdź stan po ponownym odczycie Integracji. Połączenie mogło zostać zapisane, zanim odpowiedź dotarła do przeglądarki. Jeżeli nadal nie ma połączenia i nie widzisz ostrzeżenia o niepotwierdzonym łączeniu lub odłączeniu, użyj Połącz z Facebook → i przejdź od początku przez nadanie dostępu. Sam stary link i ponowne kliknięcie podłączenia nie odnawiają wyboru.
Komunikat o niedostępnym wyborze nie uprawnia do przejęcia strony przypisanej innemu klubowi. Gdy dostęp do strony lub jej powiązanie budzi wątpliwości, wyjaśnij je z osobą zarządzającą stroną. Ponowne połączenie tej samej strony zachowuje zapisany filtr formularzy oraz datę ostatniego leada; zmianę filtra wykonaj osobno w części opisanej poniżej.
Niepotwierdzone łączenie strony
Dział zatytułowany „Niepotwierdzone łączenie strony”Połączenie strony w Meta wymaga sprawdzenia 1 informuje, że wynik poprzedniej próby łączenia tej strony nadal wymaga potwierdzenia. Sprawdź nazwę strony w ostrzeżeniu. Nowa próba podłączenia tej samej strony jest zablokowana; samo odczekanie lub rozpoczęcie nowego logowania nie usuwa tego stanu. Wcześniej działające połączenie z inną stroną sprawdź na jego karcie.
Sprawdź i wycofaj próbę 2 służy do sprawdzenia i bezpiecznego wycofania nieukończonego połączenia. Może odłączyć subskrypcję tej strony w Meta. Użyj go, gdy chcesz zakończyć tę próbę przed nowym łączeniem. Przycisk Odśwież 3 odczytuje ponownie stan w Klubowniku.
Podczas Ładowanie… oba przyciski są zablokowane. Po potwierdzonym wycofaniu aplikacja pokazuje Potwierdzono odłączenie strony w Meta, odczytuje Integracje ponownie i usuwa ostrzeżenie tej strony. Wtedy możesz rozpocząć nowe łączenie przez Połącz z Facebook →. Sprawdzenie i wycofanie samo nie zapisuje nowego połączenia.
Jeżeli wyniku nie uda się potwierdzić, ostrzeżenie pozostaje. Może zmienić się na Odłączenie strony w Meta wymaga sprawdzenia, opisane dalej. Nieznanego wyniku nie wolno uznać za zakończenie operacji. Sprawdź ponownie później; jeżeli stan się nie zmieni, skontaktuj się z obsługą i podaj nazwę strony widoczną w ostrzeżeniu. Nie przekazuj tokenów ani danych logowania.
Stan połączenia i ostatni lead
Dział zatytułowany „Stan połączenia i ostatni lead”Połączona karta pokazuje Połączono, nazwę lub identyfikator strony i datę połączenia 1. Pole Ostatni lead z tej strony 2 podaje ostatnią zapisaną datę otrzymanego zgłoszenia. Daty tej karty są prezentowane w czasie polskim, w formacie języka panelu. Komunikat o braku leada oznacza brak zapisanej daty; sama odznaka Połączono nie potwierdza dostarczenia nowego zgłoszenia.
Porównaj otrzymane zgłoszenie z listą w Rekrutacji. Gdy nie ma zapisanej daty, zobaczysz — jeszcze nie otrzymano żadnego leada — 1. W tym wariancie pojawia się odnośnik Meta Lead Ads Testing Tool i opis próby 2. Otwiera on oddzielne narzędzie zewnętrzne w nowej karcie; samo otwarcie nie tworzy leada w Klubowniku. Wysłanie testowego leada może uruchomić zwykłą obsługę zgłoszenia, w tym powiadomienia. Po próbie sprawdź ponownie datę na karcie i zgłoszenie w Rekrutacji.
Filtr formularzy Lead Ads
Dział zatytułowany „Filtr formularzy Lead Ads”Zaznacz formularze, z których klub ma odbierać zgłoszenia, i kliknij Zapisz wybór. Pusty wybór oznacza wszystkie formularze tej strony, a nie wyłączenie integracji. Ma to znaczenie, gdy na Fanpage’u działają również kampanie niezwiązane z klubem.
Sprawdź, czy lista formularzy rzeczywiście została wczytana, zanim zapiszesz jej pusty wybór. Zapis wyboru formularzy i odłączenie integracji to osobne czynności. Samo odznaczenie wszystkich pól nie zatrzymuje odbierania leadów.
Nie udało się wczytać formularzy
Dział zatytułowany „Nie udało się wczytać formularzy”Jeżeli aplikacja nie potwierdzi listy, Zapisz wybór pozostaje nieaktywny 1. Komunikat z przyciskami Ponów i Odśwież 2 zastępuje listę; nie oznacza, że strona nie ma formularzy. Kliknij Ponów, aby ponownie pobrać listę i zapisany filtr. Ten przycisk nie zapisuje ustawień i nie wysyła testowego leada.
Odśwież odczytuje ponownie ustawienia strony. Sprawdź nazwę Fanpage’a, zwłaszcza jeżeli ktoś zmienił połączenie w innym oknie. Komunikat Brak formularzy Lead Ads na tej stronie występuje dopiero po poprawnym odczycie rzeczywiście pustej listy.
Niezapisany wybór i przywracanie
Dział zatytułowany „Niezapisany wybór i przywracanie”Zaznaczenia przy formularzach 1 są najpierw wyborem roboczym. Po zmianie pojawia się Masz niezapisany wybór formularzy i Przywróć zapisany wybór 2. Przywracanie cofa robocze zaznaczenia do ostatniego potwierdzonego filtra, bez zapisu do klubu. Zapisz wybór 3 zapisuje zaznaczenia dla bieżącego połączenia.
Poczekaj na Zapisano wybór formularzy. Samo zaznaczenie pola nie zmienia odbieranych zgłoszeń. Ponowny odczyt po błędzie może zachować niezapisane zaznaczenia; komunikat o wyborze roboczym informuje, że różnią się od potwierdzonego filtra. Identyfikatory wcześniej zapisanych formularzy, których nie ma na obecnej liście Meta, są zachowywane — nie znikają tylko dlatego, że lista ich nie pokazuje.
Niepotwierdzony zapis wyboru
Dział zatytułowany „Niepotwierdzony zapis wyboru”Jeżeli zobaczysz Nie udało się potwierdzić zapisu formularzy, nie zakładaj, że poprzedni filtr pozostał bez zmian. Serwer mógł zapisać wybór, zanim odpowiedź dotarła do przeglądarki. Aplikacja blokuje kolejny zapis do czasu ponownego odczytu. Kliknij Ponów, porównaj stan z wyborem roboczym i w razie potrzeby użyj Przywróć zapisany wybór.
Przy zmianie połączenia lub filtra w innym oknie starszy zapis nie zastępuje nowych ustawień. Odśwież Integracje, sprawdź klub i Fanpage, a następnie ponownie wybierz formularze. Zapis wyboru i odłączenie są wzajemnie blokowane podczas trwającej operacji.
Odłączenie w Klubowniku
Dział zatytułowany „Odłączenie w Klubowniku”Kliknij Odłącz przy połączonej stronie i przeczytaj potwierdzenie. Po potwierdzonym odłączeniu Klubownik wyłącza integrację tego klubu. Nowa obsługa zdarzenia z rozpoznanej, wyłączonej strony pomija pobieranie danych leada i powiadomienia; nie przełącza takiej strony na połączenie globalne. Dotychczasowe zgłoszenia pozostają w Rekrutacji.
To działanie dotyczy Facebook Leads. Nie wyłącza osobnej karty piksela/CAPI ani API Klubownika. Nie cofa wcześniej wysłanych wiadomości i wykonanych operacji. Uprawnieniami konta oraz kampaniami w Meta zarządzasz oddzielnie.
Niepotwierdzone odłączenie
Dział zatytułowany „Niepotwierdzone odłączenie”Komunikat o niepotwierdzonym odłączeniu wymaga ponownego odczytania Integracji i sprawdzenia aktualnego stanu. Błąd odpowiedzi nie jest potwierdzeniem sukcesu ani cofnięcia wcześniejszego zapisu. Samo potwierdzenie lokalnego odłączenia bez jawnego wyniku w Meta nie jest potwierdzeniem zakończenia całej operacji. Gdy połączenie zmieniło się w trakcie operacji, odśwież ustawienia i sprawdź stronę przed kolejną próbą.
Wyłączenie leadów w Klubowniku i odłączenie subskrypcji strony w Meta mają osobne potwierdzenia. Jeżeli lokalne wyłączenie zostało zapisane, ale wynik w Meta wymaga sprawdzenia, po ponownym odczycie zobaczysz poniższe ostrzeżenie.
Sprawdzanie odłączenia w Meta
Dział zatytułowany „Sprawdzanie odłączenia w Meta”Odłączenie strony w Meta wymaga sprawdzenia 1 wskazuje stronę, której leady są już wyłączone w Klubowniku. Trwająca lub niepotwierdzona operacja w Meta może zablokować ponowne podłączenie tej samej strony. Sam upływ czasu nie jest potwierdzeniem zakończenia odłączenia.
Kliknij Sprawdź odłączenie 2, aby odczytać stan w Meta. Jeżeli wcześniejsze odłączenie nie zostało jeszcze rozpoczęte albo jego próba zakończyła się odrzuceniem, sprawdzenie może także ponowić odłączenie. Aplikacja nie powtarza w ciemno operacji o nieznanym wyniku. Odśwież 3 odczytuje natomiast ustawienia Klubownika.
Podczas Ładowanie… oba przyciski są nieaktywne. Po potwierdzeniu odłączenia aplikacja pokazuje Potwierdzono odłączenie strony w Meta i ponownie odczytuje Integracje. Ostrzeżenie tej strony znika po potwierdzonym odczycie. Nie uruchamiaj kolejnej próby w drugim oknie podczas oczekiwania.
Wynik Odłączenie nie zostało jeszcze potwierdzone pozostawia ostrzeżenie. Sprawdź ponownie później; jeżeli stan się nie zmieni, skontaktuj się z obsługą. Nie traktuj ponownego logowania ani wyboru tej samej strony jako potwierdzenia odłączenia. Próba nowego połączenia sprawdza taki stan i może nadal odmówić zapisu. Ostrzeżenie dotyczy wskazanej strony; wybór innej strony jest oddzielnym połączeniem i wymaga zwykłego potwierdzenia.
Zakończona próba odłączenia
Dział zatytułowany „Zakończona próba odłączenia”Dodatkowe zdanie Meta odrzuciła lub nie potwierdziła zakończonej próby odłączenia 1 oznacza inny stan niż oczekiwanie na wynik operacji. W tej sytuacji możesz użyć Sprawdź odłączenie ponownie albo rozpocząć nowe łączenie przez Połącz z Facebook →. Przeczytaj wynik każdej próby; rozpoczęcie logowania samo nie zapisuje połączenia.
Meta Pixel + Conversions API
Dział zatytułowany „Meta Pixel + Conversions API”ID piksela i token
Dział zatytułowany „ID piksela i token”W ID Piksela 1 wpisz identyfikator złożony z 5–32 cyfr, z Menedżera Zdarzeń Meta. Token Conversions API 2 służy do wysyłania zdarzeń przez CAPI. Nowy token musi mieć 20–500 znaków. Po zapisaniu panel pokazuje Token zapisany, a nie pełną wartość tokenu. Pozostawienie pustego pola tokenu podczas zwykłego zapisu zachowuje obecny token.
Usuń token usuwa zapisany token od razu, jako osobną czynność. Nie zapisuje pozostałych roboczych zmian ID, kodu testowego ani przełączników. Po usunięciu sprawdź potwierdzenie i stan karty. Ta czynność nie wyłącza samego piksela przeglądarkowego, jeżeli jego ID i przełącznik są nadal zapisane.
Kod zdarzeń testowych (opcjonalnie) 3 pochodzi z zakładki Testowanie zdarzeń w Meta. Ma do 40 liter alfabetu łacińskiego lub cyfr. Jest potrzebny do testu CAPI opisanego niżej. Przed uruchomieniem zwykłej kampanii usuń kod i zapisz ustawienia, zgodnie z informacją na karcie.
Włączenie śledzenia i zapis
Dział zatytułowany „Włączenie śledzenia i zapis”Przełączniki Piksel włączony (strony publiczne) oraz CAPI włączone (zdarzenia server-side) 1 dotyczą dwóch sposobów wysyłania zdarzeń. Wybierz ustawienia i kliknij Zapisz 2. Poczekaj na Zapisano ustawienia śledzenia. Podczas zapisu pola, przełączniki, usuwanie tokenu, przywracanie i test są zablokowane, aby nie uruchamiać sprzecznych działań jednocześnie.
Wyślij zdarzenie testowe 3 jest osobną czynnością: nie zapisuje formularza. Wymagania testu opisano poniżej.
Odznaka Aktywny odpowiada ostatnim potwierdzonym ustawieniom. Samo przestawienie przełącznika lub wpisanie innego ID nie zmienia tej odznaki. Może być aktywny sam piksel, bez tokenu i włączonego CAPI. Zgodnie z informacją na karcie piksel na publicznej stronie ładuje się po zgodzie marketingowej odwiedzającego. Konfiguracja tej karty nie zastępuje osobnego połączenia formularzy Facebook Leads ani API Klubownika.
Robocze zmiany śledzenia
Dział zatytułowany „Robocze zmiany śledzenia”Po zmianie formularza pojawia się Masz robocze zmiany ustawień śledzenia 1. Przywróć zapisane ustawienia 2 przywraca ostatni potwierdzony odczyt i usuwa wpisany roboczo nowy token. Nie wykonuje zapisu ani wysyłki testu. Przywracanie nie odzyskuje tokenu usuniętego wcześniej osobnym przyciskiem Usuń token.
Gdy istnieją robocze zmiany, test pozostaje nieaktywny. Najpierw zapisz właściwe ustawienia albo przywróć zapisane. Błędne ID, zbyt krótki token lub niepoprawny kod wymagają korekty przed zapisem. Samo opuszczenie karty nie zapisuje roboczego formularza.
Niepotwierdzony zapis śledzenia
Dział zatytułowany „Niepotwierdzony zapis śledzenia”Nie udało się potwierdzić ustawień śledzenia 1 wymaga ponownego odczytu. Pola i działania są zablokowane; nie zakładaj, że poprzedni zapis nie doszedł do skutku. Kliknij Ponów 2. Przycisk odczytuje ustawienia, bez ponawiania zapisu i bez wysyłania testu.
Po odczycie porównaj formularz z potwierdzonym stanem. Robocze zmiany mogą pozostać widoczne; w razie potrzeby użyj Przywróć zapisane ustawienia. Informacja Token zapisany potwierdza obecność tokenu, nie ujawnia jego treści. Po niepotwierdzonej zmianie sekretu nie porównasz obu wartości w panelu. Przy równoległej zmianie w innym oknie starszy zapis jest odrzucany; odczytaj stan ponownie przed przygotowaniem kolejnej zmiany.
Zdarzenie testowe
Dział zatytułowany „Zdarzenie testowe”Najpierw zapisz ID piksela, token i kod testowy oraz włącz CAPI. Usuń lub zapisz robocze zmiany. Dopiero wtedy użyj Wyślij zdarzenie testowe. Test korzysta z potwierdzonej zapisanej konfiguracji. W działającej integracji wysyła syntetyczne zdarzenie Lead do Meta; nie wymaga danych uczestnika. Samo wyświetlenie karty nie wysyła testu.
Po komunikacie Wysłano testowe zdarzenie Lead sprawdź zakładkę Testowanie zdarzeń w Menedżerze Zdarzeń Meta. Potwierdzenie przyjęcia testu nie potwierdza jeszcze całej kampanii, zgód odwiedzających ani dostarczania rzeczywistych zgłoszeń Facebook Leads.
Jeżeli aplikacja nie potwierdzi wysyłki, najpierw sprawdź test w Meta, a w karcie użyj Ponów, aby odczytać konfigurację. Nie uruchamiaj kilku prób w różnych oknach. W tym samym otwartym widoku ponowienie niepewnej próby dla niezmienionej zapisanej konfiguracji zachowuje identyfikator zdarzenia. Nowy test po potwierdzonym wyniku jest osobnym zdarzeniem. Odświeżenie strony lub zmiana konfiguracji rozpoczyna nową próbę; nie jest potwierdzeniem wyniku poprzedniej wysyłki.
API Klubownika
Dział zatytułowany „API Klubownika”Dostęp i oferta
Dział zatytułowany „Dostęp i oferta”Karta API Klubownika dotyczy programistycznego połączenia zewnętrznej strony lub systemu z danymi klubu. Gdy dostęp nie jest włączony, pokazuje Dostęp w indywidualnej wycenie 1 i opis kontaktu. Sama obecność tej karty nie oznacza aktywacji API.
Napisz do nas: contact@klubownik.pl 2 otwiera wiadomość w programie pocztowym. Kliknięcie odnośnika nie wysyła jej automatycznie, nie zamawia usługi i nie włącza dostępu. Opisz, jaki system chcesz połączyć i jakich danych potrzebuje. Nie dołączaj pełnego sekretu istniejącego klucza.
Aktywne klucze
Dział zatytułowany „Aktywne klucze”Po włączeniu funkcji odznaka Aktywne oznacza dostępność API dla klubu. Pod Twoje klucze API widzisz nazwy i skrócone prefiksy kluczy 1. Wielokropek po prefiksie informuje, że nie jest to pełny sekret. Do konfiguracji zewnętrznego systemu potrzebny jest pełny klucz przekazany osobie odpowiedzialnej za integrację; nie odtworzysz go z tej listy.
Wiersz pokazuje też zakresy uprawnień 2 oraz Ostatnie użycie 3. Nowy klucz bez odnotowanego użycia ma wartość nigdy, jak drugi klucz na ilustracji.
Lista obejmuje nieodwołane klucze bieżącego klubu, od najnowszych. Nie zawiera kluczy innego klubu ani pełnych sekretów. Przejdź do Integracji ponownie lub odśwież stronę, aby odczytać zmianę wykonaną przez obsługę. Ta karta nie ma przycisków tworzenia, kopiowania pełnego klucza ani odwołania. W sprawie wydania lub odwołania skontaktuj się z obsługą.
Zakresy i ostatnie użycie
Dział zatytułowany „Zakresy i ostatnie użycie”Zakresy określają, jakie operacje może wykonywać klucz. Nie każdy klucz musi mieć wszystkie zakresy. Karta pokazuje zapisane oznaczenia; nie zmienisz ich przez zaznaczenie pola ani kliknięcie wiersza.
| Oznaczenie | Do czego służy |
|---|---|
| schedule.read | Odczyt grafiku zajęć. |
| offers.read | Odczyt udostępnionych ofert. |
| seasonal.write | Obsługa zapisów rekrutacji sezonowej. |
| members.read | Odczyt danych uczestników dopuszczonych przez API. |
| shop.read | Odczyt danych sklepu udostępnionych przez API. |
Ustal zakres z osobą wdrażającą zewnętrzny system. Dostęp klucza dotyczy klubu, dla którego go wydano. Odznaka Aktywne nie sprawdza działania zewnętrznego systemu ani powodzenia każdej jego operacji.
Ostatnie użycie pokazuje ostatnią datę odnotowaną przez aplikację po autoryzacji klucza. Nie jest potwierdzeniem zakończenia całej operacji zewnętrznego systemu. Karta prezentuje datę i godzinę w czasie polskim. Odświeżenie listy nie wykonuje testowego wywołania API.
Brak aktywnych kluczy
Dział zatytułowany „Brak aktywnych kluczy”Możesz widzieć Aktywne 1 i jednocześnie komunikat Brak aktywnych kluczy. Skontaktuj się z nami, aby otrzymać klucz 2. Oznacza to włączoną funkcję i pustą listę nieodwołanych kluczy. Nie oznacza wyłączenia całej funkcji.
Skontaktuj się z obsługą w sprawie wydania klucza. Jeżeli zamiast kart widzisz Nie udało się potwierdzić ustawień integracji, postępuj według części o niepotwierdzonym odczycie na początku poradnika. Błąd odczytu nie jest potwierdzeniem pustej listy.