OpenAI Conversions API (API konwersji) w WooCommerce

W przeglądarce Measurement Pixel wysyła wyświetlenia produktów, dodania do koszyka, rozpoczęcia zamówienia i zakup. Gdy WooCommerce potwierdzi opłacenie zamówienia, zakup jest dodatkowo wysyłany z Twojego serwera przez OpenAI Conversions API (API konwersji) z tym samym event ID, dzięki czemu OpenAI może policzyć go raz.

Measurement Pixel działa w przeglądarce klienta. Tylko tam widać wyświetlenia produktów i aktywność w koszyku, ale to oznacza też, że zdarzenie przepada za każdym razem, gdy strona się nie załaduje albo skrypt nie wykona się do końca:

• Blokery treści lub narzędzia prywatności nie pozwalają załadować skryptu piksela.
• Klient zamyka kartę po zapłacie, zanim załaduje się strona „Zamówienie otrzymane”.
• Płatność zostaje potwierdzona później – przelew tradycyjny, niektóre bramki z przekierowaniem – gdy klienta nie ma już w sklepie.
• Przy wolnym lub nieudanym ładowaniu strony żądanie się gubi.

W każdym z tych przypadków WooCommerce i tak zapisuje zamówienie. Zdarzenie zakupu po stronie serwera wychodzi od tego zamówienia, więc żadna z tych sytuacji nie blokuje jego wysłania.

Twój serwer wysyła do OpenAI uwierzytelnione żądanie HTTPS z jednym lub kilkoma zdarzeniami. Żądanie jest adresowane Twoim Pixel ID i autoryzowane kluczem Conversions API – oba generujesz w zakładce konwersji w Ads Manager (dokumentacja OpenAI Conversions API; dokumentacja OpenAI jest dostępna po angielsku).

Wysyłaj go, gdy WooCommerce zmieni status zamówienia na opłacone – a nie wtedy, gdy wyświetli się strona „Zamówienie otrzymane”. Powiązanie zdarzenia ze statusem zamówienia, a nie z odsłoną strony, oznacza, że:

• Zdarzenie wysyła się raz na zamówienie, niezależnie od tego, ile razy ktoś odświeży stronę podziękowania.
• Metody płatności z opóźnionym potwierdzeniem wysyłają zakup dopiero wtedy, gdy płatność zostanie faktycznie potwierdzona.
• Zamówienia nieopłacone, nieudane lub porzucone nie są raportowane jako zakupy.

1. Zamówienie złożone

   WooCommerce tworzy zamówienie

2. Płatność potwierdzona

   Zamówienie osiąga status opłaconego

3. Zakup wysłany

   order_created z Twojego serwera

4. Wynik zapisany

   Przyjęty, ponawiany lub nieudany

Jeśli zakup jest wysyłany z przeglądarki i z serwera, OpenAI musi wiedzieć, że to jeden zakup. Według dokumentacji OpenAI do deduplikacji służą Pixel ID, nazwa zdarzenia (event_name) i identyfikator (id): liczy się pierwsze zdarzenie otrzymane dla pasującego klucza, a późniejsze duplikaty są pomijane.

Dlatego event ID musi być identyczny na obu ścieżkach. W WooCommerce najpewniej jest wyliczyć go z zamówienia, które znają zarówno strona „Zamówienie otrzymane”, jak i serwer, zamiast generować w przeglądarce losowy identyfikator, którego serwer nigdy nie zobaczy. Poradnik „Piksel czy Conversions API” pokazuje, jak obie ścieżki się uzupełniają.

OpenAI odrzuca zdarzenia spoza okna czasowego: znacznik czasu musi mieścić się w ostatnich 7 dniach i nie może wybiegać więcej niż 10 minut w przyszłość. Dla sklepu wynikają z tego dwie rzeczy:

• Wysyłaj pierwotny czas zakupu, a nie czas próby wysyłki – inaczej ponowione zdarzenie wskaże późniejszy czas zakupu niż rzeczywisty.
• Szybko naprawiaj nieudane wysyłki. Zamówienia, którego czas zakupu jest starszy niż 7 dni, nie da się już wysłać.

API przyjmuje też paczki do 1000 zdarzeń, a według dokumentacji błąd jednego zdarzenia w paczce powoduje odrzucenie całej paczki – jedno wadliwe zamówienie może więc zablokować inne, jeśli wdrożenie grupuje zdarzenia nieostrożnie.

Dokumentacja OpenAI zaleca używanie tego samego ID przy ponawianiu wysyłki lub przy wysyłaniu tej samej konwersji przez inną integrację. Nie publikuje harmonogramu ponowień, więc zasady zależą od wdrożenia. Rozsądne podejście rozróżnia:

Niezależnie od przyjętych zasad błąd musi być gdzieś widoczny. Bez zapisu dla każdego zamówienia zepsuta integracja wygląda dokładnie jak spokojny tydzień sprzedaży.

Wysyłka z serwera nie jest sposobem na obejście zgód. Sam piksel nie wysyła pingów pomiarowych, gdy zgoda ma wartość false (dokumentacja Measurement Pixel), a zakup wysyłany z serwera powinien respektować stan zgody zapisany dla danego zamówienia. W WordPressie baner zgód najczęściej przekazuje ten stan innym wtyczkom przez WordPress Consent API.

Pixel for ChatGPT Ads to wtyczka WooCommerce, która z serwera wysyła wyłącznie zakup. Oto, jak obsługuje każdy z powyższych punktów:

Powiększ zrzut ekranu

Zamknij

Wyświetlenia produktów, dodania do koszyka i rozpoczęcia zamówienia pozostają zdarzeniami z przeglądarki. Strona Piksel ChatGPT Ads dla WooCommerce wymienia każde zdarzenie i miejsce, z którego jest wysyłane.