OpenAI Conversions API (ang. OpenAI CAPI) to serwerowy interfejs, przez który reklamodawca przesyła zdarzenia konwersji (np. zakup, lead, rejestrację) bezpośrednio ze swojego serwera do OpenAI Ads Manager, z pominięciem przeglądarki użytkownika. Uzupełnia on OpenAI Pixel, który zbiera zdarzenia po stronie klienta, a dzięki mechanizmowi deduplikacji oba źródła mogą działać równolegle bez podwójnego liczenia konwersji. Dla marketera oznacza to pełniejsze dane o skuteczności kampanii w ekosystemie reklamowym OpenAI oraz stabilniejszą optymalizację, gdy skrypty w przeglądarce są blokowane lub ograniczane.
Jak działa OpenAI Conversions API?
Schemat jest analogiczny do serwerowych API konwersji znanych z innych platform reklamowych. Gdy użytkownik wykona na stronie akcję o wartości biznesowej, informacja o niej trafia nie tylko do Pixela, ale także na serwer reklamodawcy (lub kontener server-side GTM), który przekazuje ją do endpointu OpenAI. Zdarzenie serwerowe zawiera nazwę akcji, znacznik czasu, wartość i walutę oraz identyfikatory pozwalające przypisać konwersję do interakcji z reklamą.
Kluczowym elementem jest deduplikacja: to samo zdarzenie wysłane przez Pixel i przez CAPI musi mieć wspólny identyfikator (event ID). Platforma rozpoznaje duplikat i zlicza konwersję tylko raz. Bez tego raporty zawyżałyby wyniki, a algorytm optymalizowałby się na błędnych danych.
| Cecha | OpenAI Pixel (przeglądarka) | OpenAI Conversions API (serwer) |
|---|---|---|
| Miejsce wywołania | Przeglądarka użytkownika | Serwer reklamodawcy / server-side GTM |
| Wrażliwość na adblocki i ITP | Wysoka | Niska |
| Zdarzenia offline (CRM, płatność po czasie) | Brak możliwości | Tak |
| Kontrola nad danymi | Ograniczona | Pełna – filtrowanie i hashowanie po stronie serwera |
| Złożoność wdrożenia | Niska | Średnia |
Jak skonfigurować OpenAI CAPI przez server-side GTM?
Najczęstszy scenariusz to wdrożenie za pośrednictwem kontenera serwerowego Google Tag Managera, który już zbiera zdarzenia dla innych systemów. Typowy przebieg prac wygląda następująco:
- Wdróż OpenAI Pixel w kontenerze webowym i upewnij się, że każde zdarzenie generuje unikalny event ID.
- Skieruj zdarzenia z warstwy danych do kontenera server-side GTM (np. przez klienta GA4 lub własny endpoint).
- W kontenerze serwerowym utwórz tag wysyłający żądanie do API OpenAI z tym samym event ID, nazwą zdarzenia, wartością oraz zahashowanymi danymi użytkownika, jeśli dokumentacja je przewiduje.
- Skonfiguruj zgody (Consent Mode) tak, aby zdarzenia trafiały do API wyłącznie przy odpowiednich zgodach użytkownika.
- Zweryfikuj w OpenAI Ads Manager, czy zdarzenia z obu źródeł są łączone, a nie dublowane.
Ponieważ produkty reklamowe OpenAI są w 2026 roku wciąż stosunkowo nowe, warto przed wdrożeniem sprawdzić aktualną specyfikację pól i limitów w oficjalnej dokumentacji – nazwy parametrów mogą się zmieniać.
Kiedy warto wdrożyć CAPI, a kiedy nie?
- Warto, gdy kampanie w kanałach OpenAI mają istotny budżet, a Pixel wyraźnie „gubi” konwersje na tle danych z systemu sprzedażowego.
- Warto, gdy konwersja zapada poza stroną – np. lead kwalifikowany w CRM lub płatność potwierdzana po kilku dniach.
- Warto, gdy firma już utrzymuje server-side GTM i dodanie kolejnego odbiorcy danych jest tanie.
- Można poczekać, gdy kampanie testowe są niewielkie, a zespół nie ma zasobów na utrzymanie infrastruktury serwerowej – w tym przypadku sam Pixel często wystarcza na start.
Najczęstsze błędy przy wdrożeniu
- Różne event ID w Pixelu i w API – deduplikacja nie działa, konwersje liczone są podwójnie.
- Wysyłanie zdarzeń z serwera bez sprawdzenia zgody użytkownika, co narusza RODO i politykę platformy.
- Brak wartości i waluty przy zdarzeniach zakupu, przez co optymalizacja pod ROAS traci sens.
- Znaczne opóźnienie zdarzeń serwerowych względem pikselowych, utrudniające ich powiązanie.
- Testowanie na produkcji bez trybu testowego – zaburzenie danych historycznych kampanii.
OpenAI Conversions API w praktyce ICBM
W ICBM traktujemy CAPI OpenAI jako kolejny „odbiorca” w już istniejącej architekturze server-side taggingu, a nie osobny projekt. Zaczynamy od audytu warstwy danych i zgód, następnie mapujemy zdarzenia biznesowe klienta na zdarzenia platformy, a dopiero potem uruchamiamy wysyłkę równoległą z Pixelem i porównujemy raporty. Więcej o tym podejściu piszemy na stronie usługi server-side tagging, a szerszy kontekst narzędzi reklamowych opartych na AI znajdziesz w kategorii AI w marketingu.
Najczęściej zadawane pytania
Czy OpenAI Conversions API zastępuje OpenAI Pixel?
Nie – oba narzędzia powinny działać równolegle. Pixel dostarcza sygnały z przeglądarki w czasie rzeczywistym, a CAPI uzupełnia je o zdarzenia, które Pixel traci przez blokady lub które zapadają poza stroną. Deduplikacja po event ID sprawia, że konwersja liczona jest tylko raz.
Czy do wdrożenia CAPI potrzebny jest server-side GTM?
Nie jest to warunek konieczny, ale w praktyce to najprostsza droga, bo kontener serwerowy już zbiera zdarzenia i pozwala dodać kolejnego odbiorcę bez zmian w kodzie strony. Alternatywą jest bezpośrednia integracja z backendu sklepu lub CRM.
Jak sprawdzić, czy deduplikacja działa poprawnie?
Porównaj liczbę konwersji w OpenAI Ads Manager z liczbą transakcji w systemie sprzedażowym za ten sam okres. Jeśli platforma raportuje wyraźnie więcej zdarzeń niż faktycznie wystąpiło, zwykle oznacza to rozjazd event ID między Pixelem a API.
