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. Beispiel: können Sie Informationen wie Hotel-ID, Sprache, Währungscodes, und Check-in-Daten in der URL.

Ü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. Wenn Sie Ihren Landingpage-URLs dynamische Werte hinzufügen möchten, verwenden Sie die Methode folgende Syntax:

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

Das folgende Beispiel zeigt eine URL, die die Variablennamen von Google anstelle von tatsächliche Hotel-ID und Reiseplan:

<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, zeigt Google ersetzt die Variablen durch die tatsächlichen Werte, um sicherzustellen, dass die URL dynamische Informationen. Wenn der Nutzer z. B. ein Zimmer für 6 Nächte ab dem 23.05.2023 für Hotel Nr. 42, Google rendert den vorherigen Link wie folgt:

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. Ähnlich verhält es sich mit dem Wert von Die Variable PARTNER-HOTEL-ID wird im Element <id> der Hotelliste definiert Feed, der den Suchkriterien des Nutzers entspricht.

Einige Variablen sind Teilmengen der Preisfeed-Elemente. Beispiel: Der Parameter Die Variablen CHECKINDAY, CHECKINMONTH und CHECKINYEAR werden extrahiert aus dem einzelnes <Checkin>-Element im Preisfeed. Andere Variablen werden berechnet basierend auf dem Gebietsschema des Nutzers und anderen Client-Einstellungen.

Weitere Informationen zu den Quellen von Variablenwerten 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 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 iteriert. zur Anzahl der angegebenen Werte.

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 kostenlosen Buchungslink, der auf Ihre Landingpage weiterleitet.

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

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 ausgewählt hat ohne explizites Zimmerpaket. 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 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, lautet das Ergebnis: 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 einen Raum ausgewählt hat Gruppierung

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

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

Verwenden Sie die bedingte Anweisung IF-DEFAULT-DATE, um einen Parameter festzulegen, der kein Datum ist, kann Ihre Website dann benutzerdefiniertes Verhalten auslösen, wenn der Nutzer ein Datum.

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 die Nutzenden in diesem Beispiel kein Datum ausgewählt haben, könnte das Ergebnis ähnlich sein. an die folgende URL an, in der die Standarddatumsauswahl 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, könnte das Ergebnis der folgenden URL ähneln, je nach ausgewähltem Reiseplan:

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

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), Ergebnis ist die folgende URL:

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

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

Leere Kampagnen-IDs mit FBL-Klicks

Bei Klicks auf einen kostenlosen Buchungslink wird von IF-HOTEL-CAMPAIGN zurückgegeben, Die Werte für TRUE und CAMPAIGN-ID sind leer, wie in der folgenden URL gezeigt:

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

Mit der bedingten IF-AD-CLICK-Anweisung können Sie verhindern, dass die Kampagnen-ID leer ist: Beispiel:

<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 IF-PAYMENT-ID-Anweisung, um die URL danach zu variieren, ob der Klick das Ergebnis des PPS-Provisionsprogramms ist oder nicht. Das Beispiel unten überprüft, ob ein Klick vom PPS-Provisionsprogramm stammt, und weist dem den booking_source-Parameter basierend auf dem Ergebnis:

<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 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 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 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 folgende URL:

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ängiger Preis. Ist das der Fall, dann ist der Wert des <RateRuleID> im <Rate>-Block 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, lautet 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 bei einer Hotelkampagne in Google Ads Gebotsfaktoren für Zielgruppenlisten festlegen, Sie können IF-USER-LIST-ID zusammen mit USER-LIST-ID verwenden, um Parameter auf Ihrer Website für einen Kunden, der zu einem bestimmten Google Ads-Konto gehört, Zielgruppenliste hinzu. Sie können dies zu Tracking-Zwecken tun oder um Ihre für Nutzer von Zielgruppenlisten.

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

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 Testzwecke oder automatisch erstellt wurde 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 in diesem Beispiel nicht zum Testen oder Validieren generiert hat, das Ergebnis ist die folgende URL:

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

Wenn Google die URL zum Testen oder Validieren generiert hat, ist das Ergebnis das 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 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>

In diesem Beispiel: Wenn der Reiseplan 2 Erwachsene und 2 Kinder im Alter von 0 bis 17 Jahren umfasst. Das Ergebnis ist 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, lautet das Ergebnis: 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 gelten die folgenden allgemeinen Regeln: Seiten-Datei:

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

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

• Abfragezeichenfolge-Parameter müssen im Feld Endergebnis. Da das kaufmännische Und-Zeichen in XML ein Sonderzeichen ist und der Das Dateiformat für Landingpages ist XML. 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)&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 den Tags Landingpage-URL. Beispiel:

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

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

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

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