Twitter Conversion API дозволяє надсилати інформацію з вашого сервера безпосередньо на сервери Twitter, які можна використовувати для вимірювання успіху кампанії.
Завдяки Twitter CAPI відстеження є більш безпечним і точним. Як і Facebook, Twitter дозволяє та рекомендує використовувати гібридний метод відстеження веб+сервер. При поєднанні веб-відстеження та серверне відстеження необхідна дедуплікація. Щоб зіставити користувачів у подіях із профілями Twitter, вони використовують дані клієнтів: електронну пошту та twclid.
У цьому гайді я розповім про те, як працює Twitter conversion API і як налаштувати тег Twitter CAPI в серверному GTM.
Додавання лише Twitter pixel ID чи API token недостатньо для ідентифікації вашого Twitter CAPI. Twitter вимагає додаткової автентифікації. Цей тип автентифікації неможливо реалізувати через sGTM. Тому поки тег Twitter CAPI працює тільки зі stape. Не соромтеся змінювати шаблон тегів і за потреби самостійно здійснювати автентифікацію.
Схоже, новий Twitter CAPI ще не готовий до використання, і потребуватиме в 5 разів більше роботи, ніж «стандартне» впровадження CAPI, якщо ви вже знайомі з FB або API TikTok. Існують також деякі інші ускладнення під час використання їхньої платформи, що ускладнює роботу.
Вам знадобиться обліковий запис розробника, подайте заявку на доступ до Twitter CAPI та згенеруйте кілька маркерів доступу (access tokens). Я детально розповім про всі ці кроки пізніше в публікації в блозі.
Twitter підтримує дедуплікацію подій. Якщо ви поєднуєте веб-відстеження та серверне відстеження, ви повинні надіслати ключ дедуплікації як з веб-подіями, так і з серверними подіями. Використовуйте conversion_id, щоб надіслати ключ дедуплікації. Дедуплікація відбувається, лише якщо події були отримані протягом 48 годин.
Щоб створити подію лише для сервера, вам слід використати менеджер подій Twitter, щоб створити нову подію та вибрати встановлення за допомогою Conversion API на третьому кроці.
На відміну від інших платформ, Twitter приймає лише електронну пошту користувача та twclid. Коли ви надсилаєте електронний лист, його слід хешувати за допомогою SHA256. Тег Twitter автоматично хешує електронну пошту користувача.
На жаль, немає способу перевірити події сервера Twitter у реальному часі. Якщо відстеження налаштовано правильно, ви повинні побачити статус «Веб-тег однієї події» має відображати відстеження під час відстеження конверсій в Ads Manager протягом 12–24 годин.
Stape Container API Key - знайдіть його в налаштуваннях контейнера sGTM у вашому обліковому записі stape.
Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret - ви можете знайти його у своєму обліковому записі розробника Twitter після того, як ви створите додаток Twitter. Пізніше я покажу вам, як їх створити.
Pixel ID - Ідентифікатор універсального веб-тегу (Universal Website Tag - UWT) вашого рекламного облікового запису Twitter. Щоб знайти його, перейдіть до менеджера подій Twitter.
Event ID - Створюючи подію conversion API в менеджері подій Twitter, ви знайдете її.
Use HttpOnly cookies - Забороняє доступ JavaScript до файлів cookie, якщо ввімкнено.
Server Event Data Override - виберіть, щоб змінити один із стандартних параметрів сервера: час перетворення, кількість елементів, валюту, вартість, ідентифікатор перетворення, опис і вміст.
User Data - додайте дані користувача: email або twclid.
Logs Settings - виберіть, чи бажаєте ви використовувати логи від stape.
Автентифікація Twitter Conversion API є складним процесом; наразі автентифікація Twitter CAPI не може бути повністю функціональною на sGTM. Тому ми виконуємо автентифікацію всередині. Це означає, що для тегу Twitter CAPI потрібен хостинг Stape. Якщо в майбутньому для автентифікації можна буде використовувати лише sGTM, ми оновимо цей тег для підтримки будь-якого хостингу. Ключ API контейнера sGTM можна знайти в налаштуваннях контейнера.
Ці два ключі можна згенерувати, лише якщо у вас є обліковий запис розробника Twitter. Щоб отримати обліковий запис розробника Twitter, вам потрібно подати заявку на нього та почекати приблизно 1-3 дні, поки вашу заявку буде схвалено.
Під час подання заявки вам потрібно надіслати запит на Essential Access. Переконайтеся, що ви використовуєте правильний обліковий запис Twitter, щоб подати заявку на облікові записи розробників, оскільки пізніше неможливо змінити облікові записи.
Створіть програму за допомогою розділу «Проект і програма», коли ви отримаєте обліковий запис розробника. Після цього буде згенеровано ключ споживача та секрет споживача.
Щоб налаштувати CAPI, потрібно отримати доступ до ads API. Включіть правильний ідентифікатор програми в програму Ads API. Виберіть Conversion API у програмі Ads API у розділі «Як ви будете використовувати Ads API?»
Ви можете знайти їх у своїй рекламі в обліковому записі розробника Twitter.
Теги Twitter CAPI працюють, лише якщо ви використовуєте сервери stape для контейнерів sGTM
2. Надішліть дані до sGTM. Ви можете використовувати GA4, Webhooks або Data Tag/Data Client.
3. Завантажте тег Twitter Conversion API з GitHub. Відкрийте розділ шаблону sGTM -> натисніть три крапки у верхньому правому куті -> натисніть імпортувати -> завантажте тег, який ви нещодавно завантажили з GitHub, і натисніть «Зберегти».
4. Створіть новий тег і виберіть Twitter Tag. Додайте ключ API контейнера Stape. Для цього відкрийте налаштування контейнера sGTM і скопіюйте ключ API контейнера.
5. Додайте Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret. Я описав, як генерувати ці значення тут.
6. Додайте ідентифікатор пікселя Twitter та ідентифікатор події. Ви можете знайти ці значення в менеджері подій Twitter.
7. Додайте подію та дані користувача, які ви хочете надіслати в Twitter. І налаштуйте тригер.
8. На жаль, немає можливості перевірити Twitter CAPI в реальному часі. Після налаштування скористайтеся менеджером подій Twitter, щоб перевірити, чи надсилалися події Twitter CAPI.
Twitter CAPI може стати чудовим доповненням до стеку відстеження на стороні сервера. Хоча процес авторизації для Twitter CAPI зараз неймовірно складний, інша логіка працює дуже подібно до API конверсій FB або TikTok: ви можете надсилати спеціальні або стандартні події та використовувати лише відстеження веб+сервер або сервер. Щоб зіставити користувачів, Twitter просить надіслати дані користувачів, але наразі вони підтримують лише електронну пошту користувача та twclid.
Існує два головних недоліки Twitter CAPI: процес автентифікації та відсутність інструменту тестування в реальному часі. Через процес перевірки тег Twitter працює лише з серверами stape для sGTM. Якщо Twitter спростить процес автентифікації, команда stape оновить тег для роботи з GCP.
Сподіваюся, цей гайд допоможе вам ближче ознайомитись із Twitter CAPI та налаштувати Twitter CAPI у sGTM. Щоб дізнатися більше про Twitter CAPI, перегляньте офіційну документацію. Якщо вам потрібна допомога з налаштування Twitter CAPI, зв’яжіться з нами!
Все, що потрібно, це кілька простих запитань. Натисніть Отримати допомогу, заповніть форму, і ми надішлемо вам пропозицію.
