Совместимость событий электронной торговли и справочник по переводу (Диспетчер тегов)

В этом документе описывается совместимость и преобразование событий электронной торговли между Universal Analytics (UA) и Google Analytics 4 (GA4).

Фон

События электронной торговли GA4 автоматически преобразуются в эквивалентные события UA при отправке в ресурс UA. Перевод также происходит при отправке событий электронной торговли UA в ресурс GA4. В этом документе объясняется, как работает перевод, совместимость событий и любые компромиссы, на которые вам, возможно, придется пойти, полагаясь на автоматический перевод.

Цель

Перевод событий электронной торговли UA и GA4 помогает в следующем:

  • Простота реализации : внедрите электронную торговлю GA4, используя существующую реализацию UA с небольшим обновлением конфигурации.
  • Устраните необходимость использования двух тегов : вы можете отправлять одни и те же события электронной торговли на ресурс UA и GA4. Это дает возможность перейти на GA4 и сохранить реализацию электронной коммерции UA, не требуя поддержания конфигурации с двумя тегами.

Компромиссы

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

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

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

Как работает перевод

Тег события GA4

  • Использование gtag – рекомендуемый способ отправки событий электронной торговли GA4. Однако тег событий GA4 может считывать данные электронной торговли, переданные на уровень данных.
  • Параметры события GA4 , настроенные непосредственно в теге события GA4, будут иметь приоритет над любыми данными gtag/уровня данных или пользовательской переменной.
  • Тег событий GA4 обратно совместим с данными о событиях электронной торговли, используемыми в Universal Analytics. Поведение приоритета следующее:
    • Используйте события электронной торговли GA4.
    • Если события электронной торговли GA4 не найдены, найдите и используйте события электронной торговли UA.
  • Если событие электронной торговли UA используется с тегом события GA4, оно сначала преобразуется в эквивалентное событие электронной торговли GA4, а затем отправляется в ресурс GA4. Это применимо независимо от того, используете ли вы gtag , уровень данных или пользовательский объект .

Универсальный тег аналитики

  • Тег Universal Analytics поддерживает чтение событий электронной торговли GA4 (включая данные, отправляемые с помощью gtag).
  • Если в теге включено чтение событий электронной торговли GA4, приоритет будет следующим:
    • Используйте события электронной торговли GA4.
    • Если события электронной торговли GA4 не найдены, найдите и используйте события электронной торговли UA.
  • Если событие электронной торговли GA4 используется с тегом Universal Analytics, оно сначала преобразуется в эквивалентное событие электронной торговли UA, а затем отправляется в ресурс UA. Это применимо независимо от того, используете ли вы gtag , уровень данных или пользовательский объект .

Сопоставимые параметры для UA и GA4

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

Название параметра Universal Analytics Название параметра Google Аналитики 4 Примечания
affiliation affiliation
checkout_step
checkout_option
content_type
coupon coupon
currency currency При отправке события UA в ресурс GA4 это значение валюты будет использоваться для параметра GA4 items[].currency .
location_id
payment_type
shipping shipping
shipping_tier
tax tax
transaction_id transaction_id
value value
items[] items[]
items[].name items[].item_name
items[].id items[].item_id
items[].affiliation
items[].brand items[].item_brand
items[].category
items[].item_category
items[].item_category2
items[].item_category3
items[].item_category4
items[].item_category5
Категория товара. Можно указать до 5 уровней иерархии.

Подробную информацию о том, как обрабатывается перевод категорий между событиями UA и GA4, см. в разделе «Преобразование параметров категории» .
items[].currency
items[].coupon items[].coupon
items[].discount
items[].list_name items[].item_list_name
items[].list_position items[].index
items[].location_id
items[].price items[].price
items[].quantity items[].quantity
items[].variant items[].item_variant
promotions[] В GA4 items[] используется с конкретными параметрами промоакции, такими как items[].promotion_id .
promotions[].id items[].promotion_id Эти параметры не преобразуются при отправке события UA в GA4 и наоборот.
promotions[].name items[].promotion_name Эти параметры не преобразуются при отправке события UA в GA4 и наоборот.
promotions[].creative_name
promotions[].creative_slot items[].creative_slot Эти параметры не преобразуются при отправке события UA в GA4 и наоборот.

Перевод параметров категории

Перевод параметра категории рассматривается как особый случай при отправке событий GA4 в UA или наоборот.

В Universal Analytics при настройке параметра items[].category вы используете / в качестве разделителя, чтобы указать до пяти уровней иерархии. В Google Analytics 4 вы используете перечислимые параметры категорий, чтобы указать до пяти уровней иерархии: items[].item_category , items[].item_category2 , items[].item_category3 , items[].item_category4 и items[].item_category5 .

Поведение перевода категорий следующее:

  • Для событий GA4, переведенных в UA, перечисляемые категории будут объединены в один параметр category , где каждая категория будет разделена знаком / .
  • Для событий UA, переведенных в GA4, значение параметра категории будет разделено для заполнения соответствующих перечисляемых категорий GA4.
  • Если вы собираетесь отправлять события GA4 в UA, рекомендуется не использовать символ / в значениях категорий, так как он будет интерпретироваться как разделитель категорий при переводе в UA.
  • Будут использоваться только первые 5 уровней категорий, независимо от того, сколько из них определено.

Пример перевода категории

В следующих примерах показан параметр категории UA, переведенный в GA4. Тот же принцип применяется при переводе события GA4 в UA.

Событие UA с категорией, определяющей 5 уровней иерархии:

gtag("event", "add_to_cart", {
  items: [{
    ...
    category: "Apparel/Adult/Shirts/Crew/Short sleeve",
    ...
  }]
});

Событие UA преобразовано в событие GA4 с перечисленными категориями:

gtag("event", "add_to_cart", {
  items: [{
    ...
    item_category: "Apparel",
    item_category2: "Adult",
    item_category3: "Shirts",
    item_category4: "Crew",
    item_category5: "Short sleeve",
    ...
  }]
});

Совместимость событий UA и GA4

В таблице ниже показаны сопоставимые события электронной торговли для Universal Analytics и Google Analytics 4, а также поведение перевода при отправке события UA в GA4 и наоборот.

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

  • В столбцах «Событие UA» и «Событие GA4» указаны сопоставимые события в зависимости от того, для чего они предназначены.
  • В разделе «Параметры» перечислены параметры, не имеющие эквивалента между соответствующими событиями UA и GA4. GA4 перечисляет только параметры, которые используются только с событием GA4, а UA перечисляет только параметры, которые используются только с событием UA.
  • Поведение перевода (отправка UA в GA4) описывает поведение перевода при отправке события UA в ресурс GA4. В примечаниях представлена ​​подробная информация об отправленных данных, отличиях от события GA4 и любых заметных влияниях на отчеты GA4.
  • Поведение перевода (отправка GA4 в UA) описывает поведение перевода при отправке события UA в ресурс GA4. В примечаниях представлена ​​подробная информация об отправленных данных, отличиях от события UA и любых заметных влияниях на отчеты UA.
UA-событие Событие GA4 Параметры Поведение перевода
(Отправка UA в GA4)		 Поведение перевода
(Отправка GA4 в UA)
Впечатления от продукта ( impressions ) Только GA4:
item_list_id
item_list_name
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Совместимый .

Все параметры UA переводятся в эквиваленты GA4 и отправляются.

Отчеты GA4, для которых требуются какие-либо параметры только GA4, будут неполными.
Совместимый .

Параметры GA4 с эквивалентным параметром UA преобразуются и отправляются. Параметры только GA4 не отправляются. Параметр item_list_name уровня события игнорируется, будет отправлен только элемент item_list_name .

Отчеты UA, заполненные данными о событии GA4, будут полными/без изменений.
Клики по продуктам ( click ) Только GA4:
item_list_id
item_list_name
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id

Только UA:
content_type
 Не совместимо .

Отправляется пользовательское событие select_content и пользовательский параметр content_type . Данные items не отправляются.		 Не совместимо .

Обращение к событию UA отправляется с общим значением в качестве event_category и select_item в качестве event_action . Данные items не отправляются.
Клики по продвижению ( promoClick ) Только GA4:
creative_name
creative_slot
location_id
promotion_id
promotion_name
items

Только UA:
content_type
promotions
 Не совместимо .

Пользовательское событие select_content отправляется с content_type и promotions в качестве пользовательских параметров. Пользовательский параметр promotions не содержит никаких полезных данных.		 Не совместимо .

Обращение к событию UA отправляется с общим значением event_category и select_promotion в качестве event_action . Данные promotions не отправляются.
Просмотр деталей продукта ( detail ) Только GA4:
currency
value
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Совместимый .

Все параметры UA переводятся в эквиваленты GA4 и отправляются.

Отчеты GA4, для которых требуются какие-либо параметры только GA4, будут неполными.
Совместимый .

Параметры GA4 с эквивалентным параметром UA преобразуются и отправляются. Исключением является item_list_name , который не отправляется. Из параметров GA4 только параметры currency и value передаются с указанием валюты и дохода от транзакции соответственно. event_value также устанавливается в параметр value как целое число. Обратите внимание, что преобразование из GA4 в UA включает event_value , но обычно оно не устанавливается для обращений UA.

Отчеты UA, заполненные данными из GA4, в большинстве случаев будут полными/без изменений. Название списка элементов будет отсутствовать.
add_to_wishlist *

* данные items не поддерживаются для UA.
Только GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Совместимый .

Все параметры UA переводятся в эквиваленты GA4 и отправляются.

Отчеты GA4, для которых требуются какие-либо параметры только GA4, будут неполными.
Совместимый .

Эквивалентное событие отправляется с электронной торговлей как event_category , add_to_wishlist как event_action и параметром value как event_value .

Отчеты UA, заполненные данными о событии GA4, будут полными/без изменений. Поскольку это событие обычно не поддерживается в отчетах по электронной торговле UA, оно не окажет какого-либо заметного эффекта.
Добавление товара в корзину ( add ) Только GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Совместимый .

Все параметры UA переводятся в эквиваленты GA4 и отправляются.

Отчеты GA4, для которых требуются какие-либо параметры только GA4, будут неполными.
Совместимый .

Параметры GA4 с эквивалентным параметром UA транслируются и отправляются.* Параметры только GA4 не отправляются.

* item_list_name не отправляется, но такое поведение соответствует gtag.js (UA), который не отправляет list_name .

Отчеты UA, заполненные данными о событии GA4, будут полными/без изменений.
Удаление товара из корзины ( remove ) Только GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Совместимый .

Все параметры UA переводятся в эквиваленты GA4 и отправляются.

Отчеты GA4, для которых требуются какие-либо параметры только GA4, будут неполными.
Совместимый .

Параметры GA4 с эквивалентным параметром UA транслируются и отправляются.* Параметры только GA4 не отправляются.

* item_list_name не отправляется, но такое поведение соответствует gtag.js (UA), который не отправляет list_name .

Отчеты UA, заполненные данными о событии GA4, будут полными/без изменений.
Н/Д Событие рекомендуется только для GA4.
Несовместимо* .

*Маловероятно, что ваша реализация UA отправит это событие, поскольку это не рекомендуемое событие. Чтобы обеспечить полноту отчетов GA4, вы можете реализовать это событие для UA, используя формат GA4.

Если вы реализуете событие GA4 для UA, оно будет отображаться как событие без данных items , что может быть не очень полезно. Это не повлияет на отчеты об электронной торговле UA.
Не совместимо .

Обращение к событию отправляется с общим значением event_category , view_cart как event_action и параметром value как event_value . Данные items не отправляются.

Поскольку это событие обычно не поддерживается в отчетах по электронной торговле UA, оно не окажет какого-либо заметного эффекта.
Этапы оформления заказа ( checkout , checkout_option ) Только GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Совместимый .

Все параметры UA переводятся в эквиваленты GA4 и отправляются.

Отчеты GA4, для которых требуются какие-либо параметры только GA4, будут неполными.
Совместимый .

Параметры GA4 с эквивалентным параметром UA транслируются и отправляются.* Параметры только GA4 не отправляются.

* item_list_name не отправляется, но такое поведение соответствует gtag.js (UA), который не отправляет list_name .

begin_checkout фактически эквивалентен отправке события checkout_progress со значением checkout_step , равным 1 .

Отчеты UA, заполненные данными о событии GA4, будут полными/без изменений.
add_payment_info Только GA4:
currency
value
coupon
payment_type
items

UA:
Н/Д: параметры не поддерживаются.
Несовместимо* .

*Поскольку UA не поддерживает параметры для этого события, они не отправляются. Это сработает, но, скорее всего, не будет очень полезным.

Отчеты GA4, для которых требуются какие-либо параметры событий, будут неполными.
Совместимый .

Эквивалентное событие отправляется с электронной торговлей как event_category , add_to_wishlist как event_action и параметром value (приведенным к целому числу) как event_value . Обратите внимание, что преобразование из GA4 в UA включает event_value , но обычно оно не устанавливается для обращений UA.

Отчеты UA, заполненные данными о событии GA4, будут полными/без изменений. Поскольку это событие обычно не поддерживается в отчетах по электронной торговле UA, оно не окажет какого-либо заметного эффекта.
Н/Д Событие рекомендуется только для GA4.
Несовместимо* .

*Маловероятно, что ваша реализация UA отправит это событие, поскольку это не рекомендуемое событие. Чтобы обеспечить полноту отчетов GA4, вы можете реализовать это событие для UA, используя формат GA4.

Если вы реализуете событие GA4 для UA, оно будет отображаться как событие без данных items , что может быть не очень полезно. Это не повлияет на отчеты об электронной торговле UA.
Несовместимо* .

Обращение к событию отправляется с общим значением event_category , add_shipping_info как event_action и параметром value (приведенным к целому числу) как event_value . Параметр currency GA4 отправляется вместе с обращением в качестве валюты .

Поскольку это событие обычно не поддерживается в отчетах по электронной торговле UA, оно не окажет какого-либо заметного эффекта.
Этапы оформления заказа ( checkout , checkout_option ) Н/Д События рекомендуются только для UA.
Событие будет рассматриваться как пользовательское событие . Будут отправлены только параметры уровня события, данные items отправлены не будут.

Поскольку эти события обычно не поддерживаются в отчетах по электронной торговле GA4, они не окажут какого-либо заметного эффекта.
 Н/Д
Показы от промо-акции ( promoView ) Только GA4:
creative_name
creative_slot
location_id
promotion_id
promotion_name
items

Только UA:
promotions
 Не совместимо .

Пользовательское событие view_promotion отправляется с promotions в качестве специального параметра. Пользовательский параметр promotions не содержит никаких полезных данных.		 Не совместимо .

Обращение к событию UA отправляется с участием в качестве event_category и view_promotion в качестве event_action . Данные promotions не отправляются. Событие помечается как событие отсутствия взаимодействия .
Измерение покупок ( purchase ) Только GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Совместимый .

Все параметры UA переводятся в эквиваленты GA4 и отправляются.

Используется currency уровня события, поскольку currency уровня элемента не поддерживается.

Отчеты GA4, для которых требуются какие-либо параметры только GA4, будут неполными.
Совместимый .

Параметры GA4 с эквивалентным параметром UA транслируются и отправляются.* Параметры только GA4 не отправляются.

* item_list_name не отправляется, но такое поведение соответствует gtag.js (UA), который не отправляет list_name .

Отчеты UA, заполненные данными о событии GA4, будут полными/без изменений.
Измерение возвратов ( refund ) Только GA4:
affiliation
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Совместимый .

Все параметры UA переводятся в эквиваленты GA4 и отправляются.

Используется currency уровня события, поскольку currency уровня элемента не поддерживается.

Отчеты GA4, для которых требуются какие-либо параметры только GA4, будут неполными.
Совместимый .

Параметры GA4 с эквивалентным параметром UA транслируются и отправляются.* Параметры только GA4 не отправляются.

* item_list_name не отправляется, но такое поведение соответствует gtag.js (UA), который не отправляет list_name .

Отчеты UA, заполненные данными о событии GA4, будут полными/без изменений.