Расширенная электронная торговля

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

Примечание. Google Аналитика 4 – это будущее нашего сервиса. Мы рекомендуем перейти на события электронной торговли GA4, чтобы в дальнейшем пользоваться всеми функциями. Подробнее…

Типы данных и отслеживаемые действия

С помощью плагина расширенной электронной торговли можно отправлять следующие данные:

• Данные о показе
• Данные о товаре
• Данные о действии
• Типы действий

Данные о показе

Информацию о том, какие именно данные о товаре были просмотрены, можно получить с помощью объекта impressionFieldObject, который содержит следующие поля:

Ключ	Тип значения	Обязательное поле	Описание
id	Текст	Да*	Идентификатор или код товара. Пример: P67890. *Должен быть указан один из параметров (id или name).
name	Текст	Да*	Название товара. Пример: "Футболка Android". *Должен быть указан один из параметров (id или name).
list	Текст	Нет	Список или коллекция, куда входит товар. Пример: "Результаты поиска".
list_name	Текст	Нет	Список или коллекция, куда входит товар. Пример: "Результаты поиска".
brand	Текст	Нет	Бренд, к которому относится товар. Пример: Google.
category	Текст	Нет	Категория, к которой относится товар. Пример: "Одежда". Вы можете указать до 5 уровней иерархии, используя в качестве разделителя косую черту (/). Пример: "Одежда/Мужская одежда/Футболки".
variant	Текст	Нет	Вариант товара. Пример: "Черный".
position	Целое число	Нет	Позиция товара в списке или коллекции. Пример: 2.
list_position	Целое число	Нет	Позиция товара в списке или коллекции. Пример: 2.
price	Число	Нет	Цена товара. Пример: 29,20.

Данные о товаре

Данные об отдельных товарах, которые были просмотрены, добавлены в корзину покупок и т. д., передаются с помощью объекта productFieldObject. Он содержит следующие значения:

Ключ	Тип значения	Обязательное поле	Описание
id	Текст	Да*	Идентификатор или код товара. Пример: P67890. *Должен быть указан один из параметров (идентификатор или name).
name	Текст	Да*	Название товара. Пример: "Футболка Android". *Должен быть указан один из параметров (идентификатор или name).
brand	Текст	Нет	Бренд, к которому относится товар. Пример: Google.
category	Текст	Нет	Категория, к которой относится товар. Пример: "Одежда". Вы можете указать до 5 уровней иерархии, используя в качестве разделителя косую черту. Пример: "Одежда/Мужская одежда/Футболки".
variant	Текст	Нет	Вариант товара. Пример: "Черный".
price	Число	Нет	Цена товара. Пример: 29,20.
quantity	Целое число	Нет	Количество единиц товара. Пример: 2.
coupon	Текст	Нет	Код купона, связанного с товаром. Пример: SUMMER_SALE13.
position	Целое число	Нет	Позиция товара в списке или коллекции. Пример: 2.
list_position	Целое число	Нет	Позиция товара в списке или коллекции. Пример: 2.

Данные о рекламной акции

Информация о рекламной акции передается с помощью объекта promoFieldObject, который содержит следующие значения:

Ключ	Тип значения	Обязательное поле	Описание
id	Текст	Да*	Идентификатор рекламной акции. Пример: PROMO_1234. *Один из параметров (id или name) должен быть указан.
name	Текст	Да*	Название рекламной акции. Пример: "Летняя распродажа". *Один из параметров (id или name) должен быть указан.
creative	Текст	Нет	Объявление, связанное с рекламной акцией. Пример: summer_banner2.
creative_name	Текст	Нет	Название креатива. Пример: summer_banner2.
position	Текст	Нет	Позиция объявления. Пример: banner_slot_1.
creative_slot	Текст	Нет	Название рекламного места для объявления. Пример: banner_slot_1.

Данные о действии

Информация о выполненном действии передается с помощью объекта actionFieldObject, который содержит следующие значения:

Ключ	Тип значения	Обязательное поле	Описание
id	Текст	Да*	Идентификатор транзакции. Пример: T1234. *Обязательно, если тип действия – purchase (покупка) или refund (возврат).
affiliation	Текст	Нет	Магазин или филиал, в котором произошла транзакция. Пример: Google Store.
revenue	Число	Нет	Общий доход или суммарная ценность транзакции. Пример: 11,99. Это значение может включать любые корректировки общего дохода (стоимость доставки, налоги и т. д.). Примечание. Если доход не указан, это значение будет вычислено автоматически с использованием полей "Количество товара" и "Цена товара".
Значение	Число	Нет	Ценность события (т. е. доход от него).
tax	Число	Нет	Сумма всех налогов, связанных с транзакцией.
shipping	Число	Нет	Стоимость доставки, связанная с транзакцией.
coupon	Текст	Нет	Купон, погашенный при транзакции.
list	Текст	Нет	Список, в который входят товары, связанные с транзакцией. Необязательно.
items	Массив	Нет	Список товаров, связанных с транзакцией.
step	Целое число	Нет	Число, представляющее этап последовательности покупки. Необязательное поле, используемое для действий типа checkout (оформление покупки).
checkout_step	Целое число	Нет	Число, представляющее этап последовательности покупки.
option	Текст	Нет	Дополнительное поле для действий типа checkout и checkout_option. Предоставляет информацию о параметре (например, о способе оплаты), выбранном при оформлении покупки.
checkout_option	Текст	Нет	Параметр покупки (выбранный способ оплаты).

Ключ	Тип значения	Обязательное поле	Описание
coupon	string	Нет	Код купона для товара, выставленного на продажу.

Действия с товарами и рекламными акциями

Действия определяют, как будут интерпретироваться данные, которые вы отправляете в Google Аналитику.

Действие	Событие	Описание
click	Клик по товару/ссылке на товар (или товары).
detail	Просмотр информации о товаре.
add	Добавление одного или нескольких товаров в корзину покупок.
remove	Удаление одного или нескольких товаров из корзины покупок.
checkout	Переход к оформлению покупки одного или нескольких товаров.
checkout_option	Вариант, выбранный пользователем на определенном этапе оформления покупки.
purchase	Продажа одного или нескольких товаров.
refund	Возврат одного или нескольких товаров.
promo_click	Клик по внутренней рекламе.
add_to_cart	Добавление одного или нескольких товаров в корзину покупок.
begin_checkout	Переход к оформлению покупки одного или нескольких товаров.
checkout_progress	Завершение этапов оформления покупки.
purchase	Покупка.
refund	Оформление возврата средств за один или несколько товаров.
remove_from_cart	Удаление одного или нескольких товаров из корзины покупок.
select_content	Клик по товару или ссылке на товар.
set_checkout_option	Параметр, выбранный пользователем на определенном этапе оформления покупки.
view_item	Просмотр описания товара.
view_item_list	Просмотр списка товаров.
view_promotion	Клик по внутренней рекламе.
view_refund	Просмотр данных о возврате средств за один или несколько товаров.

Примеры

Как отслеживать показы товара

Отправьте событие view_item_list с данными об этом товаре:

gtag('event', 'view_item_list', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": 3
    }
  ]
});

Как отслеживать клики по товару

Чтобы отследить клик по товару, отправьте событие select_content, присвоив объекту product значение content_type и добавив информацию о товаре:

gtag('event', 'select_content', {
  "content_type": "product",
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    }
  ]
});

Как отслеживать просмотры страницы с информацией о товарах

Нажав на ссылку с информацией о товаре, пользователь попадает на страницу с подробными сведениями. Чтобы отслеживать просмотры такой страницы, отправьте событие view_item с информацией о товаре:

gtag('event', 'view_item', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Как отслеживать корзину покупок

Чтобы отслеживать добавление в корзину, отправьте событие add_to_cart с информацией о товаре:

gtag('event', 'add_to_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Чтобы отслеживать удаление из корзины, отправьте событие remove_from_cart с информацией о товаре:

gtag('event', 'remove_from_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Как отслеживать процесс оформления покупки

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

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

1. Как отслеживать разные этапы оформления покупки

Чтобы отследить первый этап оформления покупки, отправьте событие begin_checkout с информацией о товарах:

gtag('event', 'begin_checkout', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": ""
});

Чтобы отследить последующие этапы, отправьте событие checkout_progress с информацией о товарах:

gtag('event', 'checkout_progress', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": "SUMMER_DISCOUNT"
});

2. Как отслеживать параметры покупки

Чтобы отследить параметры покупки, отправьте событие set_checkout_option с параметром checkout_option:

gtag('event', 'set_checkout_option', {
  "checkout_step": 1,
  "checkout_option": "shipping method",
  "value": 3
});

Как отслеживать показы рекламной акции

Отправьте событие view_promotion с информацией об акции:

gtag('event', 'view_promotion', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    },
    {
      "id": "xyz987",
      "name": "spring savings"
    }
  ]
});

Как отслеживать клики по рекламной акции

Отправьте событие select_content с информацией об этой рекламной акции:

gtag('event', 'select_content', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    }
  ]
});

Как отслеживать покупки

Отправьте событие purchase с информацией о проданных товарах:

gtag('event', 'purchase', {
  "transaction_id": "24.031608523954162",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});

Как отслеживать возвраты

Чтобы отслеживать полные возвраты, отправьте событие refund с идентификатором транзакции:

gtag('event', 'refund', { "transaction_id": "T12345" })

Чтобы отслеживать частичные возвраты, отправьте событие refund с идентификатором транзакции и списком возвращаемых товаров:

gtag('event', 'refund', {
  "transaction_id": "79.18502354114992",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});