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. Beziehen Sie in die URL beispielsweise Informationen wie die Hotel-ID, die Sprache, Währungscodes sowie Check-in-Daten ein.

Übersicht

Die Landingpage-URL wird in der Landingpage-Datei definiert. Wenn die Anzeige oder der kostenlose Buchungslink angezeigt wird, werden dynamische 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>

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 generiert wird, ersetzt Google die Variablen durch die tatsächlichen Werte, sodass die URL die dynamischen Informationen enthält. Wenn der Nutzer beispielsweise ein Zimmer für sechs Nächte ab dem 23. Mai 2023 für das Hotel 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, Hotellistenfeed und den Nutzereinstellungen ab.

Dem Wert der Variablen LENGTH wird beispielsweise das 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. Zum Beispiel werden die Variablen CHECKINDAY, CHECKINMONTH und CHECKINYEAR aus dem einzelnen <Checkin>-Element im Preisfeed extrahiert. Andere Variablen werden anhand der Sprache des Nutzers und weiterer Client-Einstellungen 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:

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 angegeben ist, werden die für diese Bedingung zulässigen Werte in die URL eingefügt. Andernfalls werden die für die Anweisung zulässigen ELSE-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:

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 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, ergibt sich 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 verknüpften Preis des Zimmerpakets festgelegt, das 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, wird die folgende URL generiert:

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 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 generiert:

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

Wenn der Nutzer ein Zimmerpaket ausgewählt hat, wird die folgende URL generiert:

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

IF-DEFAULT-DATE-Beispiel

Verwenden Sie die bedingte IF-DEFAULT-DATE-Anweisung, um einen Parameter festzulegen, der kein Datum ist. Diesen kann Ihre Website 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)<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, kann das Ergebnis in etwa so aussehen wie die folgende URL, in der die Standardauswahl für Datumsangaben angezeigt wird:

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 so aussehen wie die folgende URL:

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 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 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 hilfreich, wenn Sie den Traffic von 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&booking_source=commissions

• Wenn Google bereits eine IATA-Nummer zugewiesen wurde:

  https://partner.com?hid=123&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. In diesem Fall wird der Wert des Elements <RateRuleID> im Block <Rate> der Transaktionsnachricht verwendet.

Im folgenden Beispiel wird die 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, ergibt sich folgende URL:

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

Mit IF-VERIFICATION können Sie prüfen, ob Google die URL für Tests oder die automatische Validierung generiert hat.

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

Wenn die URL in diesem Beispiel nicht von Google zum Testen oder Validieren generiert wurde, ist das Ergebnis die folgende URL:

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

Wenn die URL von Google zum Testen oder Validieren generiert wurde, 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 für den Reiseplan 2 Erwachsene und 2 Kinder zwischen jeweils 0 und 17 Jahren angegeben wurden, sieht die URL so aus:

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

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

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

Allgemeine Regeln zum Erstellen von URLs

Alle Variablen sind optional. Sie müssen keine Variablen in Ihre Landingpage-URL einfügen. Wenn Sie dennoch Reiseplan- und Nutzerinformationen mithilfe von Variablen weitergeben, verbessern Sie die Nutzererfahrung. Außerdem erfüllen Sie die Richtlinien von Google.

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

• Alle Variablen werden in Klammern gesetzt.

• Abfragestringparameter müssen in der Endausgabe durch ein Und-Zei­chen („&“) getrennt sein. Da das Und-Zeichen in XML ein Sonderzeichen und die Landingpage-Datei eine XML-Datei ist. Daher müssen Sie stattdessen das codierte Element „&“ 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>
  

  Auch in die Landingpage-URL einzubeziehende Sonderzeichen müssen URL-codiert werden. 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 generiert 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>
  

  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 Suchstringparameter verwenden. Diese Werte werden auf Ihrem Server verarbeitet. Sie können jedoch nur die in der Liste der verfügbaren Variablen enthaltenen Werte senden.

• Neben der Liste der verfügbaren Variablen können Sie bis zu fünf benutzerdefinierte Variablen verwenden.