Erstellen einer XML-Hotelfeeddatei
Hinweis
Ab dem 9. April haben Sie keinen vollständigen Zugriff mehr auf das Hotel Center. Wir freuen uns darauf, Ihnen das Property Center vorstellen zu können, das spannende Self-Service-Funktionen bietet. Vielen Dank, dass Sie geduldig gewartet haben, während wir unsere Hilfeinhalte mit den neuen Features aktualisieren. In der Zwischenzeit können Sie sich über diese bevorstehenden Änderungen informieren und erfahren, wie Sie Ihren Migrationsprozess reibungsloser gestalten können.
Hinweis
Diese Betaversion von HotelPreisanzeigen ist nur für ausgewählte Teilnehmer verfügbar. Informationen zur Teilnahme am Beta-Release-Programm finden Sie bei Ihrem Account Manager, oder registrieren Sie sich hier.
Der Hotelfeed und die Dokumentation können geändert werden.
Um Microsoft Ihre Hotelauflistungen bereitzustellen, erstellen Sie ein XML-Dokument, das eine Auflistung jedes Hotels enthält, das Sie ankündigen möchten. Eine Auflistung beschreibt den Namen, die Adresse, die Telefonnummer, die geografischen Koordinaten, die Annehmlichkeiten und vieles mehr.
Das Dokument muss UTF-8-Codierung verwenden und der Hotel-XSD entsprechen.
Informationen zum Erstellen einer Feeddatei im CSV- oder TSV-Dateiformat finden Sie unter Erstellen einer CSV-Hotelfeeddatei.
Hinweis
Microsoft unterstützt nicht alle XSD-Elemente. Microsoft ignoriert alle Elemente oder Attribute im Dokument, die nicht unterstützt werden. Die Hotelfeedreferenz enthält nur die Elemente und Attribute, die Von Microsoft unterstützt werden.
Hinweis
Das Dokument muss die Elemente in der Reihenfolge angeben, die in der Hotel XSD definiert ist (und wie in der Referenz dargestellt).
Richtiges Abrufen der Daten
Da Microsoft versucht, Eigenschaften in Ihrem Hotelfeed mit Unternehmen in Bing Karten abzugleichen, ist es wichtig, dass die von Ihnen bereitgestellten Daten über das Hotel korrekt und vollständig sind.
Wenn ein Hotel über fehlende oder falsche Informationen verfügt, kann Microsoft diese möglicherweise nicht abgleichen. Wenn Microsoft dem Hotel nicht entsprechen kann, wird es von Microsoft nicht angekündigt. Sie können einen übereinstimmenden Bericht im Hotelcenter anzeigen, der angibt, welche Hotels mit Microsoft übereinstimmen oder nicht übereinstimmen. Wenn Microsoft das Hotel nicht gefunden hat, enthält der Bericht die Meldung Dieses Hotel kann nicht mit einer Eigenschaft in Bing verglichen werden. Um Ihre Übereinstimmungsrate zu verbessern, stellen Sie sicher, dass sie in Bing-Orten für Unternehmen verfügbar sind.
Das Element der obersten Ebene in Ihrem Feed
Der Hotelfeed enthält ein einzelnes Eintragselement der obersten Ebene. Das listings -Element enthält zwei erforderliche untergeordnete Elemente: language und listing.
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<language>en</language>
<listing>
. . .
</listing>
...
</listings>
Hinweis
Feeddaten werden derzeit nur in Englisch unterstützt.
Das language -Element gibt die Sprache an, in der die Daten im Feed geschrieben werden. Um die Sprache anzugeben, verwenden Sie den aus zwei Buchstaben bestehenden ISO 639-Sprachcode. Verwenden Sie z. B. en für Englisch.
Das Listing-Element enthält Informationen zum Hotel, z. B. Name, Adresse und Telefonnummer. Informationen zum Definieren eines Eintrags finden Sie unter Definieren eines Hoteleintrags.
Definieren eines Hoteleintrags
Das listing -Element definiert ein Hotel. Sie müssen ein listing -Element für jedes Hotel angeben, das Sie ankündigen. Das folgende Beispiel zeigt die Mindestelemente, die Sie für eine Auflistung angeben müssen. Die Ausnahme besteht darin, dass Sie entweder die geografischen Koordinaten oder eine Telefonnummer angeben können. Obwohl Sie entweder die Koordinaten oder die Telefonnummer angeben können, sollten Sie beide angeben, um eine bessere Wahrscheinlichkeit zu gewährleisten, dass Eigenschaften in Bing Karten übereinstimmen.
<listing>
<id>abc123</id>
<name>Great Ambers Getaway</name>
<address>
<component name="addr1">1234 Porter Road</component>
<component name="city">Goldendale</component>
<component name="province">WA</component>
<component name="postal_code">98234</component>
</address>
<country>US</country>
<latitude>47.694351</latitude>
<longitude>-122.451782</longitude>
<phone type="main">123-456-7890</phone>
</listing>
Die ID im id -Element ist benutzerdefinierter Und muss innerhalb des Feeds eindeutig sein.
Die Adresse im address Element ist die Adresse des Hotels. Bei der Adresse muss es sich um eine Straßenadresse und nicht um einen Briefkasten handeln. Sie können die Adresse des Hotels mithilfe des component Elements angeben, das im obigen Beispiel zu sehen ist, oder mithilfe einer Freiformzeichenfolge aus dem folgenden Beispiel. Die Präferenz besteht darin, Elemente zu verwenden component .
<address>1234 Porter Road, Goldendale, WA, 98234</address>
Das latitude -Element und longitude das -Element geben die geografischen Koordinaten des Hotels an. Verwenden Sie eine Geocodierungs-API wie die Standort-API , um die Koordinaten aus einer Straßenadresse zu generieren.
In der Auflistung muss mindestens die Standard Telefonnummer des Hotels angegeben werden. Die Standard Nummer sollte die Telefonnummer der Rezeption und nicht eine zentrale Reservierungstelefonnummer sein. Je mehr Kontakttelefonnummern Sie angeben, desto besser. Das folgende Beispiel zeigt die anderen Telefonoptionen.
<phone type="main">123-456-7890</phone>
<phone type="tollfree">800-456-7890</phone>
<phone type="fax">123-456-7890</phone>
<phone type="tdd">123-456-7890</phone>
<phone type="mobile">123-456-7890</phone>
Weitere Informationen zum Angeben von Telefonnummern finden Sie im Phone-Element .
Angeben optionaler Felder für Hotelauflistung
Das folgende Beispiel zeigt die optionalen Elemente, die Sie in die Auflistung einschließen können. Obwohl sie optional sind, sollten Sie so viele Informationen wie möglich zur Unterstützung aktueller und zukünftiger Verwendungsszenarien hinzufügen.
<listing>
. . .
<category>hotel | inn</category>
<content>
<text type="description">
<body>This element contains the hotel's description.</body>
</text>
<review type="user">
<body>This element contains a review of the hotel.</body>
<date month="2" day="24" year="2018" />
<link>https://contoso.com/reviews/hotels?id=sd87s90</link>
<rating>8.5</rating>
</review>
<attributes>
<website>https://contoso.com</website>
<attr name="air_conditioned">Yes</attr>
<attr name="has_airport_shuttle">Yes</attr>
<attr name="parking_type">No payment required</attr>
</attributes>
<image type="photo" url="https://contoso.com/photos?id=345k43llj" width=800 height=600>
<date month="3" day="3" year="2018" />
<link>https://contoso.com/...</link>
<title>Hotel entrance</title>
</image>
<neighborhoods>
<neighborhood>Sodo District</neighborhood>
</neighborhoods>
<brand>Contoso</brand>
</content>
</listing>
Das category erwartete Elementformat ist vacation_rental oder Hotel gefolgt vom Pipezeichen und einem benutzerdefinierten Wert. Beispiel : vacation_rental | 'Benutzerdefinierter Wert' oder Hotel | "Benutzerdefinierter Wert"
Eine Liste der benutzerdefinierten Werte finden Sie unter Unterkunftseigenschaftenkategorien.
Das text -Element enthält eine Beschreibung des Hotels. Sie müssen das body -Element angeben, das die tatsächliche Beschreibung enthält. Abhängig von der Länge der Beschreibung kann sie abgeschnitten werden, wenn sie angezeigt wird. Wenn Sie die link Elemente und title einschließen, verweist die Link-URL online auf die Beschreibung.
Das review -Element enthält entweder eine Benutzerüberprüfung oder eine redaktionelle Überprüfung. Eine redaktionelle Rezension ist eine professionelle Bewertung, die von einer Überprüfungsbehörde wie einem Reiseblogger durchgeführt wird. Sie können eine beliebige Anzahl von Bewertungen einschließen, aber je nach Anzahl der gesendeten Bewertungen werden möglicherweise nicht alle angezeigt. Sie müssen das body -Element angeben, das die Überprüfung enthält. Abhängig von der Länge der Überprüfung kann sie abgeschnitten werden, wenn sie angezeigt wird. Wenn Sie das link -Element einschließen, verweist es auf die vollständige Liste der Onlinebewertungen.
Das attributes Element enthält eine Liste der Annehmlichkeiten, die das Hotel bietet, wie klimaanlage, ein Schwimmbad und ein kostenloses Frühstück. Eine Liste der möglichen Annehmlichkeiten finden Sie unter Attribut. Wenn Sie keine Amenity angeben, wird davon ausgegangen, dass das Hotel sie nicht bereitstellt.
Das image -Element enthält ein Bild des Hotels. Sie können eine beliebige Anzahl von Bildern einschließen, aber abhängig von der Anzahl der gesendeten Bilder werden möglicherweise nicht alle angezeigt. Die empfohlene Seitenration ist 4:3 und die Mindestbreite beträgt 720 Pixel. Bilder müssen Originalfotos sein und dürfen keine Screenshots sein. Beachten Sie, dass der link AdIdxBot-Crawler auf die URL zugreifen muss. Wenn Ihre Website die robots.txt-Datei enthält, muss sie eine der folgenden Optionen enthalten:
- Benutzer-Agent: AdIdxBot
- Ermöglichen:/
Das neighborhood -Element identifiziert die Nachbarschaft, in der sich das Hotel befindet. Sie können mehrere Viertel angeben, wenn sich das Hotel zentral zwischen mehreren Vierteln befindet.
Das brand -Element identifiziert die Marke des Hotels. Beispiel: Fabrikam Residences by Contoso, wobei Contoso die Marke ist.
Was geschieht, wenn sich der Inhalt des Hotels ändert?
Wenn Sie die Eigenschaftswerte des Hotels zwischen Feedläufen ändern (z. B. Name, Adresse, Telefon usw.), kann Microsoft Advertising es als neue Hoteleigenschaft behandeln und einen neuen Eintrag dafür erstellen. Wenn Microsoft einen neuen Eintrag erstellt, bleibt der bisherige Leistungsverlauf für das alte Hotel bis zu 36 Monate verfügbar. Beachten Sie, dass die Gebote und Multiplikatoren des alten Hotels nicht an die neue Hoteleinheit übertragen werden.
Wenn Sie ein Hotel entfernen und es einem späteren Feed mit den gleichen Eigenschaftswerten wie zuvor hinzufügen, behandelt Microsoft es als neuen Eintrag. Außerdem wird der Leistungsbericht als zwei separate Auflistungen angezeigt.
Allgemeine Regeln
Verwenden Sie die Hotel-XSD, um Ihre Hotelfeeddatei zu überprüfen, bevor Sie sie an Microsoft senden.
Das Hotelfeeddokument muss UTF-8-Codierung verwenden.
Der Feed muss Einträge für alle Ihre Hotels enthalten. Der Feedprozess unterstützt keine Teilaktualisierungen.
Microsoft ignoriert alle Elemente oder Attribute, die nicht unterstützt werden.
Die Elemente müssen in der im Hotel 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 beispielsweise die geografischen Koordinaten für ein Hotel nicht angeben, schließen Sie keine leeren <Breiten-> und <Längengradelemente> ein.
Verwenden Sie keinen HTML-Code in Ihren XML-Elementen.
Nächste Schritte
Nachdem Sie Ihre Feeddatei erstellt haben, verwenden Sie die Hotel-XSD , um sie zu überprüfen.
Bitten Sie Ihren Konto-Manager, die Feeddatei zu importieren.
Achten Sie darauf, auch Ihre Point of Sale-Daten zu importieren. Informationen zum Erstellen ihrer Feeddatei für Verkaufspunkte finden Sie unter Point of Sale Feed.
Nachdem Microsoft Ihre Daten erfolgreich importiert hat und Ihre Hotels mit Eigenschaften in Bing Karten abgleichen kann, können Sie damit beginnen, Ihre Hotelpreis- und Verfügbarkeitsdaten zu senden. Weitere Informationen finden Sie unter Transaktionsnachrichten.