GLAMI TOP je služba, která pomáhá vašemu eshopu získat zpětnou vazbu od zákazníků o vašich službách a kvalitě produktů, které si od vás zakoupili.
Jak postupovat při implementaci služby GLAMI TOP:
Nastavení udílení souhlasů nám pomáhá zjistit, zda se zákazníci chtějí účastnit programu GLAMI TOP a umožňuje vám posílat na GLAMI všechny potřebné transakční informace.
Sběr souhlasu formou pop-upu by měl proběhnout na poslední stránce v rámci objednacího procesu - tedy na na stránce s potvrzením platby v případě okamžité platby kartou, nebo jinou metodou, nebo na stránce s potvrzením objednávky v případě platby převodem na účet, nebo dobírkou.
Všechny potvrzovací stránky musí používat HTTPS.
Vzhledem k tomu, že tento modul spouští opt-in dotazník, musí být údaje o objednávce v tomto modulu přesné a správné. Nezakrývejte opt-in dotazník jakýmkoliv jiným obsahem na stránce potvrzení objednávky.
V případě, že váš shop-systém již podporuje službu GLAMI TOP, bude integrace velice jednoduchá. Nastavení sběru souhlasu (bod 1) uděláte přímo v administraci vašeho shop-systému. Přejděte do administrace vašeho shop-systém, a tam vyhledejte modul pro GLAMI TOP. Postupujte podle instrukcí.
Nastavte odesílání všech parametrů - všechny jsou povinné. Příklady parametrů s vysvětlením naleznete níže v tabulce.
Zda váš e-shop podporuje tuto funkci, můžete zkontrolovat v sekci Jak napojit váš e-shop na GLAMI, nebo přímo s obchodním systémem.
Po implementaci modulu je ještě zapotřebí nastavit DNS záznamy (bod 2 integračního návodu), více informací naleznete níže.
Pokud používáte Google Tag Manager, můžete urychlit nastavení sběru dat pomocí šablony v galerii GTM.
Postupujte stejně jako v bodě C) Integrace pomocí Javascriptu. Nastavte odesílání všech parametrů - všechny jsou povinné. Příklady parametrů s vysvětlením naleznete níže v tabulce.
Po implementaci modulu je ještě zapotřebí nastavit DNS záznamy (bod 2 integračního návodu), více informací naleznete níže.
Odkaz na GTM šablonu: https://tagmanager.google.com/gallery/#/owners/glami/templates/top-gtm-template.
Vložte následující úryvek HTML do stránky s potvrzení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.cz/js/compiled/or.js', 'glami_or');
glami_or('addParameter', 'merchant_id','FFFFDDDDFFFFDDDDFFFFDDDDFFFFDDD', 'cz');
glami_or('addParameter', 'order_id', 'ORDER_1');
glami_or('addParameter', 'email', 'name@domain.cz');
glami_or('addParameter', 'language', 'cs');
glami_or('addParameter', 'items', [
{
id: 36463570,
name: 'Long laces, red'
},
{
id: 'XT-27927237',
name: 'T-shirt with moose pattern'
}
]);
glami_or('create');
</script>
Umístěte kód těsně před koncový html element </BODY>
.
Nahraďte hodnoty s červenou barvou dynamickými hodnotami specifickými pro váš web a objednávku uživatele.
Všechny parametry jsou povinné.
Následující tabulka popisuje dostupná nastavení:
Proměnná | Jméno | Data type | Účel a popis |
---|---|---|---|
merchant_id | ID e-shopu | string (32) | ID e-shopu. Druhý parametr slouží k určení Glami domény, na které je váš eshop zaregistrovaný (cz pro Glami.cz, de pro Glami.de, tr pro Glami.com.tr). Správné hodnoty obou parametrů najdete v partnerské administraci GLAMI. |
order_id | ID objednávky | string (32) | Jednoznačné ID objednávky. Slouží k identifikaci jednotlivých objednávek. |
Zákaznický e-mail | string (255) | E-mailová adresa zákazníka ve formátu name@domain.cz. | |
language | Jazyk | string (2), string (5) |
Kód jazyka stanovující, který jazyk GLAMI použije pro komunikaci se zákazníkem. Správný formát je podle ISO 639-1 (cs, de, fr, sk, ro, hu, bg, el, tr, hr, sl, en, pt, es, et, lt, lv, it, pl), nebo také 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 | Položky | array |
Seznam objednaných položek Pole JSON objektů popisujících objednané položky. Každý objekt musí obsahovat tyto vlastnosti:
|
Hodnoty proměnných se obvykle nahrazují na stránce potvrzení objednávky s kódem na straně serveru. Následující příklad ukazuje, jak můžete implementovat 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.cz/js/compiled/or.js', 'glami_or');
glami_or('addParameter', 'merchant_id','FFFFDDDDFFFFDDDDFFFFDDDDFFFFDDD', 'cz');
glami_or('addParameter', 'order_id', 'X95624');
glami_or('addParameter', 'email', 'john@doe.cz');
glami_or('addParameter', 'language', 'cs');
glami_or('addParameter', 'items', [
{
id: 36463570,
name: 'long laces, red'
},
{
id: 'MD-27927237',
name: 'Blue T-shirt'
}
]);
glami_or('create');
</script>
Tato část popisuje některé běžné chyby, se kterými se můžete setkat při implementaci opt-in kódu.
Možné chyby | Řešení | Ukázka chyby | Ukázka řešení |
---|---|---|---|
Parametr `email` není ve správném formátu. | Email musí být zaslán ve správném formátu | glami_or('addParameter', 'email', 'john @ down'); |
glami_or('addParameter', 'email', 'john@down.cz'); |
Parametr `email` je mimo škálu. |
E-mail je příliš dlouhý (maximum je 255 znaků). Email musí být zaslán ve správném formátu |
glami_or('addParameter', 'email', 'TooLongEmail .....'); |
glami_or('addParameter', 'email', 'john@down.cz'); |
Parametr `language` není ve správném formátu. |
Obchod zaslal nesprávný kód země. Kód jazyka musí být podle ISO 639-1, nebo také locale řetězec. Správný formát je kód jazyka podle ISO 639-1 (cs, de, fr, sk, ro, hu, bg, el, tr, hr, sl, en, pt, es, et, lt, lv, it, pl), nebo také 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'); nebo glami_or('addParameter', 'language', 'en_US');
|
Parameter `merchant_id` není platný. | Obchod nám poslal neplatné ID obchodníka. |
glami_or('addParameter', 'merchant_id', 'xldk89n');
|
glami_or('addParameter', 'merchant_id', 'FFFF797D13193B02F67CACBD50ED9999');
|
Klíč pole `0` není JSON objektem |
Parametry položek jsme dostali v nesprávné struktuře. Potřebujeme pole JSON objektů obsahující klíč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í být pole JSON objektů | Potřebujeme pole JSON objektů obsahující klíče `id` a `name` |
glami_or('addParameter', 'items', null);
|
glami_or(
'addParameter',
'items',
[
{"id": 1, "name": "item 1"},
{"id": 2, "name": "item 2"}
]
);
|
JSON objekty neobsahují platnou vlastnost `id` | klíč `id` v `items` parametru chybí, nebo je prázdný |
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 objekty neobsahují platnou vlastnost `name` | Potřebujeme pole JSON objektů obsahující klíče `id` a `name` |
glami_or('addParameter', 'items', null);
|
glami_or(
'addParameter',
'items',
[
{"id": 1, "name": "item 1"},
{"id": 2, "name": "item 2"}
]
);
|
Chyby již nepodporovaných parametrů | |||
---|---|---|---|
Možné chyby | Řešení | Ukázka chyby | Ukázka řešení |
Parametr item_ids musí být oddělen středníky. |
Obchod nám neposlal žádné položky nebo prázdné identifikátory produktů. Všechny ostatní formáty jsou platné a používají se jako jeden identifikátor produktu. Například "36463570,27927237" se bere jako jeden identifikátor produktu. Středník odděluje identifikátory produktů "36463570; 27927237". |
glami_or('addParameter', 'item_ids', '');
|
glami_or('addParameter', 'item_ids', 'a212');
|
Parametr `item_names` musí být oddělen středníky. | Stejná situace jako výše s `item_ids`, pouze středníkem oddělené hodnoty názvů jsou platné. Jakýkoliv jiný oddělovač bude považován za součást názvu a tedy jako 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');
|
Odlišný počet položek parametru `item_ids` a `item_names`. | Počet zaslaných identifikátorů a názvů produktů musí být totožný. |
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');
|
Dotazník GLAMI TOP zasíláme z našich e-mailových serverů a jako odesílatele uvádíme e-mail vašeho e-shopu, který si nastavíte v partnerské administraci.
Aby byl systém rozesílání e-mailů úspěšně nastaven, je zapotřebí, abyste udělali dva následující kroky:
Pro ochranu e-mailů odesílaných z vaší domény si přidejte do vašeho SPF záznamu i náš záznam: _emailing.glami.cz
Příklad: Pokud máte u vaší domény SPF záznam ve tvaru v=spf1 ip4:1.2.3.4 -all, pak upravená verze bude v=spf1 ip4:1.2.3.4 include:_emailing.glami.cz -all
Všechny odchozí e-maily z GLAMI jsou podepsány našim DKIM klíčem. Vytvořte ke své doméně subdoménu glami-review._domainkey s DNS CNAME záznamem směřujícím na partner-review._domainkey.glami.cz
Někteří poskytovatelé hostingu vyžadují uvést tečku na konci záznamu. Příklad: glami-review._domainkey.glami.cz.
Správné nastavení e-mailu si můžete ověřit v partnerské administraci v záložce GLAMI TOP –> Nastavení, kde uvidíte status SPF a DKIM, označený jako “Ověřeno” v případě správného nastavení a “Neověřeno” v případě chyby.