Отправка данных в серверные контейнеры Менеджера тегов

В этой статье описаны различные способы отправки событий в серверный контейнер. Если вам нужна дополнительная информация, ознакомьтесь с тем, как работает тегирование на стороне сервера .

В этой статье обсуждается, как:

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

Прежде чем начать

В этом руководстве предполагается, что у вас уже есть:

• Настройте серверный контейнер в Диспетчере тегов
• Настройте сервер тегов

1. Отправьте данные с веб-сайта в серверный контейнер.

Вы можете маршрутизировать данные через реализацию на стороне сервера через Диспетчер тегов или gtag.js. Выберите свой вариант реализации.

Диспетчер тегов gtag.js

Тег Google: GA 4

Чтобы настроить тег Google для обработки на стороне сервера, вам необходимо добавить URL-адрес контейнера вашего сервера.

Создайте переменную конфигурации для URL-адреса контейнера сервера.

1. Откройте Диспетчер тегов Google.

2. Выберите веб-контейнер, который хотите настроить.

3. Откройте меню Переменные .

4. Создайте новую пользовательскую переменную типа тег Google: Настройки конфигурации .

5. Добавьте следующие параметры:

   • Имя : server_container_url
   • Значение : укажите URL-адрес серверного контейнера вашего серверного контейнера Диспетчера тегов.

6. Назовите переменную, например, «URL-адрес сервера», и сохраните ее.

Назначьте URL-адрес серверного контейнера тегу Google.

1. Откройте Меню тегов .
2. Добавьте новый тег Google или отредактируйте существующий.
3. В настройках конфигурации выберите только что созданную переменную контейнера сервера.
   Совет : Чтобы увидеть, какие параметры были унаследованы от переменной настроек, нажмите «Показать унаследованные настройки» .
4. Чтобы тег Google сработал раньше других триггеров, нажмите «Запуск» и используйте триггер «Инициализация — все страницы» . Узнайте больше о триггерах страницы .
5. Сохраните тег и опубликуйте контейнер.

Необязательно: отправлять дополнительные параметры с каждым событием.

Вы можете отправить дополнительные два типа дополнительных параметров: параметры уровня конфигурации и параметры уровня события. Параметры конфигурации влияют на поведение вашего тега Google и могут быть установлены только на уровне тега Google.

Параметры события определяют дополнительную информацию о событии и могут быть установлены для всех событий, событий выбора или событий page_view .

Параметры конфигурации Все события Выберите события события page_view

Узнайте, как повторно использовать настройки конфигурации в Диспетчере тегов Google .

Чтобы отправлять дополнительные параметры для всех событий, повторно используйте настройки событий в Диспетчере тегов Google .

Чтобы отправить дополнительные параметры с событием Google Analytics 4 :

1. В веб-контейнере добавьте тег события Google Аналитики 4 или измените существующий.
2. Нажмите «Параметры события» > «Добавить строку» .
3. Добавьте параметр для отправки вместе с событием. Предварительно определенные параметры событий см. в справочнике по рекомендуемым событиям .
   • В поле Имя добавьте название вашего параметра, например, language .
   • В поле «Значение» добавьте значение вашего параметра.

Совет. Если значение необходимо определить во время загрузки Диспетчера тегов, используйте переменную вместо жестко запрограммированного значения.

1. Настройте триггер для срабатывания при инициализации — все страницы .
2. Сохраните тег и опубликуйте контейнер.

Чтобы отправить параметр в событии page_view :

1. В веб-контейнере измените существующий тег Google .

2. Отключите page_view по умолчанию в настройках конфигурации, добавив новый параметр:

   • Имя : send_page_view
   • Значение : false

3. Создайте новый тег событий Google Analytics: GA4 .

   • Выберите тег конфигурации, который вы изменили на шаге 1.
   • Установите имя события на page_view .

4. Добавьте параметр для отправки вместе с событием. Предварительно определенные параметры событий см. в справочнике по рекомендуемым событиям . - В поле Имя добавьте название вашего параметра, например language .

   • В поле Value добавьте значение вашего параметра.

Совет. Если значение необходимо определить во время загрузки Диспетчера тегов, используйте переменную вместо жестко запрограммированного значения.

1. Настройте триггер для срабатывания при инициализации — все страницы .
2. Сохраните тег и опубликуйте контейнер.

2. Получите данные в контейнере на стороне сервера.

Когда вы отправляете HTTP-запрос в серверный контейнер, клиент должен запросить этот запрос.

Ключевой термин: «Клиенты» — это адаптеры между программным обеспечением, работающим на устройстве пользователя, и серверным контейнером Диспетчера тегов. Они получают данные измерений от устройства, преобразуют эти данные в одно или несколько событий, обрабатывают данные в контейнере и упаковывают результаты для отправки обратно на устройство.

Чтобы просмотреть список доступных клиентов:

1. Откройте Диспетчер тегов Google.

2. Откройте контейнер сервера.

3. На панели навигации слева нажмите «Клиенты» . Клиент GA4 по умолчанию предварительно установлен в вашем серверном контейнере.

4. Нажмите на имя клиента, чтобы просмотреть или изменить детали.

Дополнительные настройки клиента

В большинстве случаев клиент не потребует никаких изменений. Однако ваш вариант использования может отличаться, и вы можете изменить один из следующих параметров:

• Приоритет: определяет порядок запуска клиентов. Первыми запускаются более высокие номера, и первый клиент, соответствующий входящему запросу, станет активным клиентом для этого запроса.

• Критерии активации: Критерии активации определяют, когда клиент будет отвечать на запросы:

  • Пути gtag.js по умолчанию для определенных идентификаторов. Используйте этот параметр, чтобы включить обработку JavaScript gtag.js через URL-адрес контейнера вашего сервера. Если этот параметр включен, этот клиент будет активироваться в ответ на запросы к путям запросов gtag.js по умолчанию, например /gtag/js?id=TAG_ID . Нажмите «Добавить идентификатор измерения» , чтобы добавить один или несколько идентификаторов назначения .

Необязательно: получите дополнительные данные в диспетчере тегов на стороне сервера.

Если вы отправляете дополнительные параметры , вам необходимо настроить клиент Google Analytics 4 в контейнере вашего сервера для анализа дополнительных параметров и создания на их основе данных о событиях.

Некоторые теги сервера включают дополнительные параметры в свои исходящие запросы без какой-либо настройки. Чтобы исключить эти параметры, создайте преобразование , чтобы удалить значение.

Чтобы использовать дополнительные параметры в других тегах:

1. В контейнере вашего сервера нажмите «Переменные» в левой навигационной панели.
2. Создайте новую пользовательскую переменную .
3. В разделе «Конфигурация переменных» выберите тип переменной «Данные события» .
4. В поле «Путь к ключу» введите имя параметра.
5. Дайте вашей переменной имя и сохраните .

Теперь вы можете использовать параметр события в любом другом теге внутри контейнера вашего сервера.

3. Необязательно: отправьте данные из источников, отличных от веб-сайтов.

Протокол измерения Google Analytics можно использовать для включения поддержки тегов на стороне сервера из таких источников, как мобильные приложения и межсерверные приложения.

Мобильные приложения

Чтобы ваше приложение Android или iOS отправляло данные в контейнер вашего сервера, вы создадите собственный тег изображения и настроите его для использования протокола измерения:

1. В мобильном контейнере (Android или iOS) нажмите Теги > Создать .
2. В разделе «Конфигурация тега» выберите тип тега «Пользовательское изображение» .
3. Задайте в качестве значения URL-адреса изображения пиксельное изображение в серверном контейнере по пути в клиенте Measurement Protocol, который вы указали ранее. Добавьте любые желаемые параметры протокола измерений в конец URL-адреса вашего пикселя:
   https://custom.example.com/app ?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
4. Снимите флажок «Включить очистку кэша» .
5. Сохраните тег и опубликуйте контейнер.
6. В серверном контейнере нажмите «Клиенты» > «Создать» .
7. В разделе «Конфигурация клиента» выберите тип клиента «Протокол измерений» .
8. Задайте для параметра «Путь активации» путь к конечной точке коллекции вашего приложения.
9. Сохраните конфигурацию клиента и опубликуйте контейнер на стороне сервера.

Межсерверные приложения

Чтобы отправить данные протокола измерений в серверный контейнер, замените имя хоста www.google-analytics.com доменным именем вашего серверного контейнера. Например:

POST /batch HTTP/1.1
Host: collection.example.com

v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home

Чтобы получать обращения Measurement Protocol, настройте серверную установку Диспетчера тегов с помощью клиента Measurement Protocol:

1. В серверном контейнере нажмите «Клиенты» > «Создать» .
2. В разделе «Конфигурация клиента» выберите тип клиента «Протокол измерений» .
3. Установите Путь активации на путь к конечной точке вашего сервера.
4. Сохраните конфигурацию клиента и опубликуйте контейнер.

Следующие шаги

Чтобы отправлять данные в истинном собственном контексте, вам необходимо обслуживать сценарии Google, такие как библиотека Google Analytics, со своих собственных серверов.

Загружать скрипты Google через мой