Variablen und Bedingungen

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

Überblick

Die Landingpage-URL wird in der Landingpage-Datei definiert. Wenn der Link zur Anzeige oder kostenlosen Buchung zu sehen ist, werden die dynamischen Informationen in der URL durch tatsächliche Werte ersetzt. Verwenden Sie die folgende Syntax, um Ihren Landingpage-URLs dynamische Werte hinzuzufügen:

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

Das folgende Beispiel zeigt eine URL, die anstelle der tatsächlichen Hotel-ID und des Reiseplans die Variablennamen von Google verwendet:

<URL>https://www.partnerdomain.com?hotelID=(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 sechs Nächte ab dem 23.05.2023 für Hotel Nr. 42 bucht, zeigt Google den vorherigen Link so an:

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, Ihrem Hotellistenfeed und den Nutzereinstellungen ab.

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

Einige Variablen sind Teilmengen der Preisfeed-Elemente. Beispielsweise werden die Variablen CHECKINDAY, CHECKINMONTH und CHECKINYEAR aus dem einzelnen <Checkin>-Element im Preisfeed extrahiert. Andere Variablen werden basierend auf der Sprache des Nutzers und anderen Client-Einstellungen 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, mit denen Sie Ihre Landingpage-URL erstellen können:

Variable Empfohlen/optional Beschreibung
ADVANCE-BOOKING-WINDOW Optional Die Anzahl der Tage im Voraus 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 Ihre Feedinformationen und eine andere Unterkunfts-ID 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 Die zweistellige Tagesangabe im Element <Checkin> des Hotelpreisfeeds. 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 Die zweistellige Monatsangabe im Element <Checkin> des Hotelpreisfeeds. Beispiel: 05.
CHECKINYEAR Recommended Die vierstellige Jahreszahl, die im Element <Checkin> des Hotelpreisfeeds angegeben ist. 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 im Reiseplan angegebene Alter des Kindes darstellt. Diese Variable kann nur in Verbindung mit einem bedingten FOR-EACH-CHILD-AGE-Block verwendet werden, ist aber nicht obligatorisch.
CLICK-TYPE Optional Gibt an, ob der Nutzer auf den Eintrag für einen Standard-Hotelpreis 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 gewesen wären, wenn der Nutzer eine geringfügige Aktion ausgeführt hätte. Preisregel-IDs für Tarife für bestimmte Zielgruppen werden hier immer ausgefüllt, wenn dem Nutzer auf der Benutzeroberfläche eine entsprechende Anzeige angezeigt wird.
CUSTOM[1-5] Optional Die Werte für benutzerdefinierte Felder, die im Element <Result> definiert sind, sind auf 200 Zeichen pro benutzerdefiniertes Feld beschränkt. Weitere Informationen finden Sie unter Übersicht über 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 in der Suche angegebenes Datum ausgewählt hat. 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 im angegebenen Zeitraum auf eine Hotelanzeige oder einen kostenlosen Buchungslink geklickt.
GOOGLE-SITE Optional Das Google-Produkt, über das ein Nutzer Ihre Hotelpreisdaten aufgerufen 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 bei automatisierten Datenqualitätstests auf deiner Website. Diese Abfragen werden Ihnen nicht in Rechnung gestellt. In Google Analytics können dieser Parameter und sein Wert verwendet werden, um Zugriffe bei der automatischen Überprüfung von 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 mit dem Element <Nights> im Hotelpreisfeed definiert ist. Beispiel: 3.
NUM-ADULTS Recommended (must be used with the NUM-CHILDREN or FOR-EACH-CHILD-AGE condition) Die Anzahl der 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 (0 bis 17 Jahre), die der Nutzer im Reiseplan angegeben hat. NUM-CHILDREN, FOR-EACH-CHILD-AGE oder beide sind erforderlich, um Reisepläne mit Belegungen durch Kinder abzuschließen.
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 wurden. 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 Hotelpreisfeed. 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> im Block <RoomBundle> oder <PackageData> der Transaktionsnachricht.
PARTNER-CURRENCY Optional Der dreistellige Währungscode des Elements <Baserate> im Attribut currency im Hotelpreisfeed. Beispiel: USD oderCAD .
PARTNER-HOTEL-ID Recommended Die eindeutige Kennung des Hotels, die durch das Element <id> im Hotellistenfeed definiert ist.
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 (z. B. „01234567“) an, wenn 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 dem Nutzer 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-Angebote verwenden, wird der Wert dieser Variable dem Attribut id des 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 ID, die durch das Element <RatePlanID> im <RoomBundle>-Block eines Preisfeeds definiert ist. Die <RatePlanID> steht für die eindeutige Kennung für eine Kombination aus Zimmer- und Paketdaten. Weitere Informationen finden Sie unter Zimmerpakete.
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) Die ID, die durch das Attribut rate_rule_id im <Rate>-Block eines Preisfeeds definiert ist. Weitere Informationen finden Sie unter Nutzerabhängige Preise.
USER-COUNTRY Recommended Ein aus zwei Buchstaben bestehender Ländercode, 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 für die Landeswährung des Nutzers. 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 festgelegt werden:
  • mobile
  • tablet
  • desktop
  • unknown

Der Wert der Variablen USER-DEVICE wird aus den Clienteinstellungen des Nutzers abgeleitet.
USER-LANGUAGE Recommended Ein aus zwei Buchstaben bestehender ISO 639-1-Sprachcode, der die Sprache der Anzeige oder des kostenlosen Buchungslinks angibt. Der Wert der Variablen 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 dienen als Grundlage zum Festlegen von Gebotsanpassungen. Wenn der Nutzer Teil mehrerer Zielgruppenlisten ist, wird die Zielgruppenliste mit der größten Gebotsanpassung ausgewählt. Die Zusammenhänge zwischen den Zielgruppen mit der größten Gebotsanpassung werden nach dem Zufallsprinzip ausgewählt.
VERIFICATION Optional Ein boolescher Wert, der bestätigt, ob der Link von Google zum Testen oder zur automatischen Validierung generiert wurde. Wenn der Link von Google zum Testen oder zur automatischen Validierung generiert wurde, lautet der Wert true. Andernfalls lautet er false.

Bedingte Logik in URLs

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

Die bedingte Logik unterstützt die folgenden Anweisungen:

  • if_statement: Wenn true festgelegt ist, werden die für diese Bedingung zulässigen Werte in die URL eingefügt. Andernfalls werden die Werte gemäß der Anweisung ELSE eingefügt.

  • for_statement: Erstellt eine FOR-Schleifenbedingung, die über die Anzahl der angegebenen Werte iteriert.

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 Hoteleintrag 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 ein oder mehrere nutzerabhängige Preise nicht verfügbar waren, weil der Nutzer nicht berechtigt war. Andernfalls wird false zurückgegeben. Standardmäßig ist true angegeben, wenn dem Nutzer ein Tarif für bestimmte Zielgruppen angezeigt wurde.
IF-DEFAULT-RATE Optional Gibt true zurück, wenn der Nutzer auf einen Hoteleintrag geklickt hat, bei dem Standarddaten verwendet wurden. Andernfalls wird false zurückgegeben.
IF-HOTEL-CAMPAIGN Optional Gibt true zurück, wenn der Nutzerklick aus 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 für Hotels im PPS-Provisionsprogramm (Pay-per-Stay) den Wert true an. Andernfalls wird false.
IF-PROMO-CODE Optional Gibt true zurück, wenn der Nutzer auf einen Preis geklickt hat, der auf einer ARI-Aktion oder einer Preisregel mit einer 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-Kundenlisten-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 zur automatischen Validierung generiert wurde. Andernfalls wird false zurückgegeben.
ELSE Recommended (if you use any conditional IF statements) Wenn die vorherige Bedingung nicht erfüllt ist, werden die für diese Bedingung geltenden Werte 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 <OccupancyDetails> beispielsweise 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 FOR-EACH-Anweisung.

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 weitergeleitet zu werden.

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

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 Block <Room Bundle> einer Transaktionsnachricht wird auf den implizit zugeordneten Preis für das Zimmerpaket festgelegt, den der Nutzer ausgewählt hat.

Im folgenden Beispiel wird diese 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 zurückgegeben:

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

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

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 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-DEFAULT-DATE

Verwenden Sie die bedingte IF-DEFAULT-DATE-Anweisung, um einen Nicht-Datumsparameter festzulegen, mit dem Ihre Website dann ein 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 Standardzeitraumauswahl ä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, könnte das Ergebnis je nach ausgewähltem Reiseplan der folgenden URL ähneln:

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 aus einer Hotelkampagne geklickt hat.

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. bei einer regulären 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 stammt, gibt IF-HOTEL-CAMPAIGN TRUE zurück und der Wert für CAMPAIGN-ID ist leer, wie in der folgenden URL zu sehen:

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

Mit der bedingten IF-AD-CLICK-Anweisung können Sie die leere Kampagnen-ID 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>

Beispiel für IF-PAYMENT-ID (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 oder nicht. Im folgenden Beispiel wird geprüft, ob ein Klick vom PPS-Provisionsprogramm stammt, und dem booking_source-Parameter wird anhand des Ergebnisses 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 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 diese 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, wird die folgende URL zurückgegeben:

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

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

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, 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&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 auf Ihrer Website einen Parameter für einen Kunden festzulegen, der zu einer bestimmten Google Ads-Zielgruppenliste gehört. Dies können Sie zu Tracking-Zwecken oder zur Anpassung Ihrer Website für Mitglieder von Zielgruppenlisten tun.

<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, wird die folgende URL zurückgegeben:

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

IF-VERIFICATION-Beispiel

Wenn Sie prüfen möchten, ob die URL von Google für Tests oder für die automatische Validierung generiert wurde, 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 zum Testen oder Validieren nicht generiert hat, lautet das Ergebnis 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, mit dem das Höchstalter für jede Person durch Kinder ausgefüllt wird, wie im Hotelpreisfeed angegeben.

Im folgenden Beispiel wird diese 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 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 umfasste, ist das Ergebnis die folgende URL:

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

Allgemeine Regeln für die Erstellung von URLs

Alle Variablen sind optional. Sie müssen keine Variablen in Ihre Landingpage-URL einfügen. Durch die Verwendung von Variablen zur Weitergabe von Reiseplan- und Nutzerinformationen wird jedoch die Nutzerfreundlichkeit verbessert und die Einhaltung der Google-Richtlinien erleichtert.

Die folgenden allgemeinen Regeln gelten, wenn erstellte URLs in einer Landingpage-Datei definiert werden:

  • Alle Variablen sind in Klammern gesetzt.

  • Abfragestringparameter können nur nach dem Fragezeichen („?“) in der URL übergeben werden.

  • Abfragestringparameter müssen in der Endausgabe durch ein Und-Zeichen („&“) getrennt sein. Da das kaufmännische Und-Zeichen in XML ein Sonderzeichen ist und das Landingpage-Dateiformat XML ist. Daher müssen Sie an ihrer Stelle die codierte Entität "&amp;" verwenden. Die endgültige Ausgabe enthält ein echtes „&“-Zeichen. Beispiel:

    <!-- Do this: -->
<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&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, URL-codieren. Beispiel:

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

    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 in der URL-Codierungstabelle.

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

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

    Die daraus resultierende URL könnte so aussehen:

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

  • Sie können eine beliebige ID für den Namen der Abfragestringparameter 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.