Logo

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 > Facebook w panelu IdoSell?

  • Czy wiesz, jaki Piksel jest już używany przez sklep, jeśli wcześniej został dodany ręcznie?

Uwaga

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 paneluCo uruchamia
Meta Pixel (dawniej Facebook Pixel)USTAWIENIA > Facebook > Meta PixelZdarzenia 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

  1. Otwórz Menedżer zdarzeń w Meta.

  2. Wybierz zestaw danych (Piksel) używany przez sklep.

  3. Skopiuj identyfikator, czyli ciąg cyfr znajdujący się pod nazwą zestawu danych.

  4. W panelu IdoSell przejdź do USTAWIENIA > Facebook > Meta Pixel (dawniej Facebook Pixel).

  5. Wklej identyfikator Meta Piksela przy wybranej stronie sklepu.

  6. Zapisz zmiany.

  7. Odczekaj do godziny na wygenerowanie skryptów Piksela po stronie sklepu.

Po uruchomieniu Piksela sklep wysyła następujące zdarzenia:

ZdarzenieDziałanie
PageViewWejście na stronę
ViewContentWyświetlenie karty produktu
AddToCartDodanie produktu do koszyka
AddToWishlistDodanie produktu do listy życzeń
PurchaseZakup
Uwaga

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

  1. Przejdź do USTAWIENIA > Facebook Facebook Business Extension (FBE2).

  2. Wybierz stronę sklepu.

  3. 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óbCo wybrać
Portfolio firmowePortfolio, w którym prowadzisz reklamy sklepu
Strona na FacebookuStrona marki sklepu
Profil na InstagramieOpcjonalnie - Dodaj profil, jeśli chcesz promować produkty na Instagramie
KatalogIstniejący katalog sklepu lub nowy (IdoSell zasili go produktami)
Konto reklamoweKonto, z którego będziesz prowadzić kampanie
Piksel firmy MetaPiksel 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.

Uwaga

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ń.

UstawienieGdzie w MetaCel
Automatyczne zaawansowane dopasowywanieZestawy danych > UstawieniaPoprawa przypisywania konwersji i grup remarketingowych
Monitorowanie zdarzeń bez koduZestawy danych > UstawieniaZapobieganie powstawaniu dodatkowych, zdublowanych zdarzeń
Lista zatwierdzonych domenZestawy danych > UstawieniaZezwolenie na zdarzenia z domeny sklepu
Weryfikacja domenyUstawienia firmowe > Bezpieczeństwo i dopasowanie marki > DomenyPotwierdzenie domeny firmy
Połączenie Piksela i katalogu z kontem reklamowymUstawienia firmowe > Źródła danych > Katalogi / Zestawy danych i piksele > Połączone zasobyUdostępnienie konwersji i produktów kontu reklamowemu

1. Włącz automatyczne zaawansowane dopasowywanie

  1. Otwórz Menedżer zdarzeń.

  2. Wybierz zestaw danych (Piksel) sklepu.

  3. Otwórz zakładkę Ustawienia.

  4. W sekcji Automatyczne dopasowywanie witryny ustaw przełącznik na Wł.

  5. Kliknij Pokaż opcje.

  6. 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.

Uwaga

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

  1. W zakładce Ustawienia znajdź sekcję „Lista zatwierdzonych”.

  2. Kliknij Edytuj.

  3. Dodaj domenę sklepu, np. twojsklep.pl.

Uwaga

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ę

  1. Otwórz Ustawienia firmowe > Bezpieczeństwo i dopasowanie marki > Domeny.

  2. Kliknij Dodaj.

  3. Podaj domenę bez https:// i www.

  4. Wybierz metodę weryfikacji. Zalecaną metodą jest rekord DNS TXT u operatora domeny.

  5. Kliknij Zweryfikuj.

Porada eksperta

Weryfikacja przez DNS może potrwać do 72 godzin.

5. Przypisz Piksel i katalog do konta reklamowego

Dla Piksela:

  1. Otwórz Ustawienia firmowe > Źródła danych > Zestawy danych i piksele.

  2. Wybierz Piksel sklepu.

  3. Przejdź do Połączone zasoby.

  4. Dodaj właściwe konto reklamowe.

Dla katalogu:

  1. Otwórz Ustawienia firmowe > Źródła danych > Katalogi.

  2. Wybierz katalog sklepu.

  3. Przejdź do Połączone zasoby.

  4. 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ź:

  1. Źródło zdarzeń
    Przejdź do Menedżer zdarzeń > Przegląd i 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.

  2. Deduplikację zdarzeń
    Otwórz szczegóły zdarzenia Purchase i sprawdź, czy Meta nie zgłasza problemów ze zduplikowanymi zdarzeniami.

  3. 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.

  4. 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

ObjawMożliwa przyczynaRozwiązanie
Okno logowania się nie otwieraPrzeglądarka blokuje wyskakujące oknaZezwól na wyskakujące okna dla panelu IdoSell i kliknij przycisk ponownie
W kreatorze nie ma portfolio firmowego lub konta reklamowegoKonto Facebook nie ma uprawnień administratoraNadaj uprawnienia w Ustawieniach firmowych lub zaloguj się kontem administratora
Zdarzenia Purchase są zdublowaneWłączone monitorowanie zdarzeń bez kodu albo drugi Piksel w sklepieWyłącz monitorowanie bez kodu i usuń dodatkowe kody Piksela z szablonu
W Menedżerze zdarzeń widoczna jest tylko PrzeglądarkaKreator FBE2 nie został zakończony przyciskiem GotowePrzejdź ponownie kreator do ekranu Wszystko gotowe
Meta odrzuca zdarzeniaBrak domeny na liście zatwierdzonych lub domena nie została zweryfikowanaDodaj domenę do listy zatwierdzonych i wykonaj jej weryfikację
Konto reklamowe nie widzi konwersji lub produktówPiksel albo katalog nie został przypisany do konta reklamowegoDodaj konto reklamowe w sekcji Połączone zasoby dla Piksela i katalogu

FAQ

Nie znalazłeś odpowiedzi na pytanie?Skontaktuj się z Działem Wsparcia

Przejdź do Biura Obsługi Klienta i skontaktuj się z ekspertami IdoSell