GLAMI TOP je usluga koja pomaže vašoj e-trgovini dobiti povratnu informaciju od korisnika na vaše usluge i proizvode koje su kupili kod vas.
Ovdje možete saznati kako implementirati GLAMI TOP:
Postavljane kolekcije pristanaka nam omogućuje saznati da li korisnici žele sudjelovati u GLAMI TOP programu i omogućuje vam da pošaljete GLAMI-ju sve potrebne informacije o transakcijama.
Kolekcija pristanaka u formi pop-up-a treba biti sakupljena na posljednjoj stranici procesa narudžbe- na stranici gdje se potvrđuje plaćanje karticom ili drugom metodom, ili na stranici gdje se potvrđuje bankovni transfer ili uplata pri dostavi.
Sve stranice moraju koristiti HTTPS.
Obzirom da ovaj modul šalje opt-in upitnik, svi podaci o narudžbi moraju biti točni i ispravni. Ne prekrivajte opt-in upitnik sa bilo kojim drugim sadržajem na stranici gdje se potrđuje narudžba.
Ukoliko sistem vaše trgovine podržava GLAMI TOP, integracija će biti vrlo jednostavna. Možete postaviti kolekciju pristanaka (točka 1) direktno u administraciji sistema vaše trgovine. Idite u administraciju sistema vaše trgovine i potražite modul za GLAMI TOP. Slijedite upute.
Postavite slanje svih parametara- svi su obavezni. Primjeri parametara sa objašnjenjem mogu se pronaći u tablici ispod.
Možete provjeriti da li sistem vaše e-trgovine podržava ovu funkciju u Kako povezati vašu trgovinu sa GLAMI sekcijom ili direktno sa sistemom trgovine.
Nakon implementacije modula potrebno je instalirati DNS podatke (točka 2 u integracijskom vodiču). Za više informacija pogledajte ispod.
Ukoliko koristite Google Tag Manager možete ubrzati instalaciju data podataka koristeći template u GTM Galeriji.
Nastaviti kao u C) Integracija sa Javascriptom. Postavite slanje svih parametara- svi su obavezni. Primjeri parametara sa objašnjenjem mogu se pronaći u tablici ispod.
Nakon implementacije modula potrebno je instalirati DNS podatke (točka 2 u integracijskom vodiču). Za više informacija pogledajte ispod.
Poveznica sa GTM https://tagmanager.google.com/gallery/#/owners/glami/templates/top-gtm-template.
Kopirajte html odsječak na stranicu koja potvrđuje narudžbu:
<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.hr/js/compiled/or.js', 'glami_or');
glami_or('addParameter', 'merchant_id','FFFFDDDDFFFFDDDDFFFFDDDDFFFFDDD', 'hr');
glami_or('addParameter', 'order_id', 'ORDER_1');
glami_or('addParameter', 'email', 'name@domain.hr');
glami_or('addParameter', 'language', 'hr');
glami_or('addParameter', 'items', [
{
id: 36463570,
name: 'Long laces, red'
},
{
id: 'XT-27927237',
name: 'T-shirt with moose pattern'
}
]);
glami_or('create');
</script>
Unesite kod prije završetka html elementa </BODY>
.
Zamijenite values u crvenom sa dinamičnim vrijednostima specifičnima vašoj stranici i poredku.
Svi parametri su potrebni.
Tablica opisuje dostupne postavke:
Varijabla | Ime | Vrsta date | Svrha i opis |
---|---|---|---|
merchant_id | ID e-trgovine | string (32) | ID e-trgovine. Drugi parametar se koristi da bi se odredila GLAMI domena, na kojoj je vaša e-trgovina registrirana (cz za glami.cz, de za glami.de, tr za glami.com.tr). Točne vrijednosti možete pronaći u GLAMI partnerskoj administraciji. |
order_id | ID narudžbe | string (32) | Jedinstveni ID narudžbe. Koristi se da bi se odredio individualni poredak. |
E-mail korisnika | string (255) | E-mail adresa je u formatu name@domain.hr. | |
language | Jezik | string (2), string (5) |
Kod jezika određuje kojim jezikom će GLAMI komunicirati sa korisnikom. Format koji vrijedi je ISO 639-1(cs, de, fr, sk, ro, hu, bg, el, tr, hr, sl, en, pt, es, et, lt, lv, it, pl) ili locale lanac (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 | Proizvodi | array |
Lista prodanih proizvoda Polja JSON objekata opisuju naručene proizvode. Svaki objekt mora sadržati ove karakteristike:
|
Varijabline vrijednosti se obično nadomještaju na stranici gdje se potvrđuje narudžba sa kodom na strani servera. Idući primjer prikazuje kako je moguće implementirati kod modela opt-in sa 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.hr/js/compiled/or.js', 'glami_or');
glami_or('addParameter', 'merchant_id','FFFFDDDDFFFFDDDDFFFFDDDDFFFFDDD', 'hr');
glami_or('addParameter', 'order_id', 'X95624');
glami_or('addParameter', 'email', 'john@doe.hr');
glami_or('addParameter', 'language', 'hr');
glami_or('addParameter', 'items', [
{
id: 36463570,
name: 'long laces, red'
},
{
id: 'MD-27927237',
name: 'Blue T-shirt'
}
]);
glami_or('create');
</script>
Ovaj odjeljak opisuje samo moguće pogreške na koje možete naići tijekom implementiranja opt-in koda.
Moguće pogreške | Rješenje | Primjer greške | Primjer rješenja |
---|---|---|---|
Parametar `email` je u ne ispravnom formatu. | E-mail mora biti poslan u ispravnom formatu | glami_or('addParameter', 'email', 'john @ down'); |
glami_or('addParameter', 'email', 'john@down.hr'); |
Parametar `email` je izvan ranga. |
E-mail je predugačak (maksimalni broj znakova je 255). E-mail mora biti poslan u ispravnom formatu |
glami_or('addParameter', 'email', 'TooLongEmail .....'); |
glami_or('addParameter', 'email', 'john@down.hr'); |
Parametar `language` je u ne ispravnom formatu. |
Trgovina je poslala neispravan kod države. Format mora biti kod jezika po ISO 639-1 ili locale lanac. Ispravan format je kod jezika po ISO 639-1 (cs, de, fr, sk, ro, hu, bg, el, tr, hr, sl, en, pt, es, et, lt, lv, it, pl) ili također locale lanac (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'); ili glami_or('addParameter', 'language', 'en_US');
|
Parametar `merchant_id` ne vrijedi. | Trgovina nam je poslala nevažeći ID prodavača. |
glami_or('addParameter', 'merchant_id', 'xldk89n');
|
glami_or('addParameter', 'merchant_id', 'FFFF797D13193B02F67CACBD50ED9999');
|
Ključ polja `0` nije JSON objekt |
Parametre foldera smo primili u netočnoj sktrukturi. Trebamo polja JSON objekata koji sadrže `id` i `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 polje JSON objekata | Trebamo polja JSON objekata koji sadrže `id` i `name` |
glami_or('addParameter', 'items', null);
|
glami_or(
'addParameter',
'items',
[
{"id": 1, "name": "item 1"},
{"id": 2, "name": "item 2"}
]
);
|
JSON obekti ne sadrže vrijedeći `id` | ključ u `id`u `items` parametru nedostaje ili je prazan |
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 objekti ne sadrže vrijedeći `name` | Trebamo polja JSON objekata koji sadrže `id` i `name` |
glami_or('addParameter', 'items', null);
|
glami_or(
'addParameter',
'items',
[
{"id": 1, "name": "item 1"},
{"id": 2, "name": "item 2"}
]
);
|
Greške ne vrijedećih parametara | |||
---|---|---|---|
Moguće pogreške | Rješenje | Primjer greške | Primjer rješenja |
Parametar item_ids treba biti odijeljen sa točka zarezom. |
Trgovina nam nije poslala nikakve proizvode niti prazne identifikatore proizvoda. Svi ostali formati vrijede i koriste se kao jedan identifikator proizvoda. Naprimjer "36463570,27927237" se smatra jednim od identifikatora proizvoda. Točka zarez odjeljuje identifikatore proizvoda "36463570; 27927237". |
glami_or('addParameter', 'item_ids', '');
|
glami_or('addParameter', 'item_ids', 'a212');
|
Parametar `item_names` treba biti odijeljen sa točka zarezom. | Isto kao i iznad sa `item_ids`, vrijednosti se smiju odjeljivati samo sa točka zarezom, samo onda su vrijedeće. Bilo koji drugi znak će se voditi kao dio naziva odnosno kao identifikator proizvoda. |
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');
|
Broj `item_ids` i broj `item_names` se razlikuju. | Broj poslanih identifikatora i broj naziva proizvoda mora biti isti. |
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');
|
Šaljemo upitnik za GLAMI TOP sa našeg e-mail servera, kao pošiljatelja stavljamo e-mail vaše e-trgovine koju ste vi dodali u partnersku administraciju.
Da bi smo uspješno namjestili e-mail sistem, morate slijediti dva koraka:
Kako bi zaštitili emailove poslane sa vaše domene, dodajte naš entry u vaš SPF rekord. _emailing.glami.cz
Primjer: Ako imate entry za vašu domenu v=spf1 ip4:1.2.3.4 -sve, modificirana verzija će biti v=spf1 ip4:1.2.3.4 include:_emailing.glami.cz -all
Svi odlazni emailovi od GLAMI su potpisani našim DKIM ključem. Kreirajte za svoju domenu i pod-domenu glami-review._domainkey i DNS CNAME rekord koji upućuje na partner-review._domainkey.glami.cz.
Neki pružatelji usluga traže točku na kraju. Primjer: glami-review._domainkey.glami.cz.
U partnerskoj administraciji možete provjeriti da li su email postavke točne , u Recenzije -> Postavke, gdje možete vidjeti SPF i DKIM status koji je označen kao "Ovjeren" ako je dobro postavljen, a "Neuspješan" ukoliko je pogrešan.