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:
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í.
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ě jednotky až nižší 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.