Variablen und Bedingungen

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

Überblick

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>

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 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 im Hotelpreisfeed, Hotellistenfeed und in den Nutzereinstellungen ab.

Beispielsweise wird der Wert der Variablen LENGTH dem Element <Nights> aus dem Preisfeed des zugehörigen Reiseplans zugewiesen. Ebenso wird der Wert der Variablen PARTNER-HOTEL-ID 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 von Variablenwerten finden Sie in der Preisübersicht und in der Hotelliste.

URL-Variablen

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

Variable Empfohlen/optional Beschreibung
ADVANCE-BOOKING-WINDOW Optional Die Anzahl der Tage für Vorausbuchungen 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 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 mit Preisregel-IDs für Preise, die nicht verfügbar waren, aber verfügbar gewesen wären, wenn der Nutzer eine kleinere Aktion ausgeführt hätte. Preisregel-IDs für Tarife für bestimmte Zielgruppen werden hier immer eingefügt, wenn dem Nutzer eine entsprechende UI-Anzeige 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 Übersicht über Transaktionsnachrichten. Benutzerdefinierte Felder sind nicht verfügbar, wenn Sie ARI verwenden.
DATE-TYPE Optional Gibt an, ob der Nutzer das Standarddatum oder ein bestimmtes Datum bei der Suche ausgewählt hat. 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 im festgelegten Zeitraum auf eine Hotelanzeige oder einen kostenlosen Buchungslink geklickt.
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, um automatisierte Datenqualitätstests auf Ihrer Website durchzuführen. 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 wird. 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 beide sind erforderlich, um Reisepläne mit Belegungen durch Kinder 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> im Block <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, 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> 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 zurück (z. B. „01234567“), wenn Sie ein Unternehmen mit dem Einziehen der Provision beauftragen. Wenn Sie das Format 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 lokalen Wä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 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 Variablen bei Anwendung der entsprechenden Preisregel dem Element PromoCode zugewiesen.
RATE-PLAN-ID Recommended (only applies if you use RoomBundles) Die durch das Element <RatePlanID> im <RoomBundle>-Block eines Preisfeeds definierte ID. 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 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 zweistelliger 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 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 verwendet 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 Anzeigesprache 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 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. Wenn der Link von Google zum Testen oder automatischen Validieren generiert wurde, lautet der Wert true. Andernfalls ist er false.

Bedingte Logik in URLs

Sie können 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 festgelegt ist, werden die für diese Bedingung zulässigen Werte in die URL eingefügt. Andernfalls werden die für die Anweisung ELSE erforderlichen Werte 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 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 im PPS-Provisionsprogramm (Pay-per-Stay) zurück. 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 vorherige Bedingung nicht erfüllt ist, 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> 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 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 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 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 Block <Room Bundle> einer Transaktionsnachricht wird auf den implizit zugeordneten Zimmerpaketpreis gesetzt, 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, ist das Ergebnis die folgende URL:

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 kein Zimmerpaket ausgewählt hat, wird in diesem Beispiel die folgende URL zurückgegeben:

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 aus 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 der Klick nicht auf die URL einer Hotelkampagne erfolgt (z.B. bei einer regulären Suchkampagne), ist das Ergebnis die folgende URL:

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 von einem kostenlosen Buchungslink stammt, gibt IF-HOTEL-CAMPAIGN den Wert TRUE zurück und der Wert für CAMPAIGN-ID ist leer, wie in der folgenden URL gezeigt:

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

Mit der bedingten IF-AD-CLICK-Anweisung verhindern Sie, dass die Kampagnen-ID leer ist, 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. 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 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, ist das Ergebnis die folgende URL:

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

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. 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 keinen nutzerabhängigen Preis ausgewählt hat, wird in diesem Beispiel die folgende URL zurückgegeben:

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. Sie können dies zu Tracking-Zwecken oder zum Anpassen 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, ist das Ergebnis die 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, ist 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 im Hotelpreisfeed angegebene Höchstalter für jede Belegung durch Kinder ausfüllt.

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 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 können nur nach dem Fragezeichen („?“) in der URL übergeben werden.

  • Abfragestringparameter müssen in der endgültigen Ausgabe 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 die codierte Entität "&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)&nights=(LENGTH)</URL>

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

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

    • Leerzeichen (" "): Ersetzen Sie Leerzeichen im <URL>-Element 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-Codiertabelle.

  • 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 erstellt:

    <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 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.