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

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

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

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

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

Информацию о том, какие именно данные о товаре были просмотрены, можно получить с помощью объекта 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'
    }
  ]
});