Dokumentacja CC Meta Facebook Pixel
Kompleksowa dokumentacja dla wtyczki cc_facebook_pixel.Table des matières
1. Introduction
2. installation
3. Activation de la licence
4 Configuration de base
5. Tryby śledzenia
6. Śledzenie server-side
7. Kolejkowanie zdarzeń
8. Niestandardowe zdarzenia
9. Zaawansowane dopasowanie
10. Debugowanie
11. Rozwiązywanie problemów
12. FAQ
1. Introduction
CC Facebook Pixel to profesjonalna wtyczka dla WordPress umożliwiająca pełną integrację serwisu z Facebook Pixel i Conversions API. Pozwala na śledzenie aktywności użytkowników zarówno po stronie przeglądarki, jak i serwera, co umożliwia bardziej dokładne i niezawodne śledzenie konwersji, nawet w przypadku stosowania przez użytkowników blokerów reklam.Wtyczka pozwala na pełną kontrolę nad:
- integracją z Facebook Pixel poprzez JavaScript i/lub Conversions API
- śledzeniem standardowych zdarzeń (PageView, ViewContent, itp.)
- tworzeniem i wdrażaniem niestandardowych zdarzeń
- zaawansowanym dopasowaniem danych użytkownika
- kolejkowaniem zdarzeń dla optymalnej wydajności
- debugowaniem i testowaniem integracji
2. installation
Exigences du système- WordPress 5.0 ou supérieur
- PHP 7.0 ou plus récent
- Pobierz plik ZIP wtyczki z la boutique officielle
- Se connecter au panneau d'administration de WordPress
- Aller à : Plug-ins > Ajouter un nouveau plug-in > Envoyer un plug-in
- Sélectionnez le fichier ZIP téléchargé et cliquez sur "Installer maintenant"
- Une fois l'installation terminée, cliquez sur "Activer le plug-in"
3. Activation de la licence
Przed rozpoczęciem korzystania z wtyczki konieczna jest aktywacja licencji:- Po instalacji przejdź do zakładki Ustawienia > Facebook Pixel
- Kliknij zakładkę Licence
- Saisir la clé de licence reçue après l'achat
- Cliquez sur "Activer la licence"
- Une fois l'activation réussie, un message de confirmation s'affiche
Avertissement
Bez aktywnej licencji wtyczka będzie działała w trybie ograniczonym, bez możliwości edycji ustawień i konfiguracji śledzenia.
4 Configuration de base
Aby skonfigurować podstawowe ustawienia wtyczki:- Aller à : Ustawienia > Facebook Pixel
- W sekcji „Główne ustawienia” wprowadź swój Facebook Pixel ID
- Wybierz tryb śledzenia (Tylko przeglądarka, Tylko serwer, Hybrydowo)
- Włącz lub wyłącz standardowe zdarzenia
- Cliquez sur "Enregistrer les modifications"
// Przykładowy Facebook Pixel ID
123456789012345Conseil
Facebook Pixel ID można znaleźć w Menedżerze Zdarzeń Facebooka (Events Manager) w sekcji ustawień Pixel.
5. Tryby śledzenia
Wtyczka oferuje trzy tryby śledzenia, które można wybrać w zależności od potrzeb:Tylko przeglądarka (JavaScript Pixel)
W tym trybie zdarzenia są wysyłane tylko poprzez JavaScript Pixel w przeglądarce użytkownika. Jest to klasyczny sposób śledzenia, który może być blokowany przez adblocki.
Tylko serwer (Conversions API)
W tym trybie zdarzenia są wysyłane tylko przez serwer za pomocą Facebook Conversions API. Jest to bardziej niezawodny sposób śledzenia, który nie jest blokowany przez adblocki, ale wymaga dodatkowej konfiguracji.
Hybrydowo (przeglądarka + serwer z deduplikacją)
W tym trybie zdarzenia są wysyłane zarówno przez JavaScript Pixel, jak i Conversions API, z mechanizmem deduplikacji, który zapobiega podwójnemu liczeniu zdarzeń. Ten tryb zapewnia najwyższą dokładność śledzenia.
Info
Tryb hybrydowy jest zalecany dla większości witryn, ponieważ łączy zalety obu metod śledzenia, zapewniając większą dokładność danych konwersji.
6. Śledzenie server-side
Aby skonfigurować śledzenie server-side (Conversions API):- Upewnij się, że wybrany jest tryb „Tylko serwer” lub „Hybrydowo”
- W sekcji „Śledzenie Server-Side API” wprowadź Access Token
- Opcjonalnie, włącz tryb testowy i wprowadź kod wydarzenia testowego
Avertissement
Access Token jest poufnym kluczem, który powinien być chroniony. Nie udostępniaj go osobom trzecim i nie umieszczaj w publicznych miejscach.
- Aller à Menedżera Zdarzeń w business.facebook.com
- Wybierz „Źródła Danych”
- Aller à „Ustawienia”
- W sekcji „Skonfiguruj bezpośrednią integrację” wybierz link „Wygeneruj token dostępu” wygeneruj token dostępu do API
7. Kolejkowanie zdarzeń
Funkcja kolejkowania zdarzeń umożliwia odroczenie przetwarzania zdarzeń server-side, co znacząco poprawia wydajność witryny:- W sekcji „Śledzenie Server-Side API” włącz opcję „Kolejkowanie zdarzeń”
- Przejdź do zakładki „Kolejka zdarzeń”, aby skonfigurować i monitorować kolejkę
Dla optymalnej wydajności, zalecamy skonfigurowanie zadania cron na serwerze:
- W zakładce „Kolejka zdarzeń” skopiuj URL do crona
- Dodaj zadanie cron na serwerze, które będzie wywoływać ten URL co 5 minut
// Przykładowa komenda cron dla wget
*/5 * * * * wget -q -O /dev/null https://demo.cocos.codes/cc_facebook_pixel?cc_facebook_pixel_cron=1&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX >/dev/null 2>&1
// Przykładowa komenda cron dla curl
*/5 * * * * curl -s https://demo.cocos.codes/cc_facebook_pixel?cc_facebook_pixel_cron=1&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX >/dev/null 2>&1
Note
Kolejkowanie zdarzeń działa również bez zewnętrznego zadania cron, wykorzystując wbudowany mechanizm WordPress Cron, jednak zewnętrzne zadanie cron zapewnia bardziej niezawodne i terminowe przetwarzanie zdarzeń.
8. Niestandardowe zdarzenia
Wtyczka umożliwia dodawanie niestandardowych zdarzeń JavaScript:- W sekcji „Niestandardowe zdarzenia” wprowadź własny kod zdarzeń
- Wybierz miejsce wstawienia kodu (nagłówek lub stopka strony)
// Przykładowy kod niestandardowego zdarzenia
fbq('track', 'MojeZdarzenie', {
parametr1: 'wartosc1',
parametr2: 'wartosc2'
});Avertissement
W trybie „Tylko serwer” niestandardowe zdarzenia JavaScript nie będą wysyłane, ponieważ kod Facebook Pixel nie jest wtedy wstrzykiwany na stronę. Zmień tryb śledzenia na „Hybrydowo” lub „Tylko przeglądarka”, jeśli chcesz używać niestandardowych zdarzeń JavaScript.
9. Zaawansowane dopasowanie
Zaawansowane dopasowanie pozwala na przesyłanie dodatkowych danych użytkownika do Facebooka, co poprawia skuteczność śledzenia:- W sekcji „Zaawansowane dopasowanie” włącz opcję „Włącz zaawansowane dopasowanie”
- Zaznacz pola danych użytkownika, które chcesz przesyłać:
- Telefon
- Nom
- Nom
- Ville
- Województwo
- Code postal
- Pays
Conseil
Zaawansowane dopasowanie działa najlepiej, gdy użytkownicy są zalogowani na Twojej stronie. W przypadku niezalogowanych użytkowników, wtyczka spróbuje pobrać dane z formularzy, które wypełniają.
10. Debugowanie
Wtyczka oferuje rozbudowane narzędzia debugowania, które pomagają w rozwiązywaniu problemów z integracją Facebook Pixel:- W sekcji „Ustawienia debugowania” włącz opcję „Włącz tryb debugowania”
- Przejdź do zakładki „Debugowanie”, aby uzyskać dostęp do narzędzi debugowania
- Testuj Server-Side API – wysyła testowe zdarzenie przez Conversions API
- Testuj JavaScript Pixel – otwiera stronę z aktywnym JavaScript Pixel
- Logi API – wyświetla logi żądań i odpowiedzi API
Conseil
W trybie debugowania wtyczka generuje szczegółowe logi, które można wykorzystać do diagnozy problemów. Logi są zapisywane w katalogu /wp-content/uploads/cc-facebook-pixel-logs/.
11. Rozwiązywanie problemów
Zdarzenia nie są wysyłane- Sprawdź, czy wprowadzono poprawny Facebook Pixel ID
- S'assurer que la licence est active
- Sprawdź, czy wybrany tryb śledzenia jest odpowiedni dla Twoich potrzeb
- W przypadku śledzenia server-side, sprawdź poprawność Access Token
- Włącz tryb debugowania i sprawdź logi
- Upewnij się, że WordPress Cron działa poprawnie
- Rozważ skonfigurowanie zewnętrznego zadania cron
- Sprawdź, czy serwer ma odpowiednie uprawnienia do wysyłania żądań HTTP
- Sprawdź, czy Access Token jest poprawny i aktywny
- Upewnij się, że wybrana została odpowiednia wersja API
- Włącz tryb testowy i sprawdź, czy testowe zdarzenia są wysyłane poprawnie
- Sprawdź logi API, aby zidentyfikować potencjalne problemy
12. FAQ
Co to jest Facebook Pixel?Facebook Pixel to narzędzie analityczne, które umożliwia śledzenie aktywności użytkowników na stronie internetowej i wykorzystanie tych danych do targetowania reklam na Facebooku, Instagramie i w sieci reklamowej Audience Network.
Jaka jest różnica między JavaScript Pixel a Conversions API?
JavaScript Pixel działa w przeglądarce użytkownika i może być blokowany przez adblocki. Conversions API działa po stronie serwera i nie może być blokowany przez adblocki, co zapewnia bardziej niezawodne śledzenie konwersji.
Czy mogę używać wtyczki bez aktywnej licencji?
Wtyczka będzie działać w trybie ograniczonym bez aktywnej licencji, umożliwiając podgląd ustawień, ale nie będzie można edytować konfiguracji ani korzystać z zaawansowanych funkcji.
Czy wtyczka spowalnia ładowanie strony?
Wtyczka została zoptymalizowana pod kątem wydajności. Funkcja kolejkowania zdarzeń server-side znacząco redukuje wpływ na czas ładowania strony.
Czy wtyczka jest zgodna z RODO/GDPR?
Wtyczka sama w sobie nie zbiera danych osobowych, ale umożliwia przesyłanie danych do Facebooka. Obowiązkiem właściciela witryny jest zapewnienie zgodności z RODO/GDPR, w tym uzyskanie odpowiednich zgód od użytkowników.
Czy mogę wykluczyć określonych użytkowników ze śledzenia?
Tak, w sekcji „Ustawienia debugowania” możesz wybrać role użytkowników, które będą wykluczone ze śledzenia.
Jak mogę sprawdzić, czy Facebook Pixel działa poprawnie?
Włącz tryb debugowania i użyj narzędzi debugowania, aby przetestować integrację. Możesz również skorzystać z rozszerzenia Facebook Pixel Helper dla przeglądarki Chrome.
Co się stanie, jeśli wyłączę kolejkowanie zdarzeń?
Zdarzenia server-side będą przetwarzane synchronicznie, co może spowolnić ładowanie strony, szczególnie przy dużym ruchu.
Gdzie mogę uzyskać pomoc, jeśli mam problemy z wtyczką?
Wsparcie techniczne jest dostępne dla posiadaczy licencji. Skontaktuj się z nami przez page de soutien.
