Интеграции
Google Tag Manager (server-side)
Отправляйте клики и конверсии в ваш серверный контейнер GTM как хиты GA4 Measurement Protocol.
Интеграция Google Tag Manager отправляет каждый записанный клик Letlink и каждую одобренную конверсию в ваш собственный серверный контейнер GTM как хит GA4 Measurement Protocol. Когда событие попадает на ваш сервер тегов, любой тег в контейнере может его обработать — GA4, Google Ads, Meta, хранилище данных, — поэтому вы настраиваете получателей один раз в GTM, а не отдельно для каждого инструмента. Доступно на Growth и Ultimate.
Что вам понадобится
- Работающий серверный контейнер с собственным HTTPS-адресом, например
https://gtm.example.com. - Клиент Measurement Protocol в этом контейнере. По умолчанию GTM его не добавляет.
- Идентификатор измерения (
G-…) веб-потока GA4, в который пересылает контейнер.
Подготовьте контейнер
- В серверном контейнере откройте Clients → New и выберите тип клиента Measurement Protocol.
- Укажите Activation Path
/mp/collect(или любой другой путь — тот же путь вы введёте в Letlink) и сохраните. - Добавьте или используйте существующий тег Google Analytics: GA4, запускаемый этим клиентом, а также любые другие теги, которые должны получать события, затем нажмите Submit для контейнера.
Подключите к Letlink
- Откройте Интеграции → Google Tag Manager (серверный). Только для владельцев и администраторов.
- Введите URL сервера тегов (без пути), Measurement ID и, если вы его меняли, путь клиента.
- Секрет API необязателен. Вставьте секрет GA4 Measurement Protocol, если ваш тег GA4 пересылает с ним хиты в Google.
- Сохраните и нажмите Отправить тестовое событие, затем проследите, как запрос приходит в режиме Предпросмотр контейнера.
Что мы отправляем
Запрос POST на <tagging server><path>?measurement_id=G-… со стандартным телом GA4 Measurement Protocol. client_id — тот же отпечаток устройства, что использует панель управления, а страна посетителя передаётся в user_location, если известны.
| Событие Letlink | Событие GA4 | Дополнительные параметры |
|---|---|---|
| Клик | link_click |
short_code, link_type, variation, destination_url, значения UTM, click_id |
| Продажа | purchase |
transaction_id (ID вашего заказа), value, currency |
| Лид | generate_lead |
value, currency, если переданы |
| Регистрация | sign_up |
method = short_link |
| Пользовательское | Название вашего события, приведённое к правилам GA4 | value, currency, если переданы |
Каждая конверсия также содержит conversion_id (conv-<id>) и click_id клика, из которого она пришла, чтобы вы могли объединять их в BigQuery или устранять дубли в тегах.
Ничего не приходит — что проверить?
- URL сервера тегов должен использовать HTTPS и быть доступен из интернета.
404обычно означает, что ни один клиент не обработал путь: проверьте путь активации клиента Measurement Protocol. - Режим предварительного просмотра показывает запросы, только пока он открыт. Отправляйте тестовое событие после его открытия.
- Конверсии всегда отправляются в эту интеграцию, даже если рабочее пространство не передаёт конверсии в рекламные платформы.