GLAMI TOP je podpora, ki pomaga vaši e-trgovini pridobiti feedback za vaše usluge in kvaliteto izdelkov, ki so jih kupili pri vas.
Tukaj si lahko preberete, kako implementirati GLAMI TOP:
Nastavitev zbirke privolitev nam dovoljuje poizvedeti ali si stranka želi sodelovati v GLAMI TOP programu, vam pa omogoča pošiljanje potrebnih podatkov za transakcije na GLAMI.
Zbiranje privolitve v obliki pop-up okenca naj se zbira na zadnji strani naročila - na strani za potrditev plačila za takojšna plačila s kartico ali drugo varianto, ali pa na potrditveni strani naročila v primeru bančnega prenakazila ali pa plačila z gotovino ob dostavi.
Vse potrditvene strani morajo uporabljati HTTPS.
Ker modul sproži opt-in anketo, morajo biti vse informacije o naročilu v tem modulu pravilne in točne. Ne zakrivjte opt-in ankete z nobeno drugo vsebino na strani za potrdilo naročila.
Če sistem vaše trgovine že podpira GLAMI TOP, bo integracija precej preprosta. Privolitev (1. točka) lahko nastavite neposredno v administraciji sistema vaše trgovine. Pojdite na administracijo vašega sistema trgovine in poiščite GLAMI TOP. Sledite navodilom.
Nastavitev parametrov - vsi so obvezni. Primere parametrov z obrazložitvijo si lahko ogledati v tabeli spodaj.
Če želite preveriti ali vaš sistem trgovine podpira to funkcijo, lahko to storite v sekciji Kako povezati vašo trgovino z GLAMI ali pa direktno v sistemu trgovine.
Po implementaciji modula je še vedno potrebno nastaviti DNS zapise (2. točka tega intergracijskega vodiča), več informacij spodaj.
Če uporabljate Google Tag Manager lahko tako pospešite nastavitev zbirke podatkov z uporabo predloge v GTM galeriji.
Nadaljujte s C) Integracija z Javascriptom. Nastavite pošiljanje vseh parametrov - vsi so obvezni. Primere parametrov z obrazložitvijo boste našli v tabeli spodaj.
Po implementaciji modula je še vedno potrebno nastaviti DNS zapise (2. točka tega intergracijskega vodiča), več informacij spodaj.
Link do GTM predloge https://tagmanager.google.com/gallery/#/owners/glami/templates/top-gtm-template.
Prilepite naslednji delček HTML-a v potrdilno stran naročila:
<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.si/js/compiled/or.js', 'glami_or');
glami_or('addParameter', 'merchant_id','FFFFDDDDFFFFDDDDFFFFDDDDFFFFDDD', 'si');
glami_or('addParameter', 'order_id', 'ORDER_1');
glami_or('addParameter', 'email', 'name@domain.si');
glami_or('addParameter', 'language', 'sl');
glami_or('addParameter', 'items', [
{
id: 36463570,
name: 'Long laces, red'
},
{
id: 'XT-27927237',
name: 'T-shirt with moose pattern'
}
]);
glami_or('create');
</script>
Umestite kodo ravno pred koncem html elementa </BODY>
.
Nadomestite vrednote v rdečem z dinamičnimi vrednotami, ki so specifične za vašo stran in naročilo.
Vsi parametri so potrebni.
Naslednja tabela opisuje možne nastavitve:
Spremenljivka | Ime | Tip podatkov | Namen in opis |
---|---|---|---|
merchant_id | ID e-trgovine | string (32) | ID e-trgovine. Drugi parameter je uporabljen za določitev GLAMI domene, na kateri je vaša trgovina registrirana (cz za Glami.cz, sk za Glami.sk, tr za Glami.com.tr). Pravilne vrednote lahko najdete na vaši GLAMI partnerski administraciji. |
order_id | ID naročila | string (32) | Edinstven ID naročila. Se uporablja za prepoznavanje posameznih naročil. |
Email stranke | string (255) | Email naslov v formatu name@domain.si. | |
language | Jezik | string (2), string (5) |
Koda jezika odloči kateri jezik bo GLAMI uporabil za komuniciranje s stranko. Veljavni formati so ISO 639-1 (cs, de, fr, sk, ro, hu, bg, el, tr, hr, sl, en, pt, es, et, lt, lv, it, pl) ali pa lokalna veriga (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 | Izdelki | array |
Seznam kupljenih kosov Array JSON predmetov opisuje kupljene izdelke. Vsak predmet mora vsebovati te lastnosti:
|
Variabilne vrednote so ponavadi zamenjane na potrditveni strani naročila s kodo na strani serverja. Naslednji primer prikazuje, kako vstaviti opt-in kodo 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.si/js/compiled/or.js', 'glami_or');
glami_or('addParameter', 'merchant_id','FFFFDDDDFFFFDDDDFFFFDDDDFFFFDDD', 'si');
glami_or('addParameter', 'order_id', 'X95624');
glami_or('addParameter', 'email', 'john@doe.si');
glami_or('addParameter', 'language', 'sl');
glami_or('addParameter', 'items', [
{
id: 36463570,
name: 'long laces, red'
},
{
id: 'MD-27927237',
name: 'Blue T-shirt'
}
]);
glami_or('create');
</script>
Ta sekcija opisuje nekaj pogostih napak, s katerimi se boste morda soočili med vstavljanjem opt-in kode.
Mogoče napake | Rešitev | Primer napake | Primer rešitve |
---|---|---|---|
`email` parameter je nepravilno formatiran. | Ta email mora biti poslan v pravilnem formatu. | glami_or('addParameter', 'email', 'john @ down'); |
glami_or('addParameter', 'email', 'john@down.si'); |
`email` parameter je izven dosega. |
Email je predolg (max 255 znakov). Ta email mora biti poslan v pravilnem formatu. |
glami_or('addParameter', 'email', 'TooLongEmail .....'); |
glami_or('addParameter', 'email', 'john@down.si'); |
`language` parameter je nepravilno formatiran. |
Trgovina je poslala napačno kodo države. Mora biti ena od ISO 639-1 jezikovnik kod ali pa lokalna veriga. Veljaven format je koda jezika glede na ISO 639-1 (cs, de, fr, sk, ro, hu, bg, el, tr, hr, sl, en, pt, es, et, lt, lv, it, pl) oziroma locale veriga (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'); ali glami_or('addParameter', 'language', 'en_US');
|
`merchant_id` parameter ni veljaven. | Trgovina nam je poslala nepravilen trgovski ID. |
glami_or('addParameter', 'merchant_id', 'xldk89n');
|
glami_or('addParameter', 'merchant_id', 'FFFF797D13193B02F67CACBD50ED9999');
|
Array kjuč `0` ni JSON predmet |
Parameter izdelkov smo prejeli v napačni strukturi. Potrebujemo array JSON predmetov, ki vsebujejo ključa `id` in `name` |
glami_or('addParameter', 'items', ["item 1", "item 2"]);
|
glami_or(
'addParameter',
'items',
[
{"id": 1, "name": "item 1"},
{"id": 2, "name": "item 2"}
]
);
|
`items` mora biti array JSON predmetov | Potrebujemo array JSON predmetov, ki vsebujejo ključa `id` in `name` |
glami_or('addParameter', 'items', null);
|
glami_or(
'addParameter',
'items',
[
{"id": 1, "name": "item 1"},
{"id": 2, "name": "item 2"}
]
);
|
JSON predmet ne vsebuje pravilnih `id` značilnosti | Ključ `id` v parametru `items` bodisi manjka, ali pa je prazen |
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 predmet ne vsebuje pravilne `name` značilnosti | Potrebujemo array JSON predmetov, ki vsebujejo ključa `id` in `name` |
glami_or('addParameter', 'items', null);
|
glami_or(
'addParameter',
'items',
[
{"id": 1, "name": "item 1"},
{"id": 2, "name": "item 2"}
]
);
|
Napaka zastarelih parametrov | |||
---|---|---|---|
Mogoče napake | Rešitev | Primer napake | Primer rešitve |
item_ids parameter naj bo ločen s podpičjem. |
Trgovina nam ni poslala nobenih izdelkov ali pa praznih indetifikatorjev izdelkov. Vsi drugi formati so veljavni in uporabljeni kot en indetifikator izdelka. Naprimer, "36463570,27927237" je štet kot en indetifikator izdelka. Podpičje ločuje indetifikatorje "36463570; 27927237" izdelkov. |
glami_or('addParameter', 'item_ids', '');
|
glami_or('addParameter', 'item_ids', 'a212');
|
`item_names` parameter naj bo ločen s podpičjem. | Prav tako kot zgoraj le s `item_ids` podpičjem ločene vrednote so veljavne. Kakršenkoli drug delimiter bo obravnavan kot del imena izdelka in zato tudi kot identifikator posameznega izdelka. |
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');
|
Različni številki `item_ids` in `item_names`. | Število identifikatorjev in izdelkov mora biti enako. |
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 vprašalnike pošiljamo iz našega e-mail serverja, kot pošiljatelja pa navedemo e-mail vaše e-trgovine. To lahko uredite v partnerski administraciji.
Da bi uspešno nastavili vaš e-mail sistem, morate slediti naslednjim dvem korakom:
Da bi zaščitili pošto poslano iz vaše domene, dodajte naš vstop v vaš SPF zapis: _emailing.glami.cz
Naprimer: Če imate vstop do vaše domene v=spf1 ip4:1.2.3.4 -all, potem bo spremenjena verzija v=spf1 ip4:1.2.3.4 include:_emailing.glami.cz -all
Vsi GLAMI odhodni e-maili so podpisani z našim DKIM ključem. Za vašo domeno ustvarite "pod domeno" z DNS CNAME zapisom, ki kaže na glami-review._domainkey
Nekateri gostitelji zahtevajo piko na koncu zapisa. Primer: glami-review._domainkey.glami.cz.
Pravilne e-mail nastavitve lahko preverite v partnerski administraciji v zavihku Recenzije -> Nastavitve, kjer boste videli SPF in DKIM status označen kot "potrjen" če so nastavitve pravilne in "neuspešen" v primeru napake.