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

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

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

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

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

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

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

Вы можете ��аправ��ть д��н��ые через реализацию на стороне сервера через Tag Manager или gtag.js. Выберите свой вариант реализации.

Пожалуйста, выберите вариант реализации.

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

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

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

Пожалуйста, выберите вариант реализации.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Протокол измерений Google Analytics можно использовать для включения поддержки серверной маркировки из таких источников, как мобильные приложения и сервер-серверные приложения. Эта опция позволяет отправлять события в ваш контейнер в формате протокола измерений. Контейнер отправляет эти события в Google Analytics, используя тот же механизм, что и все другие события SGTM.

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

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

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

  1. В мобильном контейнере (Android или iOS) нажмите Теги > Создать .
  2. В разделе «Конфигурация тега» выберите тип тега «Пользовательское изображение» .
  3. Установите значение URL изображения на пиксельное изображение на контейнере сервера по указанному ранее пути в клиенте Measurement Protocol. Добавьте любые нужные параметры 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, настройте серверную установку Tag Manager с клиентом Measurement Protocol:

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

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

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

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