GLAMI TOP vodič kroz integraciju

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:

  • Implementirajte kolekciju pristanaka sa uslugama jednim od sljedečih načina:
    • Sistem vaše trgovine podržava GLAMI TOP
    • Integracija sa Google Tag Managerom
    • Integracija sa Javascript
  • Postavite slanje e-mailova sa anketama, tako da ne odu u spam.

1. Implementiranje kolekcije pristanaka.

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.

Upute za integraciju

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.

A) Sistem vaše trgovine podržava GLAMI TOP (programer nije potreban)

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.

B) Integracija sa Google Tag Managerom (potreban programer)

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.

C) Integracija sa Javascript (potreban programer)

Dodavanje opt-in koda

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.
email 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:
id
ID proizvoda koji se nalazi u feedu e-trgovine. Može sadržati rasprodane proizvode - string|integer
name
Ime proizvoda koji će se prikazati u e-mailu - string
Primjer opt-in koda

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>

Uklanjanje problema

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

2. Slanje upitnika.

Š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:

  1. U partnerskoj administraciji u tabu Recenzije->Postavke, upišite email sa kojeg ćemo slati emailove sa upitnikom korisnicima: Ovaj e-mail bi trebao imati istu domenu kao vaša e-trgovina. Na primjer www.shop.com bi trebao imati email recenzije@shop.com
  2. Promjenite DNS postavke vaše e-trgovine (ista domena koju ćete koristiti za slanje e-mailova iz prvog koraka) kao što je niže opisano. Ova stavka je važna kako vaši mailovi ne bi završili u korisnikovom SPAM folderu.

Instrukcije za DNS postavke:

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.