Integracja z platformą reklamową

Konwersje X, wysyłane z twojego serwera

ROASaurus wysyła zakupy, dodania do koszyka, checkouty i wyświetlenia stron do endpointu konwersji X Ads API. W ROASaurus nie ma piksela przeglądarkowego dla X: otrzymuje on wyłącznie zdarzenia serwerowe.

X (Twitter) w skrócie
PołączenieKonwersje webowe X Ads API, podpisywane OAuth 1.0a
ZdarzeniaPurchase (wymagane), add to cart, checkout initiated, page view, każde jako event id z Events Managera
Identyfikatorytwclid, zahashowany e-mail, zahashowany telefon (E.164); IP i user agent tylko razem z jednym z nich
Dane dostępowePixel ID, klucz API i secret, token dostępu i secret
Piksel w przeglądarceNie, tylko zdarzenia serwerowe
Synchronizacja wydatkówTak: dzienne wydatki kampanii, wyświetlenia i kliknięcia po połączeniu konta reklamowego w Setup › Ad spend

Co ROASaurus wysyła do X

X nie ma standardowych nazw zdarzeń. Każdy typ zdarzenia to event id, który tworzysz w X Events Manager, na przykład tw-o1abc-o1def, i wklejasz do ROASaurus. Event id zakupu jest wymagany. Add to cart, checkout initiated i page view są opcjonalne; typ zdarzenia bez id nie jest wysyłany. Wyświetlenia produktów nie są wysyłane do X.

Każda konwersja zawiera identyfikatory: click id twclid, e-mail zahashowany SHA-256 oraz telefon w formacie E.164, również zahashowany. Adres IP i user agent są dodawane tylko razem z jednym z nich, bo X uwzględnia je wyłącznie w połączeniu. ROASaurus wysyła też id konwersji, wartość, walutę, liczbę pozycji i produkty. Konwersja bez twclid, e-maila i telefonu jest pomijana.

ROASaurus uznaje dostarczenie za wysłane dopiero wtedy, gdy X zgłosi co najmniej jedną przetworzoną konwersję.

Jak połączyć

  1. Uzyskaj aplikację deweloperską X z dostępem do Ads API.
  2. Wygeneruj tokeny użytkownika OAuth 1.0a dla użytkownika z dostępem Ad Manager do konta reklamowego: potrzebujesz klucza API i secret oraz tokena dostępu i secret.
  3. W X Events Manager utwórz zdarzenie dla każdego potrzebnego typu i skopiuj event id.
  4. W ROASaurus przejdź do Tracking & platforms, kliknij Add pixel na karcie X i wpisz Pixel ID, event id oraz cztery klucze.

Ograniczenia

  • Brak piksela w przeglądarce: X otrzymuje wyłącznie zdarzenia serwerowe.
  • Wydatki kampanii X synchronizują się po połączeniu konta reklamowego w Setup › Ad spend.
  • Samo twclid nie tworzy punktu styku w atrybucji. Oznacz reklamy X parametrami UTM, aby wizyty pojawiały się w atrybucji według źródła i kampanii.

Powiązane

FAQ

Pytania i odpowiedzi

Dlaczego X wymaga czterech kluczy?

X Ads API wymaga OAuth 1.0a w integracjach niestandardowych. Każde żądanie jest podpisywane kluczem API i secret twojej aplikacji oraz tokenem dostępu i secret użytkownika, który może zarządzać kontem reklamowym.

Czy ROASaurus ładuje piksel X?

Nie. X otrzymuje wyłącznie zdarzenia serwerowe. Konwersje są dopasowywane po click id twclid albo zahashowanym e-mailu lub telefonie kupującego.

Jakie zdarzenia X mogę wysyłać?

Purchase, add to cart, checkout initiated i page view. Utwórz każde w X Events Manager i wklej jego event id. Wymagany jest tylko purchase.

Każda sprzedaż przypisana do reklamy, która ją przyniosła

Server-side tracking, zysk i wartość życiowa klienta w jednej aplikacji. 14-dniowy darmowy okres próbny, bez karty kredytowej.

Zacznij darmowy okres próbny →