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

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

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

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

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

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

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

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

Выберите вариант реализации.

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

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

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

Выберите вариант реализации.

Рекомендации по настройке

Мы рекомендуем использовать тег GA4 на веб-странице для отправки данных в контейнер сервера. Этот тег может использовать различные методы передачи данных для обеспечения наилучшей скорости доставки событий. К таким методам относятся, помимо прочего,

  • Пиксель изображения
  • Получить API
  • XHR
  • Сервис-воркер, работающий в iframe, загружаемом из домена контейнера вашего сервера.

Чтобы убедиться в поддержке всех методов, проверьте следующее:

Политика безопасности контента (CSP)

Директива Содержание Цель
img-src [SERVER_CONTAINER_URL] Запросы на измерения
connect-src [SERVER_CONTAINER_URL] Запросы на измерения
frame-src [SERVER_CONTAINER_URL] Реализация сервис-воркера

Кроме того, параметр X-Frame-Options не должен ограничивать загрузку iframe-элементов с URL-адреса контейнера сервера.

Для получения информации о конкретных политиках для каждого продукта обратитесь к https://developers.google.com/tag-platform/security/guides/csp .

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

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

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

  1. Откройте Google Tag Manager

  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 (SGTM) можно использовать для обеспечения поддержки серверной тегировки из таких источников, как мобильные приложения и приложения, работающие между серверами. Эта опция позволяет отправлять события в ваш контейнер в формате протокола измерения. Контейнер отправляет эти события в Google Analytics, используя тот же механизм, что и все остальные события SGTM.

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

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

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

  1. В мобильном приложении (Android или iOS) нажмите «Теги» > «Новый» .
  2. В разделе «Настройка тегов» выберите тип тега «Пользовательский тег изображения» .
  3. Установите значение параметра Image 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 через мой сервер