Как использовать gtag.js в расширенной электронной торговле

Из этой статьи вы узнаете, как собирать данные о расширенной электронной торговле с помощью кода gtag.js.

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

Список событий, связанных с электронной торговлей, приведен в справке по событиям и параметрам gtag.js.

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

Перечисленные ниже параметры позволяют получать информацию о просмотренном товаре.

Параметр товара Тип данных Обязательный? Описание
id string Да* Уникальный идентификатор или код товара
name string Да* Название товара
list_name string Нет Список, в котором товар был представлен пользователю
brand string Нет Бренд товара
category string Нет Категория товара
variant string Нет Разновидность товара
list_position integer Нет Позиция товара в списке
price currency Нет Покупная цена товара

*Должен быть задан параметр id или name.

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

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

Параметр товара Тип данных Обязательный? Описание
id string Да* Уникальный идентификатор или код товара
name string Да* Название товара
brand string Нет Бренд товара
category string Нет Категория товара
variant string Нет Разновидность товара
price currency Нет Покупная цена товара
quantity integer Нет Количество единиц товара
coupon string Нет Код купона выставленного на продажу товара
list_position integer Нет Позиция товара в списке

*Должен быть задан параметр id или name.

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

Перечисленные ниже параметры позволяют получать информацию о просмотренной рекламной акции.

Параметр рекламной акции Тип данных Обязательный? Описание
id string Да* Идентификатор рекламной акции
name string Да* Название рекламной акции
creative_name string Нет Название использованного объявления
creative_slot string Нет Название рекламного места

*Должен быть задан параметр id или name.

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

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

Параметр события Тип данных Обязательный? Описание
transaction_id string Да* Уникальный идентификатор транзакции
affiliation string Нет Магазин или филиал, в котором выполнена транзакция
value number Нет Ценность события (доход от него)
tax currency Нет Сумма налога
shipping currency Нет Стоимость доставки
items array Нет Список товаров, связанных с транзакцией
checkout_step number Нет Шаг (номер этапа) в процессе оформления заказа
checkout_option string Нет Параметры покупки (выбранный способ оплаты)

*Обязателен для событий purchase (покупка) и refund (возврат).

Параметр товара Тип данных Обязательный? Описание
coupon string Нет Код купона выставленного на продажу товара

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

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

Событие Описание
select_content Нажатие на товар/ссылку на товар (или товары).
view_item Просмотр информации о товаре.
add_to_cart Добавление одного или нескольких товаров в корзину.
remove_from_cart Удаление одного или нескольких товаров из корзины.
begin_checkout Переход к оформлению покупки.
set_checkout_option Вариант, выбранный пользователем на определенном этапе оформления покупки.
purchase Продажа одного или нескольких товаров.
refund Возврат одного или нескольких товаров.
view_promotion Показ промоакции.

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

Чтобы отслеживать показы товаров, отправьте событие 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'
    }
  ]
});

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

Чтобы отслеживать показы промоакции, отправьте событие 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"
    }
  ]
});

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

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

  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": "USPS"
});

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

Чтобы отследить транзакцию, отправьте событие 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'
    }
  ]
});