Návod na integráciu GLAMI TOP

GLAMI TOP je služba, ktorá pomáha vášmu e-shopu získať spätnú väzbu od zákazníkov o vašich službách a kvalite produktov, ktoré si od vás zakúpili.

Ako postupovať pri implementácii služby GLAMI TOP:

  • Implementovať zber súhlasu so službou jedným z nasledujúcich spôsobov:
    • Váš shop-systém podporuje službu GLAMI TOP
    • Integrácia pomocou Google Tag Manager
    • Integrácia pomocou Javascriptu
  • Nastaviť odosielanie e-mailov s dotazníkom, aby zákazníkom nepadali do spamu.

1. Nastavenie zberu súhlasu so službou

Nastavenie zberu súhlasov nám pomáha zistiť, či sa zákazníci chcú zúčastniť programu GLAMI TOP a umožňuje vám posielať na GLAMI všetky potrebné transakčné informácie.

Pokyny na integráciu

Zber súhlasu formou pop-upu by mal prebehnúť na poslednej stránke procesu objednávky - teda na stránke s potvrdením platby v prípade okamžitej platby kartou či inou metódou alebo na stránke s potvrením objednávky v prípade platby prevodom na účet či dobierkou.

Všetky potvrdzovacie stránky musia používať HTTPS.

Vzhľadom k tomu, že tento modul spúšťa opt-in dotazník, musia byť údaje o objednávke v tomto module presné a správne. Nezakrývajte opt-in dotazník akýmkoľvek iným obsahom na stránke potvrdenia objednávky.

A) Váš obchodný systém podporuje GLAMI TOP (nie je ho potrebné programovať)

V prípade,že váš shop-systém už GLAMI TOP podporuje, bude integrácia veľmi jednoduchá. Nastavenie zberu súhlasu (bod 1) môžete nastaviť priamo v administrácii vášho shop-systému. Prihláste sa do administrácie vášho shop-systému a vyhľadajte modul pre GLAMI TOP. Pokračujte podľa inštrukcií.

Nastavte odosielanie všetkých parametrov - všetky sú povinné. Príklady parametrov s vysvetlením sú uvedené v nasledujúcej tabuľke.

V sekcii Ako prepojiť váš obchod s GLAMI môžete skontrolovať, či váš shop-systém túto funkciu podporuje a prepojiť tak váš obchod s GLAMI alebo priamo s shop-systémom.

Po implementácii modulu je ešte nutné nastaviť DNS záznamy (bod 2 integračného návodu), viac sa dozviete nižšie.

B) Integrácia prostredníctvom Google Tag Manager (je treba ho naprogramovať)

Pokiaľ používate Google Tag Manager, môžete urýchliť nastavenie zbierania dát pomocou šablóny v gelérii šablón GTM.

Pokračujte ako v C) Integrácia pomocou Javascript. Nastavte odosielanie všetkých parametrov - všetky sú povinné. Príklady parametrov s vysvetlením sú uvedené v nasledujúcej tabuľke.

Po implementácii modulu je ešte nutné nastaviť DNS záznamy (bod 2 integračného návodu), viac sa dozviete nižšie.

Odkaz na GTM šablónu: https://tagmanager.google.com/gallery/#/owners/glami/templates/top-gtm-template.

C) Integrácia prostredníctvom Javascriptu (je treba ho naprogramovať)

Pridanie opt-in kódu

Vložte nasledujúci úryvok HTML do stránky s potvrdením objednávky:

<script>
(function (f, a, s, h, i, o, n) {
f['GlamiOrderReview'] = i;
f[i] = f[i] || function () {(f[i].q = f[i].q || []).push(arguments);};
o = a.createElement(s), n = a.getElementsByTagName(s)[0];
o.async = 1; o.src = h; n.parentNode.insertBefore(o, n);
})(window,document,'script','//www.glami.sk/js/compiled/or.js', 'glami_or');

glami_or('addParameter', 'merchant_id','FFFFDDDDFFFFDDDDFFFFDDDDFFFFDDD', 'sk');
glami_or('addParameter', 'order_id', 'ORDER_1');
glami_or('addParameter', 'email', 'name@domain.sk');
glami_or('addParameter', 'language', 'sk');
glami_or('addParameter', 'items', [
    {
        id: 36463570,
        name: 'Long laces, red'
    },
    {
        id: 'XT-27927237',
        name: 'T-shirt with moose pattern'
    }
]);

glami_or('create');
</script>

Umiestnite kód tesne pred koncový html element </BODY>.

Nahraďte hodnoty v červenej farbe dynamickými hodnotami špecifickými pre váš web a objednávku užívateľa.

Všetky parametre sú povinné.

Nasledujúca tabuľka zobrazuje dostupné nastavenia:

Premenná Meno Data typ Účel a popis
merchant_id ID E-shopu string (32) ID e-shopu. Druhý parameter slúži k určeniu GLAMI domény, na ktorej je váš eshop zaregistrovaný (cz pre GLAMI.cz, sk pre GLAMI.sk, hu pre GLAMI.hu). Správne hodnoty oboch parametrov nájdete v partnerskej administrácii GLAMI.
order_id ID objednávky string (32) Jedinečné ID objednávky. Slúži k identifikácii jednotlivých objednávok.
email Zákaznícky e-mail string (255) E-mailová adresa zákazníka vo formáte name@domain.sk.
language Jazyk string (2), string (5) Kód jazyka určuje, ktorý jazyk bude GLAMI používať na komunikáciu so zákazníkom.
Správny formát je podľa ISO 639-1 (cs, de, fr, sk, ro, hu, bg, el, tr, hr, sl, en, pt, es, et, lt, lv, it, pl) alebo tiež locale string (cs_CZ, de_DE, fr_FR, sk_SK, ro_RO, hu_HU, bg_BG, el_GR, tr_TR, hr_HR, sl_SI, en_US, pt_BR, es_ES, et_EE, lt_LT, lv_LV, it_IT, pl_PL).
items Items array Zoznam objednaných položiek
Array z JSON objects popisujú objednané položky. Každý objekt musí obsahovať tieto properties:
id
ID položky, ktorá je obsiahnutá v produktovom feede obchodu. Môže obsahovať vypredané výrobky - string|integer
name
Názov položky, ktorá sa zobrazí v e-maily - string
Príklad opt-in kódu

Hodnoty premenných sa obvykle nahrádzajú na stránke potvrdenia objednávky s kódom na strane servera. Nasledujúci príklad ukazuje, ako môžete implementovať kód modulu opt-in s PHP:

<script>
(function (f, a, s, h, i, o, n) {
f['GlamiOrderReview'] = i;
f[i] = f[i] || function () {(f[i].q = f[i].q || []).push(arguments);};
o = a.createElement(s), n = a.getElementsByTagName(s)[0];
o.async = 1; o.src = h; n.parentNode.insertBefore(o, n);
})(window,document,'script','//www.glami.sk/js/compiled/or.js', 'glami_or');

glami_or('addParameter', 'merchant_id','FFFFDDDDFFFFDDDDFFFFDDDDFFFFDDD', 'sk');
glami_or('addParameter', 'order_id', 'X95624');
glami_or('addParameter', 'email', 'john@doe.sk');
glami_or('addParameter', 'language', 'sk');
glami_or('addParameter', 'items', [
    {
        id: 36463570,
        name: 'long laces, red'
    },
    {
        id: 'MD-27927237',
        name: 'Blue T-shirt'
    }
]);

glami_or('create');
</script>

Riešenie problémov

Táto časť popisuje niektoré bežné chyby, s ktorými sa môžete stretnúť pri implemenácii opt-in kódu.

Možné chyby Riešenie Ukážka chyby Ukážka riešenia
Parameter `email` je nesprávne naformátovaný. Email musí byť odoslaný v správnom formáte. glami_or('addParameter', 'email', 'john @ down'); glami_or('addParameter', 'email', 'john@down.sk');
Parameter `email` je mimo rozsahu. E-mail je príliš dlhý (max 255 znakov).
Email musí byť odoslaný v správnom formáte.
glami_or('addParameter', 'email', 'TooLongEmail .....'); glami_or('addParameter', 'email', 'john@down.sk');
Parameter `language` je nesprávne naformátovaný. Obchod poslal nesprávny kód krajiny. Kód musí byť podľa kódu jazyka ISO 639-1 alebo locale reťazec.
Správny formát je kód jazyka podľa ISO 639-1 (cs, de, fr, sk, ro, hu, bg, el, tr, hr, sl, en, pt, es, et, lt, lv, it, pl) alebo locale string (cs_CZ, de_DE, fr_FR, sk_SK, ro_RO, hu_HU, bg_BG, el_GR, tr_TR, hr_HR, sl_SI, en_US, pt_BR, es_ES, et_EE, lt_LT, lv_LV, it_IT, pl_PL).
glami_or('addParameter', 'language', 'english'); glami_or('addParameter', 'language', 'en');
alebo
glami_or('addParameter', 'language', 'en_US');
Parameter`merchant_id` nie je platný. Obchod nám poslal neplatné ID obchodníka. glami_or('addParameter', 'merchant_id', 'xldk89n'); glami_or('addParameter', 'merchant_id', 'FFFF797D13193B02F67CACBD50ED9999');
Array kľúč `0` nie je JSON object Parametre položiek sme dostali v nesprávnej štruktúre.
Potrebujeme array z JSON objects obsahujúce kľúče `id` a `name`
glami_or('addParameter', 'items', ["item 1", "item 2"]); glami_or( 'addParameter', 'items', [ {"id": 1, "name": "item 1"}, {"id": 2, "name": "item 2"} ] );
`items` musí byť array z JSON objects Potrebujeme array z JSON objects obsahujúce kľúče `id` a `name` glami_or('addParameter', 'items', null); glami_or( 'addParameter', 'items', [ {"id": 1, "name": "item 1"}, {"id": 2, "name": "item 2"} ] );
JSON object neobsahuje platné `id` property kľúče `id` v `items` parameter chýba alebo je prázdny glami_or('addParameter', 'items', [{"name": "item 1"}, {"name": "item 2"}]); glami_or( 'addParameter', 'items', [ {"id": 1, "name": "item 1"}, {"id": 2, "name": "item 2"} ] );
JSON object neobsahuje správnu `name` property Potrebujeme array z JSON objects obsahujúce kľúče `id` a `name` glami_or('addParameter', 'items', null); glami_or( 'addParameter', 'items', [ {"id": 1, "name": "item 1"}, {"id": 2, "name": "item 2"} ] );
Chyby už nepodporovaných parametrov
Možné chyby Riešenie Ukážka chyby Ukážka riešenia
Parameter item_ids musí byť oddelený bodkočiarkou. Obchod nám nezaslal žiadne položky alebo prázdne identifikátory produktu. Všetky ostatné formáty sú platné a používajú sa ako jeden identifikátor produktu.
Napríklad "36463570,27927237" sa považuje za jeden identifikátor produktu. Bodkočiarka oddeľuje identifikátory produktu "36463570; 27927237".
glami_or('addParameter', 'item_ids', '');
glami_or('addParameter', 'item_ids', 'a212 ;;; b123');
glami_or('addParameter', 'item_ids', 'a212');
glami_or('addParameter', 'item_ids', 'a212 ; b123');
Parameter `item_names` musí byť oddelený bodkočiarkou. Rovnaká situácia ako vyššie s `item_ids`, iba bodkočiarkou oddelené hodnoty názvov sú platné. Akýkoľvek iný oddeľovač sa bude považovať za súčasť názvu, a teda ako jeden identifikátor produktu. glami_or('addParameter', 'item_names', 'women sport shoes, red umbrela'); glami_or('addParameter', 'item_names', 'skirt ;; jacket ;;'); glami_or('addParameter', 'item_names', 'women sport shoes;red umbrela'); glami_or('addParameter', 'item_names', 'skirt ; jacket');
Rôzny počet položiek parametrov `item_ids` a `item_names`. Počet odoslaných identifikátorov a názvov produktov musí byť rovnaký. glami_or('addParameter', 'item_ids', 'AS-1234'); glami_or('addParameter', 'item_names', 'blue jeans; red jacket'); glami_or('addParameter', 'item_ids', 'AS-1234; AS-4444'); glami_or('addParameter', 'item_names', 'blue jeans; red jacket');

2. Nastavenie odosielania dotazníka

GLAMI TOP zasielame z našich e-mailových serverov a ako odosielateľa uvádzame e-mail vášho e-shopu, ktorý si nastavíte v partnerskej administrácii.

Aby bol systém odosielania e-mailov úspešne nastavený, je potrebné, aby ste urobili dva nasledujúce kroky:

  1. V partnerskej administrácii, v záložke GLAMI TOP –> Nastavenia si nastavte e-mail, z ktorého budeme odosielať zákazníkom e-maily s dotazníkom. Tento e-mail by mal mať doménu zhodnú s vaším e-shopom. Napríklad www.shop.sk bude mať e-mail recenzie@shop.sk.
  2. Zmeňte nastavenie DNS domény vášho e-shopu (ide o rovnakú doménu, ktorú budete využívať k odosielaniu e-mailov z kroku 1.) podľa návodu nižšie. Toto nastavenie je dôležité preto, aby e-maily prišli zákazníkom do doručenej pošty a nie do zložky SPAM.

Návod k nastaveniu DNS:

Pre ochranu e-mailov odosielaných z vašej domény si pridajte do vášho SPF záznamu aj náš záznam: _emailing.glami.cz

Príklad: Pokiaľ máte pri vašej doméne SPF záznam v tvare v=spf1 ip4:1.2.3.4 -all, tak upravená verzia bude v=spf1 ip4:1.2.3.4 include:_emailing.glami.cz -all

Všetky odchádzajúce e-maily z GLAMI sú podpísané našim DKIM kľúčom. Vytvorte si k svojej doméne subdoménu glami-review._domainkey s DNS CNAME záznamom smerujúcim na partner-review._domainkey.glami.cz

Niektorí poskytovatelia hostingu vyžadujú uviesť bodku na konci záznamu. Príklad: glami-review._domainkey.glami.cz.

Správne nastavenie e-mailu si môžete overiť v partnerskej administrácii, v záložke GLAMI TOP –> Nastavenia, kde uvidíte status SPF a DKIM označený ako “Overený” v prípade správneho nastavenia a “Neoverený” v prípade chyby.