Электронная торговля GA4 (Диспетчер тегов): отправка событий GA4

В этом руководстве описывается, как обновить существующую реализацию электронной торговли Universal Analytics (Диспетчер тегов) для использования событий электронной торговли Google Analytics 4 .

Посетите центр миграции разработчиков , чтобы получить дополнительные руководства и ресурсы по миграции.

Исход

В результате следования этому руководству ваша существующая реализация Universal Analytics будет обновлена ​​для использования событий и параметров электронной торговли GA4. Эта обновленная реализация электронной торговли также будет использоваться для отправки данных об электронной торговле в новый ресурс GA4. Ваши отчеты об электронной торговле UA по-прежнему будут заполняться данными, и вы начнете получать данные в свой новый ресурс Google Analytics 4.

Внимание! Хотя события электронной торговли Google Analytics 4 автоматически переводятся для совместимости с Universal Analytics, не все события Google Analytics 4 имеют эквивалентное событие в Universal Analytics. Данные по этим событиям будут отсутствовать в отчетах по электронной торговле Universal Analytics. См. раздел «Компромиссы и соображения» ниже.

Прежде чем вы начнете

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

   • Вы используете ресурс Universal Analytics.
   • На вашем сайте используется Диспетчер тегов и уровень данных для отправки событий электронной торговли.

2. Просмотрите варианты миграции для реализации электронной коммерции , чтобы узнать о недостатках каждого варианта. Подтвердите, что вы действительно хотите следовать этому руководству, чтобы использовать события электронной торговли Google Analytics 4 для существующей реализации Universal Analytics.

3. Ознакомьтесь со справочником по совместимости событий , чтобы узнать, как события UA преобразуются при отправке в ресурс GA4.

Компромиссы и соображения

Просмотрите и учтите приведенную ниже информацию, чтобы полностью понять последствия использования событий электронной торговли Google Analytics 4 с существующей реализацией электронной торговли Universal Analytics (Диспетчер тегов).

Плюсы	Минусы
Позволяет просматривать данные электронной торговли в отчетах GA4 и Universal Analytics. Использование событий и параметров GA4 позволяет получать полные отчеты об электронной торговле GA4.	Требуется изменить существующие события электронной торговли. Не все события и параметры GA4 имеют эквиваленты в Universal Analytics. Параметры shipping_tier , discount , currency , location_id , promotion_name и promotion_id не имеют эквивалентов Universal Analytics и не будут отображаться в ваших отчетах Universal Analytics.

Выполнение

Ключевой целью реализации является переход от использования уровня данных к использованию API gtag.js. Чтобы гарантировать отсутствие прерываний измерений во время этого перехода, в приведенных ниже инструкциях рекомендуется сначала выполнить все обновления конфигурации тегов, а затем обновления уровня данных.

1. Создайте и настройте новый ресурс GA4.

Выполните следующие шаги, чтобы создать и настроить новый ресурс Google Аналитики 4 :

1. Создайте новый ресурс Google Аналитики 4.
   • Используйте Ассистент настройки GA4 , чтобы автоматически создать новый ресурс GA4 и скопировать следующие настройки из вашего ресурса Universal Analytics: название ресурса , URL-адрес веб-сайта , часовой пояс и настройки валюты . Однако снимите флажок «Включить сбор данных с использованием существующих тегов», чтобы отключить функцию связанного тега сайта. Альтернативно, если вы не хотите копировать какие-либо настройки из своего ресурса Universal Analytics , создайте ресурс Google Analytics 4 без Ассистента настройки GA4 .
2. Добавьте тег Google.
   1. Откройте контейнер Диспетчера тегов Google для существующей реализации Universal Analytics.
   2. Нажмите Теги > Создать .
   3. Нажмите «Конфигурация тега» и выберите «Тег Google» .
   4. Введите идентификатор тега вашего ресурса Google Аналитики 4.
   5. Выберите, чтобы активировать тег на всех страницах (или на подмножестве страниц, которые вы хотите измерить).
   6. Сохраните и опубликуйте конфигурацию тега.

2. Добавьте конфигурацию тега событий GA4 для отслеживания событий электронной торговли.

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

1. Создайте новую конфигурацию тега и выберите «Событие GA4» .
2. В качестве имени события используйте встроенную переменную . При этом будет использоваться название события электронной торговли GA4, отправленное с помощью API gtag.js.
3. В разделе «Дополнительные настройки» , а затем «Электронная торговля» установите флажок «Отправлять данные электронной торговли» .
4. В качестве источника данных выберите «Уровень данных» .
5. Нажмите Сохранить . Триггеры будут добавлены на последующих этапах, поэтому вы можете спокойно игнорировать любые предупреждения об отсутствующих триггерах.

Ключевой момент: вам не нужно создавать несколько тегов событий GA4. Вместо этого для всех событий электронной торговли можно использовать один тег события GA4 с использованием встроенной переменной Event . Триггеры тега будут определять конкретные события электронной торговли GA4, которые активируют тег.

3. Обновите конфигурации тегов электронной торговли UA, чтобы использовать события GA4.

Для каждой конфигурации тега электронной торговли Universal Analytics вам потребуется добавить триггер для срабатывания эквивалентного события электронной торговли GA4 и включить возможность чтения данных о событиях электронной торговли GA4.

Для каждого события электронной торговли Universal Analytics общие шаги по обновлению до соответствующего события GA4 следующие:

1. Для события электронной торговли UA, которое вы хотите обновить, используйте информацию, доступную в разделе «Совместимость событий UA и GA4» и «Сравнимые параметры для таблиц UA и GA4» и/или помощника по миграции электронной торговли , чтобы определить соответствующее имя события GA4. Например, если вы обновляете событие для отслеживания кликов по продуктам, имя события GA4 будет select_item .
2. Обновите конфигурацию тега Universal Analytics для события:
   1. В разделе «Дополнительные настройки» выберите «Электронная торговля» установите флажок «Использовать схему GA4» , чтобы убедиться, что существующие теги правильно считывают обновленное событие электронной торговли GA4. Это изменение можно внести до перехода с уровня данных на API gtag.js.
   2. В разделе «Триггеры» добавьте новый триггер специального события , где имя события — это событие электронной торговли GA4, указанное выше. После выполнения этого шага у вас должно быть как минимум два триггера: исходный триггер, который активировал тег, и новый добавленный триггер, который в конечном итоге сработает после завершения перехода к событиям GA4. Дополнительным триггером является обеспечение отсутствия прерывания передачи данных при переходе с уровня данных на API gtag.js , как описано далее в этом документе.
   3. Сохраните изменения.
3. Добавьте новый триггер в тег события GA4:
   1. Откройте тег событий GA4 , который вы ранее настроили для отправки событий и параметров электронной торговли в ваш ресурс GA4.
   2. В разделе «Триггеры» добавьте созданный выше триггер специального события (например, select_item ), чтобы тег события GA4 сработал для связанного действия электронной торговли после перехода к событиям GA4.
   3. Сохраните изменения.
4. Повторите описанные выше шаги для каждого действия электронной торговли Universal Analytics. После завершения опубликуйте изменения в Диспетчере тегов.

Внимание! Обязательно включите параметр «Использовать схему GA4» в конфигурации тега Universal Analytics. Если эта опция не включена, ваши отчеты об электронной торговле UA не будут заполняться правильно.

4. Включите API gtag.js.

Чтобы обновить реализацию электронной торговли с UA на GA4, рекомендуется перейти от использования уровня данных к использованию API gtag.js , который работает совместно с Диспетчером тегов.

Чтобы включить API gtag.js, добавьте следующий фрагмент кода в верхнюю часть страницы над фрагментом контейнера Диспетчера тегов:

<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
</script>

Внимание: если вы ранее следовали инструкциям «Добавление переменных уровня данных на страницу» и уже объявили переменную уровня данных на странице, приведенный выше фрагмент следует поместить после существующего объявления уровня данных.

5. Переход от уровня данных к использованию gtag.js

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

Чтобы помочь с обновлением, воспользуйтесь следующими ресурсами:

• В руководстве для разработчиков электронной торговли (GA4) вы узнаете, как отправлять события электронной торговли GA4 с помощью API gtag.js , а также настраивать тег событий GA4 и триггеры в Диспетчере тегов.
• Таблица «Совместимость событий UA и GA4», которая поможет вам найти подходящее название события GA4 для действия электронной торговли Universal Analytics. Например, если вы обновляете событие для отслеживания показов продуктов, имя события GA4 будет view_item_list .
• Таблица сопоставимых параметров для UA и GA4 поможет сопоставить имена параметров электронной торговли UA с эквивалентными именами параметров электронной торговли GA4.
• Помощник по миграции электронной торговли , позволяющий проверить правильность обновления событий электронной торговли.

Для каждого события электронной торговли Universal Analytics общие шаги по переходу от использования API dataLayer.push() с событиями электронной торговли UA к использованию API gtag.js с соответствующим событием электронной торговли GA4 следующие:

1. Обновите названия специальных событий, указав соответствующие названия событий GA4. Например, если вы обновляете событие для измерения кликов по продукту, в котором используется специальное имя события productClick , обновленное имя события для GA4 будет select_item . Имя события GA4 должно совпадать с именем события триггера, который вы настроили ранее.

   Например, следующее событие клика по продукту с использованием уровня данных

   dataLayer.push({'event': 'productClick', 'ecommerce': {<ecommerce_parameters>}});
   

   при переходе на API gtag.js становится следующим:

   gtag('event', 'select_item', {<ecommerce_parameters>});
   

2. Обновите параметры электронной торговли, чтобы они соответствовали ожидаемым для события GA4. Обязательно используйте сопоставимые параметры для UA и GA4, поскольку названия параметров были изменены. Заполните значение параметра GA4 соответствующим значением параметра UA.

Примечание. После завершения перехода от использования API dataLayer.push() к API gtag.js вы можете при желании удалить любые пользовательские триггеры событий, которые срабатывают на основе старых событий уровня данных UA.

Пример: обновление события UA до GA4

В следующем примере показано, как создать эквивалентное событие GA4 для активности электронной торговли по клику на продукт , реализованной в Диспетчере тегов для Universal Analytics.

Раньше: отправка событий UA с использованием уровня данных

Ниже показано измерение клика по продукту для Universal Analytics, реализованное с использованием уровня данных . Имя пользовательского события — productClick .

<script>
/**
 * Call this function when a user clicks on a product link. This function uses the event
 * callback datalayer variable to handle navigation after the ecommerce data has been sent
 * to Google Analytics.
 * @param {Object} productObj An object representing a product.
 */
function(productObj) {
  dataLayer.push({
    'event': 'productClick',
    'ecommerce': {
      'click': {
        'actionField': {'list': 'Search Results'},      // Optional list property.
        'products': [{
          'name': productObj.name,                      // Name or ID is required.
          'id': productObj.id,
          'price': productObj.price,
          'brand': productObj.brand,
          'category': productObj.cat,
          'variant': productObj.variant,
          'position': productObj.position
         }]
       }
     },
     'eventCallback': function() {
       document.location = productObj.url
     }
  });
}
</script>

В Диспетчере тегов конфигурация тега Universal Analytics выглядит следующим образом:

Тип тега: Универсальная аналитика
Тип трека: Событие
Категория события: Ecommerce
Действие по событию: Product Click
Включить расширенные функции электронной торговли: true
Использовать уровень данных: true
Триггер: event равно productClick .

Конфигурация триггера настроена на активацию тега, когда событие productClick передается на уровень данных:

После: отправка событий GA4 с помощью gtag.js

Обновления конфигурации тегов для UA

В Диспетчере тегов конфигурация тега Universal Analytics обновляется для того, чтобы событие клика по продукту инициировалось по имени события GA4, и был включен параметр «Использовать схему GA4» . Конфигурация тега теперь следующая:

Тип тега: Универсальная аналитика
Тип трека: Событие
Категория события: Ecommerce
Действие по событию: Product Click
Включить расширенные функции электронной торговли: true
Использовать уровень данных: true
Использовать схему GA4: true
Триггер 1: event равно productClick .
Триггер №2: event равно select_item

Конфигурация триггера нового триггера пользовательского события настроена на активацию тега имени события select_item :

Обновления конфигурации тегов для GA4

Событие GA4 настроено для отслеживания активности электронной торговли, реализованной с использованием событий и параметров GA4. Тег использует встроенную переменную Event для передачи названия события в GA4. Тот же триггер, созданный для тега UA (т. е. select_item ), используется для активации тега GA4.

Переход от уровня данных к использованию gtag.js

Ниже показано, как в приведенной выше реализации UA происходит переход от использования специального события productClick с API dataLayer.push() к использованию события select_item GA4 с API gtag.js. Значения параметра select_item устанавливаются соответствующим образом.

<script>
/**
 * Call this function when a user clicks on a product link.
 * @param {Object} productObj An object representing a product.
 */
function(productObj) {
  gtag('event', 'select_item', {
    'items': [{
      'item_id': productObj.id,
      'item_name': productObj.name,
      'index': productObj.position,
      'item_list_name': 'Search Results',
      'item_brand': productObj.brand,
      'item_category': productObj.cat,
      'item_variant': productObj.variant,
      'price': productObj.price
    }]
  });
}
</script>