Stape

Twitter conversion API tag для sGTM

Відредаговано
26 серп. 2022 р.
Опубліковано
20 серп. 2022 р.
Також є

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

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

У цьому гайді я розповім про те, як працює Twitter conversion API і як налаштувати тег Twitter CAPI в серверному GTM.

Як працює Twitter conversion APIСкопіюйте посилання на цей розділ

АвтентифікаціяСкопіюйте посилання на цей розділ

Додавання лише 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 conversion API event

Параметри користувача Twitter CAPIСкопіюйте посилання на цей розділ

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

Тестування Twitter CAPIСкопіюйте посилання на цей розділ

На жаль, немає способу перевірити події сервера Twitter у реальному часі. Якщо відстеження налаштовано правильно, ви повинні побачити статус «Веб-тег однієї події» має відображати відстеження під час відстеження конверсій в Ads Manager протягом 12–24 годин.

Параметри тегу Twitter CAPIСкопіюйте посилання на цей розділ

twitter conversion API tag for sGTM

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 CAPIСкопіюйте посилання на цей розділ

Stape container API keyСкопіюйте посилання на цей розділ

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

stape container API key

Consumer Key та Consumer Secret.Скопіюйте посилання на цей розділ

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

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

Створіть програму за допомогою розділу «Проект і програма», коли ви отримаєте обліковий запис розробника. Після цього буде згенеровано ключ споживача та секрет споживача.

twitter capi api keys 

Twitter ads CAPI доступ.Скопіюйте посилання на цей розділ

Щоб налаштувати CAPI, потрібно отримати доступ до ads API. Включіть правильний ідентифікатор програми в програму Ads API. Виберіть Conversion API у програмі Ads API у розділі «Як ви будете використовувати Ads API?»

OAuth Token та OAuth Token Secret.Скопіюйте посилання на цей розділ

Ви можете знайти їх у своїй рекламі в обліковому записі розробника Twitter.

Як налаштувати тег CAPI Twitter у sGTMСкопіюйте посилання на цей розділ

!

Теги Twitter CAPI працюють, лише якщо ви використовуєте сервери stape для контейнерів sGTM

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

3. Завантажте тег Twitter Conversion API з GitHub. Відкрийте розділ шаблону sGTM -> натисніть три крапки у верхньому правому куті -> натисніть імпортувати -> завантажте тег, який ви нещодавно завантажили з GitHub, і натисніть «Зберегти».

import twitter CAPI tag

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

contaniner API key stape

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

6. Додайте ідентифікатор пікселя Twitter та ідентифікатор події. Ви можете знайти ці значення в менеджері подій Twitter.

7. Додайте подію та дані користувача, які ви хочете надіслати в Twitter. І налаштуйте тригер.

twitter CAPI tag

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, зв’яжіться з нами!

Потрібна допомога з налаштування відстеження на стороні сервера?

Все, що потрібно, це кілька простих запитань. Натисніть Отримати допомогу, заповніть форму, і ми надішлемо вам пропозицію.

Отримати допомогу
Теги:sGTM tag

Схожі пости

Відредаговано 29 лют. 2024 р.

Як налаштувати дедуплікацію подій Facebook у Google Tag Manager

Використання відстеження на стороні сервера Facebook (Facebook Conversions API) стає все популярнішим через його здатність запобігати блокування пікселів відстеження ITP і AdBlockers. Ще одна величезна перевага Facebook conversion API полягає в тому, що він збільшує тривалість життя файлів cookie FB. Якщо ви ще не впровадили FB Conversions API на своєму сайті, дотримуйтесь цього гайду. У цій статті я опишу, як налаштувати дедуплікацію подій Facebook, якщо ви використовуєте як браузер, так і методи відстеження на сервері для свого сайту.

Відредаговано 27 берез. 2022 р.

Як налаштувати Facebook Conversion API + дедуплікацію подій і хешування даних користувача

Facebook Pixel дозволяє відстежувати, що користувачі роблять на вашому сайті, збирати аудиторії ремаркетингу та створювати схоже. Якщо піксель Facebook реалізований правильно, він подасть відповідну інформацію в алгоритми машинного навчання (machine learning algorithms) FB. FB ML використовуватиме піксельні дані, щоб показувати ваші оголошення людям, які найімовірніше здійснить конверсію.

Відредаговано 21 берез. 2024 р.

Як налаштувати серверний контейнер в Google Tag Manager

Збір даних про відвідувачів вашого веб-сайту має вирішальне значення для аналізу та покращення присутності бізнесу в Інтернеті, охоплення користувачів і перетворення їх у клієнтів. Однак збір даних стає все більш проблематичним через інтелектуальне запобігання відстеження, блокування реклами та скорочення терміну служби файлів cookie. Google Analytics та інші подібні інструменти почнуть бачити менше даних про відвідувачів вашого веб-сайту та надаватимуть менше інформації для аналізу.

Розмістіть свій сервер GTM на Stape