Hyros
Monikanavainen attribuutioseuranta, joka yhdistää mainosklikkaukset ostoksiin useiden istuntojen välillä.
Yleistä
Hyros on attribuutioalusta, joka yhdistää mainosklikkaukset ostoksiin myös silloin, kun asiakkaan matka kulkee useiden istuntojen ja laitteiden kautta. Se tallentaa mainosten klikkaustunnisteet (fbclid, gclid, ttclid) URL-osoitteista, liittää ne asiakkaan sähköpostiin ja näyttää, mitkä kampanjat todella tuottivat myyntiä.
Integraatiossa on kaksi osaa, ja molemmat ovat valinnaisia:
- Universal-skripti ajetaan kassalla ja välittää asiakkaan sen hetkisen URL-osoitteen (mahdollisine klikkaustunnisteineen) Hyrosille.
- Palvelinpuolen osto- ja palautustapahtumat lähetetään palvelimeltamme Hyrosille onnistuneen tilauksen ja palautuksen jälkeen.
Ota käyttöön jompi kumpi tai molemmat sen mukaan, miten käytät Hyrosia.
Käyttöönotto
- 1
Avaa Hyros-hallintapaneelissasi Tracking → Scripts ja kopioi koko Universal Tracking Script -katkelma.
- 2
Avaa Hyros-hallintapaneelissasi Settings → API ja luo API-avain. Anna avaimelle luomisvaiheessa oikeudet tilausten luomiseen ja tilausten hyvittämiseen — ilman näitä palvelinpuolen osto- ja palautustapahtumat epäonnistuvat. Kopioi avain.
- 3
Avaa kassan Integraatioasetukset hallintapaneelissa, vieritä kohtaan Hyros ja ota se käyttöön.
- 4
Liitä universal-skriptin katkelma Universal-skripti -kenttään. Vain seurantaosoite tallennetaan; ympäröivä JavaScript hylätään tallennuksen yhteydessä.
- 5
Liitä API-avain API-avain -kenttään. Tallenna.
| Asetus | Kuvaus |
|---|---|
| Universal-skripti | Koko universal-skriptin katkelma, kopioidaan kohdasta Hyros → Tracking → Scripts. Vain seurantaosoite tallennetaan. |
| API-avain | API-avain, luodaan kohdassa Hyros → Settings → API oikeuksilla tilausten luomiseen ja hyvittämiseen. Käytetään palvelinpuolen osto- ja palautustapahtumiin. |
Lähetetyt tapahtumat
Onnistuneen maksun jälkeen ostotapahtuma lähetetään osoitteeseen POST /api/v1.0/orders seuraavilla kentillä:
| Kenttä | Arvo |
|---|---|
| orderId | Tilauksen yksilöivä tunnus |
| Asiakkaan sähköposti (kun saatavilla) | |
| phoneNumbers[] | Asiakkaan puhelinnumero (kun saatavilla) |
| firstName / lastName | Asiakkaan nimi (kun saatavilla) |
| leadIps[] | Asiakkaan IP-osoite (kun saatavilla) |
| currency | Tilauksen valuutta |
| items[] | Tilatut tuotteet nimen, hinnan ja määrän kera |
| date | Maksun ajankohta |
Kun tilaus hyvitetään, vastaava palautustapahtuma lähetetään osoitteeseen DELETE /api/v1.0/orders/{orderId} hyvitetyllä summalla, jotta Hyros voi kirjata sen raportteihinsa.
Sekä osto- että palautustapahtuma lähetetään vain, jos asiakas on antanut analytiikkasuostumuksen kassalla. Ilman suostumusta mitään ei lähetetä. Katso: Yleistä — GDPR-suostumus
Miten attribuutio toimii
Hyros yhdistää attribuution kahdesta lähteestä:
- Universal-skripti tallentaa mainosten klikkaustunnisteet URL-osoitteesta, kun kävijä saapuu kassalle, ja tallentaa ne Hyrosin palvelimille selainistuntoon liitettyinä.
- Palvelinpuolen ostotapahtuma toimittaa ostajan sähköpostin ja tilaustiedot Hyrosille maksun onnistuttua.
Hyros yhdistää nämä palvelinpuolellaan käyttäen sähköpostia yhdistävänä avaimena. Koska attribuutio tehdään palvelinpuolella, se selviää evästeiden häviämisestä, mainostenestoista ja iOS:n seurantarajoituksista, jotka muuten katkaisisivat pelkästään selainpohjaisen pikselin.
Jos markkinointisivustollasi (Verkkokurssikassan ulkopuolella) on myös Hyrosin universal-skripti asennettuna, kävijät yhdistetään automaattisesti sivustosi ja kassan välillä sähköpostin perusteella.
Huomioita
- Hyros käsittelee kirjoituksia asynkronisesti (yleensä näkyvillä noin 10 sekunnin sisällä). API:n
200 OKtarkoittaa, että tapahtuma otettiin vastaan, ei että se olisi vielä käsitelty. - Aivan oston jälkeen (noin 10 sekunnin sisällä) tehdyt palautukset voivat epäonnistua hiljaisesti Hyrosin päässä, koska alkuperäistä tilausta ei ole vielä indeksoitu. Käytännössä tämä on erittäin harvinaista.
- Universal-skripti ladataan kassan ennen maksua -vaiheessa. Kertaladattuna se on käytössä loppuistunnon ajan, kunnes sivu ladataan uudelleen.