GLAMI TOP integrační průvodce

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:

  • Implementovat sběr souhlasu se službou jedním z následujících způsobů:
    • Váš shop-systém podporuje službu GLAMI TOP
    • Integrace pomocí Google Tag Manager
    • Integrace pomocí Javascriptu
  • Nastavit odeslání e-mailů s dotazníkem, aby zákazníkům nepadaly do spamu.

1. Nastavení sběru souhlasu se službou

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.

Pokyny integrace

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.

A) Váš shop-systém podproruje GLAMI TOP (není potřeba programátor)

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.

B) Integrace pomocí Google Tag Manageru (zprovozní programátor)

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.

C) Integrace pomocí Javascriptu (zprovozní programátor)

Přidání opt-in kódu

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.
email 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:
id
ID položky, které je obsaženo ve feedu obchodu, může zahrnovat vyprodané produkty - string|integer
name
Název položky, která bude zobrazena v e-mailu - string
Příklad opt-in kódu

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>

Odstraňování problémů

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 ;;; b123');
glami_or('addParameter', 'item_ids', 'a212');
glami_or('addParameter', 'item_ids', 'a212 ; b123');
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');

2. Nastavení odesílání dotazníku

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:

  1. V partnerské administraci v záložce GLAMI TOP –> Nastavení si nastavte e-mail, ze kterého budeme posílat zákazníkům e-maily s dotazníkem. Tento e-mail by měl mít doménu shodnou s vaším e-shopem. Například www.shop.cz bude mít e-mail recenze@shop.cz.
  2. Změňte nastavení DNS domény vašeho e-shopu (jedná se o stejnou doménu, kterou využijete k odesílání e-mailů z kroku 1.) podle návodu níže. Toto nastavení je důležité proto, aby e-maily skončily zákazníkům v doručené poště, a nikoliv ve složce SPAM.

Návod k nastavení DNS:

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.