В этой статье описаны различные способы отправки событий в серверный контейнер. Если вам нужна дополнительная информация, ознакомьтесь с тем, как работает тегирование на стороне сервера .
В этой статье обсуждается, как:
- Отправка данных с веб-сайта в серверный контейнер
- Отправка дополнительных данных в серверный контейнер
- Получайте данные в серверном контейнере
- Отправлять данные из источников, отличных от веб-сайтов.
Прежде чем начать
В этом руководстве предполагается, что у вас уже есть:
1. Отправьте данные с веб-сайта в серверный контейнер.
Вы можете маршрутизировать данные через реализацию на стороне сервера через Диспетчер тегов или gtag.js. Выберите свой вариант реализации.
Необязательно: отправлять дополнительные параметры с каждым событием.
Вы можете отправить дополнительные два типа дополнительных параметров: параметры уровня конфигурации и параметры уровня события. Параметры конфигурации влияют на поведение вашего тега Google и могут быть установлены только на уровне тега Google.
Параметры события определяют дополнительную информацию о событии и могут быть установлены для всех событий, событий выбора или событий page_view
.
2. Получите данные в контейнере на стороне сервера.
Когда вы отправляете HTTP-запрос в серверный контейнер, клиент должен запросить этот запрос.
Чтобы просмотреть список доступных клиентов:
Откройте контейнер сервера.
На панели навигации слева нажмите «Клиенты» . Клиент GA4 по умолчанию предварительно установлен в вашем серверном контейнере. Если вам нужно работать с Universal Analytics, настройте клиент Google Analytics: Universal Analytics .
Нажмите на имя клиента, чтобы просмотреть или изменить детали.
Дополнительные настройки клиента
В большинстве случаев клиент не потребует никаких изменений. Однако ваш вариант использования может отличаться, и вы можете изменить один из следующих параметров:
Приоритет: определяет порядок запуска клиентов. Первыми запускаются более высокие номера, и первый клиент, соответствующий входящему запросу, станет активным клиентом для этого запроса.
Критерии активации: Критерии активации определяют, когда клиент будет отвечать на запросы:
Для клиентов UA: Пути Universal Analytics по умолчанию : клиент активируется, когда пути запроса включают
/collect
,/r/collect
и другие аналогичные пути, используемые файлами JavaScript, которые отправляют данные в Google Analytics. Этот параметр активен по умолчанию.Пути gtag.js по умолчанию для определенных идентификаторов. Используйте этот параметр, чтобы включить обработку JavaScript gtag.js через URL-адрес контейнера вашего сервера. Если этот параметр включен, этот клиент будет активироваться в ответ на запросы к путям запросов gtag.js по умолчанию, например
/gtag/js?id=TAG_ID
. Нажмите «Добавить идентификатор измерения» , чтобы добавить один или несколько идентификаторов назначения .
Необязательно: получите дополнительные данные в диспетчере тегов на стороне сервера.
Если вы отправляете дополнительные параметры , вам необходимо настроить клиент Google Analytics 4 в контейнере вашего сервера для анализа дополнительных параметров и создания на их основе данных о событиях.
Некоторые теги сервера включают дополнительные параметры в свои исходящие запросы без какой-либо настройки. Чтобы исключить эти параметры, создайте преобразование , чтобы удалить значение.
Чтобы использовать дополнительные параметры в других тегах:
- В контейнере вашего сервера нажмите «Переменные» в левой навигационной панели.
- Создайте новую пользовательскую переменную .
- В разделе «Конфигурация переменных» выберите тип переменной «Данные события» .
- В поле «Путь к ключу» введите имя параметра.
- Дайте вашей переменной имя и сохраните .
Теперь вы можете использовать параметр события в любом другом теге внутри контейнера вашего сервера.
3. Необязательно: отправьте данные из источников, отличных от веб-сайтов.
Протокол измерения Google Analytics можно использовать для включения поддержки тегов на стороне сервера из таких источников, как мобильные приложения и межсерверные приложения.
Мобильные приложения
Чтобы ваше приложение Android или iOS отправляло данные в контейнер вашего сервера, вы создадите собственный тег изображения и настроите его для использования протокола измерения:
- В мобильном контейнере (Android или iOS) нажмите Теги > Создать .
- В разделе «Конфигурация тега» выберите тип тега «Пользовательское изображение» .
- Задайте в качестве значения 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
- Снимите флажок «Включить очистку кэша» .
- Сохраните тег и опубликуйте контейнер.
- В серверном контейнере нажмите «Клиенты» > «Создать» .
- В разделе «Конфигурация клиента» выберите тип клиента «Протокол измерений» .
- Задайте для параметра «Путь активации» путь к конечной точке коллекции вашего приложения.
- Сохраните конфигурацию клиента и опубликуйте контейнер на стороне сервера.
Межсерверные приложения
Чтобы отправить данные протокола измерений в серверный контейнер, замените имя хоста 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:
- В серверном контейнере нажмите «Клиенты» > «Создать» .
- В разделе «Конфигурация клиента» выберите тип клиента «Протокол измерений» .
- Установите Путь активации на путь к конечной точке вашего сервера.
- Сохраните конфигурацию клиента и опубликуйте контейнер.
Следующие шаги
Чтобы отправлять данные в истинном собственном контексте, вам необходимо обслуживать сценарии Google, такие как библиотека Google Analytics, со своих собственных серверов.