Variablen und Bedingungen

Hotelanzeigen und kostenlose Buchungslinks enthalten Links zu Landingpages, auf denen die Nutzer Räume buchen können. Sie können festlegen, wie Google den Link so erstellen soll, dass alle zusätzliche Informationen über den Nutzer und seinen Reiseplan. 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 werbe- oder Buchungslink wird angezeigt, dynamische Informationen in der URL werden durch tatsächliche Werte. 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 vom in Ihrem Hotelpreis-Feed, Hotellisten-Feed und Ihren Nutzereinstellungen.

Beispiel: Der Wert der Variablen LENGTH wird dem Element <Nights> zugewiesen. aus dem Preisfeed des zugehörigen Reiseplans. 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 berechnet basierend auf dem Gebietsschema des Nutzers und anderen Client-Einstellungen.

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

URL-Variablen

In der folgenden Tabelle werden die verfügbaren Variablen beschrieben, mit denen Sie Ihre Landingpage-URL erstellen:

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, sind die folgenden Werte in die URL eingefügt werden. Andernfalls werden die Werte ELSE-Anweisung eingefügt.

• 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, lautet das Ergebnis: URL:

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 <RatePlanID>-Elements im Der <Room Bundle>-Block einer Transaktionsnachricht wird implizit auf den Preis des zugehörigen Zimmerpakets, 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, 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 zu sehen ist:

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 auf eine Hotelkampagne zurückzuführen sind.

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. eine reguläre 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 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, 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, ist das Ergebnis eines der folgenden folgende URLs:

• Wenn Google noch keine IATA-Nummer zugewiesen wurde:

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

• Wenn Google 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 einen Anzeige mit Hoteleigenschaften.

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, wird das Ergebnis ist 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ängiger Preis. Ist das der Fall, dann ist der Wert des <RateRuleID> im <Rate>-Block 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, lautet das Ergebnis: die 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 die URL von Google zum Testen oder zur automatischen Validierung generiert wurde.

<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, erhalten Sie 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 Höchstalter jedes Belegung durch Kinder, 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 beim Erstellen von URLs

Alle Variablen sind optional. Sie müssen keine Variablen in die Landingpage-URL. Die Verwendung von Variablen zur Weitergabe von Reiseplan und Nutzer Informationen im Allgemeinen eine bessere User Experience schaffen und Ihnen helfen, den Google-Richtlinien entsprechen.

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 die codierte Entität "&" an ihrer Stelle. In der endgültigen Ausgabe wird ein tatsächliches „&“ Zeichen. 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. Beispiel: Bindestriche („-“) müssen nicht URL-codiert werden. Eine Liste mit gängigen Zeichen, die URL-codiert werden müssen, erhalten 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>
  

  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. Diese Werte werden auf Ihrem Server verarbeitet. Die Werte, die Sie übergeben, sind jedoch auf die Liste der verfügbaren Variablen.

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