Zacznij
Jak skonfigurować Facebook Conversion API z Product Feed Elite
  1. Strona główna
  2. Baza wiedzy
  3. Integracja
  4. Jak skonfigurować Facebook Conversion API z Product Feed Elite

Jak skonfigurować Facebook Conversion API z Product Feed Elite

Jeśli już korzystasz z Facebook Pixel, ale chcesz bardziej niezawodnego śledzenia konwersji, zwłaszcza w przypadku użytkowników blokujących reklamy lub z ograniczonymi plikami cookie, Conversions API (CAPI) pomaga wypełnić te luki.

Wygeneruj token dostępu CAPI w Meta, połącz go z Product Feed Elite, a Twój sklep będzie wysyłać zdarzenia zarówno z przeglądarki, jak i z serwera.

Używanie zarówno Pixela (przeglądarka), jak i CAPI (serwer) poprawia dokładność śledzenia i zapewnia, że dane reklamowe są pełniejsze.

Jeśli jeszcze nie skonfigurowałeś swojego katalogu produktów na Facebooku, zacznij od Jak skonfigurować katalog produktów na Facebooku / Meta w WooCommerce. Ten artykuł obejmuje warstwę śledzenia Pixel i CAPI, która działa równolegle z tym katalogiem.

Wymagania wstępne

Upewnij się, że poniższe elementy są gotowe przed włączeniem Facebook Conversions API (CAPI).

WymaganieCo to oznacza
WooCommerceZainstaluj i uruchom WooCommerce z aktywnym sklepem. Upewnij się, że strony koszyka, płatności i potwierdzenia zamówienia (podziękowania) działają poprawnie.
Product Feed ProZainstaluj i aktywuj wtyczkę Product Feed Pro. Funkcja Facebook Pixel jest zawarta w Product Feed Pro. Odpowiednie ustawienia znajdziesz w Product Feed → Settings → General.
Product Feed EliteZainstaluj, aktywuj i licencjonuj Product Feed Elite. Elite umożliwia Conversions API (CAPI) i bogatsze śledzenie po stronie serwera oprócz Facebook Pixel dostarczanego przez Product Feed Pro.
Identyfikator Meta PixelPobierz ID PixelaMeta Events Manager i wprowadź je w swoich ustawieniach, aby połączyć śledzenie witryny z kontem Meta.
Token dostępu CAPIWygeneruj token dostępu CAPIMeta Events Manager dla tego samego Pixela (lub zestawu danych), którego używasz w WooCommerce. Zobacz jak utworzyć token dostępu Conversions API poniżej.

Musisz najpierw włączyć Facebook Pixel, zanim zaczniesz używać Conversions API.

Conversions API działa razem z Pixelem, a nie jako jego zamiennik. Pixel wysyła zdarzenia z przeglądarki; CAPI wysyła te same zdarzenia z Twojego serwera, aby poprawić dokładność śledzenia.

Utwórz swój token dostępu Conversions API w Meta

Wtyczka wysyła zdarzenia serwerowe do Meta przy użyciu tokenu dostępu, który należy do Twojego Pixela (Meta wprowadza również terminologię zestawu danych dla tego samego źródła danych). Dlatego powinieneś wygenerować token po tym, jak dowiesz się, które ID Pixela wprowadzisz w Product Feed Pro.

Zanim zaczniesz

  • Zaloguj się przy użyciu konta Meta, które ma pełną kontrolę lub zarządza dostępem do Firmy, do której należy Piksel.
  • Jeśli brakuje opcji “Wygeneruj token dostępu”, Twój użytkownik często nie ma odpowiedniej roli w firmie lub przy Pikselu. Poproś administratora firmy o przyznanie dostępu lub wygenerowanie tokenu za Ciebie.
  • Numeryczny identyfikator Piksela w ustawieniu Katalog produktów musi być zgodny z Pikselem/zbiorem danych, który wybrałeś podczas tworzenia tego tokenu. Jeśli się różnią, Meta odrzuci zdarzenia lub przypisze je do niewłaściwego źródła.

Kroki w Menedżerze Zdarzeń

  1. Otwórz Meta Events Manager.
  2. W lewym pasku bocznym, w sekcji Źródła danych (lub Zbiory danych), kliknij Piksel, którego używasz w swoim sklepie WooCommerce.
  3. Otwórz kartę Ustawienia tego Piksela (ikona koła zębatego lub górne Ustawienia, w zależności od układu Meta).
  4. Przewiń do sekcji API Konwersji.
  5. Znajdź Wygeneruj token dostępu (może znajdować się pod Skonfiguruj ręcznieSkonfiguruj bezpośrednią integrację lub podobnym sformułowaniem, którego Meta używa w przepływie konfiguracji CAPI).
  6. Kliknij Wygeneruj token dostępu. Meta może poprosić Cię o potwierdzenie uprawnień lub której aplikacji może używać tokenu, i dokończenie monitów.
  7. Gdy Meta wyświetli ciąg tokenu, kliknij KopiujPrzechowuj go w menedżerze haseł; Meta często wyświetla go tylko raz, a później nie można ponownie wyświetlić całego sekretu.
  8. Jeśli zgubisz token, użyj opcji Cofnij / Wygeneruj token dostępu ponownie w tym samym obszarze API Konwersji, a następnie wklej nowy token do pola Wprowadź swój token Facebook Conversion API w Katalog produktów → Ustawienia → Ogólne i zapisz.
Zakładka Ustawienia Meta Events Manager pokazująca przycisk Wygeneruj token dostępu w sekcji Conversions API

Jeśli nie widzisz przycisku Wygeneruj token dostępu

  • Potwierdź, że otworzyłeś Ustawienia dla właściwego Piksela (a nie Piksela innego konta reklamowego).
  • Otwórz kartę Przegląd i poszukaj opcji Skonfiguruj API Konwersji lub Rozpocznij. Niektóre konta najpierw przeprowadzają przez tworzenie tokenu za pomocą tego przepływu konfiguracji.
  • Zobacz przewodnik Meta: Rozpocznij pracę z API Konwersji (oficjalna dokumentacja deweloperska). Meta może zmieniać swój interfejs w zależności od regionu lub typu konta, więc zapoznaj się z ich dokumentacją, jeśli etykiety nieco się różnią.

Po wygenerowaniu tokenu

  • Nigdy nie umieszczaj tokenu w Git, nie wklejaj go na publicznych forach ani nie wysyłaj e-mailem w postaci zwykłego tekstu.
  • Wklej go tylko w sekcji Product Feed → Settings → General → Insert your Facebook Conversion API token (patrz poniższe kroki).

Włącz Piksel Facebooka

  1. Przejdź do WP Admin → Product Feed → Settings.
  2. Otwórz zakładkę Ogólne.
  3. Sprawdź ustawienia dla Facebook Pixel i Conversions API.

Niektóre opcje, w tym Enable Facebook Conversion API i pole tokena CAPI, są dostępne tylko w Product Feed Elite.

Aby włączyć Piksel:

  1. Włącz Add Facebook Pixel.
  2. Wprowadź swój Facebook Pixel ID. Użyj identyfikatora numerycznego większego od zera; w przeciwnym razie wtyczka pominie fragment kodu.
  3. Zapisz swoje ustawienia.
Zakładka Ogólne Ustawień Product Feed z przełącznikiem Włącz Facebook Pixel i polem ID Pixela

Włącz Facebook Pixel przed użyciem Conversions API (CAPI). Jeśli wyłączysz Piksel, wtyczka nie wysyła zdarzeń CAPI.

Włącz Facebook Conversions API i dodaj swój token

  1. Włącz Enable Facebook Conversion API.
  2. Wklej swój token dostępu Conversions API w pole Insert your Facebook Conversion API token.
  3. Kliknij Zapisz zmiany.
Zakładka Ogólne Ustawień Product Feed z przełącznikiem Włącz Facebook Conversion API i polem tokenu dostępu

Po włączeniu Twój sklep wysyła zdarzenia do Meta, używając obu:

  • Piksel Facebooka (śledzenie w przeglądarce), oraz
  • Conversions API (śledzenie po stronie serwera).

Ta kombinacja poprawia niezawodność śledzenia i pomaga Meta dokładniej mierzyć konwersje.

Więcej szczegółów znajdziesz w linku Read more obok ustawienia CAPI.

Jak Conversions API działa z Pikselem Facebooka

Gdy odwiedzający wchodzi w interakcję z Twoim sklepem, Product Feed Elite może wysyłać zdarzenia śledzenia do Meta na dwa sposoby:

  1. Z przeglądarki za pomocą Facebook Pixel
  2. Z Twojego serwera za pomocą Conversions API (CAPI)

Obie metody mogą raportować to samo zdarzenie do Meta.

Źródło śledzeniaCo się dzieje
Przeglądarka (Facebook Pixel)Piksel ładuje się na Twojej stronie internetowej i śledzi działania odwiedzających, takie jak PageView, ViewContent, AddToCart i Purchase.
Serwer (Conversions API)Gdy włączysz CAPI i dodasz prawidłowy token dostępu, Twój serwer wysyła to samo zdarzenie bezpośrednio do Meta.

Jak unika się duplikatów zdarzeń

Gdy zarówno Pixel, jak i Conversions API wysyłają to samo zdarzenie, Meta używa wspólnego identyfikatora zdarzenia, aby rozpoznać, że odnoszą się do tej samej akcji.

Pozwala to Mecie policzyć zdarzenie tylko raz, nawet jeśli przeglądarka i serwer wyślą je oba.

Dlaczego poprawia to śledzenie?

Twój serwer nadal może wysyłać zdarzenia po stronie serwera, nawet gdy:

  • Przeglądarki ograniczają pliki cookie
  • Blokery reklam uniemożliwiają ładowanie Pixela
  • Przeglądarki blokują skrypty śledzące

Z tego powodu jednoczesne używanie Pixela i Conversions API może poprawić dokładność śledzenia i pomóc Mecie lepiej dopasowywać zdarzenia do użytkowników i produktów.

Objęte zdarzenia (te same zdarzenia co Facebook Pixel)

Product Feed Elite śledzi te same typy zdarzeń, co Facebook Pixel. Wtyczka automatycznie wyzwala te zdarzenia, gdy odwiedzający wchodzą w interakcję ze stronami w Twoim sklepie.

Strona lub sytuacjaZdarzenie wysłane do Meta
Pojedynczy produktViewContent – wyzwalane, gdy odwiedzający przegląda produkt.
KoszykAddToCart – wyzwalane, gdy produkt jest dodawany do koszyka.
PłatnośćInitiateCheckout – wyzwalane, gdy klient rozpoczyna proces płatności.
Zamówienie otrzymane/DziękujemyPurchase – wyzwalane po pomyślnym zamówieniu.
Kategoria produktuViewCategory – wyzwalane, gdy odwiedzający przegląda kategorię produktów.
Wyniki wyszukiwania produktówSearch – wyzwalane, gdy odwiedzający szuka produktów w Twoim sklepie.

Feed produktów a zdarzenia śledzenia

Twój feed produktów i Twoje zdarzenia śledzenia służą różnym celom:

Feed produktów wysyła dane Twojego katalogu do Meta (tytuły produktów, ceny, obrazy i identyfikatory).

Facebook Pixel i Conversions API wysyłają dane o zachowaniu, takie jak które produkty odwiedzający przeglądają, dodają do koszyka lub kupują.

Gdy identyfikatory produktów w Twoim feedzie pasują do identyfikatorów treści wysyłanych przez zdarzenia, Meta może poprawnie powiązać działania klientów z produktami w Twoim katalogu. Pomaga to ulepszyć raportowanie, optymalizację i dynamiczne reklamy produktowe.

W zależności od Twojego motywu lub konfiguracji płatności, niektóre zdarzenia mogą zachowywać się nieco inaczej na niektórych stronach. Zalecamy weryfikację kluczowych zdarzeń w Meta Events Manager przy użyciu Test Events lub strumienia zdarzeń na żywo.

Zweryfikuj Piksel Facebook i API konwersji

Po włączeniu Pikselu Facebook i API konwersji (CAPI) należy potwierdzić, że oba działają poprawnie.

Sprawdź zdarzenia w Menedżerze zdarzeń Meta

Otwórz Menedżer zdarzeń Meta i przejdź do Testuj zdarzenia. Następnie odwiedź swój sklep i wywołaj zdarzenie, takie jak przeglądanie produktu lub dokonanie zakupu testowego. Powinieneś zobaczyć zdarzenia pochodzące z obu źródeł:

  • Przeglądarka (Piksel Facebook)
  • Serwer (API konwersji)

Potwierdź, że zdarzenia nie są zduplikowane

Gdy zarówno Piksel, jak i CAPI wysyłają to samo zdarzenie, Meta automatycznie rozpoznaje, że należą one do tej samej akcji i liczy je tylko raz.

Sprawdź łączność serwera

Twój serwer hostingowy musi być w stanie wysyłać bezpieczne żądania do Meta.
Jeśli Twój serwer blokuje te połączenia, zdarzenia CAPI mogą nie pojawić się, nawet jeśli Piksel nadal działa.

Weryfikacja obu metod śledzenia zapewnia, że Twój sklep wysyła kompletne i niezawodne dane do Meta w celu raportowania i optymalizacji reklam.

Rozwiązywanie problemów

Jeśli Piksel Facebook lub API konwersji (CAPI) nie działa zgodnie z oczekiwaniami, przejrzyj poniższe kontrole.

Nie pojawiają się żadne zdarzenia serwerowe
Potwierdź, że opcja Dodaj Piksel Facebook jest włączona, ID Pikselu jest prawidłowe, Włącz API konwersji Facebook jest włączone, a token został wklejony. Zweryfikuj, czy token należy do tego samego Pikselu. Wygeneruj ponownie token w Menedżerze zdarzeń, jeśli został unieważniony lub skopiowany nieprawidłowo.
Nie można wygenerować tokenu w Meta
Twój użytkownik Meta potrzebuje uprawnień do biznesu/Pikselu; użyj Ustawień dla poprawnego źródła danych lub postępuj zgodnie z instrukcjami Meta dotyczące rozpoczęcia pracy z API konwersji, jeśli przycisk znajduje się w kreatorze konfiguracji.
Pojawiają się tylko zdarzenia przeglądarkowe
Twój serwer może nie być w stanie wysyłać zdarzeń do Meta. Sprawdź, czy firewall, wtyczka zabezpieczająca lub dostawca hostingu blokuje wychodzące połączenia z Twojego serwera.
Słabe dopasowanie katalogu
Upewnij się, że identyfikatory produktów w Twoim kanale pasują do identyfikatorów treści wysyłanych przez Piksel. Jeśli nie pasują, Meta nie będzie w stanie powiązać zdarzeń z prawidłowymi produktami w Twoim katalogu.
Zduplikowane zdarzenia
Upewnij się, że nie używasz innego Pikselu Facebook lub wtyczki śledzącej z tym samym identyfikatorem Pikselu. Wiele integracji może spowodować dwukrotne wysłanie tego samego zdarzenia.

Często zadawane pytania

Czy CAPI zastępuje Piksel Facebook?
Nie. W tej implementacji CAPI jest zaprojektowane do pracy z Pikslem, a nie do jego zastępowania. Wtyczka najpierw sprawdza, czy Dodaj Piksel Facebook jest włączony, a dopiero potem może wysyłać żądania CAPI. Dlatego zachowaj oba włączone, aby Meta otrzymywała sygnały z przeglądarki i serwera, a następnie deduplikowała przy użyciu wspólnego identyfikatora event_id.
Co się stanie, jeśli mój token CAPI wygaśnie lub zostanie unieważniony?
Serwerowe zdarzenia nie będą akceptowane przez Meta, dopóki ponownie nie dodasz prawidłowego tokenu. Zdarzenia Pixel przeglądarki nadal mogą być widoczne, więc możesz zobaczyć niższy zasięg serwera w Testowe zdarzenia. Aby to naprawić, wygeneruj nowy token w Meta Events Manager, zaktualizuj Wprowadź swój token Facebook Conversion API w ustawieniach Product Feed, zapisz i przetestuj ponownie.
Czy Facebook Pixel jest darmowy, czy potrzebuję do niego Product Feed Elite?
Facebook Pixel jest zawarty w darmowym pluginie Product Feed Pro (dostępny od wersji 13.5.8). Nie potrzebujesz Elite, aby używać samego Pixela. Product Feed Elite dodaje warstwę Conversions API (CAPI), wysyłanie zdarzeń po stronie serwera, deduplikację i pole tokenu ponad Pixel. Jeśli potrzebujesz tylko śledzenia opartego na przeglądarce, Product Feed Pro jest wystarczający; jeśli chcesz śledzenia po stronie serwera, potrzebujesz Elite.
Jakie dane klienta wysyła CAPI do Meta?
Kiedy Twój serwer wysyła zdarzenie CAPI, plugin wysyła URL stronyadres IP odwiedzającego i user agenta (ciąg znaków przeglądarki/urządzenia) wraz z danymi zdarzenia. Te informacje są wykorzystywane przez Meta do dopasowywania zdarzeń po stronie serwera do profili użytkowników w celu atrybucji i optymalizacji. Żadne hasła, dane płatności ani inne wrażliwe dane nie są uwzględniane. Szczegółowe informacje na temat obsługi danych znajdziesz w dokumentacji danych Conversions API firmy Meta.
Czy mogę używać wielu identyfikatorów Pixel lub wielu zestawów danych?
Nie. Plugin obsługuje pojedynczy identyfikator Pixel wprowadzony globalnie w Product Feed → Ustawienia → Ogólne. Wszystkie zdarzenia — zarówno przeglądarkowe (Pixel), jak i serwerowe (CAPI) — są wysyłane do tego jednego Pixela. Jeśli potrzebujesz śledzić wiele pikseli lub zestawów danych, musisz zarządzać tym na poziomie Meta lub użyć oddzielnej integracji.

Potrzebujesz więcej pomocy?

Użytkownicy Product Feed Elite: otwórz zgłoszenie wsparcia, a nasz zespół się tym zajmie.

Użytkownicy Product Feed Pro: opublikuj nowy temat na forum WordPress.org.

Czy ten artykuł był pomocny?

Powiązane artykuły

Dokończ zakup
AdTribes WooCommerce Product Feed

Najlepsza wtyczka WooCommerce do kanałów produktów

  • AdTribes Pty Ltd
    ABN: 40 675 636 816
Produkt
Zasoby i informacje
Witryny partnerskie
Rymera