Dokumentacja Pixel for ChatGPT Ads

1. 1Pobierz plik ZIP wtyczki z potwierdzenia zakupu.
2. 2W WordPressie przejdź do Wtyczki → Dodaj wtyczkę → Wyślij wtyczkę na serwer, wybierz plik ZIP i kliknij Zainstaluj.
3. 3Kliknij Włącz wtyczkę.
4. 4Otwórz zakładkę Licence, wklej klucz licencyjny i aktywuj go.

Zdarzenia konwersji są wysyłane dopiero przy aktywnej licencji. Ekran licencji pokazuje plan, pozostałe aktywacje i datę, do której licencja jest ważna. Interfejs wtyczki jest w języku angielskim.

• Strona WordPress z zainstalowanym i włączonym WooCommerce.
• Sklep działający przez HTTPS.
• Dozwolone wychodzące żądania HTTPS z Twojego serwera, aby zdarzenia zakupu mogły dotrzeć do Conversions API.
• OpenAI Pixel ID do pomiaru w przeglądarce.
• Klucz OpenAI Conversions API do zdarzeń zakupu wysyłanych z serwera.
• Klucz licencyjny Pixel for ChatGPT Ads.

Obsługiwane są zarówno WooCommerce High-Performance Order Storage, jak i starszy zapis zamówień jako wpisów (post-based). Zmiany w motywie ani w szablonach strony zamówienia nie są potrzebne.

W zakładce Settings wklej swój OpenAI Pixel ID w pole OpenAI Pixel ID i zapisz. Przy włączonym pomiarze w przeglądarce OpenAI Measurement Pixel ładuje się w sklepie i zaczyna wysyłać zdarzenia z przeglądarki.

Jeśli obsługa zgód jest włączona, piksel pozostaje zablokowany, dopóki dany odwiedzający nie wyrazi zgody marketingowej – zobacz Zgody.

Na tym samym ekranie wklej klucz Conversions API w pole Conversions API key. Klucz jest zapisywany wyłącznie do użytku po stronie serwera. Nie trafia do kodu HTML strony i nigdy nie jest wysyłany do przeglądarki.

Przy włączonym pomiarze po stronie serwera order_created jest wysyłane z Twojego serwera, gdy zamówienie WooCommerce osiągnie status opłaconego. Każda próba jest zapisywana w zakładce Diagnostics razem z odpowiedzią HTTP, więc odrzucony klucz czy limit zapytań są widoczne, a nie przechodzą bez echa.

Te zdarzenia są wysyłane ze strony:

• Wyświetlenie produktucontents_viewed
• Dodanie do koszykaitems_added
• Rozpoczęcie zamówieniacheckout_started
• Zakuporder_created

Wyłączenie pomiaru w przeglądarce zatrzymuje wszystkie cztery zdarzenia z przeglądarki. Pomiar zakupu po stronie serwera nie jest tym objęty i działa dalej. Porównanie piksela i Conversions API wyjaśnia, co każda ścieżka widzi, a czego nie.

order_created to zdarzenie wysyłane przez Conversions API. Uruchamia się przy zmianie statusu zamówienia WooCommerce na opłacone, a nie przy załadowaniu strony, więc klient, który zamknie kartę przed załadowaniem strony „Zamówienie otrzymane”, i tak generuje zdarzenie zakupu. Tak samo działają metody płatności z opóźnionym potwierdzeniem.

Event ID jest wyliczany z zamówienia, więc zdarzenie z serwera i zdarzenie z przeglądarki dla tego samego zakupu mają ten sam identyfikator i mogą zostać połączone w jedną konwersję. Ponowne załadowanie strony „Zamówienie otrzymane” nie tworzy drugiego identyfikatora.

Nieudane wysyłki są ponawiane automatycznie. To, co nadal się nie udaje po ponowieniach, zostaje w dzienniku i można to wysłać ponownie ręcznie.

Szczegóły – dlaczego z serwera wysyłany jest tylko zakup, zasadę 7 dni dla znacznika czasu w OpenAI i to, czego wysyłka z serwera nie naprawi – opisuje poradnik o OpenAI Conversions API w WooCommerce.

Wtyczka odczytuje zgodę marketingową przez WordPress Consent API. Jeśli Twoja wtyczka do zgód implementuje to API, działa to bez dodatkowej konfiguracji.

• Zdarzenia z przeglądarki pozostają zablokowane do czasu udzielenia zgody marketingowej.
• Zdarzenie zakupu wysyłane z serwera korzysta ze stanu zgody zapisanego dla danego zamówienia, więc późniejsza zmiana preferencji nie zmienia wcześniejszych zamówień.
• Zamówienia bez zgody marketingowej mają w zakładce Diagnostics stan Not sent, a nie są oznaczane jako błąd.

Narzędzia do zgód, które nie obsługują WordPress Consent API, nie są wykrywane automatycznie. Twoje obowiązki prawne zależą od sklepu, konfiguracji i jurysdykcji.

Zakładka Diagnostics pokazuje opłacone zamówienia i to, co stało się z ich zdarzeniem zakupu. Kolumny (etykiety w interfejsie wtyczki są po angielsku):

• Order – zamówienie WooCommerce, do którego należy zdarzenie.
• WC paid – czy zamówienie osiągnęło status opłaconego.
• Consent – stan zgody marketingowej zapisany dla zamówienia.
• Delivery – wysłane, ponawiane, nieudane lub niewysłane.
• Attempts – ile razy próbowano wysłać zdarzenie.
• HTTP status – kod odpowiedzi zwrócony przy ostatniej próbie.

Nieudaną wysyłkę można ponowić z tego samego ekranu po usunięciu przyczyny.

Licencje są roczne i obejmują określoną liczbę aktywacji – jedną na instalację WordPressa. Dezaktywacja strony zwalnia jej aktywację dla innego sklepu.

Active

Pomiar działa. Zdarzenia są wysyłane, aktualizacje docierają, a wsparcie jest dostępne.

Expired

Nowe konwersje nie są mierzone. Odnów licencję, aby wznowić wysyłkę zdarzeń, aktualizacje i wsparcie.

Disabled

Nowe konwersje nie są mierzone. Licencja została dezaktywowana i żadne nowe zdarzenia nie są wysyłane.

Nazwy statusów widnieją tak we wtyczce, której interfejs jest obecnie w języku angielskim.

Aktualizacje wtyczki pojawiają się na standardowym ekranie aktualizacji WordPressa, dopóki licencja jest aktywna. Zobacz cennik i limity planów.

Brak zdarzeń z przeglądarki w sklepie

Sprawdź, czy pomiar w przeglądarce jest włączony, czy Pixel ID jest zapisany i – jeśli obsługa zgód jest włączona – czy udzielono zgody marketingowej. Cache całych stron może też serwować kopię strony sprzed konfiguracji wtyczki.

Opłacone zamówienie ma stan Not sent

Dla tego zamówienia nie udzielono zgody marketingowej, więc zdarzenie z serwera nie zostało wysłane. Tak ma działać pomiar uwzględniający zgody.

Wysyłka nieudana z kodem 401

Klucz Conversions API został odrzucony. Zaktualizuj klucz w zakładce Settings, a potem wyślij zdarzenie ponownie z zakładki Diagnostics.

Wysyłka pokazuje 429

Żądanie przekroczyło limit zapytań. Zostanie ponowione automatycznie; nic nie musisz robić, chyba że skończy się stanem Failed.

Wysyłki są ciągle ponawiane

Twój serwer może nie mieć połączenia z API. Sprawdź wychodzące żądania HTTPS, reguły firewalla i ewentualne proxy przed WordPressem.

Zamówienia brakuje w dzienniku

Zdarzenie zakupu jest zapisywane, gdy WooCommerce oznaczy zamówienie jako opłacone. Zamówienia, które wciąż czekają na płatność, nie zostały jeszcze wysłane.

Konwersje wyglądają na zdublowane

Sprawdź, czy drugi piksel nie jest zainstalowany gdzie indziej. Kod w motywie lub kontener menedżera tagów wysyła zdarzenia bez event ID nadawanego przez wtyczkę, więc nie da się ich zdeduplikować ze zdarzeniem z serwera.

Nadal masz problem? Wyślij nam numer zamówienia i status HTTP widoczny w zakładce Diagnostics – skontaktuj się ze wsparciem.