INTEGRITY Dokumentace

E-commerce

Můžete použít zaraz.ecommerce() kdekoli uvnitř <body> značka stránky.

zaraz.ecommerce() umožňuje sledovat běžné události v cestě e-commerce uživatele, například když uživatel přidá produkt do košíku, zahájí proces objednávky nebo dokončí objednávku na vašem webu. Jedná se o async funkci, takže si můžete zvolit, zda await to, pokud se chcete ujistit, že bylo dokončeno před spuštěním dalšího kódu.

Chcete-li začít používat zaraz.ecommerce(), musíte ji nejprve povolit ve svém účtu Zaraz a zapnout akci E-commerce pro nástroj, kterému chcete data o e-commerce odesílat. Poté přidejte zaraz.ecommerce() do <body> element vašeho webu.

Zaraz e-commerce je v současné době kompatibilní s Google Analytics 3 (Universal Analytics), Google Analytics 4, Bing, Facebook Pixel, Amplitude, Pinterest Conversions API, TikTok a Branch.

Aktivace sledování e-commerce

Události e-commerce nemusíte mapovat na spouštěče. Zaraz data automaticky předává ve správném formátu nástrojům, které e-commerce podporují.

  1. V dashboardu Cloudflare přejděte na Nastavení stránce.

    Přejděte na Nastavení ↗
  2. Povolit Sledování e-commerce.

  3. Vyberte Save.

  4. Přejděte na Zaraz > Konfigurace nástrojů > Nástroje třetích stran.

  5. Vyhledejte nástroj, který chcete použít pro sledování e-commerce, a vyberte Úprava.

  6. Vyberte Nastavení.

  7. V části Pokročilé, zapněte Sledování e-commerce.

  8. Vyberte Save.

Sledování e-commerce je nyní zapnuté. Pokud na web přidáte další nástroje, které chcete použít s zaraz.ecommerce(), budete muset zopakovat kroky 6-9 pro daný nástroj.

Přidání sledování e-commerce na váš web

Po zapnutí sledování e-shopu na vašem Zaraz dashboardu musíte přidat zaraz.ecommerce() do <body> element vašeho webu:

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

Chcete-li vytvořit úplnou sledovací událost, musíte přidat událost a jeden nebo více parametrů. Níže najdete seznam událostí a parametrů, které Zaraz podporuje, a také příklady kódu pro různé typy událostí.

Seznam podporovaných událostí

Seznam podporovaných parametrů:

Parametr Typ Popis
product_id Řetězec ID produktu.
sku Řetězec Číslo SKU produktu.
category Řetězec Kategorie produktu.
name Řetězec Název produktu.
brand Řetězec Název značky produktu.
variant Řetězec Varianta produktu (v závislosti na produktu může jít například o barvu nebo velikost).
price Číslo Cena produktu.
quantity Číslo Počet kusů produktu.
coupon Řetězec Název nebo sériové číslo kódu kupónu spojeného s produktem.
position Číslo Pozice produktu v seznamu produktů (například 2).
products Array Seznam produktů zobrazených v seznamu produktů.
products.[].product_id Řetězec ID produktu zobrazené v seznamu produktů.
products.[].sku Řetězec SKU produktu zobrazené v seznamu produktů.
products.[].category Řetězec Kategorie produktu zobrazená v seznamu produktů.
products.[].name Řetězec Název produktu zobrazený v seznamu produktů.
products.[].brand Řetězec Značka produktu zobrazená v seznamu produktů.
products.[].variant Řetězec Varianta produktu zobrazená v seznamu produktů.
products.[].price Číslo Cena produktu zobrazená v seznamu produktů.
products.[].quantity Číslo Množství produktu zobrazené v seznamu produktů.
products.[].coupon Řetězec Název nebo sériové číslo kódu kupónu spojeného s produktem zobrazeným v seznamu produktů.
products.[].position Číslo Pozice produktu v seznamu produktů (například 2).
checkout_id Řetězec ID checkoutu.
order_id Řetězec Interní ID objednávky, transakce nebo nákupu.
affiliation Řetězec Název affiliate partnera, od kterého objednávka vznikla.
total Číslo Tržby včetně započtených slev a kupónů.
revenue Číslo Tržby bez poštovného a daní.
shipping Číslo Náklady na dopravu za transakci.
tax Číslo Celková daň za transakci.
discount Číslo Celková sleva za transakci.
coupon Řetězec Název nebo sériové číslo kupónu uplatněného na úrovni celé transakce.
currency Řetězec Kód měny transakce.
value Číslo Celková hodnota produktu po vynásobení množstvím.
creative Řetězec Popisek kreativy sledované propagační akce.
query Řetězec Hledaný výraz produktu.
step Číslo Číslo kroku v rámci procesu checkoutu.
payment_type Řetězec Typ použité platby.

Příklady kódu událostí

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",
		},
	],
});