A GLAMI TOP egy olyan szolgáltatás, mely segít webáruházadnak vásárlói értékeléseket gyűjteni szolgáltatásaid és termékeid minőségéről.
Így telepítsd a GLAMI TOP-ot:
A hozzájárulás-kérés lehetővé teszi számunkra, hogy kiderítsük, szeretnének-e a vásárlók részt venni a GLAMI TOP kérdőívben.
A hozzájárulás pop-up (felugró ablak) formájában történő összegyűjtését a megrendelés utolsó oldalán - a fizetés visszaigazolási oldalán - kell elvégezni.
Minden megerősítő oldalon HTTPS-t kell használni.
Mivel ez a modul indítja az opt-in kérdőívet, a benne szereplő összes rendelési adatnak pontosnak és helyesnek kell lennie. Ne fedd le az opt-in kérdőívet semmilyen más tartalommal a vásárlást megerősítő oldalon.
Ha az üzlet-rendszered már támogatja a GLAMI TOP-ot, a telepítés nagyon egyszerű lesz. Beállíthatod a hozzájárás megadását (1. pont) az adminisztrációs szekcióban. Menj az üzleted adminisztrációjába és keresd a GLAMI TOP modult, majd kövesd az utasításokat.
Az összes paraméter küldése a beállításhoz - mindegyik kötelező. A paraméterek magyarázatait az alábbi táblázat tartalmazza.
A Hogyan kapcsold üzleted a GLAMI-hoz szekcióban, vagy egyenesen az üzlet-rendszeredben ellenőrizheted, hogy támogatja-e a üzleted ezt a funkciót.
A modul telepítése után szükséges a DNS rekord megadása (a telepítési útmutató 2. pontja), további információkért olvass tovább.
A Google Tag Manager használatával felgyorsíthatod az adatgyűjtési beállításokat a GTM galéria sablonjának felhasználásával.
Folytasd a C) Javascript beillesztése szerint. Kérlek, állítsd be az összes paraméter küldését - mindegyik kötelező. Az alábbi táblázatban találsz példákat a paraméterekre.
A modul telepítése után szükséges a DNS rekord megadása (a telepítési útmutató 2. pontja), további információkért olvass tovább.
Link a GTM sablonhoz: https://tagmanager.google.com/gallery/#/owners/glami/templates/top-gtm-template.
Illeszd be a következő HTML kódrészletet a vásárlást megerősítő oldalra:
<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.hu/js/compiled/or.js', 'glami_or');
glami_or('addParameter', 'merchant_id','FFFFDDDDFFFFDDDDFFFFDDDDFFFFDDD', 'hu');
glami_or('addParameter', 'order_id', 'ORDER_1');
glami_or('addParameter', 'email', 'name@domain.hu');
glami_or('addParameter', 'language', 'hu');
glami_or('addParameter', 'items', [
{
id: 36463570,
name: 'Long laces, red'
},
{
id: 'XT-27927237',
name: 'T-shirt with moose pattern'
}
]);
glami_or('create');
</script>
Helyezd a kódot közvetlenül a záró html elem elé </BODY>
.
Cseréld ki a pirossal jelölt értékeket a weboldaladhoz a rendeléshez tartozó értékekkel.
Minden paramétert kötelező megadni.
A következő táblázat ismerteti az elérhető beállításokat:
Változó | Név | Adattípus | Leírás |
---|---|---|---|
merchant_id | Webshop azonosító | string (32) | Webshop azonosító. Itt a második paramétert arra használjuk, hogy meghatározzuk a domain címet, amelyen az üzleted regisztrálva van (hu a Glami.hu-hoz, cz a Glami.cz-hez, de a Glami.de-hez...). A megfelelő értéket a GLAMI partner adminisztrációban találod. |
order_id | Rendelés azonosító | string (32) | Egyedi rendelés azonosító. Az egyes rendelések megkülönböztetésére szolgál. |
Vásárló e-mail címe | string (255) | Az e-mail cím formátuma: name@domain.hu. | |
language | Nyelv | string (2), string (5) |
Nyelvkód, amely meghatározza, hogy a GLAMI milyen nyelven fog kommunikálni az ügyféllel. Érvényes formátumok az ISO 639-1 (cs, de, fr, sk, ro, hu, bg, el, tr, hr, sl, en, pt, es, et, lt, lv, it, pl) vagy pedig 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 | Elemek | array |
A megrendelt tételek listája JSON objektumok sora, amely leírja a megrendelt tételeket. Minden objektumnak tartalmaznia kell ezeket a tulajdonságokat:
|
A változó értékeket általában a megrendelés visszaigazolási oldalán a szerveroldalon található kód váltja fel. A következő példa bemutatja, hogyan valósítható meg az opt-in kód a PHP-vel:
<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.hu/js/compiled/or.js', 'glami_or');
glami_or('addParameter', 'merchant_id','FFFFDDDDFFFFDDDDFFFFDDDDFFFFDDD', 'hu');
glami_or('addParameter', 'order_id', 'X95624');
glami_or('addParameter', 'email', 'john@doe.hu');
glami_or('addParameter', 'language', 'hu');
glami_or('addParameter', 'items', [
{
id: 36463570,
name: 'long laces, red'
},
{
id: 'MD-27927237',
name: 'Blue T-shirt'
}
]);
glami_or('create');
</script>
Ez a szakasz ismertet néhány gyakori hibát, amelyekkel az opt-in kód végrehajtása során találkozhatsz.
Lehetséges hibák | Megoldás | Példa hibára | Példa megoldásra |
---|---|---|---|
A `email` paraméter helytelenül van formázva. | Az e-mailt megfelelő formátumban kell elküldeni. | glami_or('addParameter', 'email', 'john @ down'); |
glami_or('addParameter', 'email', 'john@down.hu'); |
Az `email` paraméter a tartományon kívül esik. |
Az e-mail túl hosszú (maximum 255 karakter). Az e-mailt megfelelő formátumban kell elküldeni. |
glami_or('addParameter', 'email', 'TooLongEmail .....'); |
glami_or('addParameter', 'email', 'john@down.hu'); |
A `language` paraméter helytelenül van formázva. |
Az üzlet helytelen országkódot küldött. Az ISO 639-1 nyelvkód vagy pedig locale string szerint szükséges megadni. Érvényes formátumok az ISO 639-1 nyelvkód (cs, de, fr, sk, ro, hu, bg, el, tr, hr, sl, en, pt, es, et, lt, lv, it, pl) vagy pedig 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'); vagy glami_or('addParameter', 'language', 'en_US');
|
A `merchant_id` paraméter nem érvényes. | Az áruház helytelen Kereskedő-azonosítót küldött nekünk. |
glami_or('addParameter', 'merchant_id', 'xldk89n');
|
glami_or('addParameter', 'merchant_id', 'FFFF797D13193B02F67CACBD50ED9999');
|
A`0` array kulcs nem egy JSON objekum |
Helytelen struktúrájú paraméter elemeket kaptunk. Szükségünk van JSON-objektumok tömbjére, amelyek tartalmazzák az „id” és „name” kulcsokat |
glami_or('addParameter', 'items', ["item 1", "item 2"]);
|
glami_or(
'addParameter',
'items',
[
{"id": 1, "name": "item 1"},
{"id": 2, "name": "item 2"}
]
);
|
Az `items` pataméternek JSON objektumok tömbjének kell lennie | Szükségünk van JSON-objektumok tömbjére, amelyek tartalmazzák az „id” és „name” kulcsokat |
glami_or('addParameter', 'items', null);
|
glami_or(
'addParameter',
'items',
[
{"id": 1, "name": "item 1"},
{"id": 2, "name": "item 2"}
]
);
|
A JSON objektum nem tartalmaz érvényes `id` tulajdonságot | hiányzó vagy üres `id` az `items` paraméterben |
glami_or('addParameter', 'items', [{"name": "item 1"}, {"name": "item 2"}]);
|
glami_or(
'addParameter',
'items',
[
{"id": 1, "name": "item 1"},
{"id": 2, "name": "item 2"}
]
);
|
A JSON objektum nem tartalmaz érvényes `name` tulajdonságot | Szükségünk van JSON-objektumok tömbjére, amelyek tartalmazzák az „id” és „name” kulcsokat |
glami_or('addParameter', 'items', null);
|
glami_or(
'addParameter',
'items',
[
{"id": 1, "name": "item 1"},
{"id": 2, "name": "item 2"}
]
);
|
Az elavult paraméterek hibái | |||
---|---|---|---|
Lehetséges hibák | Megoldás | Példa hibára | Példa megoldásra |
Az paramétereket pontosvesszővel kell elválasztani. |
Az áruház nem küldött nekünk semmilyen terméket vagy csak üres termék-azonosítót. Az összes többi formátum érvényes és egyetlen termékazonosítóként használható. Például, "36463570,27927237" egy termékazonosítónak tekinthető. A pontosvessző különválasztja a termékazonosítókat "36463570; 27927237". |
glami_or('addParameter', 'item_ids', '');
|
glami_or('addParameter', 'item_ids', 'a212');
|
Az paramétereket pontosvesszővel kell elválasztani. | Ugyanúgy, mint a fenti `item_ids` esetében, csak a pontosvesszővel elválasztott értékek érvényesek. Bármely más elválasztó a terméknév részeként, tehát egyetlen termékazonosítóként lesz azonosítva. |
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');
|
Különböző darabszámú tételek az `item_ids` és `item_names` paraméterekben. | Az elküldött azonosítók és terméknevek számának azonosnak kell lennie. |
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');
|
A GLAMI TOP kérdőívet az e-mail szervereinkről küldjük, és feladóként az üzleted e-mail címét adjuk meg, amelyet a partner adminisztrációban állítottál be.
Az levelezőrendszer sikeres beállításához a következő két lépést kell végrehajtanod:
A domainedről küldött e-mailek védelme érdekében add hozzá a bejegyzést az SPF-rekordhoz: _emailing.glami.cz
Pélául: Ha van egy bejegyzésed a domainedhez v=spf1 ip4:1.2.3.4 -mind, akkor a módosított verzió ez lesz: v=spf1 ip4:1.2.3.4 include:_emailing.glami.cz -all
Az összes GLAMI által elküldött e-mail a DKIM kulcsunk által van aláírva. Hozz létre a domainhez egy aldomaint - glami-review._domainkey, egy DNS CNAME rekorddal, mely a partner-review._domainkey.glami.cz-re mutat.
Néhány tárhelyszolgáltató pontot igényel a felvétel végén. Példa: glami-review._domainkey.glami.cz.
A helyes e-mail beállításokat a partner adminisztrációban ellenőrizheted a GLAMI TOP -> Beállítások alatt, ahol az SPF és DKIM státusz „Verified”, ha helyesen van beállítva és „Failed”, ha hibásan.