Propojení se systémy třetích stran

Propojení se systémy třetích stran

Zkopírovat odkaz na sekciImport/export

V AR je dostupná agenda pro export a import dat e-shopu, ale tato agenda se vytváří vždy na míru. Možné vstupy, výstupy a jejich formát se řeší konfigurační úpravou, konkrétně definicí importního/exportního schématu. Formát vstupních a výstupních dat je CSV, kde je jako oddělovač doporučen ; (středník).

Konfiguračně lze také, na úrovni jednotlivých exportů, nastavit, zda se mají do atributů, které nejsou na dané entitě definovány doplnit tyto hodnoty z nadřazených objektů (Master nebo předloha Alias produktu). V praxi to znamená, že například u varianty produktu pokud není konkrétní hodnota definovaná přímo na variantě, tak se vyexportuje hodnota definovaná na master produktu této varianty (pokud je na Master produktu definovaná). V případě Alias produktů platí obdobné dědění pouze s tím rozdílem, že se hodnoty doplňují z předlohy konkrétního Alias produktu.

Aktuálně je podporován import a export těchto entit:

• produkty a jejich varianty
• kategorie
• skupiny
• značky
• typy parametrů
• lokalizace výše uvedeného
• Výmaz entit pokud nejsou součástí importního souboru.

Zkopírovat odkaz na sekciObecná pravidla pro import

• struktura importu je definována prvním řádkem v importním souboru, podle kterého se určuje, co který sloupec znamená (tedy zda se jedná o identifikátor, základní atribut, parametr, kategorie, štítek apod.)
• každý záznam (řádek) musí obsahovat identifikátor entity – pokud identifikátor entity chybí, import selže
• na pořadí sloupců nezáleží
• pokud nějaký sloupec nebo řádek, který je nadefinován, v importu chybí, data se nemění
• pokud import obsahuje nějaký sloupec, který není znám (není v definici konkrétního importního schématu), je ignorován
• pokud import obsahuje nové entity, vytvoří se, existující entity jsou aktualizovány; vytváření nových entit je možné konfiguračně zakázat
• pro oddělení více hodnot v rámci jednoho atributu je standardně znak "|"

Zkopírovat odkaz na sekciImport produktů

U produktů lze importovat následující data:

• základní atributy
• zařazení do kategorie
• štítky
• značka
• parametry
• zařazení do skupiny
• rozšířené ceny
• ceny za proklik pro srovnávače
• kód předlohy v případě, že importovaný produkt je alias
• vazby na další produkty (související, alternativní atd.)
• galerie
• skladová dostupnost

Zkopírovat odkaz na sekciZákladní atributy

Mezi základní atributy patří:

• identifikátor entity – standardně kód (povinný údaj)
• název (povinný údaj)
• krátký popis
• popis
• viditelnost
• katalogový kód
• jednotka
• cena s/bez DPH
• běžná cena s/bez DPH
• sazba DPH
• metadata
• parametry objednávání

Pro tato data platí následující pravidla:

• název je povinný, ostatní data jsou nepovinná
• pokud je hodnota prázdná, tak jsou data vymazána

Zkopírovat odkaz na sekciZařazení do kategorie

• sloupec musí obsahovat kód nebo název kategorie (doporučeno je používat kód kategorie)
• pokud je hodnota prázdná, vazba na kategorie je zrušena
• sloupec může obsahovat více kategorií, tzv. produkt může být zařazen do více kategorií

Zkopírovat odkaz na sekciŠtítky

Štítky lze importovat dvěma způsoby:

1. Sloupec reprezentuje jeden štítek a hodnoty v jednotlivých řádcích udávají, zda daný produkt má/nemá přiřazený štítek. Výčet hodnot, které představují splnění této podmínky (má štítek), je libovolný. Ostatní hodnoty nebo prázdná hodnota znamená, že štítek přiřazený není.

• Příklad: kód produktu; novinka 01;ano 02;ne

2. Sloupec obsahuje výčet všech štítků přiřazených k produktu. Pokud je hodnota prázdná, jsou všechny štítky odebrány. Pokud některý ze štítků není definován, je zobrazena příslušná chybová hláška. Příklad:

• kód produktu; štítky
• 01;novinka|akce|doprava zdarma
• 02; ...

Zkopírovat odkaz na sekciZnačka

• sloupec musí obsahovat kód nebo název značky (doporučeno je používat kód značky)
• pokud je hodnota prázdná, vazba produktu na značku je zrušena
• sloupec může obsahovat pouze jednu značku
• pokud značka neexistuje, může být vytvořena

Zkopírovat odkaz na sekciParametry

• názvy parametrů jsou definovány v prvním řádku importního souboru
• pokud parametr neexistuje, je vytvořen
• hodnoty parametrů jsou definovány v příslušných řádcích, přesněji řečeno název hodnoty parametru – pokud hodnota parametru neexistuje, je vytvořena
• pokud je hodnota v importu prázdná, je parametr daného produktu odstraněn

Zkopírovat odkaz na sekciZařazení do skupiny

• sloupec musí obsahovat kód nebo název skupiny (doporučeno je používat kód skupiny)
• pokud je hodnota prázdná, vazba na skupiny je zrušena
• sloupec může obsahovat více skupin, tzn. produkt může být zařazen do více skupin

Zkopírovat odkaz na sekciRozšířené ceny

• sloupec musí obsahovat cenu pro danou měnu a typ
• pokud je hodnota prázdná, cena se odstraní
• sloupec musí obsahovat pouze jednu hodnotu

Zkopírovat odkaz na sekciCeny za proklik pro srovnávače

• sloupec musí obsahovat cenu za proklik pro daný srovnávač a typ (google-detail, heureka-detail, zbozi-detail, zbozi-výpis)
• pokud je hodnota prázdná, cena se odstraní
• sloupec musí obsahovat pouze jednu hodnotu

Zkopírovat odkaz na sekciAlias produkty

V případě, že importovaný produkt je alias, tak prázdné hodnoty znamenají, že hodnota se pro daný atribut dědí ze své předlohy (dává-li to smysl u daného atributu). Toto pravidlo neplatí při importu prázdných cen alias-variant, tj. import prázdných cen alias-variant neovlivňuje dědičnost (v tomto případě dědičnost alias-masteru, protože alias-varianty přebírají dědičnost z alias-masteru) a pokud předtím varianty nedědily ceny, tak je dědit nebudou ani nadále.

Při vyplněné hodnotě to znamená, že je hodnota přepisuje hodnotou z předlohy. Není tedy možné přepsat hodnoty z předlohy prázdnou hodnotou.

Zkopírovat odkaz na sekciVazby na další produkty

• Sloupec obsahuje výčet kódů všech navázaných produktů pro daný typ vazby (alternativní, související, atd.) oddělených oddělovačem. Nové vazby jsou vytvořeny, chybějící jsou odstraněny. Pokud je hodnota prázdná, jsou všechny vazby odebrány.

Zkopírovat odkaz na sekciImport kategorií

U kategorií lze importovat následující data:

• základní atributy
• nadřazenou kategorii
• štítky
• galerie

Pro tato data platí následující pravidla:

• název je povinný, ostatní data jsou nepovinná
• pokud je hodnota příslušné položky v řádku prázdná, tak jsou data vymazána
• je doporučeno nejprve importovat kořenové kategorie a postupně kategorie nižší úrovně

Zkopírovat odkaz na sekciZákladní atributy

Mezi základní atributy patří:

• identifikátor – standardně kód (povinný údaj)
• název (povinný údaj)
• krátký popis
• popis
• viditelnost
• metadat

Pro tato data platí následující pravidla:

• název je povinný ostatní data jsou nepovinná.
• pokud je hodnota příslušné položky v řádku prázdná, data jsou vymazána.

Zkopírovat odkaz na sekciNadřazená kategorie

• zařazení kategorie do nadřazené kategorie, která je definována kódem v daném sloupci
• pokud nadřazená kategorie neexistuje, je zaznamenána chyba
• pokud je hodnota příslušné položky v řádku prázdná, kategorie je importována jako kořenová.

Zkopírovat odkaz na sekciŠtítky

U importu štítků ke kategoriím platí stejná pravidla jako u importu štítků k produktu.

Zkopírovat odkaz na sekciImport skupin

U skupin lze importovat následující data:

• základní atributy
• štítky
• galerie

Zkopírovat odkaz na sekciZákladní atributy

Mezi základní atributy patří:

• identifikátor – standardně kód (povinný údaj)
• název (povinný údaj)
• popis
• publikace – informace o tom, zda se jedná o vizuální nebo nevizuální skupinu, viz Skupina produktů
• priorita zobrazení
• viditelnost
• metadata

Pro tato data platí následující pravidla:

• název je povinný, ostatní data jsou nepovinná
• pokud je hodnota příslušné položky v řádku prázdná, tak jsou data vymazána

Zkopírovat odkaz na sekciŠtítky

U importu štítků ke skupinám platí stejná pravidla jako u importu štítků k produktu.

Zkopírovat odkaz na sekciImport parametrů

U parametrů lze importovat následující data:

• základní atributy

Zkopírovat odkaz na sekciZákladní atributy

• identifikátor – standardně kód (povinný údaj)
• název (povinný údaj)
• skupina pro porovnání
• název pro web
• popis
• viditelnost na webu
• viditelnost ve filtru produktů
• vylučovací význam při filtrování
• trvalý filtr
• rozbalený filtr
• viditelnost v detailu produktu
• typ zobrazení

Zkopírovat odkaz na sekciImport lokalizace

Entity (jako produkty, kategorie apod.) je možné lokalizovat. Lokalizace je možné importovat.

Lokalizovat lze standardní textové hodnoty (název, krátký popis, popis, metadata apod.).

Zkopírovat odkaz na sekciZákladní atributy

• identifikátor – standardně kód (povinný údaj)
• lokalizace dané hodnoty v daném jazyce

Zkopírovat odkaz na sekciImport hodnot parametrů

U hodnot parametrů lze importovat následující data:

• základní atributy

Zkopírovat odkaz na sekciZákladní atributy

• identifikátor – standardně kód (povinný údaj)
• název (povinný údaj)
• popis
• krátký popis
• stav
• typ parametru (povinný atribut; pokud parameter neexistuje je záznam přeskočen)
• číselnou hodnotu

Zkopírovat odkaz na sekciEnhanced Ecommerce

V rámci zobrazení každé stránky dochází k vystřelení události do GA, která odesílá následující data:

• promokód, pokud uživatel nějaký zadal
• aktuálně zvolenou měnu
• aktuálně zvolenou jazykovou mutaci webu
• hodnoty z affiliate odkazů
• stavový HTTP kód

V rámci každé Enhanced Ecommerce operace dochází k vystřelení události do GA, která je shodně pojmenovaná pro všechny akce: fgeEECAction. Ošetřeny jsou níže uvedené události.

Zkopírovat odkaz na sekciImprese produktu

V rámci zobrazení položky produktu (z různých druhů výpisů produktů) dochází k vystřelení události, která zahrnuje následující data:

• měnu produktu
• název produktu
• id produktu
• cenu produktu
• značku produktu
• identifikátor kategorie produktu
• případnou variantu produktu
• název seznamu, v rámci kterého produkt vypisujeme
• pozici produktu v rámci daného seznamu

Zkopírovat odkaz na sekciKliknutí na produkt

V rámci kliknutí na produkt dochází k vystřelení události, která zahrnuje následující data:

• měnu produktu
• název produktu
• id produktu
• cenu produktu
• značku produktu
• případnou variantu produktu
• identifikátor kategorie produktu
• název seznamu, v rámci kterého produkt vypisujeme
• pozici produktu v rámci daného výpisu

Zkopírovat odkaz na sekciZobrazení detailu produktu

V rámci zobrazení detailu produktu dochází k vystřelení události, která zahrnuje následující data:

• měnu produktu
• název produktu
• id produktu
• cenu produktu
• značku produktu
• případnou variantu produktu
• identifikátor kategorie produktu

Zkopírovat odkaz na sekciPřidání produktu do košíku

V rámci zobrazení popup okna s informací o přidání produktu do košíku dochází k vystřelení události, která zahrnuje následující data:

• měnu produktu
• název produktu
• id produktu
• cenu produktu
• značku produktu
• případnou variantu produktu
• identifikátor kategorie produktu
• objednané množství daného produktu

Zkopírovat odkaz na sekciZobrazení kroků objednávkového procesu

V rámci zobrazení jednotlivých kroků objednávkového procesu dochází k vystřelení události, která zahrnuje následující data:

• měnu objednávky
• číslo kroku objednávky
• název kroku objednávky
• výčet položek objednávky (krok 1) – u každé položky předáváme tato data:
  • název produktu
  • cenu produktu
  • id produktu
  • značku produktu
  • identifikátor kategorie produktu
  • případnou variantu produktu

Zkopírovat odkaz na sekciZměna množství v košíku

V rámci změny množství nebo odebrání položky v košíku dochází k vystřelení události, která zahrnuje následující data:

• měnu produktu
• přírůstek nebo úbytek množství daného produktu oproti předchozímu stavu
• data identifikující daný produkt

Zkopírovat odkaz na sekciNákup/transakce

V rámci potvrzení odeslané objednávky dochází k vystřelení události, která zahrnuje následující data:

• unikátní id objednávky
• měnu objednávky
• celkovou cenu za položky objednávky včetně DPH
• výčet položek objednávky – u každé položky předáváme následující data:
  • název produktu
  • cena produktu včetně DPH
  • id produktu
  • značka produktu
  • varianta produktu
  • kategorie produktu
  • objednané množství produktu
• zvolenou dopravu/platbu – u každé položky předáváme následující data:
  • název dopravy/platby
  • cena dopravy/platby
  • kód dopravy/platby

Kromě výše uvedených enhanced ecommerce událostí dochází k vystřelování custom událostí, která odesílají data ohledně sledování:

• pohybu uživatele v košíku
• kliknutí na produkt
• přidání produktu do košíku
• dokončení nákupu
• změny množství v košíku
• prokliku click-to-action tlačítek

Zkopírovat odkaz na sekciGoogle Analytics 4 ecommerce events

Je zavedena podpora pro sledování základních ecommerce událostí v rámci Google Analytics 4. Zahrnuje následující události:

• view_item_list
• view_item
• select_item
• add_to_cart
• remove_from_cart
• view_cart
• begin_checkout
• add_payment_info
• add_shipping_info
• purchase

Zkopírovat odkaz na sekciHeureka.cz – Ověřeno zákazníky

Systém podporuje využití služby Ověřeno zákazníky serveru Heureka.cz. Detailní popis služby je specifikován na tomto odkaze: https://info.heureka.cz/overeno-zakazniky/. Server Heureka.cz pro správnou funkci služby Ověřeno zákazníky vyžaduje informace o každé objednávce v e-shopu. Systém tak na pozadí odesílá na server Heureky ka ždé 2 minuty informace o nové objednávce (e-mail zákazníka, číslo objednávky, kód zboží).

Pro správnou funkci je potřeba pouze tajný klíč (32 znakový řetězec dostupný v administraci e-shopu na Heureka.cz), který implementátor e-shopu nakonfiguruje v systému.

Zkopírovat odkaz na sekciZbozi.cz - Měření konverzí

Systém umožňuje export objednávek do systému Zbozi.cz pro účely měření konverzí. Úloha v pravidelných intervalech provádí kontrolu nově vzniklých objednávek a odesílá jejich detailní informace - číslo objednávky, seznam položek objednávky (v rozsahu kód produktu, název produktu, jednotková cena a počet kusů), typ a cenu dopravy, typ platby a e-mail zákazníka (pokud zákazník nezamítl jeho uvedení v rámci objednávky). Pro konfiguraci služby je třeba id obchodu a tajný klíč, které jsou přiděleny obchodu na základě smlouvy se Zbozi.cz.

Zkopírovat odkaz na sekciNapojení na systém Balíkobot

Konfiguračně je možné zapnout integraci se systémem Balíkobot v jejíž konfiguraci je možné uvést typy dopravy pro které má klient uzavřenou se společností Balíkobot smlouvu. U objednávek s tímto typem doprav je pak možné přímo v AR objednávat dopravu pro jednotlivé zásilky včetně stažení a tisku štítků. V AR je pak také možné objednat svoz balíků dopravcem včetně stažení a tisku předávacího archu. A detailu objednávky v AR je pak možné sledovat stav odeslaných zásilek.

Aktuálně podporujeme tyto typy doprav:

• GSL, GLS ParcelShop (ShopDeliveryService)
• PPL
• Zásilkovna (a přes zásilkovnu, Českou poštu - balík do ruky)
• DHL
• DPD (bez služby DPD Pickup)
• Slovenská pošta (Balík na adresu, Balík na poštu, Balík do Balíkoboxu)

V případě, že má zvolený dopravce vybrat od zákazníka úhradu za objednávku, je nutné aby zvolená platba byla typu dobírka. Pro jiné typy plateb se do Balíkobotu neposíla doběrečné a zásilka se považuje za uhrazenou.

Zkopírovat odkaz na sekciNapojení na affiliate programy

Je možné konfiguračně zapnout napojení na affiliate programy. To spočívá ve sledování parametrů v URL a pokud je některý z nich vázaný k nějakému programu, tak se uživateli údaj z něj zapíše do:

• session - pokud není přihlášený a nepovolil marketingové a analytické cookie
• cookie - pokud není přihlášený a povolil marketingové a analytické cookie
• DB k uživatelskému účtu - pokud je přihlášený

Takto získaný údaj je pak použitý po vytvoření objednávky a uložen k ní. Objednávky, které obsahují odpovídající údaj relevantní pro daný affiliate program, se pak posílají do tohoto programu. Do některých programů se objednávky posílají z FE, pokud uživatel povolil marketingové a analytické cookie, pro některé se posílají pouze z BE.

Momentálně podporujeme tyto služby:

• CJ Vivnetworks
• eHub

Tyto služby lze aktivovat pro jednotlivé katalogy, pro každý může být aktivovaná pouze jedna služba.

Zkopírovat odkaz na sekciNapojení na Facebook Conversion API

Konfiguračně je možné zapnout modul pro napojení na Facebook conversion API pomocí backend (server to server) komunikace. Modul spočívá v tom, že data je možné odeslat bez souhlasu uživatele s cookies.

Původně tato funkcionalita byla zpracována pomocí tzv. Facebook pixel, která je nyní omezena. Projektově musí být upravena sekce webu Ochrana osobních údajů s informací o následném zpracování dat.

V aktuální implementaci dochází k odeslání těchto událostí:

• Zobrazení detailu produktu
• Přidání položky do košíku
• Vytvoření objednávky
• Kompletní registrace uživatele
• Kompletní přihlášení k newsletteru

Projektově je možné doplnit implementaci o další události, které mohou být zpracovány.

Zkopírovat odkaz na sekciExporty XML feedů

Systém podporuje export katalogu produktů do externích systémů (srovnávače). Exportní soubory jsou generovány automatickou úlohou, která je spouštěna jednou za 2 hodiny a jsou vystaveny ke stažení na konfigurovatelném URL. Implementátor e-shopu na základě požadavku provozovatele vytvoří konfiguraci exportu pro požadované srovnávače a sdělí URL, na které bude exportní soubor dostupný. Konfigurace exportu obsahuje primárně kód katalogu, název exportního souboru a formát exportního souboru. Lze tak například vytvořit exporty pro srovnávače využívající formát exportního souboru definovaný serverem Heureka. Konfiguračně lze dále definovat například vyloučení produktu z exportu na základě přiřazení konkrétního štítku nebo naopak nastavit export pouze pro produkty s daným štítkem.

Jsou podporovány následující formáty exportů:

• Google Merchant Center – XML feed produktů včetně možnosti zařazení produktu do google kategorie v administračním rozhraní e-shopu
• Heureka.cz – XML feed produktů včetně možnosti zařazení produktu do heureka kategorie a vyplnění specifického názvu produktu v administračním rozhraní e-shopu
• Heureka.sk – XML feed produktů včetně možnosti zařazení produktu do heureka kategorie a vyplnění specifického názvu produktu v administračním rozhraní e-shopu
• Zboží.cz – XML feed produktů včetně možnosti zařazení produktu do zboží.cz kategorie a vyplnění specifického názvu produktu v administračním rozhraní e-shopu
• FB ROI Hunter kampaně – XML feed produktů
• Glami.cz – XML feed produktů včetně možnosti zařazení produktu do glami kategorie v administračním rozhraní e-shopu
• Biano.cz – XML feed produktů

Pro potřeby exportu je dále možné provést mapování stromu kategorií e-shopu na strom kategorií srovnávacího serveru. Konkrétně lze v detailu kategorie provést přiřazení kategorie ze stromu kategorii Google, Heureka CZ, Heureka SK, Zboží a Glami. Samotné přiřazení je realizováno výběrem ze stromu externích kategorií. Strom externích kategorií je v e-shopu jednou denně aktualizován automatickou úlohou. Přehled vygenerovaných xml feed souborů je dostupný v administračním rozhraní e-shopu pod položkou „Produkty/XML feedy“. Pro identifikaci produktů se používá zkrácený unikátní kód, který nepřesahuje 32 znaků a je tudíž použitelný napříč všemi podporovanými feedy. Stejný klíč je použit i pro integraci s analytikou (např. Google Analytics) tak, aby bylo možné provázat produkty ve feedech s kampaněmi.

[//]: # (TODO JKO) - chybí popis na GTM