Variablen und Bedingungen

Hotelanzeigen und kostenlose Buchungslinks enthalten Links zu Landingpages, auf denen Nutzer Zimmer buchen können. Sie können festlegen, dass Google den Link so generieren soll, dass er alle zusätzlichen Informationen über die Nutzer und deren Reisepläne enthält. Sie können beispielsweise Informationen wie die Hotel-ID, die Sprache, Währungscodes und Check-in-Daten in die URL aufnehmen.

Übersicht

Die Landingpage-URL wird in der Landingpage-Datei definiert. Wenn die Anzeige oder der kostenlose Buchungslink eingeblendet wird, werden die dynamischen Informationen in der URL durch tatsächliche Werte ersetzt. Wenn Sie Ihren Landingpage-URLs dynamische Werte hinzufügen möchten, verwenden Sie die folgende Syntax:

<URL>https://partner_url?param_id=(variable_name)</URL>

In den folgenden Beispielen wird eine URL mit den Variablennamen von Google anstelle der tatsächlichen Hotel-ID und des Reiseplans verwendet:

Beispiel 1

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)</URL>

Beispiel 2

<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)</URL>

Wenn der Landingpage-Link für die Suchergebnisseite generiert wird, ersetzt Google die Variablen durch die tatsächlichen Werte, damit die URL die dynamischen Informationen enthält. Wenn der Nutzer beispielsweise ein Zimmer für 6 Nächte ab dem 23.05.2023 für Hotel 42 bucht, rendert Google den vorherigen Link so:

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

Die Werte, die Google den Variablen im Abfragestring zuweist, hängen von den entsprechenden Daten in Ihrem Hotelpreis-Feed, Ihrem Hotellisten-Feed und den Nutzereinstellungen ab.

Beispiel: Der Wert der Variable LENGTH wird dem Element <Nights> aus dem Preisfeed des zugehörigen Reiseplans zugewiesen. Der Wert der Variable PARTNER-HOTEL-ID wird im Element <id> des Hotellisten-Feeds definiert, der den Suchkriterien des Nutzers entspricht.

Einige Variablen sind Teilmengen der Preisfeedelemente. Beispiel: Die Variablen CHECKINDAY, CHECKINMONTH und CHECKINYEAR werden aus dem einzelnen <Checkin>-Element im Preisfeed extrahiert. Andere Variablen werden basierend auf dem Gebietsschema des Nutzers und anderen Clienteinstellungen berechnet.

Weitere Informationen zu den Quellen von Variablenwerten finden Sie in der Preisübersicht und in der Hotelliste.

URL-Variablen

In der folgenden Tabelle werden die verfügbaren Variablen beschrieben, die Sie zum Erstellen der Landingpage-URL verwenden können:

Variable Empfohlen/Optional Beschreibung
ADVANCE-BOOKING-WINDOW Optional Die Anzahl der Tage, die der Nutzer im Voraus bucht, vor dem Check-in-Datum in der Zeitzone des Hotels zum Zeitpunkt der Buchung. Beispiel: 36.
ALTERNATE-HOTEL-ID Recommended (if you have separate IDs to identify properties versus booking engines) Eine alternative Kennung für Ihre Unterkunft. Dieser Attributname wird in Ihrem Hotellistenfeed angegeben. Die Verwendung separater IDs ist nützlich, wenn Sie eine Unterkunftskennung für Ihre Feedinformationen und eine andere Unterkunftskennung für Ihr Buchungssystem benötigen.
CAMPAIGN-ID Recommended Die ID der Google Ads-Kampagne, die Sie mit der URL verknüpfen möchten. Dieses Feld ist leer, wenn der Klick nicht mit einer Google Ads-Kampagne verknüpft ist.
CHECKINDAY Recommended Der zweistellige Tag, der im Element <Checkin> des Hotelpreisfeeds definiert ist. Beispiel: 20.
CHECKINDAY-OF-WEEK Optional Der Wochentag (Monday bis Sunday), an dem der Check-in stattfindet, in der Zeitzone des Hotels. Beispiel: Tuesday
CHECKINMONTH Recommended Der zweistellige Monat, der im Element <Checkin> des Hotelpreisfeeds definiert ist. Beispiel: 05.
CHECKINYEAR Recommended Das vierstellige Jahr, das im Element <Checkin> des Hotelpreisfeeds definiert ist. Beispiel: 2023.
CHECKOUTDAY Recommended Der zweistellige Tag, der aus den Elementen <Nights> und <Checkin> des Hotelpreisfeeds berechnet wird. Beispiel: 26
CHECKOUTMONTH Recommended Der zweistellige Monat, der aus den Elementen <Nights> und <Checkin> des Hotelpreisfeeds berechnet wird. Beispiel: 05
CHECKOUTYEAR Recommended Das vierstellige Jahr, das aus den Elementen <Nights> und <Checkin> des Hotellistenfeeds berechnet wird. Beispiel: 2023
CHILD-AGE Recommended (must be provided for child occupancy pricing) Das Höchstalter der Kinder, wie in den <Child "age">-Elementen des Preisfeeds angegeben. Diese Variable muss in Verbindung mit einem bedingten FOR-EACH-CHILD-AGE-Block verwendet werden.
CHILD-INDEX Optional Eine 0-indexierte Schleifenvariable, die einen Zähler für jedes im Reiseplan angegebene Kind und dessen Alter darstellt. Diese Variable ist zwar nicht obligatorisch, kann aber nur in Verbindung mit einem bedingten FOR-EACH-CHILD-AGE-Block verwendet werden.
CLICK-TYPE Optional Gibt an, ob der Nutzer auf den Eintrag für einen Standardhotelpreis oder für ein Zimmerpaket geklickt hat. Folgende Werte sind möglich:
  • hotel: Der Nutzer hat auf den Eintrag für einen Standardzimmerpreis geklickt.
  • room: Der Nutzer hat auf den Eintrag für ein Zimmerpaket geklickt.
CLOSE-RATE-RULE-IDS Optional (only applies if you are using conditional or private rates) Eine durch Kommas getrennte Liste von Preisregel-IDs für Preise, die nicht verfügbar waren, aber verfügbar gewesen wären, wenn der Nutzer eine kleine Aktion ausgeführt hätte. Hinweis: Die Preisregel-IDs für Tarife für bestimmte Zielgruppen werden hier immer angegeben, wenn dem Nutzer eine entsprechende Preisdarstellung angezeigt wird.
Optional Eingestellt: Die Werte für benutzerdefinierte Felder, die im Element <Result> definiert sind, mit einer Zeichenbeschränkung von 200 Zeichen pro benutzerdefiniertem Feld. Weitere Informationen finden Sie unter Übersicht über Transaktionsnachrichten. Benutzerdefinierte Felder sind bei Verwendung von ARI nicht verfügbar. CUSTOM-Variablen werden nur aufgeführt, wenn Sie die Preise in der Transaktionsnachricht senden.
DATE-TYPE Optional Gibt an, ob der Nutzer das Standarddatum oder ein bestimmtes Datum ausgewählt hat, das in der Suche angegeben wurde. Folgende Werte sind möglich:
  • default: Der Nutzer hat auf eine Hotelanzeige oder einen kostenlosen Buchungslink geklickt, bei dem die Standarddaten verwendet wurden.
  • selected: Der Nutzer hat auf eine Hotelanzeige oder einen kostenlosen Buchungslink mit festgelegten Daten geklickt.
GOOGLE-ADS-CLICK-SOURCE Optional Gibt an, dass Google Ads die Quelle des Klicks war. Folgende Werte sind möglich:
  • bl: Bezahlte Buchungslinks
  • tpa: Anzeigen für Reiseangebote
  • tfsa: Reisefeeds in Suchanzeigen
  • pm: Performance Max-Kampagnen oder Performance Max-Kampagnen für die Reisebranche
  • dg: Demand Gen-Kampagne

    • Hinweis:Wenn der Klick über die Google Suche und nicht über Google Ads erfolgt ist, ist dieser Parameter leer.
GOOGLE-SITE Optional Das Google-Produkt, auf dem ein Nutzer Ihre Hotelpreisdaten gesehen hat. Folgende Werte sind möglich:
  • localuniversal: Der Nutzer hat den Hotel-Buchungslink über die google.com-Suche gefunden.
  • mapresults: Der Nutzer hat den Hotel-Buchungslink über maps.google.com gefunden.
  • verification: Google verwendet diesen Wert, wenn Datenqualitätstests auf Ihrer Website durchgeführt werden. Diese Abfragen werden Ihnen nicht in Rechnung gestellt. Google Analytics kann diesen Parameter und seinen Wert verwenden, um den Bestätigungstraffic für Hotelanzeigen zu identifizieren.
  • unknown: Der Nutzer hat die Anzeige oder den kostenlosen Buchungslink über eine unbestimmte Quelle gefunden.
LENGTH Recommended Die Aufenthaltsdauer in Form der Anzahl der Übernachtungen, die durch das Element <Nights> im Hotelpreis-Feed definiert ist. Beispiel: 3.
MODIFICATION-IDS Optional

Wenn Sie ARI-Preisänderungen verwenden, ist der Wert dieser Variable das Attribut id der Preisänderungsnachricht. Wenn mehrere Preisänderungen angewendet werden, ist dies eine durch Kommas getrennte Liste von Änderungs-IDs in beliebiger Reihenfolge.
NUM-ADULTS Recommended (must be used with the NUM-CHILDREN or FOR-EACH-CHILD-AGE condition) Die Anzahl der erwachsenen Gäste, die der Nutzer für den Reiseplan angegeben hat. Diese Variable muss in Verbindung mit NUM-CHILDREN, FOR-EACH-CHILD-AGE oder beiden verwendet werden.
NUM-CHILDREN Recommended Die Anzahl der Kinder (0–17 Jahre), die vom Nutzer im Reiseplan angegeben wurde. NUM-CHILDREN, FOR-EACH-CHILD-AGE oder beide sind erforderlich, um erfolgreich an Reiseplänen mit Kindern teilzunehmen.
NUM-GUESTS Recommended (if you don't send child occupancy pricing) Die Gesamtzahl der Gäste (Erwachsene und Kinder), die vom Nutzer für den Reiseplan angegeben wurde. Dieser Wert ist die Summe der Werte NUM-ADULTS und NUM-CHILDREN. Um die Teilnahme zu maximieren, wird dringend empfohlen, stattdessen sowohl NUM-ADULTS als auch NUM-CHILDREN zu verwenden.
PACKAGE-ID Recommended (applies if you use Room Bundles) Die eindeutige Kennung für das Paket im Hotelpreisfeed. Bei einem Standardpaket ist die Paket-ID der Wert des <PackageID>-Elements innerhalb eines <Result>-Blocks. Bei einem Zimmerpaket ist die Paket-ID der Wert des Elements <PackageID> in den Blöcken <RoomBundle> oder <PackageData> der Transaktionsnachricht.
PARTNER-CURRENCY Optional Der dreistellige Währungscode, der im Hotelpreisfeed durch das Attribut currency des Elements <Baserate> definiert ist. Beispiel: USD oderCAD .
PARTNER-HOTEL-ID Recommended Die eindeutige Kennung für das Hotel, die durch das Element <id> im Hotellistenfeed definiert wird.
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) Die eindeutige Kennung für das Zimmer im Hotelpreisfeed. Bei einem Standardzimmer ist die Zimmer-ID ein Wert des Elements <RoomID> im Block <Result>. Bei einem Zimmerpaket ist die Zimmer-ID der Wert, der dem Element <RoomID> in den Blöcken <RoomBundle> oder <RoomData> in der Transaktionsnachricht zugewiesen ist.
Optional (only applies to Ads) Eingestellt: Gibt den vordefinierten String commission oder die zugewiesene IATA-Nummer von Google an (z. B. „01234567“), falls Sie ein Unternehmen mit dem Einziehen der Provision beauftragen. Wenn Sie das Format Ihrer IATA-Nummer oder eines vordefinierten Strings ändern möchten, müssen Sie sich an Ihren Technical Account Manager (TAM) wenden.
PRICE-DISPLAYED-FEES (Optional) Die Höhe der Gebühren, die in den Gesamtsteuern und -gebühren enthalten sind, in der Landeswährung des Nutzers. Der Wert von PRICE-DISPLAYED-FEES ist der Wert des Elements <Fee> in der Transaktionsnachricht. Bei ARI ist dies der berechnete Gebührenbetrag basierend auf der TaxFeeInfo-Nachricht. Beispiel: „60.14“.
PRICE-DISPLAYED-TAX (Optional) Der Steuerbetrag in der Landeswährung des Nutzers. Der Wert von PRICE-DISPLAYED-TAX ist der Wert des <Tax>-Elements im Hotelpreisfeed. Beispiel: „3.14“.
PRICE-DISPLAYED-TOTAL (Optional) Die Gesamtkosten für das Zimmer in der Landeswährung des Nutzers. Der Wert von PRICE-DISPLAYED-TOTAL ist die Summe der Elemente <Baserate>, <Tax> und <OtherFees> aus dem Hotelpreisfeed. Beispiel: „152.13“.
PROMO-CODE (Optional)

Wenn Sie ARI-Angebote verwenden, wird der Wert dieser Variable dem Attribut id des angewendeten <Promotion> zugewiesen. Wenn mehrere Angebote angewendet werden, handelt es sich um eine durch Kommas getrennte Liste von Angebots-IDs in beliebiger Reihenfolge.

Wenn Sie Ratenregeln verwenden, wird der Wert dieser Variablen dem Element PromoCode zugewiesen, wenn die entsprechende Ratenregel angewendet wird.
RATE-PLAN-ID Recommended (only applies if you use RoomBundles) Die ID, die durch das Element <RatePlanID> im Block <RoomBundle> eines Preisfeeds definiert wird. <RatePlanID> steht für die eindeutige Kennung einer Kombination aus Zimmer- und Paketdaten. Für eine optimale Leistung sollte sie maximal 50 Zeichen lang sein. Weitere Informationen finden Sie unter Raum-Bundles.
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) Die ID, die durch das Attribut rate_rule_id im Block <Rate> eines Preisfeeds definiert wird. Weitere Informationen finden Sie unter Nutzerabhängige Preise.

Hinweis:Es werden nur nutzerabhängige Preise oder Tarife für bestimmte Zielgruppen angezeigt, die nicht ausgeblendet sind.
USER-COUNTRY Recommended Ein Ländercode mit zwei Buchstaben, der den Standort des Nutzers angibt. Diese Informationen werden aus den Clienteinstellungen des Nutzers extrahiert. Beispiel: US oder FR.
USER-CURRENCY Recommended Ein dreistelliger Währungscode, der die Landeswährung des Nutzers angibt. Der Wert der Variable USER-CURRENCY wird aus den Clienteinstellungen des Nutzers abgeleitet. Beispiel: USD oder CAD .
USER-DEVICE Recommended Der Gerätetyp des Nutzers. Der Wert von USER-DEVICE kann einer der folgenden sein:
  • mobile
  • tablet
  • desktop
  • unknown

Der Wert der Variable USER-DEVICE wird aus den Clienteinstellungen des Nutzers abgeleitet.
USER-LANGUAGE Recommended Ein zweistelliger ISO 639-1-Sprachcode, der die Sprache der Anzeige oder des kostenlosen Buchungslinks angibt. Der Wert der Variable USER-LANGUAGE wird aus den Clienteinstellungen des Nutzers abgeleitet. Beispiel: en oder fr.
USER-LIST-ID (in Google Ads definiert) Optional (only applies if you use Audience Lists in Google Ads) Die Google Ads-Nutzerlisten-ID, die die Zielgruppenliste oder Nutzerinformationen enthält. Zielgruppenlisten werden als Grundlage für das Festlegen von Gebotsanpassungen verwendet. Wenn der Nutzer zu mehreren Zielgruppenlisten gehört, wird die Zielgruppenliste mit der größten Gebotsanpassung ausgewählt. Bei Zielgruppen mit der höchsten Gebotsanpassung entscheidet das Zufallsprinzip.
VERIFICATION Optional Ein boolescher Wert, der angibt, ob der Link von Google zu Test- oder Validierungszwecken generiert wurde. Der Wert ist true, wenn der Link von Google zum Testen oder Validieren generiert wurde, andernfalls false.

Bedingte Logik in URLs

Sie können spezielle Anweisungen im <URL>-Element einer Landingpage-Datei verwenden, um Endpunkte bedingt zu erstellen.

Die bedingte Logik unterstützt die folgenden Anweisungen:

  • if_statement: Wenn true, werden die Werte, die dieser Bedingung entsprechen, in die URL eingefügt. Andernfalls werden die Werte eingefügt, die der Anweisung ELSE entsprechen.

  • for_statement: Erstellt eine FOR-Schleifenbedingung, die die angegebene Anzahl von Werten durchläuft.

IF- und FOR-Anweisungen umfassen Folgendes:

Bedingung Empfohlen/Optional Beschreibung
IF-AD-CLICK (nur Hotelanzeigen) Optional Wird zu true aufgelöst, wenn der Nutzerklick von einer Anzeige stammt. Wird zu false aufgelöst, wenn der Nutzer auf einen kostenlosen Buchungslink geklickt hat.
IF-CLICK-TYPE-HOTEL Optional Wird zu true aufgelöst, wenn der Nutzer auf einen Eintrag für ein Hotel geklickt hat, andernfalls zu false.
IF-CLICK-TYPE-ROOM Optional Wird zu true aufgelöst, wenn der Nutzer auf einen Eintrag für ein Zimmerpaket geklickt hat, andernfalls zu false.
IF-CLOSE-RATE-RULE-IDS Optional Wird zu true aufgelöst, wenn ein oder mehrere nutzerabhängige Preise nicht verfügbar waren, weil der Nutzer nicht berechtigt war. Andernfalls wird zu false aufgelöst. Standardmäßig ist dies true, wenn dem Nutzer eine Preisdarstellung für Tarife für bestimmte Zielgruppen angezeigt wurde.
IF-DEFAULT-DATE Optional Wird zu true aufgelöst, wenn der Nutzer auf einen Hoteleintrag mit Standarddaten geklickt hat, andernfalls zu false.
IF-HOTEL-CAMPAIGN Optional Wird zu true aufgelöst, wenn der Nutzerklick von einer Hotelkampagne stammt, andernfalls zu false. Diese Unterscheidung ist für Partner hilfreich, die mehrere Kampagnentypen in Google Ads haben, um die Attribution zuzuweisen.
IF-MODIFICATION-IDS Optional Wird zu true aufgelöst, wenn der Nutzer auf einen Preis geklickt hat, der durch eine ARI-Preisänderung geändert wurde. Andernfalls wird zu false aufgelöst.
(nur Hotelanzeigen) Recommended (if you use pay-per-stay Google Ads campaigns) Eingestellt:Wird für Hotels, die am Pay-per-Stay-Provisionsprogramm teilnehmen, auf true gesetzt, andernfalls auf false.
IF-PROMO-CODE Optional Wird zu true aufgelöst, wenn der Nutzer auf einen Preis geklickt hat, der auf einem ARI-Angebot oder einer Preisregel mit einer bestimmten PromoCode basiert. Andernfalls wird zu false aufgelöst.
IF-PROMOTED (nur Hotelanzeigen) Recommended (if you use Promoted hotels) Wird zu true aufgelöst, wenn der Nutzer auf eine Anzeige mit Hoteleigenschaften geklickt hat, andernfalls zu false.
IF-RATE-RULE-ID Optional Wird zu true aufgelöst, wenn der Nutzer einen nutzerabhängigen Preis ausgewählt hat, andernfalls zu false.
IF-USER-LIST-ID (in Google Ads definiert) Optional Wird zu true aufgelöst, wenn der Nutzer Mitglied einer Google Ads-Kundenlisten-ID ist, die Sie beim Festlegen von Gebotsfaktoren für Zielgruppenlisten angegeben haben. Andernfalls wird zu false aufgelöst.
IF-VERIFICATION Optional Wird zu true aufgelöst, wenn der Link von Google zu Test- oder Validierungszwecken generiert wurde, andernfalls zu false.
ELSE Recommended (if you use any conditional IF statements) Wenn die vorherige Bedingung nicht erfüllt ist, werden die Werte, die dieser Bedingung entsprechen, in die URL eingefügt.
END-IF Optional (required if you have any IF conditional statements) Beendet den bedingten Block der IF-Anweisung.
FOR-EACH-CHILD-AGE Optional (required for child occupancy pricing) Wird einmal für jedes <Child "age">-Element im Preisfeed ausgeführt. Wenn die <OccupancyDetails> beispielsweise die beiden Elemente <Child age="17"> und <Child age= "17"> enthalten, wird die Anweisung zweimal ausgeführt.
END-FOR-EACH Optional (required if using FOR-EACH block) Beendet den bedingten Block der FOR-EACH-Anweisung.

Beispiel für IF-AD-CLICK

Sie können einen bedingten Block erstellen, der prüft, ob der Nutzer auf eine Anzeige oder einen kostenlosen Buchungslink geklickt hat, um ihn auf Ihre Landingpage weiterzuleiten.

Im folgenden Beispiel wird die Anweisung in einer Landingpage-Datei verwendet:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

Wenn der Nutzer in diesem Beispiel nicht auf eine Anzeige geklickt hat, wird die folgende URL zurückgegeben:

https://www.partner.com?hid=123&adType=0

Wenn der Nutzer auf die Anzeige geklickt hat, wird die folgende URL zurückgegeben:

https://www.partner.com?hid=123&adType=1

Beispiel für IF-CLICK-TYPE-HOTEL

Sie können einen bedingten Block erstellen, der prüft, ob der Nutzer ein Hotel ohne explizites Zimmerpaket ausgewählt hat. Der Wert des <RatePlanID>-Elements im <Room Bundle>-Block einer Transaktionsnachricht wird auf den implizit zugeordneten Zimmerpaketpreis festgelegt, den der Nutzer ausgewählt hat.

Im folgenden Beispiel wird die Anweisung in einer Landingpage-Datei verwendet:

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Wenn der Nutzer in diesem Beispiel kein Zimmerpaket ausgewählt hat, wird die folgende URL zurückgegeben:

https://partner.com/landing?hid=123

Wenn der Nutzer ein Zimmerpaket ausgewählt hat, wird die folgende URL zurückgegeben:

https://partner.com/landing_room?hid=123

Beispiel für IF-CLICK-TYPE-ROOM

Sie können einen bedingten Block erstellen, der prüft, ob der Nutzer ein RoomBundle ausgewählt hat.

Im folgenden Beispiel wird die Anweisung in einer Landingpage-Datei verwendet:

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Wenn der Nutzer in diesem Beispiel kein Zimmerpaket ausgewählt hat, wird die folgende URL zurückgegeben:

https://partner.com/landing?hid=123

Wenn der Nutzer ein Zimmerpaket ausgewählt hat, wird die folgende URL zurückgegeben:

https://partner.com/landing_room?hid=123

Beispiel für IF-CLOSE-RATE-RULE-IDS

Sie können einen bedingten Block erstellen, der prüft, ob der Nutzer spezielle reduzierte Preise oder Tarife für bestimmte Zielgruppe(n) für Mitglieder eines Treuepunkteprogramms hat.

Im folgenden Beispiel wird die Anweisung in einer Landingpage-Datei verwendet:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-CLOSE-RATE-RULE-IDS)&amp;rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(ENDIF)</URL>

Wenn der Nutzer in diesem Beispiel nicht für den privaten Preis infrage kommt, wird die folgende URL zurückgegeben:

https://partner.com?hid=123

Wenn der Nutzer Mitglied eines Treuepunkteprogramms ist und Anspruch auf einen Tarif für bestimmte Zielgruppe(n) hat, wird die folgende URL zurückgegeben:

https://partner.com?hid=123&rate_rule=sample_qr

Das folgende Beispiel zeigt eine Logik für nutzerabhängige Preise mit Check-in-Datum, Check-out-Datum und Belegungsdetails mit verschachtelten IF-Bedingungen, um zu prüfen, ob der Nutzer Anspruch auf einen privaten Preis, einen nutzerabhängigen privaten Preis oder einen öffentlichen Preis hat:

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYear)&amp;checkoutDay=(CHECKOUTDAY)&amp;checkoutMonth=(CHECKOUTMONTH)&amp;checkoutYear(CHECKOUTYear)&amp;num_adults=(NUM-ADULTS)(IF-CLOSE-RATE-RULE-IDS)&amp;promo_type=member_signup&amp;rate_rule=(CLOSE-RATE-RULE-ID)(ELSE)(IF-RATE-RULE-ID)&amp;promo_type=conditional&amp;rate_rule=(RATE-RULE-ID)(ELSE)promo_type=public(ENDIF)(ENDIF)</URL>

Wenn der Nutzer Anspruch auf einen privaten Preis hat, wird die folgende URL zurückgegeben:

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=member_signup&rate_rule=sample_qr

Wenn der Nutzer Anspruch auf einen nutzerabhängigen Preis für bestimmte Zielgruppen hat, wird die folgende URL zurückgegeben:

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=conditional&rate_rule=US_users

Wenn der Nutzer Anspruch auf einen öffentlichen Preis hat, wird die folgende URL zurückgegeben:

https://partner.com/?hid=123&checkinDay=05&checkinMonth=03&checkinYear=2026&checkoutDay=07&checkoutMonth=03&checkoutYear=2026&num_adults=2&promo_type=public

Beispiel für IF-DEFAULT-DATE

Verwenden Sie die bedingte Anweisung IF-DEFAULT-DATE, um einen Parameter festzulegen, der kein Datum ist. Ihre Website kann diesen Parameter dann verwenden, um ein benutzerdefiniertes Verhalten auszulösen, wenn der Nutzer kein Datum ausgewählt hat.

Im folgenden Beispiel wird geprüft, ob das Standarddatum verwendet wurde:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)(IF-DEFAULT-DATE)&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

Wenn der Nutzer in diesem Beispiel kein Datum ausgewählt hat, könnte das Ergebnis der folgenden URL ähneln, die Standarddatumsauswahlen enthält:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

Wenn der Nutzer ein Datum ausgewählt hat, sieht das Ergebnis je nach ausgewähltem Reiseplan möglicherweise so aus:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false

Beispiel für IF-HOTEL-CAMPAIGN (Klicks auf Hotelanzeigen und kostenlose Buchungslinks)

Sie können einen bedingten Block erstellen, der prüft, ob der Nutzer auf eine Anzeige aus einer Hotelkampagne geklickt hat.

Im folgenden Beispiel wird die Anweisung in einer Landingpage-Datei verwendet:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

Wenn in diesem Beispiel nicht auf die URL einer Hotelkampagne geklickt wird (z.B. bei einer regulären Suchkampagne), wird die folgende URL zurückgegeben:

https://www.partner.com?hotelID=123&utm_campaign=87654321

Wenn der Nutzer auf die URL einer Hotelkampagne klickt, wird die folgende URL zurückgegeben:

https://www.partner.com?hotelID=123&hotel_campaign=12345678

Das ist nützlich, wenn Sie die Zugriffe über Klicks auf Hotelkampagnen von anderen Klicks unterscheiden möchten.

Leere CAMPAIGN-IDs mit Klicks auf kostenlose Buchungslinks

Wenn der Klick von einem kostenlosen Buchungslink stammt, gibt IF-HOTEL-CAMPAIGN den Wert TRUE zurück und der Wert CAMPAIGN-ID wird leer gelassen, wie in der folgenden URL zu sehen:

https://www.partner.com?hotelID=123&hotel_campaign=

Sie können die bedingte Anweisung IF-AD-CLICK verwenden, um eine leere Kampagnen-ID zu verhindern, wie im folgenden Beispiel gezeigt:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)(IF-AD-CLICK)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

IF-MODIFICATIONS-IDS

Sie können einen bedingten Block erstellen, der prüft, ob der Nutzer die Nachricht ARI-Preisänderungen aktualisiert hat.

Im folgenden Beispiel wird die Anweisung in einer Landingpage-Datei verwendet:

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-MODIFICATION-IDS)&amp;promo_applied=true&amp;mod_ids=(MODIFICATION-IDS)(ENDIF)</URL>

Wenn der Nutzer in diesem Beispiel die Nachricht zu ARI-Preisänderungen nicht geändert hat, wird die folgende URL zurückgegeben:

https://partner.com?hid=123

Wenn der Nutzer die Nachricht zu ARI-Preisänderungen aktualisiert hat, lautet die resultierende URL:

https://partner.com?hid=123&promo_applied=true&mod_ids=7

IF-PROMO-CODE

Sie können einen bedingten Block erstellen, der prüft, ob der Aktionscode für den Rabatt mit dem Preis für den angegebenen Nutzer verknüpft ist, der über ARI-Angebote oder Preisregel-Nachrichten konfiguriert ist.

Im folgenden Beispiel wird die Anweisung in einer Landingpage-Datei verwendet:

<URL>https://partner.com/booking?hid=(PARTNER-HOTEL-ID)(IF-PROMO-CODE)&amp;promotion_code=(PROMO-CODE)&amp;discount_applied=true(ENDIF)</URL>

Wenn der Gutscheincode in diesem Beispiel ungültig war, wird die folgende URL zurückgegeben:

https://partner.com?hid=123

Wenn der Nutzer einen gültigen Gutscheincode hat und Anspruch auf einen Rabatt hat, wird die folgende URL zurückgegeben:

https://partner.com?hid=123&promotion_code=123_abc&discount_applied=true

Beispiel für IF-PROMOTED (nur Hotelanzeigen)

Sie können einen bedingten Block erstellen, der prüft, ob der Nutzer auf eine Anzeige für Hotels geklickt hat.

Im folgenden Beispiel wird die Anweisung in einer Landingpage-Datei verwendet:

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

Wenn der Nutzer in diesem Beispiel keine Anzeige mit Hoteleigenschaften ausgewählt hat, wird die folgende URL zurückgegeben:

https://partner.com/0?hid=123

Wenn der Nutzer eine Anzeige mit Hoteleigenschaften ausgewählt hat, wird die folgende URL zurückgegeben:

https://partner.com/1?hid=123

Beispiel für IF-RATE-RULE-ID

Sie können einen bedingten Block erstellen, der prüft, ob der Nutzer einen nutzerabhängigen Preis ausgewählt hat. Wenn das der Fall ist, wird der Wert des Elements <RateRuleID> im Block <Rate> der Transaktionsnachricht verwendet. Weitere Informationen

Im folgenden Beispiel wird die Anweisung in einer Landingpage-Datei verwendet:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;rate_rule=(RATE-RULE-ID)(ELSE)(ENDIF)</URL>

Wenn der Nutzer in diesem Beispiel keinen nutzerabhängigen Preis ausgewählt hat, wird die folgende URL zurückgegeben:

https://www.partner.com?hid=123

Wenn der Nutzer einen nutzerabhängigen Preis ausgewählt hat, wird die folgende URL zurückgegeben:

https://www.partner.com?hid=123&rate_rule=(RATE-RULE-ID)

Beispiel für IF-USER-LIST-ID (in Google Ads definiert)

Wenn Sie in einer Hotelkampagne in Google Ads Gebotsfaktoren für Zielgruppenlisten festlegen, können Sie IF-USER-LIST-ID in Verbindung mit USER-LIST-ID verwenden, um auf Ihrer Website einen Parameter für einen Kunden festzulegen, der zu einer bestimmten Google Ads-Zielgruppenliste gehört. Das kann zu Tracking-Zwecken oder zur Anpassung Ihrer Website für Mitglieder von Zielgruppenlisten sinnvoll sein.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

Wenn der Nutzer in diesem Beispiel nicht Mitglied einer Zielgruppenliste ist, wird die folgende URL zurückgegeben:

https://www.partner.com?hid=123

Wenn der Nutzer Mitglied der Zielgruppenliste 12345678 war, wird die folgende URL zurückgegeben:

https://www.partner.com?hid=123&audience_list=12345678

Beispiel für IF-VERIFICATION

Wenn Sie prüfen möchten, ob Google die URL zu Test- oder Validierungszwecken generiert hat, können Sie IF-VERIFICATION verwenden.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

Wenn Google in diesem Beispiel die URL nicht zum Testen oder Validieren generiert hat, lautet das Ergebnis:

https://www.partner.com?hid=123

Wenn Google die URL zu Test- oder Validierungszwecken generiert hat, lautet das Ergebnis:

https://www.partner.com?hid=123&isgoogle=true

Beispiel für FOR-EACH-CHILD-AGE

Sie können einen bedingten Block erstellen, der das Höchstalter jedes Kindes enthält, wie im Hotelpreisfeed angegeben.

Im folgenden Beispiel wird die Anweisung in einer Landingpage-Datei verwendet:

<URL>https://partner.com?adults=(NUM-ADULTS)&amp;children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&amp;age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&amp;hid=(PARTNER-HOTEL-ID)&amp;</URL>

Wenn der Reiseplan in diesem Beispiel 2 Erwachsene und 2 Kinder im Alter von 0 und 17 Jahren enthält, wird die folgende URL zurückgegeben:

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

Wenn der Reiseplan 2 Erwachsene und 0 Kinder umfasst, sieht die URL so aus:

https://www.partner.com?adults=2&children=0&hid=123

Allgemeine Regeln für das Erstellen von URLs

Alle Variablen sind optional. Sie müssen keine Variablen in die Landingpage-URL einfügen. Wenn Sie jedoch Variablen verwenden, um Reiseplan- und Nutzerinformationen zu übergeben, ist das für den Nutzer in der Regel besser und Sie können die Google-Richtlinien leichter einhalten.

Beim Definieren von zusammengesetzten URLs in einer Landingpage-Datei gelten die folgenden allgemeinen Regeln:

  • Alle Variablen sind von öffnenden und schließenden Klammern umgeben.

  • Abfragestring-Parameter müssen in der endgültigen Ausgabe durch ein kaufmännisches Und-Zeichen ("&") getrennt werden. Das kaufmännische Und-Zeichen ist ein Sonderzeichen in XML und das Dateiformat der Landingpage-Datei ist XML. Daher müssen Sie stattdessen die codierte Entität „&amp;“ verwenden. In der endgültigen Ausgabe wird ein tatsächliches „&“-Zeichen gerendert. Beispiel:

    <!-- Do this: -->
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;nights=(LENGTH)</URL>

<!-- Do NOT do this: -->
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>

    Sonderzeichen, die Sie in die Landingpage-URL einfügen, müssen ebenfalls URL-codiert sein. Beispiel:

    • Leerzeichen („ “): Ersetzen Sie Leerzeichen im Element <URL> durch „%20;“.
    • Schrägstrich ("/"): Ersetze Schrägstriche im Element <URL> durch "%2F;".

    Nicht alle nicht alphabetischen Zeichen müssen URL-codiert sein. Bindestriche („-“) müssen beispielsweise nicht URL-codiert werden. Eine Liste gängiger Zeichen, die URL-codiert werden müssen, finden Sie unter URL-Codierung.

  • Werte für einen einzelnen Parameter können aus mehreren Variablen erstellt werden. Im folgenden Beispiel wird ein einzelner Parameter, checkinDate, aus den Variablen CHECKINDAY, CHECKINMONTH und CHECKINYEAR erstellt:

    <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>

    In diesem Beispiel sieht die URL so aus:

    https://www.partnerdomain.com?checkinDate=7/23/1971

  • Sie können eine beliebige ID für den Namen der Abfragestring-Parameter verwenden. Ihr Server verarbeitet diese Werte. Die Werte, die Sie übergeben, sind jedoch auf die Liste der verfügbaren Variablen beschränkt.

  • Zusätzlich zu den verfügbaren Variablen können Sie bis zu fünf benutzerdefinierte Variablen verwenden.