Pomiar po stronie serwera w ChatGPT Ads

Sam pixel w przeglądarce traci część zdarzeń: przez blokady, wyczyszczone ciasteczka i zakupy kończone na innym urządzeniu. Dokumentacja OpenAI nazywa pomiar serwerowy bardziej niezawodnym źródłem i zaleca używanie go razem z pixelem.

Poniżej, jak to działa w praktyce: jaki klucz jest potrzebny, jak zbudowane jest zdarzenie i jak uniknąć podwójnego liczenia tej samej konwersji.

Grzegorz Wysocki
CEO emedia

Komentarz autora: Rozdzielenie kluczy to rzecz, na której traci się pierwszą godzinę. Klucz Menedżera reklam służy do zarządzania kampaniami i nie nadaje się do wysyłania konwersji, a klucz konwersji tworzy się osobno. Komunikat błędu tego nie tłumaczy, więc człowiek szuka problemu w kodzie, a nie w tym, że użył niewłaściwego klucza.

Czym różni się od pixela?

Pixel działa w przeglądarce i podlega wszystkiemu, co przeglądarki i wtyczki potrafią zablokować. Interfejs serwerowy wysyła zdarzenia bezpośrednio z Twojego zaplecza, więc jest odporniejszy, ale wymaga pracy programisty.

Dwa zdarzenia obsługiwane są wyłącznie tą drogą: instalacja aplikacji i jej otwarcie. Pixel ich nie przyjmie. Wysyła się je ze wskazaniem źródła jako aplikacji mobilnej.

Dwa różne klucze, łatwe do pomylenia

W panelu tworzy się dwa rodzaje kluczy i łatwo je pomylić. Klucz Menedżera reklam daje dostęp do zarządzania kampaniami. Klucz konwersji służy wyłącznie do wysyłania zdarzeń z serwera i tworzy się go w sekcji konwersji.

Klucz konwersji trzymaj w menedżerze sekretów po stronie serwera. Nigdy nie umieszczaj go w kodzie strony, bo daje prawo zapisu zdarzeń na Twoim koncie.

Jak zbudowane jest zdarzenie?

Zdarzenie ma własny identyfikator, typ, znacznik czasu w milisekundach, źródło akcji oraz obiekt z danymi w kształcie odpowiadającym typowi. Opcjonalnie dokłada się identyfikator kliknięcia oraz dane użytkownika w postaci zahaszowanej.

Warto przekazywać identyfikator kliknięcia zawsze, gdy jest dostępny, bo to najpewniejsza droga połączenia konwersji z reklamą. Pixel zapisuje go w ciasteczku, więc zaplecze może go odczytać przy składaniu zamówienia.

Do testów służy tryb walidacji, w którym system sprawdza poprawność zdarzeń, ale ich nie zapisuje. Warto go użyć, zanim wdrożenie trafi na produkcję.

Paczki i deduplikacja

Zdarzenia wysyła się pojedynczo albo paczkami do tysiąca sztuk. Tu czai się pułapka: jeśli jedno zdarzenie w paczce jest błędne, odrzucana jest cała paczka. Przy dużych wolumenach oznacza to, że jeden nieprawidłowy rekord potrafi zablokować tysiąc konwersji.

Druga sprawa to podwójne liczenie. Jeśli tę samą konwersję wysyłasz z przeglądarki i z serwera, w obu miejscach użyj tego samego identyfikatora zdarzenia. System dopasowuje duplikaty po identyfikatorze pixela, nazwie zdarzenia i tym identyfikatorze, a zapisuje tylko pierwsze, które dotrze.

Przy zdarzeniach własnych trzeba zachować także tę samą nazwę własną po obu stronach, bo to ona zastępuje nazwę standardową przy dopasowaniu.

Gdy wysyłasz zdarzenia w cudzym imieniu

Agencje i dostawcy narzędzi pomiarowych powinni dodawać do każdego żądania stały identyfikator integracji. Nie wpływa on na uwierzytelnianie, ale pozwala OpenAI rozpoznać, kto wysyła dane.

Wartość ma od jednego do sześćdziesięciu czterech znaków ASCII, zaczyna się literą lub cyfrą i może zawierać kropki, podkreślenia i myślniki. Ten sam identyfikator należy stosować konsekwentnie we wszystkich żądaniach.

Jak emedia może w tym pomóc?

Pomiar serwerowy wdrażamy u klientów, którzy mają zaplecze techniczne albo sklep na własnej platformie.

• Projektujemy wysyłkę zdarzeń z serwera razem z deduplikacją względem pixela.
• Konfigurujemy klucze i przechowywanie sekretów po stronie serwera.
• Testujemy wdrożenie w trybie walidacji, zanim trafi na produkcję.
• Konfiguracja konta i pomiaru: 1500 zł netto jednorazowo.

Podsumowanie

Jeśli masz zaplecze techniczne, wdrażaj pomiar serwerowy razem z pixelem, nie zamiast niego. Pilnuj dwóch rzeczy: osobnego klucza konwersji oraz wspólnego identyfikatora zdarzenia po obu stronach. I pamiętaj, że jedno błędne zdarzenie potrafi odrzucić całą paczkę.

Przeczytaj także

• Pixel OpenAI krok po kroku: instalacja, zgody i CSP
• Zdarzenia konwersji w ChatGPT Ads: pełna lista
• Dane klienta w pomiarze: jak hashować polskie nazwiska
• Obsługa ChatGPT Ads: nasza oferta prowadzenia kampanii, cennik i zakres prac

Najczęstsze pytania

Jak to powstaje?

Ten wpis napisał człowiek, a model przygotował pierwszą wersję roboczą. Obie strony są niżej wymienione z nazwy, razem ze źródłami, na których stoją twierdzenia.

• Tematy, opinie i ostatnia decyzja: Grzegorz Wysocki, właściciel emedia, agencji marketingowej z Lublina prowadzącej kampanie płatne i SEO dla klientów.
• Wersja robocza, kod i testy: Claude Opus 5 od Anthropic, w narzędziu Claude Code. Nic nie trafia na stronę bez przeczytania i poprawienia przez człowieka.
• Grafiki: sceny powstają z wykorzystaniem AI na bazie zdjęcia autora, a napisy składamy sami.

Źródła: centrum pomocy OpenAI i dokumentacja dla deweloperów, warunki oraz zasady reklamowe OpenAI, a także ustawienia i zrzuty z naszego własnego konta reklamowego. Liczby pochodzą z dokumentacji producenta albo z realnych kampanii. Jeśli czegoś nie wiemy, piszemy o tym wprost.

Źródła: OpenAI, dokumentacja interfejsu konwersji oraz konfiguracji dla partnerów, centrum pomocy ChatGPT Ads, stan na 1 września 2026. Zrzut z konta reklamowego emedia.

Realizacja: artykuł zrealizowany przez człowieka we współpracy z systemami AI. Redakcję i publikację firmuje autor. Wykorzystane systemy: Anthropic oraz OpenAI.