Shoptet - zapojení e-shopu do platformy Targito

Společnost Targito vyvinula doplněk pro platformu Shoptet, který po nainstalování a nastavení zajistí datové napojení e-shopu na platformu Targito (více o datovém napojení zde) a nastaví webový tracking (více o webovém trackingu zde). Hlavní předností doplňku je automatizovaná práce s daty - doplněk se stará o stahování a formátování dat dle specifikací Targito a také efektivní nasazení webového trackingu - doplněk sám vkládá skripty do příslušných stránek a zajišťuje tak trackování všech stránek s řídícími i doplňkovými skripty.

 

Obsah dokumentu

 


Postup zapojení e-shopu na Shoptet do platformy Targito

1. Vysvětlení způsobu sběru kontaktů a komunikace se zodpovědnou osobou, která informaci předá správci systému Targito.

2. Volba typu sběru kontaktů dle (kap. 5.).

3. Instalace Targito doplňku:

a) Vytvoření účtu s právy spravovat doplňky e-shopu a poskytnutí přístupu zodpovědné osobě zastupující společnost Targito (projektový manažer společnosti Targito)

b) Instalace doplňku Targito správcem e-shopu.

4. Nastavení doplňku Targito na straně správce systému Targito (nastavení provádí Tech Lead společnosti Targito).

5. Kontrola synchronizovaných dat společností Targito.

6. Jednorázová ruční synchronizace ostatních dat (pouze je-li to potřeba); tento krok zařizuje (po dohodě) projektový manažer Targito ve spolupráci se zástupcem vývojového oddělení společnosti Targito.


1. Zavedení doplňku

Zavedení doplňku je z pohledu e-shopu pouze formální procedura.

Postup zavedení doplňku:

  1. Je-li doplněk stále v beta verzi, je nutné, aby e-shop vytvořil účet, který má povolení zapínat rozšíření, a zpřístupnil jej zodpovědné osobě ze společnosti Targito. Zodpovědná osoba ze společnosti Targito posléze, skrze vytvořený účet, nainstaluje doplněk do e-shopu a provede nastavení napojení.

  2. Je-li doplněk v provozním režimu, tak správce e-shopu může buď postupovat podle předchozího kroku (krok 1), nebo může sám doplněk nainstalovat ve správě doplňku a dát vědět zodpovědné osobě ze společnosti Targito (zpravidla projektový manažer Targito ve spolupráci s vývojovým týmem Targito), která provede nastavení a zprovoznění napojení


2. Datová synchronizace

Datová synchronizace začne automaticky probíhat v noci toho dne, kdy byl doplněk zaveden a nastaven. Každý den se kolem 01:00 UTC spustí cloudová procedura, která stáhne z e-shopu potřebná data a nahraje je na zřízené FTP úložiště, které bylo předem připraveno společností Targito. Z tohoto úložiště si pak platforma Targito data automaticky naimportuje do svých vnitřních struktur.

Datová synchronizace je dvojího druhu:

1. Plná synchronizace - tj. synchronizují se všechna data. Provede se, pokud dosud nebyla provedena žádná synchronizace, nebo byla-li vyžádaná opětovná plná synchronizace.

Tento typ synchronizace může trvat několik hodin.

2. Diferenciální (rozdilová) synchronizace - tj. synchronizují se pouze rozdílová data s přesahem 6 dnů do minulosti a pouze tato data se následně aktualizují v platformě Targito. Provede se, jedná-li se o řadovou synchronizaci, tj. existuje již provedená předchozí synchronizace.

Tento druh synchronizace trvá běžně jednotkynižší desítky minut.


3. Datové zdroje

1. Kontakty - podléhají diferenciální synchronizaci

a) Kontakty z uživatelských účtů (tj. údaje o registrovaných uživatelích e-shopu).

Názvy souborů na FTP:

  • all_contacts-<ORIGIN>.csv - soubor pro plnou synchronizaci

  • contacts-<ORIGIN>.csv - diferenciální soubor

 b) Kontakty z objednávek (údaje z objednávkových formulářů) - řídí se politikou e-shopu o sběru dat.

Názvy souborů na FTP:

  • all_transaction_contacts-<ORIGIN>.csv - soubor pro plnou synchronizaci

  • transaction_contacts-<ORIGIN>.csv - diferenciální synchronizace


2.Skupiny produktů - nepodléhají diferenciální synchronizaci.

Jako skupinu produktů v platformě Targito v tomto kontextu označujeme obecná data o produktech e-shopu, případně s výchozí variantou produktu. Například: Shoptet produkt “tričko Adidas” je jako Targito skupina produktů, Shoptet varianta produktu je barva, velikost, složení, apod., tj. například zelené tričko Adidas je jako produkt v Targito.

  • Shoptet produkt = Targito skupina produktů

  • Shoptet varianta produktu = Targito produkt

Názvy souborů na FTP:

productgroups-<ORIGIN>.csv - soubor pro plnou synchronizaci


3.Produkty - nepodléhají diferenciální synchronizaci.

Jako produkt v Targito je v tomto kontextu vnímaná každá unikátní varianta daného produktu v e-shopu.

Názvy souborů na FTP:

products-<ORIGIN>.csv - soubor pro plnou synchronizaci


4.Objednávky - podléhají diferenciální synchronizaci.

Názvy souborů na FTP:

  • all_transactions-<ORIGIN>.csv - soubor pro plnou synchronizaci

  • transactions-<ORIGIN>.csv - diferenciální synchronizace


5.Slevové kupóny - nepodléhají diferenciální synchronizaci.

Pro správné zobrazování slevových kódů ze Shoptet v platformě Targito je nutné zadat “remark” do pole v části “Data”. Například: “Vanocni_kampan_vanocni_retezy_sleva_20”.

Pro správné fungování automatizovaných importů je třeba dodržet specifikace z dokumentace k synchronizaci slevových kódů.

Následující pole v Shoptetu odpovídají daným sloupcům v importním souboru a je nutné je vždy vyplnit pro správné fungování synchronizace:

remark = ID a name - pozor id nesmí obsahovat mezeru (místo mezery lze použít “podtržítko” _), diakritiku, vše by mělo být malými písmeny

platný od = valid_from

platný do = valid_to

kód = code

Pokud je cokoli z valid_to/from, id, name, code prázdné, slevový kód se neexportuje do souboru pro import do Targita. Origin je doplněn automaticky v exportu.

Jako identifikátor "řádku" (unikátní klíč) je id + origin + code, tzn. v CSV nesmí být 2x to samé id slevového kódu ve stejném originu a se stejným slevovým kódem.

Názvy souborů na FTP:

dicount_coupons-<ORIGIN>.csv - soubor pro plnou synchronizaci


6.Strom kategorií - nepodléhá diferenciální synchronizaci.

Z důvodu zavedení konzistence a zpřístupnění webového trackingu jsou jako ID kategorií mapovány URL adresy (path) daných kategorií.

Názvy souborů na FTP:

categories-<ORIGIN>.csv - soubor pro plnou synchronizaci


7.Mailing list - podléhá diferenciální synchronizaci.

Seznam kontaktů, který byl posbírán doplňkem Mass Mailing (viz bod 5 - zde). Synchronizuje se i seznam kontaktů, které ubyly z mailing listu za diferenciální období (unsubscribes).

Názvy souborů na FTP:

  • mailing_list-<ORIGIN>.csv - soubor pro plnou synchronizaci

  • unsubscribes-<ORIGIN>.csv - diferenciální synchronizace


4. Webový tracking

Nasazení webového trackingu proběhne vždy spolu se zahájením datové synchronizace, případně ihned na vyžádání. Po nasazení začne webový tracking fungovat v reálném čase.

Trackované události:

1.Zobrazení skupiny produktů - událost je vyvolána návštěvou uživatele na stránce s produktem e-shopu.

2.Zobrazení produktu - událost je opět spojená s návštěvou uživatele na stránce s produktem - pro každou variantu produktu e-shopu je vyvolána jedna událost zobrazení produktu.

3.Návštěva kategorie - událost vznikne návštěvou uživatele na stránce s kategorií.

4.Nákup - událost je vyvolaná na děkovací stránce po nákupu.

5.Změna košíku - událost je vyvolaná, když uživatel změní obsah košíku.


5. Sběr kontaktů

Dle politiky e-shopu existuje několik postupů, jak sbírat kontakty pro účely e-mailingu. Rozhodnutí o způsobu sběru kontaktů lze změnit kdykoliv v průběhu využívání doplňku Targito. Změna způsobu sběru kontaktů se vztahuje pouze na nová data, stará zůstanou zachována tak, jak byla synchronizována.

Přechází-li zakaznik z jiné mailingové platformy, pak je nutné při počáteční synchronizaci ručně provést synchronizaci kontaktů z předešlé platformy (postup synchronizace kontaktů z předešlé platformy lze najít zde). Týká se to zejména ručně přihlášených kontaktů a kontaktů, které souhlas s e-mailingem odebraly.

Vyřešit - nové kontakty do databáze (aby šly přes double opt-in)

Targito doplněk dokáže jednat ve spolupráci s doplňkem Mass Mailing (tj. Hromadná rozesílka), který poskytuje Shoptet (od tarifu “Profi” jako součást licence, jinak zpoplatněno). Doplněk Mass Mailing přidává do UI e-shopu několik elementů:

1.Checkbox na objednávkovou stránku (“Zasílat newsletter”)

2.Checkbox do uživatelského rozhraní přihlášeného uživatele (“Zasílat newsletter”)

3.Formulář pro ruční přihlášení k odběru newsletteru v zápatí tématu e-shopu.

Doplněk Targito může:

1.Úplně ignorovat doplněk Mass Mailing:

  • Schovat všechny formulářové prvky

  • Všechny objednávky považovat za oprávněný zájem a importovat data kontaktů z objednávkových formulářů

  • Zajišťovat odhlašování kontaktů z e-mailingu v Targitu (tedy mimo e-shop)

  • Kontakty z patičky se neimportují do Targita, jelikož prvek pro přihlášení z patičky je skrytý.

2.Respektovat data sbíraná doplňkem Mass Mailing:

  • Dále zobrazovat formulářové prvky kromě přihlášení z patičky (tento prvek bude schován)

  • Importovat pouze ty kontakty z objednávek, které udělily souhlas pomocí doplňku Mass Mailing

  • Respektovat odhlášení registrovaného uživatele z odběru e-mailingu pomocí odebrání souhlasu v uživatelském rozhraní e-shopu.

Doplněk Targito ve výchozím nastavení exportuje z datového zdroje Mailing List (kap. 3. bod 7)) seznam mailing_list, tj. kontakty posbírané doplňkem Mass Mailing. Zároveň se při možnosti respektování dat z Mass Mailing doplňku exportuje seznam unsubscribes, kde jsou kontakty, které zmizely z datového zdroje Mailing List za diferenciální období.

Tyto procesy byly nastaveny v nejlepším možném souladu s GDPR do doby, než Shoptet vyřeší GDPR soulad doplňku Mass Mailing.