# Gapli Meta Pixel

> Moduł WordPress/WooCommerce GAPLI (`gapli-meta-pixel`) · kategoria: Marketing · aktualna wersja 1.0.4 · WordPress 6.0+ · WooCommerce 10.0+ · PHP 8.0+  
> Wersja HTML: https://gapli.com/docs/meta-pixel

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.

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