Objekt produktů – contents
Pole contents popisuje jednotlivé produkty v transakci. Předává se v událostech ViewContent, AddToCart, AddToWishlist, InitiateCheckout, AddPaymentInfo a Purchase.
Parametry objektu
Každý objekt v poli popisuje jeden produkt. Pole může obsahovat libovolný počet objektů.
| Parametr | Typ | Doporučenost | Příklad hodnoty | Popis |
|---|---|---|---|---|
id | string | Povinný u Purchase | 'ABC12345' | Unikátní identifikátor položky v e-shopu – totožný s hodnotou, kterou používáte v tagu ITEM_ID v XML feedu Zboží.cz. |
quantity | number | Povinný u Purchase | 2 | Počet kusů daného produktu v košíku / objednávce. |
unit_price | number | Povinný u Purchase | 33490 | Cena za jeden kus v CZK včetně DPH. |
content_name | string | Povinný u Purchase | 'iPhone 15 Pro Max' | Libovolný název. Lze použít jako podmínku retargetingu. |
content_category | string | Doporučený | 'Elektronika | Mobilní telefony | Apple' | Kompletní cesta kategorie z vašeho XML feedu. Jako oddělovač úrovní slouží svislá čára | (pipe). Předávejte stejnou hodnotu, jakou máte uvedenou u nabídek v XML feedu – celý řetězec pak lze použít jako přesnou podmínku pro retargeting nebo konverze. |
Příklad
contents: [
{
id: 'ABC12345',
quantity: 1,
unit_price: 33490, // s DPH
content_name: 'iPhone 15 Pro Max',
content_category: 'Elektronika | Mobilní telefony | Apple'
},
{
id: 'KRYT999',
quantity: 2,
unit_price: 500, // s DPH
content_name: 'Ochranný kryt'
}
]Hodnota value vs. součet contents
Parametr value na úrovni události je celková hodnota produktů bez DPH. Parametry unit_price v contents[], delivery_price a other_costs jsou včetně DPH. value nemusí nutně odpovídat součtu unit_price × quantity přepočítanému na základ daně – může zahrnovat slevy nebo jiné úpravy. Detailní rozpad košíku je v contents[].