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:
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.
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.
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.
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.
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. |
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:
|
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>
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');
|
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');
|
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:
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.