Конверсии X с вашего сервера
ROASaurus отправляет покупки, добавления в корзину, оформления заказа и просмотры страниц на эндпоинт конверсий X Ads API. Браузерного пикселя для X в ROASaurus нет: он получает только серверные события.
| X (Twitter): коротко | |
|---|---|
| Подключение | Веб-конверсии X Ads API с подписью OAuth 1.0a |
| События | Purchase (обязательно), add to cart, checkout initiated, page view — каждое как id события из Events Manager |
| Идентификаторы | twclid, хешированный email, хешированный телефон (E.164); IP и user agent только вместе с одним из них |
| Учётные данные | Pixel ID, API key и secret, access token и secret |
| Браузерный пиксель | Нет, только серверные события |
| Синхронизация расходов | Да: расходы по кампаниям, показы и клики по дням после подключения рекламного аккаунта в разделе Setup › Ad spend |
Что ROASaurus отправляет в X
В X нет стандартных названий событий. Каждый тип события — это id события, который вы создаёте в X Events Manager, например tw-o1abc-o1def, и вставляете в ROASaurus. Id события покупки обязателен. Добавление в корзину, начало оформления заказа и просмотр страницы необязательны; тип события без id не отправляется. Просмотры товаров в X не отправляются.
Каждая конверсия содержит идентификаторы: click id twclid, email, хешированный по SHA-256, и телефон в формате E.164, тоже хешированный. IP-адрес и user agent добавляются только вместе с одним из них, потому что X учитывает их лишь в сочетании. ROASaurus также отправляет id конверсии, сумму, валюту, количество товаров и сами товары. Конверсия без twclid, email и телефона пропускается.
ROASaurus считает отправку выполненной, только если X сообщает хотя бы об одной обработанной конверсии.
Как подключить
- Получите приложение разработчика X с доступом к Ads API.
- Создайте пользовательские токены OAuth 1.0a для пользователя с доступом Ad Manager к рекламному аккаунту: нужны API key и secret, а также access token и secret.
- В X Events Manager создайте по событию на каждый нужный тип и скопируйте id событий.
- В ROASaurus откройте Tracking & platforms, нажмите Add pixel на карточке X и введите Pixel ID, id событий и четыре ключа.
Ограничения
- Браузерного пикселя нет: X получает только серверные события.
- Расходы по кампаниям X синхронизируются после подключения рекламного аккаунта в разделе Setup › Ad spend.
- Один только twclid не создаёт касание в атрибуции. Размечайте рекламу в X параметрами UTM, чтобы визиты попадали в атрибуцию по источнику и кампании.
Читайте также
Ответы на вопросы
Почему X требует четыре ключа?
X Ads API требует OAuth 1.0a для собственных интеграций. Каждый запрос подписывается API key и secret вашего приложения, а также access token и secret пользователя, который может управлять рекламным аккаунтом.
Загружает ли ROASaurus пиксель X?
Нет. X получает только серверные события. Конверсии сопоставляются по click id twclid или по хешированному email или телефону покупателя.
Какие события X можно отправлять?
Purchase, add to cart, checkout initiated и page view. Создайте каждое в X Events Manager и вставьте его id события. Обязательно только purchase.
Каждая продажа прослежена до рекламы, которая её принесла
Серверный трекинг, прибыль и пожизненная ценность клиента в одном приложении. 14 дней бесплатно, без банковской карты.
Начать бесплатный пробный период →