Integració del Pixel Sojern

Si esteu realitzant campanyes publicitàries a través de Sojern, podeu connectar el vostre compte Sojern a Wink introduint el vostre ID de contenidor GTM de Sojern al portal de Wink. Un cop connectat, el pixel de seguiment de Sojern s’activa automàticament per a la vostra propietat, cobrint tot el viatge del client des de la cerca fins a la reserva completada.

Consell

Això pressuposa que ja teniu un compte Sojern actiu i que heu rebut el vostre ID de contenidor GTM del vostre gestor de compte Sojern. Si encara no teniu un compte Sojern, visiteu sojern.com/contact per començar.

---

Què Heu de Fer

1. Obteniu el vostre ID de contenidor GTM de Sojern

   Contacteu amb el vostre gestor de compte Sojern i sol·liciteu el vostre ID de contenidor GTM. Té el format GTM-XXXXXXX. Aquest és diferent del vostre ID de pixel Sojern — assegureu-vos de demanar específicament l’ID de contenidor GTM.

2. Introduïu-lo al portal de Wink

   Inicieu sessió a my.wink.travel, seleccioneu el vostre compte i aneu a la pestanya Personalitzacions. Enganxeu el vostre ID de contenidor GTM de Sojern al camp Sojern i deseu. La vostra integració ja està activa.

3. Confirmeu-ho amb el vostre gestor de compte Sojern

   Informeu al vostre gestor de compte Sojern que la integració està activa. Ells poden verificar des del seu costat que el pixel s’està activant correctament a wink.travel per a la vostra propietat i que les dades flueixen al vostre compte Sojern.

Nota

No cal que col·loqueu cap codi de pixel al vostre propi lloc web per a aquesta integració. Wink carrega automàticament el vostre contenidor Sojern a totes les pàgines on la vostra propietat està activa.

Aquesta configuració funciona per a qualsevol ID de contenidor GTM personalitzat. Només hem utilitzat Sojern com a exemple perquè és una integració molt comuna.

---

Què Fa Wink al Nostre Costat

Per transparència, això és el que Wink configura per fer que aquesta integració funcioni:

• Un camp d’ID de contenidor GTM de Sojern està disponible a la pestanya Personalitzacions del vostre portal Wink. Quan introduïu el vostre ID de contenidor, Wink valida el format i el desa de manera segura associat a la vostra propietat.
• A cada pàgina on la vostra propietat està activa a Wink, el vostre ID de contenidor GTM de Sojern es renderitza a la pàgina i el sistema de gestió d’etiquetes de Wink carrega dinàmicament el vostre contenidor Sojern juntament amb el seu propi. Això passa automàticament — no es requereixen passos manuals per part de l’equip de Wink per propietat.
• El vostre contenidor Sojern es carrega de manera asíncrona, cosa que significa que no afecta el rendiment de càrrega de la pàgina per als vostres clients.
• El seguiment propi de Wink i el vostre pixel Sojern funcionen en paral·lel, llegint de les mateixes dades d’esdeveniments compartides. Cada esdeveniment de reserva que Wink fa el seguiment està simultàniament disponible per al vostre contenidor Sojern.
• Quan la vostra propietat no s’està visualitzant — per exemple, quan un client està navegant per un altre hotel a Wink — el vostre contenidor Sojern no es carrega. Això assegura que Sojern només rep dades rellevants per a la vostra propietat.

---

Referència DataLayer

Wink envia esdeveniments compatibles amb GA4 al dataLayer durant tot el viatge del client. El vostre contenidor GTM llegeix d’aquest mateix dataLayer compartit, així que qualsevol disparador o variable que configureu té accés a totes les propietats descrites a continuació.

Cada esdeveniment segueix l’estructura estàndard GA4 Enhanced Ecommerce: una cadena event de nivell superior i un objecte ecommerce. Abans de cada push, Wink neteja la càrrega útil ecommerce anterior per evitar que dades antigues afectin nous disparadors.

Nota

Patró de reinici de dataLayer

Wink reinicia l’objecte ecommerce abans de cada push d’esdeveniment:

dataLayer.push({ ecommerce: null });   // neteja l'esdeveniment anterior
dataLayer.push({ event: '...', ecommerce: { ... } });

No confieu que les propietats ecommerce persisteixin entre esdeveniments. Llegiu-les sempre en el moment del disparador dins del mateix esdeveniment.

---

Esdeveniments del Viatge de Reserva

Aquests esdeveniments s’activen automàticament mentre un client avança pel procés de reserva. Configureu els vostres disparadors GTM com a disparadors d’Esdeveniment Personalitzat que coincideixin amb els noms d’esdeveniment següents.

Pas	Esdeveniment	Quan s’activa
1	view_item_list	Es carrega la graella o llista d’inventari d’hotels
2	view_item	El client visualitza la pàgina d’una propietat específica
3	add_to_cart	El client afegeix una habitació a la cistella
4	begin_checkout	Es carrega la pàgina de pagament / checkout
5	add_payment_info	El client selecciona un mètode de pagament
6	login	El client s’autentica via SSO
7	purchase	La reserva queda confirmada
8	refund	La reserva queda cancel·lada

---

view_item_list

S’activa quan es mostra una graella o llista d’inventari d’hotels.

{
  "event": "view_item_list",
  "ecommerce": {
    "item_list_id": "featured_hotels",
    "item_list_name": "Featured Hotels",
    "items": [ ]
  }
}

---

view_item

S’activa quan un client visualitza una propietat específica.

{
  "event": "view_item",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

---

add_to_cart

S’activa quan un client afegeix una habitació a la seva cistella.

{
  "event": "add_to_cart",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

---

begin_checkout

S’activa quan es carrega la pàgina de pagament / checkout.

{
  "event": "begin_checkout",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "coupon": "SUMMER10",
    "items": [ ]
  }
}

coupon només està present quan s’ha aplicat un codi de descompte.

---

add_payment_info

S’activa quan el client selecciona o confirma un mètode de pagament.

{
  "event": "add_payment_info",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "coupon": "SUMMER10",
    "payment_type": "STRIPE",
    "items": [ ]
  }
}

payment_type s’omple amb el tipus d’adquirent de pagament. coupon només està present quan s’ha aplicat un codi de descompte.

---

login

S’activa quan un client s’autentica via inici de sessió únic.

{
  "event": "login",
  "ecommerce": {
    "method": "IAM"
  }
}

---

purchase

S’activa quan una reserva queda confirmada.

{
  "event": "purchase",
  "ecommerce": {
    "currency": "USD",
    "transaction_id": "bc-a1b2c3d4",
    "value": 299.00,
    "coupon": "SUMMER10",
    "shipping": 0.00,
    "tax": 0.00,
    "items": [
      {
        "item_id": "rr-xyz789",
        "item_name": "Deluxe Ocean Suite",
        "item_brand": "Grand Resort",
        "item_category": "GUEST_ROOM",
        "price": 299.00,
        "quantity": 1,
        "property_id": "prop-abc123",
        "property_name": "Grand Resort Maldives",
        "property_brand": "Grand Collection",
        "property_chain": "Luxury Hotels International",
        "city_name": "Malé",
        "country_code": "MV",
        "start_date": "2026-06-01",
        "end_date": "2026-06-05",
        "num_adults": 2,
        "num_children": 0,
        "cancellation_policy": "Refundable",
        "rate_plan_id": "rp-summer2026",
        "room_rate_id": "rr-xyz789",
        "room_rate_name": "Summer Escape — Bed & Breakfast",
        "num_perks": 2,
        "room_location": "Overwater",
        "room_view": "Ocean",
        "room_classification": "Suite"
      }
    ]
  }
}

transaction_id és l’identificador únic del contracte de reserva. coupon, shipping i tax només estan presents quan s’apliquen.

---

refund

S’activa quan una reserva queda cancel·lada.

{
  "event": "refund",
  "ecommerce": {
    "currency": "USD",
    "transaction_id": "bc-a1b2c3d4",
    "value": 299.00,
    "coupon": "SUMMER10",
    "shipping": 0.00,
    "tax": 0.00,
    "items": [ ]
  }
}

transaction_id coincideix amb l’esdeveniment purchase per a la mateixa reserva. coupon, shipping i tax només estan presents quan s’apliquen.

---

Propietats dels Articles

Tots els esdeveniments que inclouen un array items comparteixen el mateix esquema d’article. Cada propietat és opcional tret que s’indiqui que és obligatòria.

Camps estàndard GA4

Aquests camps són entesos nativament per GA4 i apareixen en informes ecommerce estàndard sense configuració addicional.

Propietat	Tipus	Obligatori	Descripció
item_id	string	Sí	Identificador únic per a l’habitació o producte
item_name	string	—	Nom de l’habitació o producte
affiliation	string	—	Nom de l’afiliat o venedor
coupon	string	—	Codi de cupó aplicat a l’article
currency	string	—	Codi de moneda ISO 4217 (p. ex. USD)
creative_name	string	—	Nom creatiu usat en una promoció
creative_slot	string	—	Posició de la ranura de la creativitat promocional
discount	number	—	Quantitat de descompte aplicada
index	number	—	Posició a la llista (basat en 1)
item_brand	string	—	Nom de l’hotel o marca
item_category	string	—	Tipus de producte — p. ex. GUEST_ROOM, ACTIVITY, ATTRACTION, MEETING_ROOM, RESTAURANT, SPA
item_list_id	string	—	Identificador de la llista a la qual pertany aquest article
item_list_name	string	—	Nom visible de la llista
location_id	string	—	Coordenades geogràfiques de la propietat
price	number	—	Preu unitari
promotion_id	string	—	Identificador de la promoció
promotion_name	string	—	Nom visible de la promoció
quantity	number	—	Quantitat (per defecte 1)

Paràmetres personalitzats a nivell d’article

Aquests paràmetres porten context específic de reserva de Wink. GA4 no els mostra automàticament en informes — cal registrar cadascun com a dimensió personalitzada a nivell d’article a la vostra propietat GA4 abans que aparegui en exploracions o informes estàndard. Vegeu Dimensions personalitzades a GA4 més avall per a instruccions.

Propietat	Tipus	Descripció
property_id	string	Identificador de la propietat a Wink
property_name	string	Nom visible de la propietat
property_brand	string	Marca a la qual pertany la propietat
property_chain	string	Cadena a la qual pertany la propietat
property_url_name	string	Slug amigable per URL de la propietat
city_name	string	Ciutat on es troba la propietat
country_code	string	Codi de país ISO 3166-1 alpha-2
start_date	string	Data d’entrada en format YYYY-MM-DD
end_date	string	Data de sortida en format YYYY-MM-DD
num_adults	number	Nombre d’adults a la reserva
num_children	number	Nombre de nens a la reserva
cancellation_policy	string	Un de: Refundable, Non-Refundable, Refundable-With-Restrictions, Non-Refundable-With-Restrictions
rate_plan_id	string	Identificador del pla tarifari
room_rate_id	string	Identificador de la tarifa específica de l’habitació
room_rate_name	string	Nom visible de la tarifa de l’habitació
num_perks	number	Nombre de beneficis inclosos amb la tarifa
room_location	string	Descripció de la ubicació de l’habitació (p. ex. Overwater, Garden)
room_view	string	Descripció de la vista de l’habitació (p. ex. Ocean, City)
room_classification	string	Classificació o categoria de l’habitació (p. ex. Suite, Standard)
bed_type	string	Configuració del llit de l’habitació (p. ex. King, Twin)

---

Dimensions personalitzades a GA4

GA4 ignora els paràmetres personalitzats a nivell d’article en informes fins que no els registreu explícitament com a dimensions personalitzades a nivell d’article. Només cal registrar els paràmetres que voleu utilitzar en informes — no cal registrar els 20.

1. Obriu Definicions Personalitzades

   A GA4, aneu a Administrador (icona d’engranatge a baix a l’esquerra) → seleccioneu la vostra propietat → Visualització de dades → Definicions personalitzades.

2. Creeu una nova dimensió personalitzada

   Feu clic a Crear dimensions personalitzades.

3. Ompliu els detalls de la dimensió

   • Nom de la dimensió — l’etiqueta llegible que apareix als informes GA4 (vegeu la taula a continuació)
   • Abast — seleccioneu Article
   • Paràmetre d’esdeveniment — el nom exacte del paràmetre tal com apareix al dataLayer (vegeu la taula a continuació)
   • Descripció — opcional però recomanada

4. Deseu i repetiu

   Feu clic a Desa, després repetiu per a cada paràmetre que vulgueu fer el seguiment.

Nota

Les dimensions personalitzades poden trigar fins a 24 hores a aparèixer als informes GA4 després del registre. Les dades històriques recollides abans del registre no es retroalimenten.

GA4 permet fins a 50 dimensions personalitzades a nivell d’article per propietat en propietats estàndard (les propietats 360 en permeten més).

Utilitzeu la taula següent com a referència quan creeu dimensions personalitzades. El valor de Paràmetre d’esdeveniment ha de coincidir exactament — GA4 distingeix majúscules i minúscules.

Nom de la dimensió	Paràmetre d’esdeveniment	Tipus
ID de la propietat	property_id	Text
Nom de la propietat	property_name	Text
Marca de la propietat	property_brand	Text
Cadena de la propietat	property_chain	Text
Nom URL de la propietat	property_url_name	Text
Nom de la ciutat	city_name	Text
Codi de país	country_code	Text
Data d’entrada	start_date	Text
Data de sortida	end_date	Text
Nombre d’adults	num_adults	Nombre
Nombre de nens	num_children	Nombre
Política de cancel·lació	cancellation_policy	Text
ID del pla tarifari	rate_plan_id	Text
ID de la tarifa d’habitació	room_rate_id	Text
Nom de la tarifa d’habitació	room_rate_name	Text
Nombre de beneficis	num_perks	Nombre
Ubicació de l’habitació	room_location	Text
Vista de l’habitació	room_view	Text
Classificació de l’habitació	room_classification	Text
Tipus de llit	bed_type	Text

---

Esdeveniments addicionals disponibles

Els següents esdeveniments estan disponibles al dataLayer de Wink però no formen part del procés estàndard de reserva. Poden ser activats per altres interaccions a la plataforma.

add_to_wishlist

{
  "event": "add_to_wishlist",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

remove_from_cart

{
  "event": "remove_from_cart",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

select_item

{
  "event": "select_item",
  "ecommerce": {
    "item_list_id": "featured_hotels",
    "item_list_name": "Featured Hotels",
    "items": [ ]
  }
}

view_cart

{
  "event": "view_cart"
}

Aquest esdeveniment no inclou cap càrrega útil ecommerce.

view_promotion

{
  "event": "view_promotion",
  "ecommerce": {
    "creative_name": "Summer Banner",
    "creative_slot": "hero",
    "promotion_id": "promo_001",
    "promotion_name": "Summer Sale",
    "items": [ ]
  }
}

select_promotion

{
  "event": "select_promotion",
  "ecommerce": {
    "creative_name": "Summer Banner",
    "creative_slot": "hero",
    "promotion_id": "promo_001",
    "promotion_name": "Summer Sale",
    "items": [ ]
  }
}

search

{
  "event": "search",
  "ecommerce": {
    "search_term": "beachfront resort"
  }
}

select_content

{
  "event": "select_content",
  "ecommerce": {
    "content_type": "hotel",
    "content_id": "prop_12345"
  }
}

share

{
  "event": "share",
  "ecommerce": {
    "method": "copy_link",
    "content_type": "hotel",
    "item_id": "prop_12345"
  }
}

sign_up

{
  "event": "sign_up",
  "ecommerce": {
    "method": "email"
  }
}

generate_lead

{
  "event": "generate_lead",
  "ecommerce": {
    "currency": "USD",
    "value": 0.00
  }
}

join_group

{
  "event": "join_group",
  "ecommerce": {
    "group_id": "group_abc"
  }
}

earn_virtual_currency

{
  "event": "earn_virtual_currency",
  "ecommerce": {
    "virtual_currency_name": "WinkPoints",
    "value": 100
  }
}

spend_virtual_currency

{
  "event": "spend_virtual_currency",
  "ecommerce": {
    "virtual_currency_name": "WinkPoints",
    "value": 50,
    "item_name": "Room Upgrade"
  }
}

level_start

{
  "event": "level_start",
  "ecommerce": {
    "level_name": "Gold"
  }
}

level_end

{
  "event": "level_end",
  "ecommerce": {
    "level_name": "Gold",
    "success": true
  }
}

level_up

{
  "event": "level_up",
  "ecommerce": {
    "level": 2,
    "character": "traveler"
  }
}

post_score

{
  "event": "post_score",
  "ecommerce": {
    "score": 980,
    "level": 2,
    "character": "traveler"
  }
}

unlock_achievement

{
  "event": "unlock_achievement",
  "ecommerce": {
    "achievement_id": "first_booking"
  }
}

tutorial_begin

{
  "event": "tutorial_begin",
  "ecommerce": {}
}

tutorial_complete

{
  "event": "tutorial_complete",
  "ecommerce": {}
}

---

virtualPageView

Aquest és un esdeveniment personalitzat de Wink — no forma part del conjunt estàndard d’esdeveniments GA4. Es fa push a cada navegació de pàgina i porta context de dispositiu i sessió. No inclou un objecte ecommerce.

{
  "event": "virtualPageView",
  "device": "Desktop",
  "deviceAgent": "Mozilla/5.0 ...",
  "os": "MacOS",
  "path": "/hotels/grand-resort",
  "title": "Grand Resort — Wink",
  "userId": "user_abc123",
  "startDate": "2026-06-01",
  "endDate": "2026-06-05",
  "guests": "2",
  "rooms": "1"
}

Propietat	Descripció
device	Tipus de dispositiu detectat — Desktop, Android, iPhone, iPad o similar
deviceAgent	Cadena d’agent d’usuari en brut
os	Sistema operatiu detectat — Windows, MacOS, Linux, UNIX
path	Ruta de la pàgina actual
title	Títol de la pàgina actual
userId	Identificador d’usuari autenticat (omitit quan no està connectat)
startDate	Data d’entrada de la sessió de cerca actual
endDate	Data de sortida de la sessió de cerca actual
guests	Nombre de convidats de la sessió de cerca actual
rooms	Nombre d’habitacions de la sessió de cerca actual