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 в sGTM. 

Как работает Twitter conversion APIСкопировать ссылку на этот раздел

АутентификацияСкопировать ссылку на этот раздел

Добавление только идентификатора пикселя Twitter или токена API недостаточно для идентификации вашего Twitter CAPI. Twitter требует дополнительной аутентификации. Этот тип аутентификации невозможно реализовать через sGTM. Поэтому пока тег Twitter CAPI работает только со stape. Не стесняйтесь изменять шаблон тега и реализовывать аутентификацию самостоятельно, если это необходимо.

Похоже, что новый Twitter CAPI еще не готов к прайм-тайму, и потребует в 5 раз больше работы, чем "стандартная" реализация CAPI, если вы уже знакомы с API FB или TikTok. Есть также некоторые другие сложности при использовании их платформы, которые усложняют ситуацию.

Вам понадобится учетная запись dev, заявка на доступ к Twitter CAPI и генерация нескольких токенов доступа. Я подробно расскажу обо всех этих шагах позже в блоге.

Дедупликация событийСкопировать ссылку на этот раздел

Twitter поддерживает дедупликацию событий. Если вы сочетаете отслеживание веб- и серверных событий, вы должны отправлять ключ дедупликации как с веб-, так и с серверными событиями. Используйте conversion_id для отправки ключа дедупликации. Дедупликация происходит только в том случае, если события были получены в течение 48 часов.

Чтобы создать событие только для сервера, следует воспользоваться менеджером событий Twitter для создания нового события и на 3-м шаге выбрать установку с помощью Conversion API.

twitter conversion API event

Параметры пользователя Twitter CAPIСкопировать ссылку на этот раздел

В отличие от других платформ, Twitter принимает только электронную почту пользователя и twclid. Когда вы отправляете письмо, оно должно быть хэшировано с помощью SHA256. Тег Twitter автоматически хэширует электронную почту пользователя.

Тестирование Twitter CAPIСкопировать ссылку на этот раздел

К сожалению, не существует способа проверить события сервера Twitter в режиме реального времени. Если отслеживание настроено правильно, вы должны увидеть, что статус "Веб-тег одиночного события" должен показать отслеживание на странице Conversion Tracking в 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 dev после создания приложения Twitter. Позже я покажу вам, как их генерировать.

Pixel ID - Идентификатор универсального тега сайта (UWT) вашей рекламной учетной записи Twitter. Чтобы найти его, зайдите в менеджер событий Twitter.

Event ID - При создании события API конверсии в менеджере событий Twitter вы найдете его.

Use HttpOnly cookies - Запрещает JavaScript обращаться к cookie, если активировано.

Server Event Data Override - выберите, чтобы переопределить один из стандартных параметров сервера: время конвертации, количество элементов, валюта, стоимость, идентификатор конвертации, описание и содержание.

User Data - добавьте данные пользователя: email или twclid.

Logs Settings - выберите, хотите ли вы использовать логи от stape.

Что нужно для настройки Twitter CAPIСкопировать ссылку на этот раздел

Ключ API контейнера StapeСкопировать ссылку на этот раздел

Аутентификация 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 для подачи заявки на dev-аккаунты, поскольку впоследствии сменить учетную запись будет невозможно.

Создайте приложение, используя раздел Project and App, когда получите учетную запись dev. После этого будут сгенерированы Consumer Key и Consumer Secret.

twitter capi api keys 

Доступ к Twitter ads CAPIСкопировать ссылку на этот раздел

Для настройки CAPI необходимо получить доступ Ads API. Укажите правильный App ID в Ads API Application. Выберите Conversion API в Ads API Application в разделе "Как вы будете использовать Ads API?".

OAuth Token и OAuth Token SecretСкопировать ссылку на этот раздел

Вы можете найти их в ad внутри аккаунта Twitter dev.

Как установить тег Twitter CAPI в 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 и скопируйте Container API Key.

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 просит отправить данные пользователя, но пока они поддерживают только email пользователя и 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 (Face-book Conversions API) становится все более популярным благодаря его способности предотвращать блокировку пикселей отслеживания со стороны ITP и AdBlockers. Еще одно значительное преимущество Facebook Conversions API заключается в том, что он увеличивает продолжительность жизни FB cookie. Если вы еще не внедрили FB Conversions API на своем сайте, следуйте этому руководству.

Отредактировано 27 мар. 2022 г.

Как настроить Facebook Conversion API + Дедупликацию событий и Хэширование информации пользователей

Facebook Pixel позволяет отслеживать, что делают пользователи на вашем сайте, собирать аудитории ремаркетинга и создавать двойни-ков. Если пиксель Facebook применяется правильно, он будет пере-давать соответствующую информацию алгоритмам машинного обу-чения FB. FB ML будет использовать данные пикселя, чтобы показы-вать ваши объявления людям, которые с наибольшей вероятностью конвертируются.

Отредактировано 21 мар. 2024 г.

Как настроить Google Tag Manager Server Container

Сбор данных о посетителях вашего сайта имеет решающее значение для анализа и улучшения развертывания бизнеса в Интернете, привлечения пользователей и преобразования их в клиентов. Однако сбор данных становится все более проблематичным из-за Intelligent Tracking Prevention, AdBlockers и сокращения срока службы cookie. Google Analytics и другие подобные инструменты начинают видеть меньше данных о посетителях вашего сайта и предоставляют меньше информации для анализа.

Хостите свой сервер GTM на Stape