Pro správně fungující analýzu dat a chytrou personalizaci potřebuje Samba tyto datové zdroje:
V případě, že váš e-shop byl vytvořen jednou z aktuálně podporovaných platforem, nemusíte vytváření feedů vůbec dále řešit a stačí postupovat dle návodu integrace pro příslušnou platformu. Pokud využíváte jinou platformu, nezoufejte, Samba pracuje na integraci dalších nejpoužívanějších platforem. Do té doby využijte integraci vlastního e-shopu podle specifikace v následujícím textu.
Odkazy (veřejně přístupné, případně obsahující přístupové údaje ve formátu https://username:password@vaseshop.cz/adresafeedu.xml) na tyto feedy následně uvedete v sekci Nastavení – Integrace – Datová integrace – Nastavení připojení v Sambě.
Pro uložení změn stiskněte Uložit konfiguraci.
Jakmile máte všechny údaje vyplněné, stiskněte Zkontrolovat. Samba ihned stáhne feedy dle vašeho nastavení. Obvykle do několika minut uvidíte také výstup z naší kontroly, abyste mohli nedostatky opravit.
Datové feedy se standardně aktualizují 1x denně.
Obecně vyžadujeme od všech feedů:
- formát XML
- kódování UTF-8LE,
- nepoužívání unicode řídících znaků (kromě CR a LF).
Produktový feed
Produktový feed obsahuje veškerou databázi produktů, které kdy byly na vašem e-shopu prodávány. Pro plnou funkčnost systému doporučujeme poskytnout co nejvíce nepovinných parametrů. Díky tomuto feedu rozpoznáme vlastnosti produktů (typ produktu, značka, kategorie, cenová kategorie) a můžeme dynamicky vybírat ty správné produkty pro vaše zákazníky. Dále zjistíme, které produkty můžeme propagovat (díky informaci o naskladnění), můžeme zvýrazňovat zlevněné produkty a dále optimalizovat predikce vzhledem k očekávanému přínosu.
Podporované parametry produktu
Podporovány jsou tyto elementy:
Každý produkt může mít neomezené množství různých variant, tj. stejných produktů s některými odlišnými parametry např. barvou nebo velikostí. Tyto varianty jsou seskupené do jednoho rodičovského produktu, tzv. master produkt. Toto označení zaručí, že se zákazníkovi nebudou doporučovat v jednom reklamním sdělení např. různé varianty téhož produktu. Jako master produkt se automaticky zpracovává produkt s PRODUCT_ID
, který není zanořený v tagu VARIANT
.
Příklad produktového feedu
<?xml version="1.0" encoding="utf-8"?> <PRODUCTS> <PRODUCT> <PRODUCT_ID>D45S8741545SD</PRODUCT_ID> <BRAND>Značka</BRAND> <TITLE>Název produktu</TITLE> <DESCRIPTION>Detailní popis produktu</DESCRIPTION> <PRICE>42.1</PRICE> <PRICE_BEFORE_DISCOUNT>40.1</PRICE_BEFORE_DISCOUNT> <STOCK>60</STOCK> <URL>http://www.mujeshop.cz/cesta/k/produktu</URL> <IMAGE>http://www.mujeshop.cz/cesta/k/obrazku.jpg</IMAGE> <CATEGORYTEXT>Oblečení | Dámské | Kalhoty</CATEGORYTEXT> <PARAMETERS> <PARAMETER> <NAME>Barva</NAME> <VALUE>Bílá</VALUE> </PARAMETER> </PARAMETERS> <VARIANT> <PRODUCT_ID>D45S8741545SD-XXL</PRODUCT_ID> <TITLE>Název produktu</TITLE> <DESCRIPTION>Detailní popis produktu</DESCRIPTION> <PARAMETERS> <PARAMETER> <NAME>Velikost</NAME> <VALUE>XXL</VALUE> </PARAMETER> <PARAMETER> <NAME>EAN</NAME> <VALUE>467891186861118</VALUE> </PARAMETER> </PARAMETERS> <PRICE>42.1</PRICE> <STOCK>10</STOCK> <IMAGE>http://www.mujeshop.cz/cesta/k/produktuXXL.jpg</IMAGE> <URL>http://www.mujeshop.cz/cesta/k/produktu?variant=xxl</URL> </VARIANT> </PRODUCT> </PRODUCTS>
Zákaznický feed
Zákaznický feed by měl obsahovat celou databázi vašich zákazníků. Díky tomu Samba může přizpůsobit personalizaci na základě dalších metaparametrů jako je pohlaví nebo doba od registrace.
Samba podporuje 3 úrovně přihlášení k odběru newsletteru:
- every day – odběr denních novinek,
- special occasions – odběr speciálních akcí, např. týdenní, měsíční,
- never – uživatel je odhlášen od newsletterů.
Podporované parametry zákazníka
Název tagu | Typ | Povinný | Popis |
---|---|---|---|
CUSTOMER_ID | String | ano | zákaznické ID |
NEWSLETTER_FREQUENCY | Enum: every day | special occasions | never | ano | informace o odběru newsletteru |
NLF_TIME | Datetime (as string) | ne | datetime ve formátu YYYY-MM-DDThh:mm:ss.sTZD (více informací) Čas změny stupně přihlášení |
String | ano/ne | validní emailová adresa. Jedná se o povinný prvek v případě, že na zákazníka budete odesílat newslettery. | |
REGISTRATION | Datetime (as string) | ne | datetime registrace zákazníka ve formátu YYYY-MM-DDThh:mm:ss.sTZD (více informací) |
FIRST_NAME | String | ne | křestní jméno |
LAST_NAME | String | ne | příjmení |
ZIP_CODE | String | ne | PSČ |
PHONE | String | ne | telefonní číslo ve formátu odpovídajícím International Telecommunication Union. Mělo by obsahovat symbol plus ("+") jako mezinárodní předponu, kód státu a samotné číslo, například"+420777123456" pro Českou Republiku |
SMS_FREQUENCY | Enum: every day | special occasions | never | ne | informace o odběru novinek formou SMS |
DATA_PERMISSION | Enum | ne | full | do_not_personalize | anonymized_only výchozí: full |
PARAMETERS | [par1,par2] | ne | další parametry zákazníka,NAME nemusí být unikátní, vizte příklad |
Příklad zákaznického feedu
<?xml version="1.0" encoding="utf-8"?> <CUSTOMERS> <CUSTOMER> <CUSTOMER_ID>D45S8741545SD</CUSTOMER_ID> <EMAIL>jan.novak@email.cz</EMAIL> <REGISTRATION>2014-12-31T03:53:43.962Z</REGISTRATION> <FIRST_NAME>Jan</FIRST_NAME> <LAST_NAME>Novák</LAST_NAME> <NEWSLETTER_FREQUENCY>every day</NEWSLETTER_FREQUENCY> <NLF_TIME>2014-12-31T03:56:43.962Z</NLF_TIME> <ZIP_CODE>15000</ZIP_CODE> <PARAMETERS> <PARAMETER> <NAME>Bonusové body</NAME> <VALUE>100</VALUE> </PARAMETER> <PARAMETER> <NAME>Gender</NAME> <VALUE>female</VALUE> </PARAMETER> </PARAMETERS> </CUSTOMER> </CUSTOMERS>
Objednávkový feed
Objednávkový feed by měl ideálně obsahovat historii všech objednávek na vašem eshopu (doporučujeme historii za poslední 2 roky, ale můžete nahrát i celou historii případně v zápětí využít inkrementálního datového feedu – viz níže). Tento feed Sambě slouží k analýze nákupních vzorů vašich zákazníků, které poté dále aplikuje v personalizaci. Veškeré produkty v tomto feedu musí být obsaženy v produktovém feedu, jinak budou nevalidní objednávky systémem automaticky ignorovány.
Samba podporuje 3 stavy objednávek:
- finished – dokončená objednávka, kdy zákazník zaplatil nebo převzal zboží. Pouze tyto objednávky jsou aktuálně systémem Samba zpracovávány,
- created – právě vytvořená objednávka čekající na dokončení (provedení platby, doručení atd.),
- canceled – zrušená nebo smazaná objednávka ze strany zákazníka nebo e-shopu.
Při volbě zpracování kompletního objednávkového feedu platí následující: Pokud je vašim zákazníkům umožněno vytvářet objednávky bez registrace, vkládejte do tohoto feedu namísto CUSTOMER_ID
element EMAIL
a pokud máte k dispozici, doplňte i PHONE
a ZIP_CODE
. Samba z těchto údajů vytvoří zákazníky, na které budete moci ve svých kampaních cílit. V případě inkrementálního zpracování jsou ovšem takto vytvoření zákazníci vždy jen pro aktuální inkrement objednávek – pro starší objednávky již nebudou zákazníci nagenerování a tím ani objednávky zpracovány.
Detailně: Pokud v zák. feedu existuje zákazník s daným EMAIL
a přitom je uvedené neznámé CUSTOMER_ID
(nebo není uvedeno vůbec), je tato objednávka automaticky přiřazena zákazníkovi s tímto EMAIL
ze zákaznického feedu. V opačném případě bude hodnota v EMAIL
použita jako nové zákaznické ID. Objednávky bez uvedeného EMAIL
i CUSTOMER_ID
nebudou zpracovány.
Podle znění vašich obchodních podmínek vyberte volbu v nastavení připojení (u Datové integrace) pro takto vytvořené zákazníky:
Inkrementální objednávkový feed
Po prvotním jednorázovém načtení kompletního objednávkového datového feedu (dle informací výše) je možné využívat pro následující načítání objednávkových dat feed inkrementální (či dodatkový), jak je patrné na obrázku níže:
Při využití inkrementů lze obecně říci, že se zpracují pouze ty položky, které obsahují produkty uvedené v produktovém datovém feedu. V případě inkrementálního datového feedu funguje načítání tedy následovně:
- Proběhlo jednorázové načtení kompletních dat v rámci datového feedu a nyní jsou v rámci stejného účtu využívány jednodenní inkrementy.
- V rámci příkladu je v objednávkovém inkrementu obsažena objednávka „Obj1“ z 1. 1., která obsahuje produkt „Prod1“.
- Nejprve se 1. 1. stáhne inkrement objednávkového feedu, který obsahuje objednávku „Obj1“ a zároveň je v produktovém feedu ve stejný den obsažen produkt „Prod1“. Objednávka se v takovém případ zpracuje.
- Den poté (tedy 2. 1.) se již objednávka „Obj1“ v inkrementu nenachází a produkt „Prod1“ se nenachází ani v produktovém datovém feedu. Objednávka se v takovém případě nezpracuje.
- Následující den (tedy 3. 1.) se objednávka „Obj1“ v inkrementu nadále nenachází, ale produkt „Prod1“ se objevil v produktovém datovém feedu. Objednávka se v tomto případě znovu zpracuje.
Rozhodující tedy pro Sambu je, zda se produkt nachází v produktovém datovém feedu v okamžik posledního zpracování objednávky z inkrementu – v takovém případě totiž dochází k jejímu správnému uložení do ukládané historie. Následující dny se pak v Sambě objednávka zpracuje v případě, že se daný produkt aktuálně v produktovém datovém feedu nachází.
Podporované parametry objednávky
Název tagu | Typ | Povinný | Popis |
---|---|---|---|
ORDER_ID | String | ano | ID objednávky |
CUSTOMER_ID | String | ne | ID zákazníka |
CREATED_ON | Datetime (as String) | ano | datetime vytvoření objednávky ve formátu YYYY-MM-DDThh:mm:ss.sTZD (více informací). |
ITEMS | ano | produkty v objednávce | |
FINISHED_ON | Datetime (as String) | ne | datetime dokončení objednávky ve formátu YYYY-MM-DDThh:mm:ss.sTZD (více informací). Nepoužívejte nebo ponechte prázdné, pokud dosud nebyla objednávka dokončena. |
STATUS | String | ne | stav objednávky. Povolené hodnoty: created, finished, canceled. |
String | ne | validní emailová adresa | |
PHONE | String | ne | telefonní číslo ve formátu odpovídajícím International Telecommunication Union. Mělo by obsahovat symbol plus ("+") jako mezinárodní předponu, kód státu a samotné číslo, například"+420777123456" pro Českou Republiku |
ZIP_CODE | String | ne | PSČ adresy doručení |
COUNTRY_CODE | String | ne | Mezinárodní identifikace země adresy doručení dle ISO 3166-1 alpha-2, např. "CZ" |
ITEMS – položky objednávky
Každá objednávka musí obsahovat všechny produkty z dané zakázky. Cena produktu zde určuje prodejní cenu, kterou zákazník zaplatil (bez dopravného a balného, včetně DPH).
Název tagu | Typ | Povinný | Popis |
---|---|---|---|
PRODUCT_ID | String | ano | ID produktu nebo produktové varianty |
AMOUNT | Number (integer, >0) | ne | počet kusů objednaného produktu (default: 1) |
PRICE | Number (>=0) | ne | sumární cena všech kusů daného produktu včetně DPH. |
Příklad objednávkového feedu
<?xml version="1.0" encoding="utf-8"?> <ORDERS> <ORDER> <ORDER_ID>5ds465d</ORDER_ID> <CUSTOMER_ID>d4s5a6sd6as</CUSTOMER_ID> <CREATED_ON>2014-12-31T03:53:43.962Z</CREATED_ON> <FINISHED_ON>2015-01-05T03:53:43.962Z</FINISHED_ON> <STATUS>finished</STATUS> <ZIP_CODE>15500</ZIP_CODE> <COUNTRY_CODE>CZ</COUNTRY_CODE> <ITEMS> <ITEM> <PRODUCT_ID>DAS656</PRODUCT_ID> <AMOUNT>6</AMOUNT> <PRICE>36</PRICE> </ITEM> </ITEMS> </ORDER> <ORDER> <ORDER_ID>35DS45</ORDER_ID> <EMAIL>jan.novak@email.cz</EMAIL> <CREATED_ON>2014-12-31T03:53:43.962Z</CREATED_ON> <FINISHED_ON>2015-01-05T03:53:43.962Z</FINISHED_ON> <STATUS>finished</STATUS> <ZIP_CODE>15500</ZIP_CODE> <COUNTRY_CODE>CZ</COUNTRY_CODE> <ITEMS> <ITEM> <PRODUCT_ID>DAS656</PRODUCT_ID> <AMOUNT>6</AMOUNT> <PRICE>36</PRICE> </ITEM> </ITEMS> </ORDER> </ORDERS>
Feed kategorií
Feed kategorií by měl obsahovat strom kategorií produktů použitých v produktovém feedu. TITLE
musí být konzistentní s názvy kategorií CATEGORYTEXT
v produktovém feedu. Tento feed je nezbytný, pokud chcete, aby Samba zpracovávala také návštěvy samotných kategorií a bylo možné upravovat jejich personalizaci.
Podporované parametry kategorií
Příklad feedu kategorií
<?xml version="1.0" encoding="utf-8"?> <CATEGORY> <ITEM> <TITLE>Nadkategorie</Title> <URL>http://www.mujeshop.cz/cesta/k/nadkategorii</URL> <ITEM> <TITLE>Podkategorie</Title> <URL>http://www.mujeshop.cz/cesta/k/podkategorii</URL> </ITEM> </ITEM> <ITEM> <TITLE>Nadkategorie A</Title> <URL>http://www.mujeshop.cz/cesta/k/nadkategoriia</URL> <ITEM> <TITLE>Podkategorie A</Title> <URL>http://www.mujeshop.cz/cesta/k/podkategoriia</URL> <ITEM> <TITLE>Podkategorie B</Title> <URL>http://www.mujeshop.cz/cesta/k/podkategoriib</URL> </ITEM> </ITEM> </ITEM> </CATEGORY>
Zaokrouhlování cen
Do newsletteru se propisují ceny uvedené v produktovém feedu. Pokud ale máte některé ceny nastaveny na hodnoty typu 419,72 Kč, je možné Sambě říci, aby takovouto cenu zaokrouhlila na vámi požadovaný počet desetinných míst.
Toto nastavení naleznete v sekci Nastavení – Integrace – Datová integrace – Nastavení připojení, kde si zvolíte zda-li a na kolik desetinných míst chcete ceny zaokrouhlovat.
Například toto nastavení by zaokrouhlovalo ceny na celá čísla. Cena 419,72 Kč by se tedy zaokrouhlila na hodnotu 420 Kč.
This post is also available in: English (Angličtina)