Integracja Conversions API (CAPI) z Meta Ads
Integracja Facebook Business Extension (FBE2) umożliwia połączenie sklepu IdoSell z kontem Meta, czyli tworzy lub przypisuje Piksel, katalog produktów i konto reklamowe. Po skonfigurowaniu FBE2 sklep może przekazywać zdarzenia dwoma kanałami: z przeglądarki przez Meta Pixel oraz z serwera przez Conversions API (CAPI). CAPI nie jest zależne od blokowania reklam ani od ograniczeń cookies działających w przeglądarce. Dzięki temu Meta może otrzymywać pełniejsze informacje o zdarzeniach dotyczących zakupów. Przekłada się to na dokładniejszą atrybucję konwersji, lepszą optymalizację kampanii i większe grupy remarketingowe.
Samo połączenie FBE2 jest niewystarczające. Żeby CAPI działało poprawnie, po zakończeniu kreatora wykonaj 5 ustawień w Meta Business Suite opisanych w tym artykule.
Co znajdziesz w tym artykule?
Jak przygotować zasoby Meta przed rozpoczęciem konfiguracji,
Jak skonfigurować Meta Pixel i FBE2,
Jak skonfigurować CAPI po stronie Meta,
Jakie ustawienia skonfigurować po stronie Meta.
Zanim zaczniesz sprawdź
Czy masz portfolio firmowe w Meta (Menadżer Firmy / Business Manager)?
Czy masz uprawnienia administratora portfolio firmowego dla konta Facebook, którego użyjesz podczas konfiguracji?
Czy masz stronę na Facebooku przypisaną do portfolio firmowego?
Czy masz konto reklamowe w tym samym portfolio oraz dodaną do niego metodę płatności?
(Opcjonalnie) Czy masz profil na Instagramie, jeśli chcesz promować produkty również na Instagramie?
Czy masz dostęp do modułu
USTAWIENIA > Aplikacje i kanały sprzedaży > Facebookw panelu IdoSell?Czy wiesz, jaki Piksel jest już używany przez sklep, jeśli wcześniej został dodany ręcznie?
Jeżeli identyfikator Piksela został wcześniej dodany w module Meta Pixel, podczas konfiguracji FBE2 wybierz ten sam Piksel. Używanie dwóch różnych Pikseli na jednej domenie może rozdzielić dane o konwersjach.
Meta Pixel i Facebook Business Extension (FBE2)
Konfigurację rozpocznij w panelu IdoSell, przechodząc do USTAWIENIA > Aplikacje i kanały sprzedaży > Facebook. Do integracji z Conversions API wymagane jest połączenie przez Facebook Business Extension (FBE2). Moduł Meta Pixel umożliwia natomiast ręczne dodanie identyfikatora Piksela.
| Moduł | Ścieżka w panelu | Co uruchamia |
|---|---|---|
| Meta Pixel (dawniej Facebook Pixel) | USTAWIENIA > Facebook > Meta Pixel | Zdarzenia wysyłane z przeglądarki |
| Facebook Business Extension (FBE2) | USTAWIENIA > Facebook > Facebook Business Extension (FBE2) | Piksel, Conversions API, katalog produktów i konto reklamowe |
Po wejściu w Ustawienia > Facebook znajdziesz tabelę Integrowany produkt Facebook z kolumną dla każdej strony sklepu.
zielony znacznik oznacza aktywną integrację,
czerwony znacznik oznacza, że integracja nie została skonfigurowana.
Sprawdź wiersze Facebook Business Extension (FBE2) oraz Meta Pixel (dawniej Facebook Pixel) dla strony, którą konfigurujesz.
Na przykładzie powyżej FBE2 działa tylko w pierwszym sklepie, a Meta Pixel w obu. Integrację FBE2 konfigurujesz osobno dla każdej strony.
Konfiguracja Meta Pixel
Otwórz Menedżer zdarzeń w Meta.
Wybierz zestaw danych (Piksel) używany przez sklep.
Skopiuj identyfikator, czyli ciąg cyfr znajdujący się pod nazwą zestawu danych.
W panelu IdoSell przejdź do
USTAWIENIA > Facebook > Meta Pixel(dawniej Facebook Pixel).Wklej identyfikator Meta Piksela przy wybranej stronie sklepu.
Zapisz zmiany.
Odczekaj do godziny na wygenerowanie skryptów Piksela po stronie sklepu.
Po uruchomieniu Piksela sklep wysyła następujące zdarzenia:
| Zdarzenie | Działanie |
|---|---|
| PageView | Wejście na stronę |
| ViewContent | Wyświetlenie karty produktu |
| AddToCart | Dodanie produktu do koszyka |
| AddToWishlist | Dodanie produktu do listy życzeń |
| Purchase | Zakup |
Zdarzenia muszą być aktywne także po stronie Meta.
Konfiguracja Facebook Business Extension (FBE2)
1. Zaloguj się do panelu IdoSell przez indywidualny adres
System może automatycznie wylogować Cię z panelu IdoSell i poprosić o ponowne zalogowanie. Jeśli tak się nie stanie, wyloguj się z panelu, a następnie zaloguj się ponownie przez adres https://clientXXXX.idosell.com/panel, gdzie XXXX oznacza ID klienta. ID klienta znajdziesz w Biurze Obsługi Klienta (BOK) w sekcji Konto > Zarządzanie kontem. Dopiero po zalogowaniu się przez ten adres przejdź do kolejnych kroków.
2. Otwórz moduł FBE2
Przejdź do
USTAWIENIA > Facebook Facebook Business Extension (FBE2).Wybierz stronę sklepu.
Kliknij Włącz integrację z FBE2.
Jeżeli w module Meta Pixel znajduje się już identyfikator Piksela, wybierz ten sam Piksel podczas konfiguracji FBE2.
3. Zaloguj się do Facebooka
W nowym oknie zaloguj się do Facebooka kontem posiadającym uprawnienia administratora portfolio firmowego. Jeśli okno się nie pojawi, zezwól przeglądarce na wyskakujące okna dla panelu IdoSell.
4. Zaakceptuj połączenie IdoSell Catalog
Zapoznaj się z informacjami dotyczącymi połączenia, a następnie kliknij Dalej.
5. Wybierz zasoby firmowe
Na ekranie Potwierdź ustawienia i sprawdź każdy zasób. Za pomocą strzałki możesz wskazać istniejący zasób albo utworzyć nowy.
| Zasób | Co wybrać |
|---|---|
| Portfolio firmowe | Portfolio, w którym prowadzisz reklamy sklepu |
| Strona na Facebooku | Strona marki sklepu |
| Profil na Instagramie | Opcjonalnie - Dodaj profil, jeśli chcesz promować produkty na Instagramie |
| Katalog | Istniejący katalog sklepu lub nowy (IdoSell zasili go produktami) |
| Konto reklamowe | Konto, z którego będziesz prowadzić kampanie |
| Piksel firmy Meta | Piksel zainstalowany już w sklepie. Utwórz nowy tylko wtedy, gdy sklep nie miał wcześniej Piksela |
6. Włącz automatyczne zaawansowane dopasowywanie
Przewiń ekran Potwierdź ustawienia w dół i upewnij się, że przełącznik Automatyczne zaawansowane dopasowywanie jest włączony. Następnie kliknij Kontynuuj.
7. Zatwierdź uprawnienia aplikacji
Aplikacja IdoSell Catalog wymaga uprawnień do:
zarządzania katalogami produktów,
rozszerzonego zarządzania firmą,
zarządzania reklamami na kontach reklamowych.
Pozostaw wymagane uprawnienia włączone i kliknij Dalej.
8. Poczekaj na połączenie kont
Na ekranie pojawi się komunikat: Trwa łączenie kont. Nie zamykaj okna podczas wykonywania tej operacji (proces może potrwać kilka minut).
9. Zakończ konfigurację
Po wyświetleniu komunikatu "Wszystko gotowe!" kliknij Gotowe. Okno konfiguracji zostanie zamknięte. W module FBE2 zobaczysz połączone zasoby. Od tej chwili sklep wysyła zdarzenia przez Piksel i CAPI.
Samo wykonanie powyższych kroków nie kończy konfiguracji. Aby CAPI działało prawidłowo, skonfiguruj również ustawienia opisane w następnej sekcji.
Konfiguracja CAPI po stronie Meta
Dla każdego podłączonego sklepu sprawdź 5 ustawień.
| Ustawienie | Gdzie w Meta | Cel |
|---|---|---|
| Automatyczne zaawansowane dopasowywanie | Zestawy danych > Ustawienia | Poprawa przypisywania konwersji i grup remarketingowych |
| Monitorowanie zdarzeń bez kodu | Zestawy danych > Ustawienia | Zapobieganie powstawaniu dodatkowych, zdublowanych zdarzeń |
| Lista zatwierdzonych domen | Zestawy danych > Ustawienia | Zezwolenie na zdarzenia z domeny sklepu |
| Weryfikacja domeny | Ustawienia firmowe > Bezpieczeństwo i dopasowanie marki > Domeny | Potwierdzenie domeny firmy |
| Połączenie Piksela i katalogu z kontem reklamowym | Ustawienia firmowe > Źródła danych > Katalogi / Zestawy danych i piksele > Połączone zasoby | Udostępnienie konwersji i produktów kontu reklamowemu |
1. Włącz automatyczne zaawansowane dopasowywanie
Otwórz Menedżer zdarzeń.
Wybierz zestaw danych (Piksel) sklepu.
Otwórz zakładkę Ustawienia.
W sekcji Automatyczne dopasowywanie witryny ustaw przełącznik na Wł.
Kliknij Pokaż opcje.
Włącz dostępne parametry: adres e-mail, numer telefonu, imię i nazwisko, płeć, miejscowość, województwo, kod pocztowy, kraj, datę urodzenia oraz identyfikator zewnętrzny.
Dane klientów są haszowane przed przekazaniem do Meta. Jako sprzedawca odpowiadasz za odpowiednie uwzględnienie przekazywania danych do Meta w polityce prywatności sklepu oraz zbieranie wymaganych zgód zgodnie z RODO.
2. Wyłącz monitorowanie zdarzeń bez kodu
W zakładce Ustawienia znajdź opcję Monitoruj zdarzenia automatycznie bez kodu i ustaw ją na Wył.
IdoSell przekazuje komplet zdarzeń e-commerce. Pozostawienie automatycznego monitorowania może spowodować utworzenie dodatkowych zdarzeń, np. drugiego Purchase i zawyżenie wyników.
3. Dodaj domenę do listy zatwierdzonych
W zakładce Ustawienia znajdź sekcję „Lista zatwierdzonych”.
Kliknij Edytuj.
Dodaj domenę sklepu, np. twojsklep.pl.
Jeżeli lista zatwierdzonych zawiera już domeny, ale nie ma na niej domeny sklepu, zdarzenia z niej mogą zostać odrzucone przez Meta.
4. Zweryfikuj domenę
Otwórz
Ustawienia firmowe > Bezpieczeństwo i dopasowanie marki > Domeny.Kliknij Dodaj.
Podaj domenę bez https:// i www.
Wybierz metodę weryfikacji. Zalecaną metodą jest rekord DNS TXT u operatora domeny.
Kliknij Zweryfikuj.
Weryfikacja przez DNS może potrwać do 72 godzin.
5. Przypisz Piksel i katalog do konta reklamowego
Dla Piksela:
Otwórz
Ustawienia firmowe > Źródła danych > Zestawy danych i piksele.Wybierz Piksel sklepu.
Przejdź do Połączone zasoby.
Dodaj właściwe konto reklamowe.
Dla katalogu:
Otwórz
Ustawienia firmowe > Źródła danych > Katalogi.Wybierz katalog sklepu.
Przejdź do Połączone zasoby.
Dodaj konto reklamowe.
Bez tych powiązań konto reklamowe nie zobaczy konwersji ani produktów potrzebnych do reklam dynamicznych.
Jak sprawdzić, czy wszystko działa poprawnie?
Po zakończeniu konfiguracji odczekaj około godziny, a następnie wykonaj test w sklepie. Możesz złożyć testowe zamówienie lub przejść ścieżkę od strony produktu do dodania go do koszyka.
Następnie w Menedżerze zdarzeń Meta sprawdź:
Źródło zdarzeń
Przejdź doMenedżer zdarzeń > Przeglądi sprawdź zdarzenia PageView, ViewContent, AddToCart oraz Purchase. Przy prawidłowo działającej integracji powinny być dla nich widoczne dwa źródła: Przeglądarka i Serwer. Jeśli widoczne jest tylko jedno z nich, oznacza to, że dane nie są przesyłane przez oba kanały.Deduplikację zdarzeń
Otwórz szczegóły zdarzenia Purchase i sprawdź, czy Meta nie zgłasza problemów ze zduplikowanymi zdarzeniami.Jakość dopasowania zdarzeń (EMQ)
Sprawdź wynik dla zdarzenia Purchase. Powinien wynosić co najmniej 6/10. Pamiętaj, że pierwszy wynik może pojawić się dopiero po około 48 godzinach.Diagnostykę
Przejdź do sekcji Diagnostyka i sprawdź, czy nie ma komunikatów o błędach dotyczących domeny lub brakujących parametrów.
Najczęstsze problemy
| Objaw | Możliwa przyczyna | Rozwiązanie |
|---|---|---|
| Okno logowania się nie otwiera | Przeglądarka blokuje wyskakujące okna | Zezwól na wyskakujące okna dla panelu IdoSell i kliknij przycisk ponownie |
| W kreatorze nie ma portfolio firmowego lub konta reklamowego | Konto Facebook nie ma uprawnień administratora | Nadaj uprawnienia w Ustawieniach firmowych lub zaloguj się kontem administratora |
| Zdarzenia Purchase są zdublowane | Włączone monitorowanie zdarzeń bez kodu albo drugi Piksel w sklepie | Wyłącz monitorowanie bez kodu i usuń dodatkowe kody Piksela z szablonu |
| W Menedżerze zdarzeń widoczna jest tylko Przeglądarka | Kreator FBE2 nie został zakończony przyciskiem Gotowe | Przejdź ponownie kreator do ekranu Wszystko gotowe |
| Meta odrzuca zdarzenia | Brak domeny na liście zatwierdzonych lub domena nie została zweryfikowana | Dodaj domenę do listy zatwierdzonych i wykonaj jej weryfikację |
| Konto reklamowe nie widzi konwersji lub produktów | Piksel albo katalog nie został przypisany do konta reklamowego | Dodaj konto reklamowe w sekcji Połączone zasoby dla Piksela i katalogu |