Erstellen eines Angebotsseitenfeeds

Erstellen Sie ein XML-Dokument, das einen Pos (Point of Sale) für jede von Ihnen unterstützte Buchungswebsite enthält, um Bing Ihre Landing Pages-Daten bereitzustellen. Ein POS beschreibt den Anzeigenamen, die URL und die Kriterien für den Abgleich des Benutzers mit einem POS.

Das Dokument muss UTF-8-Codierung verwenden und der PointsOfSale-XSD entsprechen.

Das Element der obersten Ebene in Ihrem Feed

Der Feed landing pages enthält ein einzelnes PointsOfSale-Element der obersten Ebene. Das PointsOfSale -Element erfordert ein untergeordnetes PointOfSale-Element für jede Website, das Benutzer zum Buchen eines Raums verwenden können.

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <PointOfSale>
    . . .
  </PointOfSale>
  ...
</PointsOfSale>

Das PointOfSale -Element beschreibt den Anzeigenamen, die URL und die Kriterien für den Abgleich des Benutzers mit einem POS. Informationen zum Definieren eines POS finden Sie unter Definieren eines Point of Sale.

Definieren einer Verkaufsstelle

Das PointsOfSale Element enthält eine Liste von PointOfSale-Elementen , eine für jede POS-Website, die Benutzer zum Buchen von Räumen verwenden können. Die Liste muss Landing Pages für einen einzelnen Partner enthalten.

Im Folgenden werden Elemente gezeigt PointOfSale , die Landing Pages für englischsprachige Benutzer definieren. Das erste PointOfSale Element definiert einen POS für englischsprachige Endbenutzer auf einem beliebigen Gerät, und das zweite PointOfSale Element definiert einen POS für englischsprachige Endbenutzer auf mobilen Geräten. Die POS-URL enthält Details zur Transaktion, z. B. das Ein- und Auscheckdatum, die Hotel-ID und die Benutzersprache. Bing verwendet den Anzeigenamen und die POS-URL, um einen Link zu erstellen, der der Anzeige hinzugefügt wird. Wenn der Benutzer auf den Link klickt, wird er zur Buchungswebsite weitergeleitet. Wenn Sie Nachverfolgungsvorlagen für die Leistungsnachverfolgung verwenden, muss das LPURL-Element der Landing Page URL in der POS-Feeddatei konfiguriert werden, damit die Nachverfolgung funktioniert. Bing verwendet den Anzeigenamen und die POS-URL oder LPURL, um einen Link zu erstellen, der der Anzeige hinzugefügt wird. Wenn der Benutzer auf den Link klickt, wird er zur Buchungswebsite weitergeleitet.

  <PointOfSale id="English">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" />
    <URL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
    <LPURL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</LPURL>
  </PointOfSale>
  <PointOfSale id="English-Mobile">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" device="mobile" />
    <URL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
    <LPURL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</LPURL>
  </PointOfSale>

Schließen Sie das DisplayNames -Element nur für Online-Reisebüros ein. Schließen DisplayNames Sie nicht für Lieferanten des zentralen Reservierungssystems (CRS) (auch als Integrationspartner bezeichnet) und direkte Lieferanten (z. B. Hotelbesitzer oder Ketten) ein. Für CRS-Lieferanten und Direktlieferanten verwendet Bing den Namen des Hotels aus dem Eigenschaftenfeed.

Wenn Sie einschließen DisplayNames, müssen Sie ein Match Element einschließen, für das das Sprachkriterium auf dieselbe Sprache festgelegt ist.

Bing verwendet den POS, der dem Benutzer basierend auf den Abgleichskriterien des POS am besten entspricht. Basierend auf den oben genannten Abgleichskriterien verwenden Benutzer auf mobilen Geräten die English-Mobile POS, und alle anderen verwenden den englischen POS. Informationen dazu, wie Bing Benutzer mit einem POS abgleicht, finden Sie unter Übereinstimmende Angebotsseiten. Eine Liste der Kriterien, die Sie abgleichen können, finden Sie im Match-Element .

Das URL -Element gibt den Link zu der Website an, auf der der Benutzer den Raum buchen kann. Das Beispiel zeigt die Verwendung dynamischer Abfrageparameter. Bing ersetzt die dynamischen Variablen zur Laufzeit durch Werte. Informationen zur Verwendung dynamischer Abfrageparameter finden Sie unter Verwenden dynamischer Abfrageparameter.

Im Folgenden finden Sie ein vollständiges XML-Dokument für Zielseiten.

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <PointOfSale id="English">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" />
    <URL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
  </PointOfSale>
  <PointOfSale id="English-Mobile">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" device="mobile" />
    <URL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
  </PointOfSale>
</PointsOfSale>

Übereinstimmende Zielseiten

Zielseiten enthalten ein Match Element, das die Kriterien enthält, die Bing verwendet, um einen Benutzer einem POS zuzuordnen. Im Folgenden finden Sie das Kriterium, das Bing verwendet, um Benutzer mit Zielseiten abzugleichen. Die Liste ist in der bevorzugten Reihenfolge angeordnet.

• Land/Region
• Währung
• language
• Gerät
• sitetype

Bing verwendet die folgenden Regeln, um die beste POS-Übereinstimmung zu finden.

• Bing gibt länderspezifischen Übereinstimmungen die höchste Präferenz und die geringste Präferenz für Geräte-Übereinstimmungen.

• Wenn Match keins der Kriterien angibt, gleicht Bing implizit alle Werte für das Kriterium ab. Wenn Match beispielsweise Sprache und Währung angegeben werden, stimmt Bing implizit mit jedem Land und Gerät überein.

• Wenn Match ein oder mehrere Kriterien angibt, verwendet Bing den POS mit den explizitsten Übereinstimmungen.

• Wenn keine explizite Regelabgleichung vorhanden ist, ist die Auswahl von POS nicht deterministisch. Es wird empfohlen, eine explizite Regel für das Übereinstimmungskriterium hinzuzufügen.

Das Match status-Attribut des Elements bestimmt, ob der POS basierend auf dem Abgleich ein- oder ausgeschlossen werden soll. Wenn status nie ist und Bing alle Kriterien erfüllt, verwendet Bing den POS nicht. Um einen POS auszuschließen, müssen alle Kriterien übereinstimmen. Im folgenden Beispiel schließt Bing den POS explizit aus, wenn der Benutzer aus dem USA oder Frankreich stammt, und schließt ihn implizit ein, wenn der Benutzer aus einem anderen Land stammt.

<PointOfSale id='exclude-example'>
  . . .
  <Match status='never' country='US' />
  <Match status='never' country='FR' />
  . . .
</PointOfSale>

Wenn status ja ist, schließt Bing keine Landing Pages aus, die nicht explizit allen Kriterien entsprechen, aber der POS, der dem meisten Kriterium entspricht, wird bevorzugt. Im folgenden Beispiel ordnet Bing den Benutzer explizit dem POS zu, wenn das Land des Benutzers Frankreich ist. Wenn das Land des Benutzers nicht Frankreich ist, wird der POS weiterhin berücksichtigt, bis eine bessere Übereinstimmung gefunden wird. Wenn keine bessere Übereinstimmung gefunden wird, verwendet Bing den POS.

<PointOfSale id='exclude-example'>
  . . .
  <Match status='yes' country='FR' />
  . . .
</PointOfSale>

Bing empfiehlt, für jeden POS die gleichen Abgleichskriterien zu verwenden. Dies minimiert die Komplexität bei der Bestimmung, warum ein POS mit einem anderen übereinstimmt.

Verwenden dynamischer Abfrageparameter

Ein Point of Sale (POS) enthält ein URL Element, das die Website identifiziert, auf der Benutzer Räume buchen können. Die URL kann dynamische Abfrageparameter enthalten, bei denen es sich um benutzerdefinierte Parameter handelt, die ein vordefiniertes Token für ihren Wert enthalten. Bing ersetzt dann das Token durch einen Wert, bevor die URL zur Anzeige hinzugefügt wird. Mithilfe dynamischer Abfrageparameter können Sie die ID des Hotels, das Check-in-Datum, die Aufenthaltsdauer und vieles mehr in die URL aufnehmen.

Im Folgenden wird die Syntax veranschaulicht, die Sie verwenden, um dynamische Abfrageparameter in Ihrer POS-URL anzugeben. Da dynamische Abfrageparameter Abfrageparameter sind, müssen sie dem Fragezeichensymbol (?) in der URL folgen.

http://domain.com/path?param-name=(dynamic-variable-name)

Im Folgenden sind die namen dynamischen Variablen aufgeführt, bei denen die Groß-/Kleinschreibung beachtet wird, die Sie in der URL angeben können.

Alle Daten, z. B. CHECKINDAY, befinden sich in der Zeitzone des Hotels.

Im Folgenden finden Sie eine Beispiel-URL, die dynamische Abfrageparameter und codierte Entitäten enthält.

<URL>http://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)</URL>

Bevor Bing die URL in der Anzeige verwendet, werden werte durch die dynamischen Variablennamen ersetzt. Wenn der Benutzer beispielsweise einen Raum für 6 Nächte ab dem 07.06.2021 für Hotel Nr. 42 bucht, rendert Bing die URL wie folgt:

http://www.partnerdomain.com?hotelID=42&checkinDay=07&checkinMonth=05&checkinYear=2021&nights=6

Bing ruft Werte für die dynamischen Parameter aus Ihrem Preisfeed und Ihrem Eigenschaftenfeed sowie benutzerspezifische Einstellungen ab. Der Wert der LENGTH-Variablen stammt beispielsweise aus dem Nights Element im Preisfeed, und der Wert der Variablen PARTNER-HOTEL-ID stammt aus dem id -Element im Property-Feed.

Einige Variablen sind Teilmengen von Price-Feedelementen. Beispielsweise werden die Variablen CHECKINDAY, CHECKINMONTH und CHECKINYEAR aus dem Checkin -Element extrahiert. Andere Variablen werden basierend auf dem Gebietsschema des Benutzers und anderen Clienteinstellungen berechnet.

Allgemeine URL-Regeln

Im Folgenden sind allgemeine Regeln aufgeführt, die bei der Verwendung dynamischer Variablen befolgt werden müssen.

• Alle dynamischen Parameter sind optional. Sie müssen keine dynamischen Parameter in Ihre POS-URL einfügen. Die Verwendung von Variablen zum Übergeben von reiseverlaufs- und benutzerspezifischen Informationen führt jedoch im Allgemeinen zu einer besseren Erfahrung für den Endbenutzer.

• Schließen Sie dynamische Variablennamen mit offenen und schließenden Klammern ein.

• Verwenden Sie codierte Entitäten für Sonderzeichen. Ersetzen Sie z. B. amper-und-zeichen (&) durch &, space durch %20 und den Schrägstrich (/) durch %2F.

• Werte für einen einzelnen Parameter können aus mehreren Variablen erstellt werden. Beispielsweise können Sie den Wert eines checkinDate-Abfrageparameters aus den Variablen CHECKINDAY, CHECKINMONTH und CHECKINYEAR erstellen.

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

• Bei dynamischen Variablen, die Von Bing erkannt, aber nicht unterstützt werden, ersetzt Bing die Variablenzeichenfolge durch eine leere Zeichenfolge.

• Da dynamische Abfrageparameter Abfrageparameter sind, müssen sie dem Fragezeichensymbol (?) in der URL folgen.

Verwenden von bedingten Direktiven

Zusätzlich zu den oben aufgeführten Variablen können Sie auch die folgenden -Anweisungen verwenden, um bedingte Logik zu erstellen.

Die folgende URL legt beispielsweise den abfrageparameter popup_datepicker auf true fest, wenn der Benutzer Standarddaten verwendet hat, anstatt Datumsangaben anzugeben.

<URL>http://partner.com?hotelID=(PARTNER-HOTEL-ID)
&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)
&amp;nights=(LENGTH)(IF-DEFAULT-DATE)&amp;popup_datepicker=true(ELSE)
&amp;popup_datepicker=false(ENDIF)</URL>

Bei "true" rendert Bing die URL wie folgt:

http://partner.com?hotelID=123&checkinDay=01&checkinMonth=05&checkinYear=2021&nights=1&popup_datepicker=true

Andernfalls rendert Bing die URL wie folgt:

http://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2021&nights=2&popup_datepicker=false

Allgemeine Regeln

• Verwenden Sie pointsOfSale XSD, um Ihre Feeddatei für Landing Pages zu überprüfen, bevor Sie sie an Bing senden.

• Das Feeddokument landing pages muss UTF-8-Codierung verwenden.

• Der Feed muss Landing Pages für alle Websites enthalten, die Benutzer zum Buchen von Räumen verwenden. Der Feedprozess unterstützt keine Teilupdates.

• Bing ignoriert alle Elemente oder Attribute, die nicht unterstützt werden.

• Elemente müssen in der in PointsOfSale XSD angegebenen Reihenfolge angegeben sein.

• Wenn Ihre Daten Sonderzeichen wie Apostrophe oder Anführungszeichen enthalten, setzen Sie sie mit Escapezeichen, oder verwenden Sie CDATA-Abschnitte. Wenn Sie sie mit Escapezeichen versehen, können Sie Entitätscodes oder Zeichencodes verwenden. Du kannst z. B. Paulus als Paul&Apos entkommen; s oder Paul's.

• Schließen Sie keine Elemente ein, die keine Daten enthalten. Wenn Sie z. B. keinen Anzeigenamen für ein Hotel angeben, schließen Sie kein leeres <DisplayNames-Element> ein.

• Verwenden Sie keinen HTML-Code in Ihren XML-Elementen.

Nächste Schritte

Nachdem Sie Ihre Feeddatei erstellt haben, verwenden Sie die PointsOfSale-XSD , um sie zu überprüfen.

Bitten Sie Ihren Konto-Manager, die Feeddatei zu importieren.

Achten Sie darauf, dass Sie auch Ihre Hoteldaten importieren. Informationen zum Erstellen ihrer Eigenschaftenfeeddatei finden Sie unter Eigenschaftenfeed.

Nach dem erfolgreichen Importieren Ihres Landing Pages-Feeds und des Eigenschaftenfeeds können Sie damit beginnen, Ihre Hotelpreis- und Verfügbarkeitsdaten zu senden. Weitere Informationen finden Sie unter Preisfeeds.