ИнтеграцииFinteza JavaScript ClientE-Commerce

E-Commerce

Если у вас Интернет-магазин, Finteza поможет получить по нему детальную аналитику, благодаря поддержке событий E-Commerce. Настроив их отправку на своем сайте, вы сможете:

  • Узнать какие товары и бренды популярны
  • Определить реальный объем продаж
  • Оценить упущенную выгоду, когда потенциальный покупатель по какой-то причине не завершает покупки

И это далеко не полный список информации, которую вы сможете получить. Больше деталей вы найдете в статье "В Finteza появился E-Commerce".

Как это работает #

E-Commerce работает аналогично событиям. Вы также устанавливаете трекинг-код на ваш сайт, а затем добавляете на страницы функции для отправки событий: например, при прохождении очередного этапа покупки, добавлении товара в корзину и т.д.

В отличие от обычных событий, треки E-Commerce обладают гораздо большим набором параметров. Они используются для отображения данных в специальных отчетах в панели Finteza:

Отчет e-Commerce в Finteza

Как отправлять события E-Commerce #

После подключения Finteza JavaScript Client вы можете отправлять E-Commerce события. Для этого добавьте на страницу сайта JavaScript-код следующего вида:

fz("ecommerce", {
  "event""{EVENT_NAME}"
  "{CART_PARAMETER1}""CART_VALUE1",
  "{CART_PARAMETER2}""CART_VALUE2",
  ...
  "items": [
    {
     "ITEM1_PARAMETER1""ITEM1_VALUE1",
     "ITEM1_PARAMETER2""ITEM1_VALUE2",
     ...
    },
    {
     "ITEM2_PARAMETER1""ITEM2_VALUE1",
     "ITEM2_PARAMETER2""ITEM2_VALUE2",
     ...
     },
     ...
  ]
} );

Вместо {EVENT_NAME}, укажите название события из списка доступных, например "View Item".

Далее добавьте описание события в формате JSON. Оно составляется из предопределенных параметров:

  • Сначала следуют параметры корзины, если событие связано с ней.
  • Далее в параметре items передается массив описаний товаров.

Список параметров следует выбирать исходя из типа события. Например, для события просмотра товара нет смысла указывать параметры доставки.

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

Далее подробно рассмотрим заполнение трека на примере основного события eCommerce — успешного завершения покупки.

Пример отправки трека для события Checkout Success #

Checkout Success — это событие успешного завершение покупки. В нем можно передать максимальное количество информации: от данных транзакции до данных о доставке.

Описание события передается в виде параметров. Общие параметры покупки, такие как номер транзакции, покупатель и т.д., заполняются только в секции корзины:

  • cart_id — идентификатор корзины.
  • transaction_id — идентификатор платежа.
  • seller, buyer — имя или идентификатор продавца и покупателя. Это могут быть логины пользователей на вашем сайте. Эти параметры необходимы для построения отчетов по топовым покупателям. Такие отчеты полезны, если вы предоставляете площадку для продажи товаров множеству сторонних продавцов.
  • affiliation — магазин или филиал, в котором выполнена транзакция оплаты.
  • detail — здесь при необходимости можно указать дополнительную информацию о покупке.
  • checkout_option — способ оплаты.
  • checkout_step — номер шага покупки. Например, если покупка на вашем сайте состоит из трех этапов: просмотра корзины, ввода данных о доставке и оплаты, вы можете пронумеровать их как 1, 2 и 3. Соответственно, на этапе успешной покупки вы передаете значение 3.

Дополнительно в секции корзины могут быть указаны суммарные платежные параметры (общая стоимость, скидка и т.д.). После описания корзины следует описание каждого товара в ней.

Отдельно рассмотрим особенности заполнения денежных параметров: profit, value, price, transaction_fee, tax_value, discount_value, shipping_value.

  • Для корзины — price не заполняется. Остальные параметры заполняются как суммарное значения соответствующих параметров товаров в корзине. Значения указываются в деньгах.
  • Для товара — в параметре price указывается цена за один товар, даже если выполняется покупка нескольких единиц товара (quantity > 1). Остальные значения указываются с учетом количества единиц товара. Например, если цена товара равна 300 USD (price = 300), и в корзине находится 5 единиц товара (quantity = 5), то в параметре value следует передать значение 1500.

fz('ecommerce', {
  "event""Checkout Success"
  "transaction_id""CH38027",
  "affiliation""Online store",
  "buyer""john_smith",
  "seller""Europe Shop",
  "cart_id""C89367",
  "cart_items": 2,
  "currency""USD",
  "value": 7.07,
  "profit": 2,
  "transaction_fee": 0.07,
  "tax_value": 0.7,
  "tax_name""Tax",
  "tax_type""VAT",
  "discount_value": 1,
  "discount_name""Black Friday",
  "discount type""B112029",
  "shipping_value": 0.3,
  "shipping_name""Shipping",
  "shipping_type""Standard Post",
  "checkout_step": 1,
  "checkout_option" : "Shipping",
  "items": [
    {
      "id""P12345",
      "name""USB Charger",
      "brand""ChargeIt",
      "category""Accessories",
      "variant""Black",
      "quantity": 2,
      "currency""USD"
      "price": 2,
      "value": 4.24,
      "profit": 1.6,
      "transaction_fee": 0.04,
      "tax_value": 0.4,
      "tax_name""Tax",
      "tax_type""VAT",
      "discount_value": 0.4,
      "discount_name""Black Friday",
      "discount type""B112029",
      "shipping_value": 0.2,
      "shipping_name""Shipping",
      "shipping_type""Standard Post",
    },
    {
      "id""P67890",
      "name""Finteza TShirt",
      "brand""Finteza",
      "category""T-Shirts",
      "variant""Red",
      "quantity": 1,
      "currency""USD"
      "price": 3.00,
      "value": 2.83,
      "profit": 0.4,
      "transaction_fee": 0.03,
      "tax_value": 0.3,
      "tax_name""Tax",
      "tax_type""VAT",
      "discount_value": 0.6,
      "discount_name""Black Friday",
      "discount type""B112029"
      "shipping_value": 0.1,
      "shipping_name""Shipping",
      "shipping_type""Standard Post",
    }
  ]
});

В результате отправки этого трека в Finteza будет создано 3 события:

  • Событие "Checkout Success" для каждого из товаров. В них будут указаны transaction_id, affiliation, cart_id, checkout_step, checkout_option, взятые из описания корзины.
  • Событие "Checkout Success" для корзины. Если cart_id не указан, событие не cгенерируется.

Поднимите прибыль со своего сайта с помощью:

Зарегистрируйтесь сейчас, чтобы получить 30 дней бесплатного доступа.

Регистрируясь, вы принимаете Соглашение об услугах
Поздравляем, аккаунт создан
  • Посетите
    finteza.com
  • Получите
    аккаунт
  • Подтвердите
    email
  • Установите
    код

На почтовый ящик {email} мы отправили письмо, пожалуйста, найдите его и активируйте аккаунт.

После этого вы сможете авторизоваться, и останется только установить трекинг-код на сайт. Это просто: