GLAMI TOP integracijski vodnik

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:

  • Implementirajte izbiro soglasij s storitvijo z enim od naslednjih možnih načinov:
    • Vaš sistem trgovine podpira GLAMI TOP
    • Integracija z Google Tag Manager
    • Integracija z Javascript
  • Nastavite pošiljanje e-mailov z vprašalniki, zato da ne pristanejo v spamu.

1. Implementacija zbirke soglasij

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.

Integracijska pravila

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.

A) Vaš sistem trgovine podpira GLAMI TOP (brez programerja)

Č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.

B) Integracija z Google Tag Manager (potrebujete programerja)

Č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.

C) Integracija z Javascript (potrebujete programerja)

Dodajanje opt-in kode

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 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:
id
ID izdelkov zbranih v feed-u trgovine, ločeni s podpičjem. Lahko vključuje razprodane izdelke - string|celo število
name
Ime izdelka, ki bo prikazan v e-mailu - string
Primer opt-in kode

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>

Odpravljanje motenj

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

2. Pošiljanje vprašalnika

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:

  1. V partnerski administraciji, pod zavihkom Recenzije -> Nastavitve vtipkajte e-mail, iz katerega bomo strankam pošiljali e-mail z vprašalnikom. Ta e-mail mora imeti isto domeno kot vaša e-trgovina. Naprimer, www.shop.com bi potemtakem imel e-mail naslov reviews@shop.com
  2. Spremenite nastavitve DNS domene vaše e-trgovine (ista domena ki jo boste uporabljali za pošiljanje e-mailov iz 1. koraka), kot je opisano spodaj. Ta nastavitev je pomembna, saj tako e-maili ne bodo končali kot vsiljena e-pošta.

Navodila za nastavitev DNS-ja:

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.