---
title: "Uuden varausmoottorin Google Analytics -integraatio"
canonical: "https://support.vitec-hotellinx.com/space/KB/199884806/Uuden%20varausmoottorin%20Google%20Analytics%20-integraatio"
format: markdown
---
> ℹ️ Hotellinxin uuteen huonevarausmoottoriin voidaan kytkeä Google Analytics 4 -integraatio.
> ℹ️ 
> ℹ️ Googlen analytiikka kerää sivustolta normaalin sivuliikenteen, käyttäjien laitetiedot ja muut perustiedot. Lisäksi varausmoottori lähettää analytiikkaan hakuihin ja ostokäyttäytymiseen liittyviä tapahtumia (`event`).

<details>
<summary>Integraation kytkeminen</summary>

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)**.
</details>

<details>
<summary>Varausmoottorin lähettämät tapahtumat (events) ja niiden sisältämät tiedot</summary>

Suurin osa lähetettävä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.<br>- `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ä)<br>> ⚠️ 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.<br>- 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.<br>- `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.<br>- `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.<br>- `currency`: varausmoottorissa käytetty valuutta
- `value`: tuotteiden kokonaishinta
- `coupon`: käytetty varauskoodi
- `items`: tuotteen tiedot (kuvattu alempana) |
</details>

<details>
<summary>Items array -taulukkoon tulevan objektin (Item) sisältö</summary>

| **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:<br>- `PAYMENT_AT_ARRIVAL`: maksu hotellilla
- `FIXED`: maksu ennakkoon | > ⚠️ Tämä parametri on konfiguroitava erikseen. |
</details>

<details>
<summary>Erikseen konfiguroitavien parametrien lisääminen</summary>

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` |
</details>