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

Jak skonfigurować Facebook Conversion API (CAPI) 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 kanału katalogu Facebook, zacznij od Jak skonfigurować kanał produktów Facebook Catalog. Warstwa śledzenia Pixel i CAPI działa wraz z tym kanałem, aby raportować konwersje z powrotem do Meta.

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. Znajdź odpowiednie ustawienia w Product Feed → Ustawienia → Ogólne.
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 Pixela FacebookPobierz Identyfikator Pixela z Meta Events Manager i wprowadź go w swoich ustawieniach, aby połączyć śledzenie witryny z kontem Meta.
Token dostępu CAPIWygeneruj token dostępu CAPI w Meta 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 należącego do Twojego Pixela (Meta wdraża również określenie zestaw danych dla tego samego bazowego źródła danych). Wygeneruj token po tym, jak dowiesz się, który identyfikator Pixela wprowadzisz w Product Feed Pro.

Zanim zaczniesz

  • Zaloguj się przy użyciu konta Meta, które ma pełną kontrolę lub dostęp zarządzania do Firmy będącej właścicielem Pixela.
  • Jeśli brakuje opcji Wygeneruj token dostępu, Twojemu użytkownikowi prawdopodobnie brakuje odpowiedniej roli w firmie lub przy Pixelu. Poproś administratora Firmy o przyznanie dostępu lub wygenerowanie tokenu za Ciebie.
  • Numeryczny identyfikator Pixela w ustawieniu Product Feed musi być zgodny z Pixelem/zestawem danych wybranym 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 Zestawy danych), kliknij Pixel używany w Twoim sklepie WooCommerce.
  3. Otwórz kartę Ustawienia dla tego Pixela (ikona zębatki lub górne Ustawienia, w zależności od układu Meta).
  4. Przewiń do sekcji Conversions API.
  5. Znajdź Wygeneruj token dostępu (może znajdować się pod Skonfiguruj ręcznie, Skonfiguruj 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ć o potwierdzenie uprawnień lub której aplikacji można użyć tokenu. Ukończ te monity.
  7. Gdy Meta wyświetli ciąg tokenu, kliknij Kopiuj. Przechowuj go w menedżerze haseł; Meta często wyświetla go tylko raz i nie można później odzyskać całego sekretu.
  8. Jeśli zgubisz token, kliknij ponownie Cofnij / Wygeneruj token dostępu w tym samym obszarze API konwersji, a następnie wklej nowy token do Product Feed → Ustawienia → Ogólne → Wprowadź swój token Facebook Conversion API 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 Pixela (nie Pixela innego konta reklamowego).
  • Otwórz kartę Przegląd i poszukaj Skonfiguruj API konwersji lub Rozpocznij. Niektóre konta najpierw przeprowadzą Cię przez proces tworzenia 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 do Product Feed → Ustawienia → Ogólne → Wprowadź swój token Facebook Conversion API (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 opcję Włącz 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 informacji można znaleźć w linku Przeczytaj więcej 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 API konwersji wysyłają to samo zdarzenie, Meta używa wspólnego identyfikatora zdarzenia, aby rozpoznać, że odnosi się ono do tej samej akcji. Pozwala to Mecie zliczyć zdarzenie tylko raz, nawet gdy zgłaszają je zarówno przeglądarka, jak i serwer.

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 zostanie dodany do koszyka.
PłatnośćInitiateCheckout: wyzwalane, gdy klient rozpocznie proces realizacji zakupu.
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 wyszukuje produkty w Twoim sklepie.

Feed produktów a zdarzenia śledzenia

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

Kanał produktów wysyła dane katalogu do Meta: tytuły produktów, ceny, obrazy i identyfikatory.

Facebook Pixel i API konwersji 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 kanale 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 reklamy dynamiczne produktów.

W zależności od Twojego motywu lub konfiguracji płatności, niektóre zdarzenia mogą zachowywać się nieco inaczej na określonych stronach. Zweryfikuj kluczowe zdarzenia w Meta Events Manager, używając Test Events lub strumienia zdarzeń na żywo.

Zweryfikuj Piksel Facebook i API konwersji

Po włączeniu Facebook Pixel i Conversions API (CAPI), potwierdź, że oba działają poprawnie.

Sprawdź zdarzenia w Menedżerze zdarzeń Meta

Otwórz Meta Events Manager i przejdź do Test Events. Odwiedź swój sklep i wywołaj zdarzenie, takie jak przeglądanie produktu lub dokonanie testowego zakupu. 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 Pixel, 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ą się nie pojawić, mimo że Pixel 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

Nie pojawiają się żadne zdarzenia serwerowe
Potwierdź, że Dodaj Facebook Pixel jest włączone, ID Pixela jest prawidłowe, Włącz Facebook Conversion API jest włączone, a token został wklejony. Zweryfikuj, czy token należy do tego samego Pixela. Wygeneruj ponownie token w Events Manager, jeśli został cofnięty lub skopiowany nieprawidłowo.
Nie można wygenerować tokenu w Meta
Twój użytkownik Meta potrzebuje uprawnień do biznesu lub Pixela. Użyj Ustawień dla poprawnego źródła danych lub postępuj zgodnie z przewodnikiem Meta Conversions API, jeśli przycisk znajduje się pod kreatorem 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 Facebook Pixel lub wtyczki śledzącej z tym samym ID Pixela. 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 Pixelem, a nie do jego zastępowania. Wtyczka najpierw sprawdza, czy Dodaj Facebook Pixel jest włączone, a dopiero potem wysyła żądania CAPI. Pozostaw oba włączone, aby Meta otrzymywała sygnały z przeglądarki i serwera, a następnie deduplikowała je przy użyciu wspólnego event_id.
Co się stanie, jeśli mój token CAPI wygaśnie lub zostanie unieważniony?
Zdarzenia serwerowe przestaną być akceptowane przez Meta, dopóki nie dodasz prawidłowego tokenu. Zdarzenia Pixela przeglądarki nadal mogą się pojawiać, więc możesz zobaczyć niższy wskaźnik pokrycia serwerowego w Test Events. 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 darmowej wtyczce Product Feed Pro. 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, oprócz Pixela. Jeśli potrzebujesz tylko śledzenia opartego na przeglądarce, Product Feed Pro jest wystarczający; jeśli chcesz śledzenia po stronie serwera obok niego, potrzebujesz Elite.
Jakie dane klienta wysyła CAPI do Meta?
Gdy Twój serwer wyśle zdarzenie CAPI, wtyczka wysyła do Meta następujące dane:
  • Adres URL strony: adres URL strony, na której wystąpiło zdarzenie
  • Adres IP i ciąg znaków przeglądarki/urządzenia (user agent): używane przez Meta do dopasowywania zdarzeń do użytkowników
  • Identyfikator kliknięcia Meta i identyfikator przeglądarki (z własnych plików cookie Meta _fbc i _fbp, gdy są obecne w przeglądarce odwiedzającego): poprawiają jakość dopasowywania zdarzeń i atrybucję
  • Kod pocztowy i kraj rozliczeniowy: uwzględniane dla zalogowanych użytkowników lub w przypadku zdarzeń zakupu; haszowane algorytmem SHA-256 przed wysłaniem, dzięki czemu surowe wartości nigdy nie opuszczają Twojego serwera
  • Anonimowy identyfikator odwiedzającego: identyfikator konta WordPress użytkownika dla zalogowanych użytkowników lub identyfikator zamówienia WooCommerce dla zakupów gości; haszowane algorytmem SHA-256 przed wysłaniem
Meta wykorzystuje te dane do dopasowywania zdarzeń po stronie serwera do profili użytkowników w celach atrybucji i raportowania. Hasła, dane płatności ani inne poufne dane osobowe nie są uwzględniane. Pełne szczegóły znajdziesz w dokumentacji danych Meta dotyczących Conversions API.
Czy mogę używać wielu identyfikatorów Pixel lub wielu zestawów danych?
Nie. Wtyczka obsługuje pojedynczy identyfikator Pixel ID 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 zbiorów danych, musiałbyś zarządzać tym na poziomie Meta lub użyć oddzielnej integracji.

Potrzebujesz więcej pomocy?

Użytkownicy Product Feed Elite: otwórz zgłoszenie pomocy technicznej, 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