GapliGapliDokumentacja modułów

Gapli Meta Pixel

Aktualna wersja 1.0.4WordPress 6.0+WooCommerce 10.0+PHP 8.0+

Meta (Facebook/Instagram) Pixel w przeglądarce i Conversions API po stronie serwera, z dopasowaniem klientów (Advanced Matching) i katalogiem produktów do reklam dynamicznych.

Pobierz instrukcję (.md)Markdown dla agenta AI

Gdzie go znajdziesz

Gapli → 📊 Meta Pixel, zakładki: Ogólne, Eventy, Katalog DPA, Advanced Matching, Diagnostyka.

Pierwsze uruchomienie

  1. W Meta Events Manager skopiuj identyfikator Pixela (15–16 cyfr) i wklej w polu „Pixel ID”.
  2. W Events Manager → Settings → Conversions API kliknij „Generate Access Token” i wklej token w polu „Conversions API Access Token”.
  3. Kliknij „Test CAPI” na zakładce Diagnostyka i sprawdź, czy połączenie działa.
  4. Jeśli sklep pokazuje baner zgód na cookies, włącz „Wymagaj zgody na cookies (RODO)” — domyślnie ta opcja jest wyłączona.
  5. Dla reklam dynamicznych dodaj w Meta Commerce Manager katalog z adresu https://<domena-sklepu>/gapli-meta-catalog/.

Co dzieje się automatycznie

  • Wysyła zdarzenia PageView, ViewContent, AddToCart, InitiateCheckout, Purchase i Search — z przeglądarki i z serwera, z deduplikacją.
  • Nie śledzi zalogowanych administratorów.
  • Co 6 godzin odświeża katalog produktów (tylko produkty dostępne w magazynie, identyfikator = SKU, ceny brutto).

Wymagania i powiązane moduły

  • Sklep musi działać na HTTPS — Meta tego wymaga.

Gdy coś nie działa

Diagnostyka: „Pixel ID: Nie skonfigurowano” albo „Połączenie CAPI: błąd”
Sprawdź Pixel ID i token, a potem kliknij „Test CAPI”. Token wygenerowany dla innego Pixela nie zadziała.
„Tryb testowy jest AKTYWNY. Eventy nie są liczone w produkcji”
Po zakończeniu testów kliknij „Wyłącz” przy trybie testowym.
„SSL: Brak — Meta wymaga HTTPS”
Włącz certyfikat SSL u hostingu i ustaw adres sklepu na https:// w Ustawienia → Ogólne.