OpenAI Pixel: wdrożenie krok po kroku
Measurement Pixel to skrypt, który zgłasza zdarzenia z Twojej strony do OpenAI Ads Manager. Bez niego kampania optymalizuje kliknięcia zamiast wyników. Poniżej kod, składnia i pełna lista zdarzeń, z dokumentacji OpenAI, stan na 4 września 2026.
Najważniejsze w skrócie
Openai pixel wdrożenie w skrócie
Zanim podejmiesz decyzję, zobacz liczby i fakty, które realnie liczą się we współpracy.
- Piksel wstawia się do sekcji head jako samodzielny fragment kodu, a następnie inicjalizuje wywołaniem oaiq z identyfikatorem pobranym z Ads Manager. Sam skrypt ładuje się asynchronicznie i nie blokuje renderowania strony.
- OpenAI udostępnia dziesięć zdarzeń standardowych, od page_viewed i contents_viewed, przez items_added i checkout_started, po order_created, lead_created, registration_completed, appointment_scheduled, subscription_created oraz trial_started. Wszystko poza tą listą zgłasza się jako custom z własną nazwą.
- Wartość transakcji przekazuje się w polu amount jako liczbę całkowitą, razem z walutą. Dokumentacja wprost wskazuje wartości całkowite dla amount i quantity, więc kwoty podaje się w najmniejszej jednostce, a nie z przecinkiem.
- Zdarzenia app_installed oraz app_opened nie działają przez Piksel przeglądarkowy i trzeba je wysłać po stronie serwera przez Conversions API. To najczęstsze źródło luk w pomiarze aplikacji mobilnych.
- Parametr debug włącza logowanie w konsoli przeglądarki. Warto go zostawić na czas wdrożenia i wyłączyć przed puszczeniem ruchu produkcyjnego.
Po co w ogóle wdrażać Piksel
Na poziomie kampanii wybiera się zdarzenie konwersji, czyli działanie, którego oczekujesz po kliknięciu w reklamę. Jeżeli takiego zdarzenia nie ma, system nie ma czego optymalizować i skupia się na klikalności. W praktyce znaczy to, że płacisz za ruch, nie mając informacji, czy z tego ruchu cokolwiek wynikło.
Piksel jest przeglądarkowym SDK, które raportuje zdarzenia ze strony i przypisuje je do reklam wyświetlonych w ChatGPT. Drugą drogą jest Conversions API, wysyłające dane bezpośrednio z serwera. OpenAI wskazuje rozwiązanie serwerowe jako bardziej niezawodne źródło danych, ale obie metody można stosować równolegle i to jest najczęstsze zalecane ustawienie.
Krok 1: kod instalacyjny w sekcji head
Pierwszy fragment tworzy kolejkę poleceń i doładowuje właściwy skrypt z serwera OpenAI. Wkleja się go w sekcję head, przed jakimkolwiek wywołaniem pomiarowym.
<script>
(function (w, d, s, u) {
if (w.oaiq) return;
var q = function () {
q.q.push(arguments);
};
q.q = [];
w.oaiq = q;
var js = d.createElement(s);
js.async = true;
js.src = u;
var f = d.getElementsByTagName(s)[0];
f.parentNode.insertBefore(js, f);
})(window, document, "script", "https://bzrcdn.openai.com/sdk/oaiq.min.js");
</script>Konstrukcja jest typowa dla pikseli reklamowych: dopóki właściwy plik się nie doładuje, wywołania trafiają do kolejki i zostają wykonane po jego pobraniu. Dzięki temu zdarzenie zgłoszone tuż po wejściu na stronę nie przepada.
W skrócie
- Umowa i faktura VAT z Marketerzy.pl
- Płatność w depozycie, zwalniana po akceptacji etapu
- Opiekun czuwa nad jakością i terminami
- Zastępstwo bez utraty historii projektu
Krok 2: inicjalizacja identyfikatorem z panelu
Identyfikator Piksela otrzymujesz przy tworzeniu źródła danych dla konta reklamowego w Ads Manager. Bez inicjalizacji skrypt nie wie, do którego konta przypisać zdarzenia.
oaiq("init", {
pixelId: "<TWOJ-PIXEL-ID>",
});Na czas wdrożenia warto dołożyć opcjonalny parametr włączający logowanie w konsoli przeglądarki. Widać wtedy od razu, czy zdarzenia wychodzą i z jakimi danymi, zamiast czekać na raporty w panelu.
Krok 3: zgłaszanie konwersji
Właściwy pomiar to wywołanie measure. Przyjmuje ono do czterech argumentów: polecenie, nazwę zdarzenia, dane zdarzenia oraz opcje.
oaiq("measure", "order_created", {
type: "contents",
amount: 2599,
currency: "USD",
});Zwróć uwagę na wartość w polu amount. Dokumentacja wskazuje liczby całkowite dla amount i quantity, więc kwoty przekazuje się bez części dziesiętnej. Wywołanie umieszcza się w miejscu, w którym konwersja faktycznie następuje, czyli na stronie podziękowania po złożeniu zamówienia, a nie na stronie koszyka.
W pakiecie
Zdarzenia standardowe dostępne w Pikselu
Poniższa lista pochodzi z dokumentacji OpenAI. Dla działań spoza niej używa się zdarzenia custom z własną nazwą przekazaną w polu custom_event_name.
- 01 page_viewed, wyświetlenie strony
- 02 contents_viewed, obejrzenie treści lub karty produktu
- 03 items_added, dodanie pozycji do koszyka
- 04 checkout_started, rozpoczęcie procesu zakupowego
- 05 order_created, złożenie zamówienia
- 06 lead_created, pozostawienie kontaktu
- 07 registration_completed, zakończona rejestracja konta
- 08 appointment_scheduled, umówienie terminu
- 09 subscription_created, wykupienie subskrypcji
- 10 trial_started, rozpoczęcie okresu próbnego
Czego Piksel nie zmierzy
Dwa zdarzenia związane z aplikacjami mobilnymi, czyli instalacja i otwarcie aplikacji, nie działają przez skrypt przeglądarkowy. Trzeba je wysłać po stronie serwera przez Conversions API. Jeżeli prowadzisz kampanię nastawioną na instalacje, samo wdrożenie Piksela nie wystarczy i luka w danych ujawni się dopiero przy próbie optymalizacji.
Poza tym Piksel dzieli ograniczenia wszystkich rozwiązań przeglądarkowych. Blokery treści, ustawienia prywatności i brak zgody na pliki cookie potrafią uciąć część zdarzeń. To jest właśnie powód, dla którego OpenAI wskazuje wysyłkę serwerową jako pewniejsze źródło, a rozwiązanie równoległe jako najbezpieczniejsze.
Proces współpracy
Kolejność wdrożenia, która nie generuje luk w danych
Utwórz źródło danych w Ads Manager
Wstaw kod instalacyjny w sekcji head
Zainicjalizuj skrypt z włączonym logowaniem
Podepnij zdarzenia w punktach realnej konwersji
Dołóż Conversions API tam, gdzie liczy się kompletność
Wyłącz logowanie i wybierz zdarzenie w kampanii
Pytania i odpowiedzi
Najczęściej zadawane pytania
Gdzie dokładnie wkleić kod Piksela?
Czy Piksel można wdrożyć przez Google Tag Manager?
W jakim formacie przekazać kwotę transakcji?
Co zrobić, jeśli moja konwersja nie pasuje do żadnego zdarzenia standardowego?
Czy sam Piksel wystarczy do pomiaru instalacji aplikacji?
Czy trzeba wdrażać i Piksel, i Conversions API?
Twój projekt w dobrych rękach
Twój projekt zasługuje na najlepszego marketera
Dopasowanie w 24 godziny. Bezpłatna konsultacja, bez opłat wstępnych.
Ostatnia aktualizacja:
Zobacz też