← Cloudflare Zaraz / zaraz / web-api
Электронная коммерция
Вы можете использовать zaraz.ecommerce() в любом месте внутри <body> тег страницы.
zaraz.ecommerce() позволяет отслеживать типичные события пути пользователя в электронной коммерции, например когда пользователь добавляет товар в корзину, начинает оформление заказа или завершает заказ на сайте. Это async функцию, поэтому вы можете выбрать await его, если хотите убедиться, что он завершился, прежде чем выполнять остальной код.
Чтобы начать использовать zaraz.ecommerce(), сначала включите эту функцию в своей учетной записи Zaraz, а также включите действие E-commerce для инструмента, которому планируете отправлять данные электронной коммерции. Затем добавьте zaraz.ecommerce() к <body> элемент вашего сайта.
На данный момент Zaraz e-commerce совместим с Google Analytics 3 (Universal Analytics), Google Analytics 4, Bing, Facebook Pixel, Amplitude, Pinterest Conversions API, TikTok и Branch.
Включение отслеживания электронной коммерции
Сопоставлять события электронной коммерции с триггерами не нужно: Zaraz автоматически передаёт данные в нужном формате инструментам с поддержкой электронной коммерции.
-
На панели управления Cloudflare перейдите к разделу Настройки страницу.
Перейдите в Настройки ↗ -
Включить Отслеживание электронной коммерции.
-
Выберите Save.
-
Перейдите в Zaraz > Конфигурация инструментов > Сторонние инструменты.
-
Найдите инструмент, который нужно использовать для отслеживания электронной коммерции, и выберите Изменить.
-
Выберите Настройки.
-
В разделе Продвинутый уровень, включите Отслеживание электронной коммерции.
-
Выберите Save.
Отслеживание электронной коммерции теперь включено. Если вы добавите на сайт дополнительные инструменты, которые хотите использовать с zaraz.ecommerce(), вам нужно будет повторить шаги 6-9 для этого инструмента.
Добавление отслеживания электронной коммерции на ваш сайт
После включения отслеживания электронной коммерции на панели Zaraz необходимо добавить zaraz.ecommerce() к <body> элемент вашего сайта:
zaraz.ecommerce("Event Name", { parameters });Чтобы создать полноценное событие отслеживания, нужно добавить событие и один или несколько параметров. Ниже приведён список событий и параметров, поддерживаемых Zaraz, а также примеры кода для разных типов событий.
Список поддерживаемых событий
Product List ViewedProducts SearchedProduct ClickedProduct AddedProduct Added to WishlistProduct RemovedProduct ViewedCart ViewedCheckout StartedCheckout Step ViewedCheckout Step CompletedPayment Info EnteredOrder CompletedOrder UpdatedOrder RefundedOrder CancelledClicked PromotionViewed PromotionShipping Info Entered
Список поддерживаемых параметров:
| Параметр | Тип | Описание |
|---|---|---|
product_id |
String | ID товара. |
sku |
String | Номер SKU товара. |
category |
String | Категория товара. |
name |
String | Название товара. |
brand |
String | Название бренда товара. |
variant |
String | Вариант товара (например, цвет или размер, в зависимости от товара). |
price |
Число | Цена товара. |
quantity |
Число | Количество единиц товара. |
coupon |
String | Название или серийный номер купона, связанного с товаром. |
position |
Число | Позиция товара в списке товаров (например, 2). |
products |
Array | Список товаров, показанных в списке товаров. |
products.[].product_id |
String | ID товара, отображаемого в списке товаров. |
products.[].sku |
String | SKU товара, отображаемого в списке товаров. |
products.[].category |
String | Категория товара, отображаемого в списке товаров. |
products.[].name |
String | Название товара, отображаемого в списке товаров. |
products.[].brand |
String | Бренд товара, отображаемого в списке товаров. |
products.[].variant |
String | Вариант товара, отображаемый в списке товаров. |
products.[].price |
Число | Цена товара, отображаемого в списке товаров. |
products.[].quantity |
Число | Количество товара, отображаемое в списке товаров. |
products.[].coupon |
String | Название или серийный номер купона, связанного с товаром в списке товаров. |
products.[].position |
Число | Позиция товара в списке товаров (например, 2). |
checkout_id |
String | ID оформления заказа. |
order_id |
String | Внутренний ID заказа, транзакции или покупки. |
affiliation |
String | Название партнёра, через которого был оформлен заказ. |
total |
Число | Выручка с учётом скидок и купонов. |
revenue |
Число | Выручка без учёта доставки и налогов. |
shipping |
Число | Стоимость доставки для транзакции. |
tax |
Число | Общий налог по транзакции. |
discount |
Число | Общая скидка по транзакции. |
coupon |
String | Название или серийный номер купона, использованного на уровне транзакции. |
currency |
String | Код валюты транзакции. |
value |
Число | Итоговая стоимость товара с учётом количества. |
creative |
String | Метка креативного материала для отслеживаемой акции. |
query |
String | Поисковый запрос товара. |
step |
Число | Номер шага в процессе оформления заказа. |
payment_type |
String | Используемый способ оплаты. |
Примеры кода событий
Product viewed
zaraz.ecommerce("Product Viewed", {
product_id: "999555321",
sku: "2671033",
category: "T-shirts",
name: "V-neck T-shirt",
brand: "Cool Brand",
variant: "White",
price: 14.99,
currency: "usd",
value: 18.99,
});Product List Viewed
zaraz.ecommerce("Product List Viewed", {
products: [
{
product_id: "999555321",
sku: "2671033",
category: "T-shirts",
name: "V-neck T-shirt",
brand: "Cool Brand",
variant: "White",
price: 14.99,
currency: "usd",
value: 18.99,
position: 1,
},
{
product_id: "999555322",
sku: "2671034",
category: "T-shirts",
name: "T-shirt",
brand: "Cool Brand",
variant: "Pink",
price: 10.99,
currency: "usd",
value: 16.99,
position: 2,
},
],
});Product added
zaraz.ecommerce("Product Added", {
product_id: "999555321",
sku: "2671033",
category: "T-shirts",
name: "V-neck T-shirt",
brand: "Cool Brand",
variant: "White",
price: 14.99,
currency: "usd",
quantity: 1,
coupon: "SUMMER-SALE",
position: 2,
});Checkout Step Viewed
zaraz.ecommerce("Checkout Step Viewed", {
step: 1,
});Order completed
zaraz.ecommerce("Order Completed", {
checkout_id: "616727740",
order_id: "817286897056801",
affiliation: "affiliate.com",
total: 30.0,
revenue: 20.0,
shipping: 3,
tax: 2,
discount: 5,
coupon: "winter-sale",
currency: "USD",
products: [
{
product_id: "999666321",
sku: "8251511",
name: "Boy’s shorts",
price: 10,
quantity: 2,
category: "shorts",
},
{
product_id: "742566131",
sku: "7251567",
name: "Blank T-shirt",
price: 5,
quantity: 2,
category: "T-shirts",
},
],
});