INTEGRITY Документация

Электронная коммерция

Вы можете использовать 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 автоматически передаёт данные в нужном формате инструментам с поддержкой электронной коммерции.

  1. На панели управления Cloudflare перейдите к разделу Настройки страницу.

    Перейдите в Настройки ↗
  2. Включить Отслеживание электронной коммерции.

  3. Выберите Save.

  4. Перейдите в Zaraz > Конфигурация инструментов > Сторонние инструменты.

  5. Найдите инструмент, который нужно использовать для отслеживания электронной коммерции, и выберите Изменить.

  6. Выберите Настройки.

  7. В разделе Продвинутый уровень, включите Отслеживание электронной коммерции.

  8. Выберите Save.

Отслеживание электронной коммерции теперь включено. Если вы добавите на сайт дополнительные инструменты, которые хотите использовать с zaraz.ecommerce(), вам нужно будет повторить шаги 6-9 для этого инструмента.

Добавление отслеживания электронной коммерции на ваш сайт

После включения отслеживания электронной коммерции на панели Zaraz необходимо добавить zaraz.ecommerce() к <body> элемент вашего сайта:

zaraz.ecommerce("Event Name", { parameters });

Чтобы создать полноценное событие отслеживания, нужно добавить событие и один или несколько параметров. Ниже приведён список событий и параметров, поддерживаемых Zaraz, а также примеры кода для разных типов событий.

Список поддерживаемых событий

Список поддерживаемых параметров:

Параметр Тип Описание
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",
		},
	],
});