Настройте шлюз тегов Google для рекламодателей

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

Обзор

Шлюз Google Tag для рекламодателей позволяет развернуть тег Google, используя собственную инфраструктуру, размещенную на домене вашего веб-сайта. Эта инфраструктура находится между вашим веб-сайтом и сервисами Google. Настройка, описанная в этой документации, поможет вам лучше измерять эффективность вашего веб-сайта. Вы можете настроить его, используя существующую сеть доставки контента (CDN), балансировщик нагрузки или веб-сервер.

В стандартных настройках Google Tag Gateway ваша веб-страница запрашивает тег Google с домена Google. Когда тег срабатывает, он отправляет запросы на измерение непосредственно в продукт Google. С помощью Google Tag Gateway для рекламодателей ваш веб-сайт загружает тег Google с вашего собственного домена. Когда тег срабатывает, некоторые запросы на измерение будут отправлены в Google с использованием вашего собственного домена.

Эта диаграмма отображает поток информации в шлюзе тегов Google для рекламодателей:

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

В этом руководстве предполагается, что ваш веб-сайт уже настроен следующим образом:

• Контейнер тегов Google или Tag Manager .
• Сеть доставки контента (CDN) или балансировщик нагрузки, способный перенаправлять запросы на внешние конечные точки.

Для начала выберите тип настройки.

Самообслуживание в пользовательском интерфейсе

1. Выберите пути измерения.

Для отображения каждого тега или контейнера Google Tag Manager необходимо зарезервировать уникальный путь измерения на домене вашего веб-сайта.

Требования к траектории измерения:

• Указанные пути не должны использоваться ранее в вашем домене.
• Каждый путь не должен совпадать с корневым путем /.
• Длина каждого пути не должна превышать 100 символов.

Google Tag Manager:

Если вы используете Google Tag Manager, вам нужно указать только идентификатор контейнера (например, GTM-XXXXXX). Этой простой настройки достаточно для всех тегов (таких как Google Analytics, Google Ads и т. д.), которые уже добавлены в этот контейнер.

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

Для настройки шлюза тегов Google для рекламодателей выберите любой путь, который еще не используется на вашем сайте. Чтобы уменьшить вероятность конфликта с уже существующим путем, вы можете выбрать любую комбинацию букв и цифр, или, если вы хотите более читабельный путь, вы можете использовать слово, например, /gtm, /metrics, /analytics или любое другое слово по вашему желанию.

Например:

Вариант использования	ИДЕНТИФИКАТОР	Путь обслуживания тегов	Исходная конечная точка
Автономный тег 1	G-12345	/abjfo/	g-12345.fps.goog
Автономный тег 2	G-67890	/fjdso/	g-67890.fps.goog
Контейнер GTM	GTM-ABCDEF	/cvfjk/	gtm-abcdef.fps.goog

Заполните следующие поля, чтобы заполнить примеры в этом документе.

Your domain: example.com
Google tag ID: G-12345
Tag serving path: /metrics

Внимание: Эта настройка перенаправляет весь трафик по выбранному пути. Чтобы избежать проблем с вашим сайтом, выберите путь, который еще не используется.

Как обрабатывать несколько тегов или контейнеров:

Если ваши теги находятся в одном контейнере GTM, повторять эту настройку не нужно. Просто добавьте единственный контейнер Google Tag Manager, и все теги внутри него будут обрабатываться автоматически.

Если ваши теги находятся в отдельных контейнерах GTM ИЛИ не связаны между собой... Вам необходимо повторить эту настройку для каждого экземпляра. Это относится к случаю, если вы используете:

• Несколько отдельных контейнеров Google Tag Manager.
• Отдельные бирки (например, G-XXXXXX), которые не находятся внутри контейнера.

При этом необходимо присвоить каждому контейнеру или тегу уникальный путь для отображения тегов.

2. Маршрутное движение

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

Google Облако

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

Создайте новый бэкэнд.

1. Открытый балансировщик нагрузки GCP

2. В балансировщике нагрузки откройте раздел «Конфигурация бэкэнда» . Создайте новый бэкэнд-сервис.

3. Настройте свой новый бэкэнд-сервис, используя информацию о геолокации:

   • Укажите имя, например, measurement-be-svc .
   • Установите тип бэкэнда на «Группа конечных точек интернет-сети» .
   • Установите протокол на HTTPS и оставьте значение Timeout в исходном виде.
   • В разделе «Бэкэнды» щелкните раскрывающийся список « Группа сетевых конечных точек Интернета» и создайте новую группу сетевых конечных точек Интернета:
     • Установите тип группы сетевых конечных точек на Internet NEG (глобальный, региональный) .
     • Установите область действия в режим «Глобальный» .
     • Установите параметр «Добавить через» на «Полное доменное имя и порт» .
     • Установите полное доменное имя на G-12345 .fps.goog .
     • Нажмите кнопку СОЗДАТЬ , чтобы создать конечную точку.
     • Закройте вкладку « Группа сетевых конечных точек» , чтобы вернуться на вкладку «Новая серверная служба» .
   • Найдите название новой группы сетевых конечных точек и выберите её.
   • Откройте раздел «Расширенные настройки» . Добавьте следующие пользовательские заголовки запроса.

     Название заголовка	Значение заголовка
     Host	G-12345 .fps.goog
     X-Forwarded-CountryRegion	{client_region_subdivision}
     X-Forwarded-Geolocation	latlong={client_city_lat_long};city={client_city}

   • Проверьте остальные настройки. Для этой интеграции не требуются ни Cloud CDN , ни Cloud Armor , поэтому вы можете смело отключить оба сервиса.
   • Сохраните новый серверный сервис.

Настройка правил маршрутизации

1. В балансировщике нагрузки откройте раздел «Правила маршрутизации» .

2. Добавьте следующие правила для хоста и пути:

   Хозяин	Путь	Бэкенд
   *	/ metrics /*	measurement-be-svc

3. Обновите конфигурацию балансировщика нагрузки.

4. В браузере проверьте настройку, перейдя по адресу https:// example.com / metrics /healthy . На странице должен отобразиться текст "ok". Убедитесь, что географическая информация включена, перейдя по адресу https:// example.com / metrics /?validate_geo=healthy . На странице должен отобразиться текст " ok ok .

Клаудфлаер

Для отображения вашего тега в Google Tag Gateway для рекламодателей вам потребуется создать запись CNAME для нового поддомена, создать правило Origin для переадресации запросов и создать правило Transform для включения информации о геолокации. Для завершения этой настройки вам потребуется тарифный план Cloudflare Enterprise. Если у вас нет тарифного плана Enterprise, рассмотрите возможность использования настройки через пользовательский интерфейс Cloudflare .

Создать запись CNAME

Примечание: Теги не будут использовать эту запись CNAME; Cloudflare использует её для внутренней маршрутизации запросов.

Выберите поддомен, который будет зарезервирован для записи CNAME. Заполните следующие поля, чтобы использовать примеры в этом документе. Эта запись CNAME никогда не будет доступна за пределами вашей конфигурации Cloudflare, поэтому имя является произвольным.

CNAME subdomain: fps

1. На вкладке DNS откройте раздел «Записи» .
2. Добавьте новую запись со следующей конфигурацией:
   • Установите тип на CNAME .
   • Задайте имя fps .
   • Установите целевое устройство на G-12345 .fps.goog .
3. Сохраните запись CNAME.

Создайте правило источника

1. На вкладке «Правила» откройте «Правила источника» и создайте правило.
2. Введите название правила, например, Route measurement .
3. Сопоставьте входящие запросы на основе пользовательского выражения фильтра и нажмите «Редактировать выражение» .
4. Вставьте следующее выражение в конструктор: (http.host eq " example.com " and starts_with(http.request.uri.path, "/ metrics "))
5. Обновите заголовок хоста , чтобы он перезаписывался на... G-12345 .fps.goog .
6. Обновите DNS-запись , чтобы переопределить... fps . example.com
7. Сохраните правило происхождения.
8. Если существуют другие правила источника, повысьте позицию вновь созданного правила, чтобы оно выполнялось после любых других путей с подстановочными знаками.
9. Проверьте настройку в браузере, перейдя по адресу https:// example.com / metrics /healthy . На странице должно отображаться сообщение ok .

Включите информацию о геолокации.

1. На вкладке «Правила» откройте «Настройки» .
2. Включите параметр «Добавить заголовки местоположения посетителей» .
3. Подождите несколько минут, пока правило распространится. В браузере проверьте настройку, перейдя по адресу https:// example.com / metrics /?validate_geo=healthy . На странице должно отобразиться сообщение ok .

Акамай

Чтобы ваш тег отображался в Google Tag Gateway для рекламодателей, вам потребуется добавить новое правило в ваш ресурс для переадресации запросов и добавления информации о геолокации.

Создайте правило перенаправления

1. Создайте новую версию конфигурации доставки в диспетчере свойств.
2. В разделе « Настройки конфигурации свойств» добавьте новое Rule
   • Введите название, например, Route measurement
3. Добавить новый матч
   • Установите в выпадающих списках соответствия значение Path , и это будет одним из
   • Установите значение параметра match равным / metrics /*
4. Добавить новое поведение
   • Выберите «Стандартное поведение свойств» и выберите поведение «Исходный сервер» .
   • Установите имя хоста исходного сервера на G-12345 .fps.goog
   • Установите заголовок Forward Host на Origin Hostname.
5. Сохраните новое правило и примените изменения.
   • Перед внедрением в рабочую среду обязательно протестируйте новое правило перенаправления в тестовой среде.
   • Совет: убедитесь, что у вас нет правил, которые изменяют или удаляют заголовки исходящего ответа. Отсутствие заголовка Content-Type в ответе может привести к сбою скриптов Google.

Включите информацию о геолокации.

1. Выберите созданное выше правило перенаправления в разделе «Настройки конфигурации свойства ».

2. Добавить новое поведение

   • Выберите «Стандартное поведение свойств» и выберите поведение «Целевая обработка контента (EdgeScape)».
   • Установите значение параметра Enable в true

3. Сохраните новое поведение и примените изменения.

   • Перед внедрением в рабочую среду обязательно протестируйте новое правило перенаправления в тестовой среде.

4. В браузере проверьте настройку, перейдя по адресу https:// example.com / metrics /healthy . На странице должен отобразиться текст "ok". Убедитесь, что географическая информация включена, перейдя по адресу https:// example.com / metrics /?validate_geo=healthy . На странице должен отобразиться текст " ok ok .

Amazon CloudFront

Для того чтобы ваш тег отображался через Google Tag Gateway для рекламодателей, вам потребуется настроить поведение вашего дистрибутива таким образом, чтобы он перенаправлял запросы и добавлял информацию о геолокации.

Добавить новый источник

1. Перейдите на страницу CloudFront в Amazon Web Services (AWS).
2. Выберите дистрибутив CloudFront
3. На вкладке «Источники» создайте источник со следующими настройками:
   • Установите домен-источник на G-12345 .fps.goog
   • Установить протокол только HTTPS

Создайте механизм перенаправления.

1. Перейдите на страницу CloudFront в AWS.
2. Выберите дистрибутив CloudFront
3. На вкладке «Поведение» создайте новое поведение со следующими настройками:
   • Установите шаблон пути на / metrics /*
   • Установите Origin и группы происхождения на G-12345 .fps.goog
   • Установить параметр «Автоматически сжимать объекты» в положение «Нет».
   • Установите политику протокола просмотра таким образом, чтобы она применялась только к протоколу HTTPS.
   • Установите разрешенные HTTP-методы : GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE.
   • В разделе «Ключ кэша и исходные запросы» выберите «Политика кэширования» и «Политика исходных запросов».
     • Установите для политики кэширования значение CachingDisabled.
     • Установите политику запроса Origin в значение AllViewerExceptHostHeader
4. В списке поведений убедитесь, что Precedence нового поведения выше, чем у всех остальных.
   • Чтобы изменить Precedence , выберите своё поведение и нажимайте кнопку « Переместить вверх» , пока оно не окажется выше всех остальных поведений.
5. Проверьте настройку в браузере, перейдя по адресу https:// example.com / metrics /healthy . На странице должно отображаться сообщение ok .

Включите информацию о геолокации.

1. Для передачи необходимой информации о геолокации установите в параметре Headers значение AllViewerExceptHostHeader в настройках перенаправления.
   • Полный список заголовков местоположения средства просмотра CloudFront подробно описан в этой статье.
2. Подождите несколько минут, пока завершится развертывание вашего дистрибутива. В браузере проверьте настройку, перейдя по адресу https:// example.com / metrics /?validate_geo=healthy . На странице должно отобразиться сообщение ok .

Быстро

Для отображения вашего тега в Google Tag Gateway для рекламодателей вам потребуется настроить службу Fastly CDN для переадресации запросов и добавления информации о геолокации. Этот процесс включает в себя создание одного условия (Condition) , одного хоста (Host) и двух фрагментов кода VCL .

Создайте условие и хост.

Сначала вам нужно будет настроить условие для идентификации запросов к шлюзу и указать хост, который будет перенаправлять их в Google.

1. Создайте новое условие со следующими настройками:

   • Тип : Request
   • Название : Google Tag Gateway Path (или любое другое название на ваш выбор)
   • Применить, если… : req.url.path ~ "^/ metrics "

2. Создайте новый хост со следующими настройками:

   • Имя/адрес хоста : fps.goog

3. Настройте новый хост, добавив следующие дополнительные параметры:

   • Нажмите «Прикрепить условие» и выберите условие, созданное на шаге 1.
   • Установите параметр Override host на fps.goog .
   • Остальные настройки оставьте по умолчанию.
   • Нажмите «Обновить» , чтобы сохранить хост.

Добавьте заголовки Google Tag ID и Geolocation.

Далее вам нужно будет добавить фрагменты кода VCL (Varnish Configuration Language) для привязки вашего идентификатора тега Google и данных геолокации клиента. Необходимо создать два отдельных фрагмента кода — один для vcl_miss и один для vcl_pass — используя один и тот же код.

1. В вашем сервисе перейдите в раздел «Фрагменты кода VCL» и создайте фрагмент кода со следующими полями:

   • Имя : Geo_MISS (или любое другое имя по вашему выбору)
   • Размещение : Within Subroutine
   • Подпрограмма : vcl_miss

   • VCL :

     if (req.url.path ~ "^/metrics") {
       set bereq.http.X-Gtg-Tag-Id = "G-12345";
       set bereq.http.X-Forwarded-Country = client.geo.country_code;
       set bereq.http.X-Forwarded-Region = client.geo.region;
       set bereq.http.X-Forwarded-Geolocation = "latlong=" +
         client.geo.latitude + "," + client.geo.longitude + ";city=" +
         client.geo.city;
     }
     

2. Создайте еще один фрагмент кода со следующими полями:

   • Имя : Geo_PASS (или любое другое имя по вашему выбору)
   • Тип : vcl_pass

   • VCL :

     if (req.url.path ~ "^/metrics") {
       set bereq.http.X-Gtg-Tag-Id = "G-12345";
       set bereq.http.X-Forwarded-Country = client.geo.country_code;
       set bereq.http.X-Forwarded-Region = client.geo.region;
       set bereq.http.X-Forwarded-Geolocation = "latlong=" +
         client.geo.latitude + "," + client.geo.longitude + ";city=" +
         client.geo.city;
     }
     

   Теперь у вас должно быть два новых, отдельных фрагмента кода. Это гарантирует добавление заголовков геолокации к любому запросу, который необходимо получить с вашего хоста, независимо от того, является ли это «промах кэша» ( vcl_miss ) или «проход кэша» ( vcl_pass ).

Активируйте и проверьте полную конфигурацию.

После создания хоста, условия и фрагментов VCL-кода вы можете активировать и протестировать всю систему.

1. Нажмите «Активировать» , чтобы применить все внесенные изменения.

2. Проверьте конфигурацию , запустив оба теста в браузере:

   • Тест 1 (Теги и маршрутизация) : Перейдите по https:// example.com / metrics /healthy
   • Тест 2 (Геолокация) : Перейдите по https:// example.com / metrics /?validate_geo=healthy

   Обе страницы должны читаться ok

Примечание: Возможно, вам потребуется очистить службу и подождать несколько минут, пока завершится эта проверка.

Другой

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

1. Добавьте источник или бэкенд, указывающий на G-12345 .fps.goog .
2. Переопределите заголовок Host , установив значение равным G-12345 .fps.goog . Разрешите пересылку всех cookie-файлов и параметров запроса.
3. Передайте информацию о геолокации посетителя, добавив один из следующих заголовков:
   • X-Forwarded-CountryRegion — Страна и регион пользователя в одном коде ISO 3166-2 (например: US-CA ).
   • X-Forwarded-Country и X-Forwarded-Region :
     • X-Forwarded-Country - Страна пользователя в виде кода ISO 3166-1 alpha-2 (например: US ).
     • X-Forwarded-Region — код подразделения региона пользователя (например: CA ).
   • Если присутствуют оба набора заголовков, будет использоваться X-Forwarded-CountryRegion .
4. Добавьте правило пути для / metrics /* , чтобы направлять трафик на шлюз тегов Google для рекламодателей.
5. Настройте зарезервированный путь таким образом, чтобы он имел более высокий приоритет, чем правило по умолчанию.
6. В браузере проверьте настройку, перейдя по адресу https:// example.com / metrics /healthy . На странице должно отобразиться сообщение ok . Убедитесь, что географическая информация включена, перейдя по адресу https:// example.com / metrics /?validate_geo=healthy . На странице должно отобразиться сообщение ok .

Шаг 3: Обновите скрипты на веб-сайте, чтобы использовать путь измерения.

Замените скрипты на каждой странице веб-сайта одним из следующих:

gtag.js

В верхней части раздела <head> найдите две строки скрипта с вашим идентификатором тега Google:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-12345"></script>

и замените их вместо этого путем измерения:

<!-- Google tag (gtag.js) -->
<script async src="/metrics/"></script>

gtm.js

В верхней части раздела <head> замените фрагмент кода Tag Manager следующим:

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'/metrics/?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','');</script>
<!-- End Google Tag Manager -->

Примечание: Google Tag Gateway для рекламодателей не поддерживает фрагмент кода <noscript> . Чтобы использовать функциональность <noscript> , продолжайте использовать стандартный фрагмент кода <noscript> Google Tag Manager, указывающий на www.googletagmanager.com.

Проверьте измерительную установку.

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

1. Перейдите в Tag Assistant и просмотрите содержимое вашего контейнера.
2. Для запуска событий используйте навигацию по сайту.

3. На вкладке «Сводка > Вывод > Отправленные запросы» убедитесь, что запросы направляются на адрес / metrics .