Variablen und Bedingungen

Hotelanzeigen und kostenlose Buchungslinks enthalten Links zu Landingpages, auf denen Nutzer Zimmer buchen können. Sie als Partner 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 in die URL beispielsweise Informationen wie die Hotel-ID, die Sprache, Währungscodes und Check-in-Daten 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. Mit der folgenden Syntax können Sie Ihren Landingpage-URLs dynamische Werte hinzufügen:

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

Die folgenden Beispiele zeigen eine URL, die anstelle der tatsächlichen Hotel-ID und des Reiseplans die Variablennamen von Google 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 erstellt 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 sechs Nächte ab dem 23.05.2023 für das Hotel Nr. 42 bucht, rendert Google den vorherigen Link so:

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

Welche Werte Google den Variablen im Abfragestring zuweist, hängt von den entsprechenden Daten in Ihrem Hotelpreisfeed, Hotellistenfeed und den Nutzereinstellungen ab.

Beispielsweise wird der Wert der Variablen LENGTH dem Element <Nights> aus dem Preisfeed des zugehörigen Reiseplans zugewiesen. Der Wert der Variablen PARTNER-HOTEL-ID wird ebenfalls im Element <id> aus dem Hotellistenfeed definiert, das den Suchkriterien des Nutzers entspricht.

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

Weitere Informationen zu den Quellen für Variablenwerte finden Sie unter Preisübersicht und Hotelliste.

URL-Variablen

In der folgenden Tabelle werden die zum Generieren Ihrer Landingpage-URL verfügbaren Variablen erläutert:

Variable Empfohlen/optional Beschreibung
ADVANCE-BOOKING-WINDOW Optional Die Anzahl der Tage 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 ist in Ihrem Hotellisten-Feed angegeben. Die Verwendung separater IDs ist nützlich, wenn Sie eine Unterkunfts-ID für die Feedinformationen und eine andere Unterkunfts-ID für das 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 Die zweistellige Tagesangabe im Element <Checkin> des Hotelpreisfeeds. Beispiel: 20.
CHECKINDAY-OF-WEEK Optional Der Wochentag (Monday bis Sunday), an dem der Check-in in der Zeitzone des Hotels stattfindet. Beispiel: Tuesday
CHECKINMONTH Recommended Die zweistellige Monatsangabe im Element <Checkin> des Hotelpreisfeeds. Beispiel: 05.
CHECKINYEAR Recommended Die vierstellige Jahresangabe im Element <Checkin> des Hotelpreisfeeds. Beispiel: 2023.
CHECKOUTDAY Recommended Die zweistellige Tagesangabe, die aus den Elementen <Nights> und <Checkin> des Hotelpreisfeeds berechnet wird. Beispiel: 26
CHECKOUTMONTH Recommended Die zweistellige Monatsangabe, die aus den Elementen <Nights> und <Checkin> des Hotelpreisfeeds berechnet wird. Beispiel: 05
CHECKOUTYEAR Recommended Die vierstellige Jahresangabe, die aus den Elementen <Nights> und <Checkin> des Hotelpreisfeeds berechnet wird. Beispiel: 2023
CHILD-AGE Recommended (must be provided for child occupancy pricing) Das maximale Alter jedes Kindes, 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 jede Belegung durch ein Kind und das Alter des Kindes darstellt, das im Reiseplan angegeben ist. 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 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 hätten sein können, wenn der Nutzer eine kleinere Aktion ausgeführt hätte. Preisregel-IDs für Tarife für bestimmte Zielgruppen werden hier immer ausgefüllt, wenn dem Nutzer in der Benutzeroberfläche Entsprechendes angezeigt wird.
CUSTOM[1-5] Optional Die Werte für benutzerdefinierte Felder, die im Element <Result> definiert sind. Pro benutzerdefiniertes Feld dürfen maximal 200 Zeichen verwendet werden. Weitere Informationen finden Sie unter Transaktionsnachrichten. Benutzerdefinierte Felder sind bei der Verwendung von ARI nicht verfügbar.
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, für die die Standarddaten verwendet wurden.
  • selected: Der Nutzer hat auf eine Hotelanzeige oder einen kostenlosen Buchungslink mit festgelegtem Zeitraum 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 mit Zielvorhaben für die Reisebranche

    • Hinweis:Wenn der Klick aus der Google Suche und nicht von Google Ads stammt, ist dieser Parameter leer.
GOOGLE-SITE Optional Das Google-Produkt, auf dem ein Nutzer Ihre Hotelpreisdaten angesehen hat. Folgende Werte sind möglich:
  • localuniversal: Der Nutzer hat den Hotel-Buchungslink über eine google.com-Suche gefunden.
  • mapresults: Der Nutzer hat den Hotel-Buchungslink über maps.google.com gefunden.
  • verification: Google verwendet diesen Wert bei automatisierten Datenqualitätstests auf Ihrer Website. Diese Abfragen werden Ihnen nicht in Rechnung gestellt. In Google Analytics können dieser Parameter und sein Wert verwendet werden, um Zugriffe für die automatische Überprüfung von Hotelanzeigen zu identifizieren.
  • unknown: Der Nutzer hat die Anzeige oder den kostenlosen Buchungslink über eine unbekannte Quelle gefunden.
LENGTH Recommended Die Aufenthaltsdauer in Form der Anzahl der Übernachtungen, die mit dem Element <Nights> im Hotelpreisfeed angegeben wurde. Beispiel: 3.
NUM-ADULTS Recommended (must be used with the NUM-CHILDREN or FOR-EACH-CHILD-AGE condition) Die Anzahl von Belegungen durch Erwachsene, die der Nutzer für den Reiseplan angegeben hat. Diese Variable muss in Verbindung mit NUM-CHILDREN, FOR-EACH-CHILD-AGE oder beidem verwendet werden.
NUM-CHILDREN Recommended Die Anzahl der Belegungen durch Kinder (zwischen 0 und 17 Jahren), die im Reiseplan vom Nutzer angegeben wurden. NUM-CHILDREN, FOR-EACH-CHILD-AGE oder beides sind erforderlich, um Reisepläne mit Belegungen durch Kinder und Jugendliche zu berücksichtigen.
NUM-GUESTS Recommended (if you don't send child occupancy pricing) Die Gesamtzahl der Belegungen (Erwachsene und Kinder), die vom Nutzer für den Reiseplan angegeben wurde. Dieser Wert ist die Summe der Werte NUM-ADULTS und NUM-CHILDREN. Für eine maximale Teilnahme 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 Hotelpreis-Feed. Bei einem Standardpaket ist die Paket-ID der Wert des Elements <PackageID> in einem <Result>-Block. 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 aus drei Buchstaben bestehende Währungscode, der durch das Attribut currency des Elements <Baserate> im Hotelpreisfeed definiert wird. Beispiel: USD oderCAD .
PARTNER-HOTEL-ID Recommended Die eindeutige Kennung für das Hotel, das 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> im Block <RoomBundle> oder <RoomData> in der Transaktionsnachricht zugewiesen ist.
PAYMENT-ID Optional (only applies to Ads) 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 die Formatierung Ihrer IATA-Nummer oder eines vordefinierten Strings ändern möchten, wenden Sie sich an Ihren Technical Account Manager (TAM).
PRICE-DISPLAYED-TAX (Optional) Der Steuerbetrag, der in der Landeswährung des Nutzers angezeigt wird. Der Wert von PRICE-DISPLAYED-TAX ist der Wert des Elements <Tax> im Hotelpreisfeed. Beispiel: „3.14“.
PRICE-DISPLAYED-TOTAL (Optional) Die Gesamtkosten für das Zimmer, die in der Landeswährung des Nutzers angezeigt werden. 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-Aktionen verwenden, wird der Wert dieser Variablen dem id -Attribut der angewendeten <Promotion> zugewiesen. Wenn mehrere Angebote angewendet werden, ist es eine durch Kommas getrennte Liste von Angebots-IDs in beliebiger Reihenfolge.

Wenn Sie Preisregeln verwenden, wird der Wert dieser Variable dem Element PromoCode zugewiesen, sofern die entsprechende Preisregel angewendet wird.
RATE-PLAN-ID Recommended (only applies if you use RoomBundles) Die vom Element <RatePlanID> im <RoomBundle>-Block eines Preisfeeds definierte ID. Die <RatePlanID> stellt die eindeutige Kennung für eine Kombination aus Zimmer- und Paketdaten dar. Weitere Informationen finden Sie unter Zimmerpakete.
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) Die durch das Attribut rate_rule_id im <Rate>-Block eines Preisfeeds definierte ID. Weitere Informationen finden Sie unter Nutzerabhängige Preise.

Hinweis: Es werden nur nutzerabhängige Preise oder Tarife für bestimmte Zielgruppen, die nicht ausgeblendet sind, angezeigt.
USER-COUNTRY Recommended Ein Ländercode aus 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 aus drei Buchstaben bestehender Währungscode, der die Landeswährung des Nutzers angibt. Der Wert der Variablen USER-CURRENCY wird aus den Clienteinstellungen des Nutzers abgeleitet. Beispiel: USD oder CAD .
USER-DEVICE Recommended Der Gerätetyp des Nutzers. Für USER-DEVICE kann einer der folgenden Werte angegeben werden:
  • mobile
  • tablet
  • desktop
  • unknown

Der Wert der Variablen USER-DEVICE wird aus den Clienteinstellungen des Nutzers abgeleitet.
USER-LANGUAGE Recommended Ein zweistelliger ISO 639-1-Sprachcode, der die Anzeigesprache der Anzeige oder des kostenlosen Buchungslinks angibt. Der Wert der Variablen USER-LANGUAGE wird von den Client-Einstellungen 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 die Nutzerinformationen enthält. Zielgruppenlisten werden als Grundlage zum Festlegen von Gebotsanpassungen verwendet. Wenn der Nutzer zu mehreren Zielgruppenlisten gehört, wird die Zielgruppenliste mit der größten Gebotsanpassung ausgewählt. Über die Zielgruppen mit der größten Gebotsanpassung wird nach dem Zufallsprinzip entschieden.
VERIFICATION Optional Ein boolescher Wert, der angibt, ob der Link von Google zum Testen oder automatischen Validieren generiert wurde. „true“, wenn der Link von Google zum Testen oder zur automatischen Validierung generiert wurde, andernfalls „false“.

Bedingte Logik in URLs

Du kannst im Element <URL> einer Landingpage-Datei spezielle Anweisungen verwenden, um Endpunkte bedingt zu erstellen.

Die bedingte Logik unterstützt die folgenden Anweisungen:

  • if_statement: Wenn true, werden die für diese Bedingung zulässigen Werte in die URL eingefügt. Andernfalls werden die für die Anweisung ELSE bereitgestellten Werte verwendet.

  • for_statement: Erstellt eine FOR-Schleifenbedingung, die auf der Grundlage der Anzahl der angegebenen Werte iteriert wird.

Die IF- und FOR-Anweisungen enthalten Folgendes:

Bedingung Empfohlen/optional Beschreibung
IF-AD-CLICK (nur Hotelanzeigen) Optional Gibt true zurück, wenn der Nutzer auf eine Anzeige geklickt hat. Gibt false zurück, wenn der Nutzer auf einen kostenlosen Buchungslink geklickt hat.
IF-CLICK-TYPE-HOTEL Optional Gibt true zurück, wenn der Nutzer auf einen Eintrag für ein Hotel geklickt hat. Andernfalls wird false zurückgegeben.
IF-CLICK-TYPE-ROOM Optional Gibt true zurück, wenn der Nutzer auf einen Eintrag für ein Zimmerpaket geklickt hat. Andernfalls wird false zurückgegeben.
IF-CLOSE-RATE-RULE-IDS Optional Gibt true zurück, wenn mindestens ein nutzerabhängiger Preis nicht verfügbar war, weil der Nutzer nicht berechtigt war. Andernfalls wird false zurückgegeben. Standardmäßig ist der Wert true, wenn dem Nutzer auf der Benutzeroberfläche ein Tarif für bestimmte Zielgruppen angezeigt wurde.
IF-DEFAULT-RATE Optional Gibt true zurück, wenn der Nutzer auf einen Hoteleintrag geklickt hat, in dem die Standarddaten verwendet wurden. Andernfalls wird false zurückgegeben.
IF-HOTEL-CAMPAIGN Optional Gibt true zurück, wenn der Nutzerklick von einer Hotelkampagne stammt. Andernfalls wird false zurückgegeben. Diese Unterscheidung ist hilfreich für Partner, die in Google Ads mehrere Kampagnentypen haben, um die Attribution zuzuordnen.
IF-PAYMENT-ID (nur Hotelanzeigen) Recommended (if you use pay-per-stay Google Ads campaigns) Gibt true für Hotels zurück, die am Programm für PPS-Provisionen (Pay-Per-Stay) teilnehmen. Andernfalls wird false zurückgegeben.
IF-PROMO-CODE Optional Gibt true zurück, wenn der Nutzer auf einen Preis geklickt hat, der auf einem ARI-Angebot oder einer Preisregel mit einem bestimmten PromoCode basiert. Andernfalls wird false zurückgegeben.
IF-PROMOTED (nur Hotelanzeigen) Recommended (if you use Promoted hotels) Gibt true zurück, wenn der Nutzer auf eine Anzeige mit Hoteleigenschaften geklickt hat. Andernfalls wird false zurückgegeben.
IF-RATE-RULE-ID Optional Gibt true zurück, wenn der Nutzer einen nutzerabhängigen Preis ausgewählt hat. Andernfalls wird false zurückgegeben.
IF-USER-LIST-ID (in Google Ads definiert) Optional Gibt true zurück, wenn der Nutzer Mitglied einer Google Ads-Kundenliste-ID ist, die Sie beim Festlegen von Gebotsfaktoren für Zielgruppenlisten angegeben haben. Andernfalls wird false zurückgegeben.
IF-VERIFICATION Optional Gibt true zurück, wenn der Link von Google zum Testen oder automatischen Validieren generiert wurde. Andernfalls wird false zurückgegeben.
ELSE Recommended (if you use any conditional IF statements) Wenn die vorangegangene Bedingung nicht erfüllt wird, werden die für diese Bedingung zulässigen Werte in die URL eingefügt.
END-IF Optional (required if you have any IF conditional statements) Beendet den bedingten Block der Anweisung IF.
FOR-EACH-CHILD-AGE Optional (required for child occupancy pricing) Wird für jedes <Child "age">-Element im Preisfeed einmal ausgeführt. Wenn <OccupancyDetails> etwa die beiden Elemente <Child age="17"> und <Child age= "17"> enthält, wird die Anweisung zweimal ausgeführt.
END-FOR-EACH Optional (required if using FOR-EACH block) Beendet den bedingten Block der Anweisung FOR-EACH.

IF-AD-CLICK-Beispiel

Sie können einen bedingten Block erstellen, der prüft, ob der Nutzer auf eine Anzeige oder einen kostenlosen Buchungslink geklickt hat, um 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 nicht auf eine Anzeige geklickt hat, wird in diesem Beispiel die folgende URL zurückgegeben:

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

Wenn der Nutzer auf die Anzeige geklickt hat, ist das Ergebnis die folgende URL:

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

IF-CLICK-TYPE-HOTEL-Beispiel

Sie können einen bedingten Block erstellen, der prüft, ob der Nutzer ein Hotel ohne explizites Zimmerpaket ausgewählt hat. Der Wert des Elements <RatePlanID> im <Room Bundle>-Block einer Transaktionsnachricht wird auf den implizit zugeordneten Zimmerpaketpreis gesetzt, 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 ein Zimmerpaket ausgewählt hat, wird die folgende URL generiert:

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

Wenn der Nutzer kein Zimmerpaket ausgewählt hat, ist das Ergebnis die folgende URL:

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

IF-CLICK-TYPE-ROOM-Beispiel

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

Im folgenden Beispiel wird diese 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 generiert:

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

Wenn der Nutzer ein Zimmerpaket ausgewählt hat, ist das Ergebnis die folgende URL:

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

IF-DEFAULT-DATE-Beispiel

Mit der bedingten IF-DEFAULT-DATE-Anweisung können Sie einen Parameter festlegen, der sich nicht auf das Datum bezieht und mit dem Ihre Website dann benutzerdefiniertes Verhalten auslösen kann, 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)<strong>(IF-DEFAULT-DATE)</strong>&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 mit Standarddatumsauswahl ähneln:

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

Wenn der Nutzer ein Datum ausgewählt hat, kann das Ergebnis je nach ausgewähltem Reiseplan in etwa der folgenden URL entsprechen:

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

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

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

Im folgenden Beispiel wird diese 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 der Nutzer in diesem Beispiel auf die URL einer Hotelkampagne klickt, wird die folgende URL zurückgegeben:

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

Wenn nicht auf die URL einer Hotelkampagne geklickt wurde (z. B. eine reguläre Suchkampagne), wird die folgende URL zurückgegeben:

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

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

Leere Kampagnen-IDs mit FBL-Klicks

Wenn der Klick über einen kostenlosen Buchungslink erfolgt, wird für IF-HOTEL-CAMPAIGN der Wert TRUE zurückgegeben und der Wert für CAMPAIGN-ID wird auf leer gesetzt, wie in der folgenden URL dargestellt:

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

Mit der IF-AD-CLICK-Bedingungsanweisung können Sie verhindern, dass eine leere Kampagnen-ID verwendet wird, 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-PAYMENT-ID-Beispiel (nur Hotelanzeigen)

Verwenden Sie die bedingte Anweisung IF-PAYMENT-ID, um die URL abhängig davon zu variieren, ob der Klick das Ergebnis des PPS-Provisionsprogramms ist. Im folgenden Beispiel wird geprüft, ob ein Klick vom PPS-Provisionsprogramm stammt, und dem Parameter booking_source wird basierend auf dem Ergebnis ein Wert zugewiesen:

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

Wenn das Hotel am Provisionsprogramm teilnimmt, wird eine der folgenden URLs zurückgegeben:

  • Wenn Google noch keine IATA-Nummer zugewiesen wurde:
    https://partner.com?hid=123&amp;booking_source=commissions
  • Wenn Google bereits eine IATA-Nummer zugewiesen wurde:
    https://partner.com?hid=123&amp;booking_source=01234567

Andernfalls ist das Ergebnis die folgende URL:

https://partner.com?hid=123&booking_source=cpc

IF-PROMOTED-Beispiel (nur Hotelanzeigen)

Sie können einen bedingten Block erstellen, der prüft, ob der Nutzer auf eine Anzeige mit Hoteleigenschaften 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 eine Anzeige mit Hoteleigenschaften ausgewählt hat, ist das Ergebnis die folgende URL:

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

Wenn der Nutzer keine Anzeige mit Hoteleigenschaften ausgewählt hat, ist das Ergebnis die folgende URL:

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

IF-RATE-RULE-ID-Beispiel

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

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

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

Wenn der Nutzer in diesem Beispiel keinen nutzerabhängigen Preis ausgewählt hat, ist das Ergebnis die folgende URL:

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

Wenn der Nutzer einen nutzerabhängigen Preis ausgewählt hat, ist das Ergebnis die folgende URL:

https://www.partner.com?hid=123&customerType=42

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

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

<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 kein Mitglied einer Zielgruppenliste war, wird die folgende URL zurückgegeben:

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

Wenn der Nutzer Mitglied der Zielgruppenliste 12345678 war, ergibt sich folgende URL:

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

IF-VERIFICATION-Beispiel

Wenn Sie prüfen möchten, ob Google die URL für Tests oder zur automatischen Validierung 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 die URL zum Testen oder Validieren nicht generiert hat, lautet das Ergebnis in diesem Beispiel die folgende URL:

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

Wenn Google die URL zum Testen oder Validieren generiert hat, ist das Ergebnis die folgende URL:

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

FOR-EACH-CHILD-AGE-Beispiel

Sie können einen bedingten Block erstellen, der das Feld für das maximale Alter für jede Belegung durch ein Kind ausfüllt, 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 in diesem Beispiel der Reiseplan 2 Erwachsene und 2 Kinder im Alter von 0 bzw. 17 Jahren umfasst, ergibt sich die folgende URL:

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

Wenn der Reiseplan 2 Erwachsene und 0 Kinder umfasst, ist das Ergebnis die folgende URL:

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

Allgemeine Regeln beim Erstellen von URLs

Alle Variablen sind optional. Sie müssen keine Variablen in Ihre Landingpage-URL einfügen. Wenn Sie jedoch Reisepläne und Nutzerinformationen mithilfe von Variablen weitergeben, verbessern Sie die Nutzerfreundlichkeit und helfen Ihnen bei der Einhaltung der Google-Richtlinien.

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

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

  • Abfragestringparameter müssen in der Endausgabe durch ein kaufmännisches Und ("&") getrennt sein. Da das Und-Zeichen in XML ein Sonderzeichen ist und das Dateiformat für Landingpages XML ist. Daher müssen Sie stattdessen das codierte Element „&amp;“ verwenden. In der endgültigen Ausgabe wird ein tatsächliches „&“-Zeichen angezeigt. 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>

    Außerdem müssen Sie Sonderzeichen, die Sie in die Landingpage-URL aufnehmen können, URL-codieren. Beispiel:

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

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

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

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

    Dieses Beispiel führt zu einer URL, die so aussehen könnte:

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

  • Sie können für den Namen der Abfragestring-Parameter eine beliebige ID verwenden. Ihr Server verarbeitet diese Werte. Sie können jedoch nur die in der Liste der verfügbaren Variablen enthaltenen Werte übergeben.

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