Przejdź do treści
Kup wtyczkę

Poradnik

Jak zainstalować piksel ChatGPT Ads w sklepie WooCommerce

ChatGPT Ads mierzy sprzedaż w WooCommerce przez dwa interfejsy OpenAI: Measurement Pixel w przeglądarce klienta i Conversions API na Twoim serwerze. Instalacja polega na pobraniu Pixel ID i klucza API z Ads Manager, a potem połączeniu ich z WooCommerce tak, aby wysyłane były prawdziwe zdarzenia produktów, koszyka i zamówień. W tym poradniku robimy to za pomocą wtyczki Pixel for ChatGPT Ads, a na koniec sprawdzamy, czy wszystko działa.

Aktualizacja

Na tej stronie

W skrócie: siedem kroków, prawie wszystko na jednym ekranie ustawień

Zanim zaczniesz

Pięć rzeczy do przygotowania i jedna do usunięcia.

  • WordPress z aktywnym WooCommerce, działający przez HTTPS.
  • Dostęp administratora do WordPressa, żeby wgrać i skonfigurować wtyczkę.
  • Dostęp do konta ChatGPT Ads w OpenAI Ads Manager (Menedżer reklam OpenAI).
  • Klucz licencyjny Pixel for ChatGPT Ads. Otrzymujesz go po zakupie; plany zaczynają się od jednej strony.
  • Serwer, który może wysyłać wychodzące żądania HTTPS. Niektóre hostingi i firewalle je blokują, a zakup wysyłany z serwera ich potrzebuje.

Sprawdź

Usuń inne kopie piksela. Jeśli piksel ChatGPT Ads jest już wklejony do nagłówka motywu, do wtyczki do skryptów w nagłówku albo do kontenera Google Tag Manager, usuń go przed startem. Druga kopia wysyła własne zdarzenia bez event ID wtyczki, więc OpenAI nie rozpozna ich jako tego samego zakupu, a konwersje mogą zostać policzone podwójnie.
1

Krok 1 z 7

Uzyskaj Pixel ID

Pixel ID wskazuje pikselowi (Measurement Pixel), do którego konta ChatGPT Ads należą zdarzenia. Zgodnie z dokumentacją OpenAI nowy Pixel ID tworzysz w zakładce konwersji w Ads Manager (dokumentacja Measurement Pixel; dokumentacja OpenAI jest dostępna po angielsku).

Pixel ID przyda się też do pomiaru po stronie serwera: to on wskazuje adres endpointu Conversions API.

Oczekiwany efekt

Pixel ID Twojego konta ChatGPT Ads, skopiowany tam, skąd łatwo go wkleisz.

Częsty problem

Inny Pixel ID w przeglądarce i na serwerze. Obie ścieżki muszą używać tego samego, inaczej zdarzeń z przeglądarki i z serwera nie da się dopasować.
2

Krok 2 z 7

Wygeneruj klucz Conversions API

Klucz Conversions API (API konwersji) upoważnia Twój serwer do wysyłania zdarzeń. OpenAI udostępnia go w tym samym miejscu – według dokumentacji zarówno Pixel ID, jak i klucz Conversions API wygenerujesz w zakładce konwersji w Ads Manager (dokumentacja Conversions API).

Traktuj klucz API jak poufne dane logowania

OpenAI wyraźnie zaznacza, że zdarzenia do Conversions API wysyła się wyłącznie z serwera. Wtyczka zapisuje klucz do użytku po stronie serwera i nie umieszcza go w kodzie strony.

Oczekiwany efekt

Klucz Conversions API zapisany wyłącznie tam, gdzie trzymasz poufne dane logowania.

Częsty problem

Wklejenie klucza do pliku motywu, page buildera lub menedżera tagów. Klucz nigdy nie może pojawić się w kodzie źródłowym strony.
3

Krok 3 z 7

Zainstaluj wtyczkę

  1. 1Pobierz plik ZIP wtyczki z potwierdzenia zakupu albo ze strony pobierania (po angielsku), podając klucz licencyjny.
  2. 2W WordPressie przejdź do Wtyczki → Dodaj wtyczkę → Wyślij wtyczkę na serwer, wybierz plik ZIP i kliknij Zainstaluj.
  3. 3Kliknij Włącz wtyczkę.

Oczekiwany efekt

Pixel for ChatGPT Ads jest na liście wtyczek jako włączona.
4

Krok 4 z 7

Aktywuj licencję

Otwórz zakładkę Licence wtyczki, wklej klucz licencyjny i aktywuj go. Dopóki licencja nie jest aktywna, żadne zdarzenia nie są wysyłane.

Oczekiwany efekt

Zakładka Licence pokazuje status Active, razem z Twoim planem i liczbą pozostałych aktywacji.

Częsty problem

Aktywacja najpierw na kopii testowej (staging). Staging zużywa własną aktywację, więc testuj tam tylko wtedy, gdy Twój plan ma wolną aktywację.
5

Krok 5 z 7

Połącz dane dostępowe

W zakładce Settings wtyczki:

  • Wklej Pixel ID w pole OpenAI Pixel ID.
  • Wklej klucz w pole Conversions API key.
  • Pozostaw włączony pomiar w przeglądarce, aby wysyłać ze strony wyświetlenia produktów, dodania do koszyka, rozpoczęcia zamówienia i zakupy.
  • Pozostaw włączony pomiar po stronie serwera, aby wysyłać każde opłacone zamówienie przez Conversions API.
  • Jeśli Twój baner zgód obsługuje WordPress Consent API, włącz obsługę zgód, aby piksel czekał na zgodę marketingową.

Ustawienia połączenia wtyczki w WordPressie (interfejs wtyczki jest po angielsku).

  1. 1OpenAI Pixel ID – z kroku 1.
  2. 2Conversions API key – z kroku 2.
  3. 3Przełączniki pomiaru w przeglądarce i po stronie serwera – zostaw oba włączone.

Oczekiwany efekt

Oba pola zapisane, pomiar w przeglądarce i po stronie serwera włączony.

Sprawdź

Jeśli sklep korzysta z cache całych stron, wyczyść go po zapisaniu ustawień, żeby odwiedzający nie dostawali kopii strony sprzed konfiguracji piksela.
6

Krok 6 z 7

Sprawdź zdarzenia z przeglądarki

  1. 1Otwórz sklep w oknie prywatnym i zaakceptuj marketingowe pliki cookie, jeśli pojawi się baner.
  2. 2Otwórz narzędzia deweloperskie przeglądarki i przejdź do karty Network (Sieć).
  3. 3Przefiltruj żądania po openai. Powinien pojawić się skrypt Measurement Pixel ładowany z hosta openai.com.
  4. 4Obejrzyj produkt, dodaj go do koszyka i przejdź do strony zamówienia, obserwując nowe żądania.

Oczekiwany efekt

Żądania do hosta openai.com, gdy oglądasz produkt, dodajesz go do koszyka i przechodzisz do strony zamówienia.

Częsty problem

Brak jakichkolwiek żądań – zwykle pomiar w przeglądarce jest wyłączony, brakuje Pixel ID, nie udzielono zgody albo serwowana jest strona z cache.
7

Krok 7 z 7

Sprawdź opłacone zamówienie

Złóż zamówienie, które osiągnie status opłaconego (prawdziwe zamówienie o niskiej wartości albo testową bramkę płatności, która oznacza zamówienia jako opłacone). Następnie otwórz zakładkę Diagnostics wtyczki i znajdź to zamówienie.

Co oznacza stan wysyłki zamówienia
Stan wysyłkiCo oznaczaCo zrobić
AcceptedOpenAI przyjęło zakup.Nic. Pomiar działa.
PendingW kolejce lub czeka na kolejną próbę.Sprawdź ponownie za chwilę.
Not sentZakup nie został wysłany – zwykle z powodu braku zgody marketingowej dla tego zamówienia.Otwórz zamówienie, aby zobaczyć powód.
FailedOstatnia próba się nie powiodła.Odczytaj status HTTP, usuń przyczynę i wyślij ponownie, jeśli zamówienie się kwalifikuje.

Diagnostyka pokazuje opłacone zamówienia i to, co stało się z każdym zdarzeniem zakupu.

  1. 1Znajdź swoje zamówienie testowe po numerze.
  2. 2Event ID jest wspólny dla zakupu z przeglądarki i z serwera.

Oczekiwany efekt

Zamówienie ma w zakładce Diagnostics stan Accepted.

Sprawdź

Zamówienie, które wciąż czeka na płatność, nie zostało jeszcze wysłane – zakup trafia do OpenAI, gdy WooCommerce oznaczy zamówienie jako opłacone.

Rozwiązywanie problemów

Najczęstsze błędy

Większość problemów z instalacją to jeden z tych pięciu.

Najczęstsze błędy przy instalacji piksela ChatGPT Ads w WooCommerce
ObjawPrawdopodobna przyczynaRozwiązanie
Konwersje wyglądają na zdublowanePiksel jest zainstalowany także w motywie lub menedżerze tagów.Usuń drugą kopię.
Failed z HTTP 401Klucz Conversions API został odrzucony.Wklej prawidłowy klucz i wyślij ponownie z zakładki Diagnostics.
Stan Pending, kolejne ponowieniaSerwer nie może połączyć się z API.Sprawdź wychodzące połączenia HTTPS, firewall i reguły proxy.
Brak zdarzeń z przeglądarkiBrak zgody, wyłączony pomiar albo nieaktualna strona z cache.Udziel zgody, sprawdź ustawienia, wyczyść cache.
Zamówienia ze stanem Not sentDla tych zamówień nie zapisano zgody marketingowej.To oczekiwane działanie przy włączonej obsłudze zgód.

Sekcja rozwiązywania problemów w dokumentacji opisuje więcej przypadków.

Bez wtyczki

Instalacja ręczna

Piksel możesz zainstalować bez wtyczki. W WooCommerce wklejenie kodu to jednak dopiero początek.

Według instrukcji OpenAI fragment kodu dodajesz do sekcji <head> każdej strony, na której chcesz mierzyć konwersje. Potem:

  • Każde zdarzenie – wyświetlenie produktu, dodanie do koszyka, rozpoczęcie zamówienia, zakup – trzeba zakodować z wartościami z WooCommerce.
  • Zdarzenie zakupu powinno uruchamiać się raz na zamówienie, a nie przy każdym załadowaniu strony „Zamówienie otrzymane”.
  • Zakup po stronie serwera wymaga własnego klienta API, uruchamianego przy statusie opłaconym.
  • Zakupy z przeglądarki i z serwera muszą mieć ten sam event ID, żeby deduplikacja zadziałała.
  • Błędy wymagają ponowień i miejsca, w którym je widać.

Poradnik o OpenAI Conversions API w WooCommerce szczegółowo omawia część po stronie serwera.

Pytania

Czy potrzebuję zarówno Pixel ID, jak i klucza API?

Pixel ID jest potrzebny do wszystkiego. Klucz API jest potrzebny do zakupu wysyłanego z serwera. Pomiar w przeglądarce i po stronie serwera można wyłączyć osobno, ale gdy działają oba, zakup ma drugą drogę, niezależną od przeglądarki.

Czy wtyczka wymaga Google Tag Managera?

Nie. Sama ładuje piksel i buduje zdarzenia bezpośrednio z WooCommerce.

Czy zmiana motywu zepsuje pomiar?

Nie. Wtyczka nie edytuje szablonów, więc zmiana motywu nie usuwa piksela. Mocno zmodyfikowany proces zamówienia warto jednak przetestować nowym zamówieniem.

Czy wtyczka działa z HPOS?

Tak. Obsługiwane są zarówno WooCommerce High-Performance Order Storage, jak i starszy zapis zamówień.

Chcesz to zainstalować?

Pixel for ChatGPT Ads to roczna licencja na 1, 5 lub 25 stron – z tymi samymi funkcjami w każdym planie.

Sprawdź cenyCo wysyła wtyczka

Powiązane poradniki