GTM Analytics Integration

Sie können jeden Google Tag Manager (GTM)-Container mit Wink verbinden, indem Sie die GTM Container-ID im Wink-Portal eingeben. Nach der Verbindung wird Ihr Container automatisch für Ihre Unterkunft geladen und liest Wink’s Buchungsereignisse direkt aus – und deckt die gesamte Gästereise von der Suche bis zur abgeschlossenen Buchung ab. Ein häufiger Anwendungsfall ist ein Sojern-Container für Retargeting und Werbung, aber jeder GTM-Container funktioniert auf die gleiche Weise.

Tipp

Dies setzt voraus, dass Sie bereits eine GTM Container-ID (Format GTM-XXXXXXX) besitzen. Wenn Ihr Container von einem Partner wie Sojern stammt, fragen Sie Ihren Account Manager speziell nach der GTM Container-ID – diese unterscheidet sich von einer Pixel- oder Tag-ID. Neu bei Sojern? Besuchen Sie sojern.com/contact, um loszulegen.

---

Was Sie tun müssen

1. Holen Sie sich Ihre GTM Container-ID

   Erhalten Sie Ihre GTM Container-ID (Format GTM-XXXXXXX). Wenn sie von einem Partner wie Sojern stammt, fordern Sie speziell die GTM Container-ID an – sie unterscheidet sich von einer Pixel- oder Tag-ID.

2. Geben Sie sie im Wink-Portal ein

   Melden Sie sich bei app.wink.travel an, wählen Sie Ihr Konto aus und öffnen Sie Ihre Anpassungseinstellungen. Fügen Sie im Abschnitt Analytics & integrations Ihre GTM Container-ID in das Feld GTM Container ID ein und speichern Sie. Ihre Integration ist jetzt aktiv.

3. Bestätigen Sie mit Ihrem Anbieter

   Wenn Ihr Container von einem Partner wie Sojern stammt, informieren Sie Ihren Account Manager, dass die Integration aktiv ist. Er kann von seiner Seite aus überprüfen, ob die Tags auf wink.travel für Ihre Unterkunft korrekt ausgelöst werden und ob Daten in Ihr Konto fließen.

Hinweis

Sie müssen keinen Pixel-Code auf Ihrer eigenen Website platzieren, um diese Integration zu nutzen. Wink lädt Ihren GTM-Container automatisch auf allen Seiten, auf denen Ihre Unterkunft aktiv ist.

Dies funktioniert für jede GTM Container-ID – Sojern ist nur ein häufiges Beispiel.

---

Was Wink auf unserer Seite macht

Zur Transparenz hier, was Wink konfiguriert, um diese Integration zu ermöglichen:

• Ein GTM Container-ID-Feld ist im Abschnitt Analytics & integrations Ihrer Anpassungseinstellungen verfügbar. Wenn Sie Ihre Container-ID eingeben, validiert Wink das Format (GTM-XXXXXXX) und speichert es sicher für Ihre Unterkunft.
• Auf jeder Seite, auf der Ihre Unterkunft bei Wink aktiv ist, wird Ihr Container direkt in die Seite eingebunden – er teilt sich Wink’s eigenes window.dataLayer – so wird er parallel zu Wink’s eigenem Container geladen, ohne dass eine zusätzliche Konfiguration erforderlich ist. Dies geschieht automatisch, ohne dass das Wink-Team pro Unterkunft eingreifen muss.
• Ihr Container wird asynchron geladen, sodass die Ladezeit der Seite für Ihre Gäste nicht beeinträchtigt wird.
• Wink’s eigenes Tracking und Ihr Container laufen parallel und lesen aus demselben gemeinsamen dataLayer. Jedes Buchungsereignis, das Wink verfolgt, steht Ihrem Container gleichzeitig zur Verfügung.
• Wenn Ihre Unterkunft nicht angezeigt wird – z. B. wenn ein Gast ein anderes Hotel bei Wink durchsucht – wird Ihr Container nicht geladen und erhält somit nur für Ihre Unterkunft relevante Daten.
• Die abgeschlossene Buchung (purchase) wird im Browser auf der Dankeseite ausgelöst. Eine GTM Container-ID ist eine Blackbox – Wink kann nicht wissen, welche Tags darin enthalten sind – daher ruft Wink Google nie von seinen Servern aus auf. Stattdessen erhält jeder GA4- oder Conversion-Tag in Ihrem Container das purchase clientseitig, genau wie jedes andere Buchungsereignis. Da der Zahlungsanbieter den Browser des Gastes weg- und zurückleitet, stellt Wink die durch die Weiterleitung unterbrochene Analytics-Sitzung vor dem Auslösen von purchase wieder her, sodass der Verkauf dem ursprünglichen Besuch des Gastes zugeordnet wird und nicht als neue Sitzung zählt.

---

DataLayer-Referenz

Wink pusht GA4-kompatible Ereignisse während der gesamten Gästereise in den dataLayer. Ihr GTM-Container liest aus demselben gemeinsamen dataLayer, sodass jeder Trigger oder jede Variable, die Sie konfigurieren, Zugriff auf alle unten beschriebenen Eigenschaften hat.

Jedes Ereignis folgt der Standard-GA4 Enhanced Ecommerce-Struktur: ein oberstes event-String und ein ecommerce-Objekt. Vor jedem Push löscht Wink die vorherigen Ecommerce-Daten, um zu verhindern, dass veraltete Daten in neue Trigger gelangen.

Hinweis

dataLayer Reset-Muster

Wink setzt das Ecommerce-Objekt vor jedem Ereignis-Push zurück:

dataLayer.push({ ecommerce: null });   // vorheriges Ereignis löschen
dataLayer.push({ event: '...', ecommerce: { ... } });

Verlassen Sie sich nicht darauf, dass Ecommerce-Eigenschaften zwischen Ereignissen erhalten bleiben. Lesen Sie sie immer zum Zeitpunkt des Triggers innerhalb desselben Ereignisses.

---

Buchungsreise-Ereignisse

Diese Ereignisse werden automatisch ausgelöst, wenn ein Gast den Buchungstrichter durchläuft. Konfigurieren Sie Ihre GTM-Trigger als Custom Event-Trigger, die den untenstehenden Ereignisnamen entsprechen.

Schritt	Ereignis	Wann es ausgelöst wird
1	view_item_list	Hotel-Inventar-Gitter oder Liste wird geladen
2	view_item	Gast sieht eine bestimmte Unterkunftsseite
3	add_to_cart	Gast legt ein Zimmer in den Warenkorb
4	begin_checkout	Checkout-/Zahlungsseite wird geladen
5	add_payment_info	Gast wählt eine Zahlungsmethode aus
6	login	Gast authentifiziert sich via SSO
7	purchase	Buchung wird bestätigt
8	refund	Buchung wird storniert

---

view_item_list

Wird ausgelöst, wenn ein Hotel-Inventar-Gitter oder eine Liste angezeigt wird.

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

---

view_item

Wird ausgelöst, wenn ein Gast eine bestimmte Unterkunft ansieht.

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

---

add_to_cart

Wird ausgelöst, wenn ein Gast ein Zimmer in den Warenkorb legt.

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

---

begin_checkout

Wird ausgelöst, wenn die Checkout-/Zahlungsseite geladen wird.

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

coupon ist nur vorhanden, wenn ein Rabattcode angewendet wurde.

---

add_payment_info

Wird ausgelöst, wenn der Gast eine Zahlungsmethode auswählt oder bestätigt.

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

payment_type wird vom Typ des Zahlungsanbieters übernommen. coupon ist nur vorhanden, wenn ein Rabattcode angewendet wurde.

---

login

Wird ausgelöst, wenn sich ein Gast über Single Sign-On authentifiziert.

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

---

purchase

Wird ausgelöst, wenn eine Buchung bestätigt wird.

{
  "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 ist die eindeutige Buchungsvertrags-ID. coupon, shipping und tax sind nur vorhanden, wenn zutreffend.

---

refund

Wird ausgelöst, wenn eine Buchung storniert wird.

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

transaction_id entspricht dem purchase-Ereignis derselben Buchung. coupon, shipping und tax sind nur vorhanden, wenn zutreffend.

---

Artikel-Eigenschaften

Alle Ereignisse, die ein items-Array enthalten, verwenden dasselbe Artikelschema. Jede Eigenschaft ist optional, sofern nicht als erforderlich markiert.

Standard-GA4-Felder

Diese Felder werden von GA4 nativ verstanden und erscheinen in Standard-Ecommerce-Berichten ohne zusätzliche Konfiguration.

Eigenschaft	Typ	Erforderlich	Beschreibung
item_id	string	Ja	Eindeutige Kennung für das Zimmer oder Produkt
item_name	string	—	Name des Zimmers oder Produkts
affiliation	string	—	Affiliate- oder Verkäufername
coupon	string	—	Auf den Artikel angewendeter Gutscheincode
currency	string	—	ISO 4217 Währungscode (z. B. USD)
creative_name	string	—	Kreativname, der in einer Promotion verwendet wird
creative_slot	string	—	Slot-Position der Promotion-Kreativ
discount	number	—	Angewendeter Rabattbetrag
index	number	—	Position in der Liste (1-basiert)
item_brand	string	—	Hotel- oder Markenname
item_category	string	—	Produkttyp – z. B. GUEST_ROOM, ACTIVITY, ATTRACTION, MEETING_ROOM, RESTAURANT, SPA
item_list_id	string	—	Kennung der Liste, zu der dieser Artikel gehört
item_list_name	string	—	Anzeigename der Liste
location_id	string	—	Geokoordinaten der Unterkunft
price	number	—	Einzelpreis
promotion_id	string	—	Kennung der Promotion
promotion_name	string	—	Anzeigename der Promotion
quantity	number	—	Menge (Standard ist 1)

Benutzerdefinierte artikelbezogene Parameter

Diese Parameter enthalten Wink-spezifischen Buchungskontext. GA4 zeigt sie nicht automatisch in Berichten an – Sie müssen jeden als artikelbezogene benutzerdefinierte Dimension in Ihrer GA4-Property registrieren, bevor er in Explorations oder Standardberichten erscheint. Siehe Benutzerdefinierte Dimensionen in GA4 weiter unten für Anweisungen.

Eigenschaft	Typ	Beschreibung
property_id	string	Wink-Unterkunftskennung
property_name	string	Anzeigename der Unterkunft
property_brand	string	Marke, zu der die Unterkunft gehört
property_chain	string	Kette, zu der die Unterkunft gehört
property_url_name	string	URL-freundlicher Slug für die Unterkunft
city_name	string	Stadt, in der sich die Unterkunft befindet
country_code	string	ISO 3166-1 alpha-2 Ländercode
start_date	string	Check-in-Datum im Format YYYY-MM-DD
end_date	string	Check-out-Datum im Format YYYY-MM-DD
num_adults	number	Anzahl der Erwachsenen in der Buchung
num_children	number	Anzahl der Kinder in der Buchung
cancellation_policy	string	Einer von: Refundable, Non-Refundable, Refundable-With-Restrictions, Non-Refundable-With-Restrictions
rate_plan_id	string	Kennung des Tarifplans
room_rate_id	string	Kennung des spezifischen Zimmerpreises
room_rate_name	string	Anzeigename des Zimmerpreises
num_perks	number	Anzahl der im Tarif enthaltenen Extras
room_location	string	Ortsbeschreibung des Zimmers (z. B. Overwater, Garden)
room_view	string	Ausblickbeschreibung des Zimmers (z. B. Ocean, City)
room_classification	string	Zimmerklassifikation oder Kategorie (z. B. Suite, Standard)
bed_type	string	Bettenkonfiguration des Zimmers (z. B. King, Twin)

---

Benutzerdefinierte Dimensionen in GA4

GA4 ignoriert benutzerdefinierte Artikelparameter in Berichten, bis Sie sie explizit als artikelbezogene benutzerdefinierte Dimensionen registrieren. Sie müssen nur die Parameter registrieren, die Sie in Berichten verwenden möchten – nicht alle 20.

1. Öffnen Sie benutzerdefinierte Definitionen

   Gehen Sie in GA4 zu Admin (Zahnrad-Symbol unten links) → wählen Sie Ihre Property → Datenanzeige → Benutzerdefinierte Definitionen.

2. Erstellen Sie eine neue benutzerdefinierte Dimension

   Klicken Sie auf Benutzerdefinierte Dimensionen erstellen.

3. Füllen Sie die Details der Dimension aus

   • Dimensionsname — die menschenlesbare Bezeichnung, die in GA4-Berichten erscheint (siehe Tabelle unten)
   • Bereich — wählen Sie Artikel
   • Ereignisparameter — der genaue Parametername, wie er im dataLayer erscheint (siehe Tabelle unten)
   • Beschreibung — optional, aber empfohlen

4. Speichern und wiederholen

   Klicken Sie auf Speichern und wiederholen Sie den Vorgang für jeden Parameter, den Sie verfolgen möchten.

Hinweis

Benutzerdefinierte Dimensionen können bis zu 24 Stunden benötigen, bis sie nach der Registrierung in GA4-Berichten erscheinen. Historische Daten, die vor der Registrierung gesammelt wurden, werden nicht nachträglich eingefügt.

GA4 erlaubt bis zu 50 artikelbezogene benutzerdefinierte Dimensionen pro Property bei Standard-Properties (360 Properties erlauben mehr).

Verwenden Sie die folgende Tabelle als Referenz beim Erstellen benutzerdefinierter Dimensionen. Der Wert für Ereignisparameter muss exakt übereinstimmen – GA4 ist case-sensitiv.

Dimensionsname	Ereignisparameter	Typ
Property ID	property_id	Text
Property Name	property_name	Text
Property Brand	property_brand	Text
Property Chain	property_chain	Text
Property URL Name	property_url_name	Text
City Name	city_name	Text
Country Code	country_code	Text
Check-in Date	start_date	Text
Check-out Date	end_date	Text
Number of Adults	num_adults	Zahl
Number of Children	num_children	Zahl
Cancellation Policy	cancellation_policy	Text
Rate Plan ID	rate_plan_id	Text
Room Rate ID	room_rate_id	Text
Room Rate Name	room_rate_name	Text
Number of Perks	num_perks	Zahl
Room Location	room_location	Text
Room View	room_view	Text
Room Classification	room_classification	Text
Bed Type	bed_type	Text

---

Weitere verfügbare Ereignisse

Die folgenden Ereignisse sind im Wink dataLayer verfügbar, gehören aber nicht zum Standard-Buchungstrichter. Sie können durch andere Interaktionen auf der Plattform ausgelöst werden.

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"
}

Dieses Ereignis enthält keine ecommerce-Daten.

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

Dies ist ein benutzerdefiniertes Wink-Ereignis – kein Teil des Standard-GA4-Ereignissets. Es wird bei jeder Seiten-Navigation gepusht und enthält Geräte- und Sitzungs-Kontext. Es enthält kein ecommerce-Objekt.

{
  "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"
}

Eigenschaft	Beschreibung
device	Erkanntes Gerätetyp – Desktop, Android, iPhone, iPad oder ähnlich
deviceAgent	Rohes User-Agent-String
os	Erkanntes Betriebssystem – Windows, MacOS, Linux, UNIX
path	Aktueller Seitenpfad
title	Aktueller Seitentitel
userId	Authentifizierte Benutzerkennung (wird weggelassen, wenn nicht eingeloggt)
startDate	Check-in-Datum aus der aktuellen Suchsitzung
endDate	Check-out-Datum aus der aktuellen Suchsitzung
guests	Anzahl der Gäste aus der aktuellen Suchsitzung
rooms	Anzahl der Zimmer aus der aktuellen Suchsitzung