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

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

Настроив отправку данных в Google Analytics с помощью 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 Analytics.

Событие Описание
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": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": 3
    }
  ]
});

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

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

gtag('event', 'select_content', {
  "content_type": "product",
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list": "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'
    }
  ]
});