--- title: "Varausmoottorin analytiikka ja seuranta" canonical: "https://support.vitec-hotellinx.com/space/KB/58949703/Varausmoottorin%20analytiikka%20ja%20seuranta" format: markdown --- [lisäpalvelu] Voit seurata varausmoottorin tapahtumia [Google Analytics](https://support.google.com/analytics/answer/10089681?hl=fi) -integraation sekä [Meta-pikselin](https://fi-fi.facebook.com/business/tools/meta-pixel) avulla. - Google Analytics -lähetyksen ja/tai Meta-pikselin kytkeminen on **lisäpalvelu**, jonka hinta on **230 EUR (alv 0%) / kpl**. - Hotellinx ei rakenna seurantapalveluiden raportointia tai esim. graafeja. --- ## Meta-pikseli: integraation kytkeminen Hotellinx kytkee Meta-pikseli -integraation hotellin varausmoottoriin. Tarvitsemme integraation kytkemiseksi hotellin **Meta-pikselin ID-tunnuksen.** 1. [Luo Meta-pikseli ohjeiden mukaisesti](https://fi-fi.facebook.com/business/tools/meta-pixel). 2. Toimita pikselin ID **[meille](https://vitechotellinx.atlassian.net/wiki/spaces/KB/pages/37814278)** integraation tilauksen yhteydessä. --- ## Google Analytics: integraation kytkeminen Hotellinx kytkee Google Analytics -integraation hotellin varausmoottoriin. Tarvitsemme integraation kytkemiseksi hotellin **GA4 measurement id** -tunnuksen. 1. Avaa sivu [https://analytics.google.com/](https://analytics.google.com/) ja kirjaudu sisään Google Analytics -tilille. 2. Avaa **Admin** > **Data collection and modification** > **Data streams** > **Data stream**. 3. Kopioi **Measurement id**-tunnus (esim. “*G-V14PZV789Z*”) ja lähetä tunnus **[meille](https://vitechotellinx.atlassian.net/wiki/spaces/KB/pages/37814278)**. --- ## Lähetettävät tapahtumat (events) ja niiden sisältämät tiedot Suurin osa varausmoottorin lähettämästä datasta käyttää Googlen [Recommended Events](https://support.google.com/analytics/answer/9267735?hl=en) -formaattia, jolloin data kerätään automaattisesti ilman ylimääräistä konfigurointia. - Taulukon **Lisätietoa**-kentässä on mainittu, mikäli datankerääminen edellyttää erillistä konfigurointia. - Konfigurointiohjeet löytyvät sivun alaosasta. | **Tapahtuman nimi** | **Parametrit** | **Lisätietoa** | | --- | --- | --- | | make_search | ``` { "arrival": "2025-02-12", "departure": "2025-02-13", "rooms": 1, "adults": 2, "children": 0, "booking_code": "", "category": "ALL", "hotel_code": "VITEC" } ``` | Lähetetään, kun käyttäjä klikkaa hakukenttien **Haku**-painiketta.
- `arrival`: saapumispäivä - `departure`: lähtöpäivä - `rooms`: haettujen huoneiden lukumäärä - `adults`: haettujen aikuisten kokonaismäärä (kaikkien huoneiden aikuiset laskettuna yhteen) - `children`**: **haettujen lasten kokonaismäärä - `booking_code`: syötetty varauskoodi - `category`: valittu kategoria (ei käytössä kaikissa varausmoottoreissa) - `hotel_code`: valittu hotellikoodi (vain monihotellijärjestelmissä)
> ⚠️ Tämä tapahtuma ja sen parametrit on konfiguroitava erikseen. | | view_item_list | ``` { "item_list_id": "availability_list_room_1", "item_list_name": "Availability list for room 1", "items": [ (Yksi tai useampi item-objekti) ] } ``` | Lähetetään kun käyttäjälle näytetään saatavuuslista.
- Sisältää esitettyjen huoneiden ja hintojen tiedot. - Jos käyttäjä hakee esim. 3 huonetta kerrallaan, tämä lähetetään kolmeen kertaan, mutta `item_list_id` ja `item_list_name` ovat esim. `availability_list_room_2` ja `availability_list_room_3`. | | add_to_cart | ``` { "currency": "EUR", "value": 142, "items": [ (item-objekti) ] } ``` | Lähetetään kun käyttäjä valitsee huoneen ja hinnan.
- `currency`: varausmoottorissa käytetty valuutta - `value`: valitun tuotteen hinta - `items`: tuotteen tiedot (kuvattu alempana) | | begin_checkout | ``` { "currency": "EUR", "value": 142, "coupon": "", "items": [ (Yksi tai useampi item-objekti) ] } ``` | Lähetetään, kun asiakas klikkaa **Varaa**-painiketta.
- `currency`: varausmoottorissa käytetty valuutta - `value`: tuotteiden kokonaishinta - `coupon`: käytetty varauskoodi - `items`: tuotteen tiedot (kuvattu alempana) | | purchase | ``` { "currency": "EUR", "value": 142, "coupon": "", "items": [ (Yksi tai useampi item-objekti) ] } ``` | Lähetetään, kun varaus on onnistunut, ja asiakkaalle näytetään varausvahvistus-sivu.
- `currency`: varausmoottorissa käytetty valuutta - `value`: tuotteiden kokonaishinta - `coupon`: käytetty varauskoodi - `items`: tuotteen tiedot (kuvattu alempana) | --- ## Items array -taulukkoon tulevan objektin (Item) sisältö | **Parametri ja esimerkkiarvo** | **Kuvaus** | **Lisätietoa** | | --- | --- | --- | | "item_id": "67", | Tuotteen huonekoodi | | | "item_name": "Kahden hengen huone erillisillä vuoteilla", | Huoneen nimi käyttäjän valitsemalla kielellä | | | "affiliation": "VITEC", | Hotellikoodi | | | "coupon": "", | Käytetty varauskoodi | | | "discount": 0, | Alennuksen määrä | | | "index": 0, | Missä järjestyksessä tuote on esitetty | | | "item_category": "Rooms", | Huonetyypin kategoria | | | "quantity": 1, | Valittu lukumäärä | | | "item_variant": "Ei-hyvitettävä hinta", | Hintatyypin nimi käyttäjän valitsemalla kielellä | | | "price": 142, | Hinta | | | "rate_code": "83", | Hintakoodi | > ⚠️ Tämä parametri on konfiguroitava erikseen. | | "room_name_pms": "Single", | Hotellinx Cloudiin konfiguroitu huoneen nimi | > ⚠️ Tämä parametri on konfiguroitava erikseen. | | "rate_category": "", | Hintakategoria | > ⚠️ Tämä parametri on konfiguroitava erikseen. | | "cancel_policy_code": "PM18", | Peruutusehdon koodi | > ⚠️ Tämä parametri on konfiguroitava erikseen. | | "mandatory_deposit_type": "PAYMENT_AT_ARRIVAL" | Onko tuote ennakkomaksettava vai ei:
- `PAYMENT_AT_ARRIVAL`: maksu hotellilla - `FIXED`: maksu ennakkoon | > ⚠️ Tämä parametri on konfiguroitava erikseen. | --- ## Erikseen konfiguroitavien parametrien lisääminen 1. Kirjaudu Google Analyticsiin sivulla [https://analytics.google.com/](https://analytics.google.com/). 2. Mene **Admin**-sivulle ja valitse **Data display** > **Custom definitions**. > ℹ️ Seurattavat attribuutit on jaettu ulottuvuuksiin (*dimensions*) ja mittareihin (*metrics*). Varausmoottorin lähettämät lisäparametrit ovat kaikki ulottuvuuksia. 3. Luo uusi seurattava ulottuvuus painamalla **Create custom dimension**. 4. Alla olevasta taulukosta löydät kullekin parametrille lisättävät tiedot. - Voit muokata **Dimension name** ja **Description**-tietoja mieleiseksi, mutta **Scope** ja **Event parameter** on oltava kuin alla olevassa taulukossa. - Kaikkia ulottuvuuksia ei tarvita. Voit lisätä vain ne, joita haluat seurata. | **Dimension name** | **Scope** | **Description** | **Event parameter** | | --- | --- | --- | --- | | Searchmask Arrival | `Event` | Search arrival date | `arrival` | | Searchmask Departure | `Event` | Search departure date | `departure` | | Rooms | `Event` | Room count entered in the searchmask | `rooms` | | Adults | `Event` | Adult (total of all rooms) count entered in the searchmask | `adults` | | Children | `Event` | Child (total of all rooms) count entered in the searchmask | `children` | | Booking code | `Event` | Booking code entered in the searchmask | `booking_code` | | Hotel Code | `Event` | Hotel code entered in the searchmask | `hotel_code` | | Category | `Event` | Category entered in the searchmask | `category` | | Cancel Policy Code | `Item` | Cancellation policy code in PMS | `cancel_policy_code` | | Mandatory Deposit type | `Item` | If item needs to be prepaid or not. FIXED = prepaid, PAYMENT_AT_ARRIVAL = not prepaid | `mandatory_deposit_type` | | PMS Room name | `Item` | Room name in pms | `room_name_pms` | | Rate Category | `Item` | Rate category | `rate_category` | | Rate Code | `Item` | Rate code in pms | `rate_code` |