Интеграция с рекламна платформа

Конверсии в X, изпращани от вашия сървър

ROASaurus изпраща покупки, добавяния в количката, започвания на плащане и прегледи на страници към крайната точка за конверсии на X Ads API. В ROASaurus няма пиксел в браузъра за X: той получава само сървърни събития.

X (Twitter) накратко
ВръзкаУеб конверсии на X Ads API, подписани с OAuth 1.0a
СъбитияПокупка (задължителна), добавяне в количката, започнато плащане, преглед на страница — всяко като ID на събитие от Events Manager
Идентификаториtwclid, хеширан имейл, хеширан телефон (E.164); IP и user agent само заедно с един от тях
Данни за достъпID на пиксела, API ключ и secret, токен за достъп и secret
Пиксел в браузъраНе, само сървърни събития
Синхронизиране на разходитеДа: разходи, импресии и кликове по кампании за всеки ден, след като свържете рекламния акаунт в Setup › Ad spend

Какво изпраща ROASaurus към X

X няма стандартни имена на събития. Всеки тип събитие е ID на събитие, което създавате в X Events Manager, например tw-o1abc-o1def, и поставяте в ROASaurus. ID на събитието за покупка е задължително. Добавянето в количката, започнатото плащане и прегледът на страница са по избор; тип събитие без ID не се изпраща. Прегледите на продукти не се изпращат към X.

Всяка конверсия изброява идентификатори: click ID twclid, имейлът, хеширан със SHA-256, и телефонът във формат E.164, хеширан. IP адресът и user agent се добавят само заедно с един от тях, защото X ги отчита само в комбинация. ROASaurus изпраща още ID на конверсията, стойност, валута, брой артикули и продуктите. Конверсия без twclid, имейл или телефон се пропуска.

ROASaurus счита изпращането за извършено само когато X отчете поне една обработена конверсия.

Как да свържете

  1. Създайте приложение за разработчици в X с достъп до Ads API.
  2. Генерирайте потребителски токени OAuth 1.0a за потребител с достъп Ad Manager до рекламния акаунт: нуждаете се от API ключа и secret, както и от токена за достъп и secret.
  3. В X Events Manager създайте събитие за всеки тип, който искате, и копирайте ID на събитията.
  4. В ROASaurus отидете на Tracking & platforms, щракнете върху Add pixel в картата на X и въведете ID на пиксела, ID на събитията и четирите ключа.

Ограничения

  • Няма пиксел в браузъра: X получава само сървърни събития.
  • Разходите по кампании в X се синхронизират, след като свържете рекламния акаунт в Setup › Ad spend.
  • Само twclid не създава точка на контакт за атрибуция. Маркирайте рекламите си в X с UTM параметри, за да се показват посещенията в атрибуцията по източник и кампания.

Свързани

ЧЗВ

Въпроси и отговори

Защо X изисква четири ключа?

X Ads API изисква OAuth 1.0a за персонализирани интеграции. Всяка заявка се подписва с API ключа и secret на вашето приложение и с токена за достъп и secret на потребител, който може да управлява рекламния акаунт.

Зарежда ли ROASaurus пиксела на X?

Не. X получава само сървърни събития. Конверсиите се съпоставят по click ID twclid или по хешираните имейл или телефон на купувача.

Кои събития мога да изпращам към X?

Покупка, добавяне в количката, започнато плащане и преглед на страница. Създайте всяко в X Events Manager и поставете неговото ID на събитието. Задължителна е само покупката.

Всяка продажба, проследена до рекламата, която я е донесла

Проследяване от страна на сървъра, печалба и пожизнена стойност на клиента в едно приложение. 14-дневен безплатен пробен период, без кредитна карта.

Започнете безплатния си пробен период →