Twitter conversion API tag для sGTM

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

С помощью Twitter CAPI вы делаете отслеживание более безопасным и точным. Как и Facebook, Twitter позволяет и рекомендует использовать гибридный метод отслеживания, веб+сервер. При комбинировании веб- и серверного отслеживания требуется дедупликация. Для сопоставления пользователей в событиях с профилями Twitter использует данные клиентов: электронную почту и twclid.

В этом руководстве я расскажу о том, как работает Twitter conversion API и как настроить тег Twitter CAPI в sGTM. 

Добавление только идентификатора пикселя 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 принимает только электронную почту пользователя и twclid. Когда вы отправляете письмо, оно должно быть хэшировано с помощью SHA256. Тег Twitter автоматически хэширует электронную почту пользователя.

К сожалению, не существует способа проверить события сервера Twitter в режиме реального времени. Если отслеживание настроено правильно, вы должны увидеть, что статус "Веб-тег одиночного события" должен показать отслеживание на странице Conversion Tracking в Ads Manager в течение 12-24 часов.

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 Conversion API - сложный процесс; на данный момент аутентификация Twitter CAPI не может быть полностью функциональной на sGTM. Поэтому мы обрабатываем аутентификацию внутри компании. Это означает, что тег Twitter CAPI требует хостинга Stape. Если в будущем появится возможность использовать для аутентификации только sGTM, мы обновим этот тег для поддержки любого хостинга. API-ключ контейнера sGTM можно найти в настройках контейнера. 

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

При подаче заявки необходимо запросить Essential Access. Обязательно используйте правильную учетную запись Twitter для подачи заявки на dev-аккаунты, поскольку впоследствии сменить учетную запись будет невозможно.

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

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

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

1. Создайте и настройте серверный контейнер Google Tag Manager. 

2. Отправьте данные в sGTM. Вы можете настроить GA4 на стороне сервера, Webhooks или Data Tag/Data Client.

3. Загрузите тег Twitter Conversion API с GitHub. Откройте раздел шаблонов sGTM -> нажмите три точки в правом верхнем углу -> Нажмите импорт -> загрузите тег, который вы недавно скачали с GitHub, и нажмите Сохранить. 

4. Создайте новый тег и выберите Twitter Tag. Добавьте API-ключ контейнера Stape. Для этого откройте настройки контейнера sGTM и скопируйте Container API Key.

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 просит отправить данные пользователя, но пока они поддерживают только email пользователя и twclid.

Есть два основных недостатка Twitter CAPI: процесс аутентификации и отсутствие инструмента тестирования в реальном времени. Из-за процесса аутентификации тег Twitter работает только с серверами stape для sGTM. Если Twitter упростит процесс аутентификации, команда stape обновит тег для работы с GCP.

Надеюсь, это руководство поможет вам лучше познакомиться с Twitter CAPI и настроить Twitter CAPI в sGTM. Для получения более подробной информации о Twitter CAPI ознакомьтесь с официальной документацией. Если вам нужна помощь в настройке Twitter CAPI, свяжитесь с нами!