Twitter conversion API tag для sGTM

Twitter Conversion API дозволяє надсилати інформацію з вашого сервера безпосередньо на сервери Twitter, що можна використовувати для оцінки успішності кампаній.

Завдяки Twitter CAPI ви робите відстеження більш безпечним і точним. Як і Facebook, Twitter дозволяє та рекомендує використовувати гібридний метод відстеження: веб+сервер. Під час об'єднання веб- та серверного відстеження необхідна дедуплікація. Для зіставлення користувачів у подіях з профілями Twitter використовуються дані клієнта: електронна пошта та twclid.

Ця стаття розповість, як працює Twitter Conversion API та як налаштувати тег Twitter CAPI у sGTM.

Щоб ідентифікувати ваш Twitter CAPI, вам потрібно більше, ніж просто ідентифікатор пікселя Twitter або токен API. Twitter вимагає додаткової аутентифікації, яку неможливо реалізувати через sGTM. Тому наразі тег Twitter CAPI працює лише з Stape. Ви можете змінити шаблон тега та реалізувати аутентифікацію самостійно, якщо це потрібно.

Новий Twitter CAPI ще не повністю оптимізований і потребуватиме в п’ять разів більше зусиль у порівнянні зі «стандартною» реалізацією CAPI, якщо ви вже знайомі з API від FB або TikTok. Крім того, є інші складнощі під час використання цієї платформи.

Вам потрібен обліковий запис розробника, доступ до Twitter CAPI та кілька токенів доступу. Ми детальніше розглянемо всі ці етапи в наступному пості блогу.

Щоб отримати доступ до Ads API, зв’яжіться з представником Twitter.

Існуючі програми Ads API

Якщо у вас є активна програма Ads API, ви можете використовувати її та токени доступу для Conversion API.

Токени доступу

• Персональні токени: створіть ці токени для вашого облікового запису Twitter у порталі розробника.
• Токени інших користувачів: використовуйте трирівневий потік OAuth:

- Командний рядок з авторизацією через веб (twurl)

- Командний рядок з авторизацією за PIN-кодом

- Користувацький веб-потік

Токени для Conversion API повинні належати користувачам з доступом AD_MANAGER або ACCOUNT_ADMIN, що можна перевірити через endpoint authenticated_user_access.

Примітка: Ви можете надати токени користувачам без доступу AD_MANAGER або ACCOUNT_ADMIN.

Аутентифікація Twitter Conversion API є складним процесом; наразі аутентифікація Twitter CAPI не може бути повністю реалізована через sGTM. Тому ми обробляємо аутентифікацію внутрішньо. Це означає, що тег Twitter CAPI вимагає хостингу від Stape. Якщо ми зможемо використовувати тільки sGTM для аутентифікації, ми оновимо цей тег для підтримки будь-якого хостингу. Ви можете знайти ключ API контейнера sGTM у налаштуваннях контейнера.

Ці два ключі можна згенерувати тільки, якщо у вас є обліковий запис розробника Twitter. Щоб отримати обліковий запис розробника Twitter, необхідно подати заявку і чекати схвалення протягом 1-3 днів.

При подачі заявки необхідно запросити Essential Access. Переконайтеся, що ви використовуєте правильний обліковий запис Twitter для подачі заявки, оскільки змінити його пізніше неможливо.

Створіть додаток, використовуючи розділ Project and App після отримання облікового запису розробника. Буде згенеровано Consumer Key та Consumer Secret.

Ці два токени ви можете знайти в рекламному кабінеті у вашому обліковому записі розробника Twitter.

1. Створіть та налаштуйте контейнер Google Tag Manager на стороні сервері.

Важливо: Тег Twitter CAPI працює тільки у випадку, якщо ви використовуєте хостинг Stape для контейнерів sGTM.

2. Надішліть дані з веб на сервер GTM. Ви можете налаштувати серверний GA4, Webhooks або Data Tag/Data Client.

3. Завантажте тег Twitter Conversion API з Template Gallery.

4. Створіть новий тег та оберіть Twitter Tag. Щоб додати Ключ API контейнера Stape, відкрийте налаштування контейнера sGTM та скопіюйте Ключ API контейнера.

5. Додайте Consumer Key, Consumer Secret, OAuth Token та OAuth Token Secret. Я описав, як згенерувати ці значення тут.

6. Додайте Twitter Pixel ID і Event ID. Ви можете знайти ці значення у Twitter Events Manager.

7. Додайте дані Server Event Data Override та User Data, які ви хочете надіслати у Twitter, та налаштуйте тригер.

Параметри тега Twitter CAPI:

Ключ API контейнера Stape - знайдіть його у налаштуваннях контейнера sGTM у вашому обліковому записі Stape.

Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret - ви можете знайти їх у вашому обліковому записі розробника Twitter після створення додатку Twitter.

Pixel ID - це Universal Website Tag (UWT) ID вашого рекламного облікового запису Twitter. Щоб знайти його, перейдіть до Twitter Events Manager.

Event ID - при створенні події API конверсії у Twitter Events Manager, ви знайдете його.

Use HttpOnly cookies - забороняє JavaScript доступ до cookies, якщо увімкнено.

Server Event Data Override - виберіть для перевизначення одного зі стандартних серверних параметрів: час конверсії, кількість елементів, валюта, значення, ID конверсії, опис і вміст.

User Data - додайте дані користувача: email або twclid.

Logs Settings - виберіть, якщо хочете використовувати логи Stape.

9. Тестування подій. Коли ваша подія успішно отримає події конверсії протягом 12-24 годин, статус тега ‘Single event web tag’ повинен показувати ВІДСТЕЖЕННЯ на сторінці Відстеження Конверсій у Ads Manager. Це не вплине на запущені кампанії, які надсилають конверсії через Conversion API.

Twitter підтримує дедуплікацію подій. Комбінування веб- та серверного відстеження вимагає надсилання ключа дедуплікації з обома веб- і серверними подіями. Використовуйте conversion_id для надсилання ключа дедуплікації. Дедуплікація відбувається тільки у випадку, якщо події були отримані протягом 48 годин.

Щоб створити подію тільки на сервері, використовуйте Twitter Events Manager для створення нової події та виберіть Встановити з API конверсії на третьому кроці.

На відміну від інших платформ, Twitter приймає лише email користувача та twclid. Коли ви надсилаєте email, він має бути зашифрований за допомогою SHA256. Тег Twitter автоматично шифрує email користувача.

На жаль, немає можливості тестувати серверні події Twitter в режимі реального часу. Якщо відстеження налаштовано правильно, ви побачите статус тега ‘Single event web tag’, що показує відстеження на сторінці Відстеження Конверсії у Ads Manager протягом 12-24 годин.

Twitter CAPI може бути чудовим доповненням до вашої системи серверного відстеження. Хоча процес авторизації для Twitter CAPI наразі неймовірно складний, інша логіка працює дуже схоже на APIs конверсій від Facebook або TikTok: ви можете надсилати користувацькі або стандартні події та використовувати комбінацію веб- і серверного відстеження або тільки серверне відстеження. Twitter запитує дані користувача для зіставлення користувачів, але наразі підтримує тільки електронну пошту та twclid.

У Twitter CAPI є два основних недоліки: процес аутентифікації та відсутність інструменту для тестування в реальному часі. Через процес перевірки тег Twitter працює лише з серверами Stape для sGTM. Якщо Twitter спростить процес авторизації, команда Stape оновить тег для роботи з GCP.

Цей посібник допоможе вам ознайомитися з Twitter CAPI та налаштувати його в sGTM. Для отримання більш детальної інформації про Twitter CAPI перегляньте офіційну документацію.