Erstellen einer CSV-Hotelfeeddatei

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 eine CSV-Datei, die eine Auflistung jedes Hotels enthält, das Sie ankündigen möchten. Ein Eintrag beschreibt den Namen, die Adresse, die Telefonnummer und die geografischen Koordinaten des Hotels.

Informationen zum Erstellen einer Feeddatei mithilfe eines XML-Dokuments finden Sie unter Erstellen einer XML-Hotelfeeddatei.

Hinweis

Der Hotelfeed unterstützt nur englisch.

Das CSV-Format unterstützt keine Bilder. Verwenden Sie stattdessen das XML-Format.

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 Ihr Hotel über fehlende oder falsche Informationen verfügt, ist Microsoft möglicherweise nicht in der Lage, diese zu finden. Wenn Microsoft dem Hotel nicht entsprechen kann, wird es von Microsoft nicht angekündigt. Nachdem Ihr TAM Ihre Hotelfeeddatei importiert hat, sendet es Ihnen einen Bericht, 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, arbeiten Sie mit Ihrem TAM zusammen.

Definieren eines Hoteleintrags

Die erste Zeile der Feeddatei ist die Kopfzeile, die die Spaltennamen der Hoteldaten im Feed enthält. Der Header muss die Spaltennamen aller erforderlichen Datenelemente enthalten. Schließen Sie nur die Namen optionaler Spalten ein, wenn Sie Daten für diese angeben.

Im Folgenden sehen Sie die Liste der Spalten, die Sie in den Feed einschließen können. Die Feeddatei kann die Spalten in beliebiger Reihenfolge enthalten, und bei den Spaltennamen wird die Groß-/Kleinschreibung nicht beachtet.

Spaltenname	Beschreibung	Datentyp	Erforderlich
id	Eine undurchsichtige, benutzerdefinierte ID, die das Hotel innerhalb des Feeds eindeutig identifiziert. Wenn Sie Ihre Transaktionsnachricht erstellen, verwenden Sie diese ID im Property Element Ihrer Transaktionsnachricht, um das Hotel zu identifizieren.	Zeichenfolge	Ja
name	Der Name des Hotels. Der Name darf maximal 200 Zeichen enthalten.	Zeichenfolge	Ja
address	Die Adresse des Hotels mit Freihandtext. Trennen Sie jede Komponente der Adresse durch ein Komma, und schließen Sie die Adresse in Anführungszeichen ein. Beispiel: "1234 Billings Way, Redmond, WA, 98030". Verwenden Sie diese Spalte nur, wenn Sie die Adresse in Freiformtext angeben. Verwenden Sie andernfalls die Adresskomponentenspalten wie addr1, city und province. Es wird empfohlen, die Adresskomponentenspalten anstelle von Freiformtext zu verwenden.	Zeichenfolge	Ja
addr1	Die Adresse des Hotels. Beispiel: 1234 Billings Way. Bei der Adresse muss es sich um eine physische Adresse und nicht um ein Postfach oder eine andere reine Postanschrift handeln.	Zeichenfolge	Ja
addr2	Zweite Adresse.	Zeichenfolge	Nein
addr3	Dritte Adresse.	Zeichenfolge	Nein
Ort	Der Name der Stadt, in der sich das Hotel befindet.	Zeichenfolge	Ja
Provinz	Der Name des Bundeslandes, der Region oder der Provinz, in dem sich das Hotel befindet.	Zeichenfolge	Ja
postal_code	Die Postleitzahl der Adresse.	Zeichenfolge	Ja
Land/Region	Das Land oder die Region, in dem sich das Hotel befindet. Geben Sie das Land oder die Region mit dem aus zwei Buchstaben bestehenden ISO 3116-Ländercode an. Verwenden Sie beispielsweise USA für USA.	Zeichenfolge	Ja
latitude	Der Breitengrad der geografischen Koordinaten des Hotels. Hinweise: Die Breiten- und Längengrade sind nur erforderlich, wenn Sie nicht angeben phone. Es wird empfohlen, sowohl die Telefon- als auch die geografischen Koordinaten anzugeben. Der Breitengrad muss im Bereich -90,0 bis 90,0 liegen. Verwenden Sie die Standort-API oder ein anderes Geocodierungstool, um die Koordinaten aus einer Straßenadresse zu generieren.	Dezimal	Nein
longitude	Der Längengrad der geografischen Koordinaten des Hotels. Hinweise: Die Breiten- und Längengrade sind nur erforderlich, wenn Sie nicht angeben phone. Es wird empfohlen, sowohl die Telefon- als auch die geografischen Koordinaten anzugeben. Der Längengrad muss zwischen -180,0 und 180,0 liegen. Verwenden Sie die Standort-API oder ein anderes Geocodierungstool, um die Koordinaten aus einer Straßenadresse zu generieren.	Dezimal	Nein
phone	Die Standard Sprachtelefonnummer, die Kunden verwenden, um das Hotel zu kontaktieren. Die Nummer sollte die Telefonnummer der Rezeption und keine zentrale Reservierungstelefonnummer sein. Hinweise: Verwenden Sie Bindestriche, Leerzeichen oder Klammern in der Telefonnummer, um die Lesbarkeit zu erleichtern. Verwenden Sie beispielsweise "610-222-3333" oder "(610) 222-3333" anstelle von "6102223333". Geben Sie nur eine Telefonnummer an. geben Sie nicht mehrere Zahlen an, z. B. 650-123-2222/33. Die Telefonnummer kann eine Durchwahl von bis zu 7 Ziffern enthalten. Voranstellen von Erweiterungen mit einer der folgenden Abkürzungen: "ext", "extn" und "x". Beispiel: "408-555-1111x12345" oder "408-555-1111 x12345". Die Telefonnummer darf keine alphabetischen Zeichen enthalten. Wenn die Telefonnummer die Landesvorwahl enthält, geben Sie ihr ein "+" voran. Beispiel: "+65 6722-2323" für eine Zahl in Singapur, bei der der Ländercode 65 ist, oder "+001 (408) 555-1111" für eine Zahl im USA, bei der der Ländercode 001 ist.	Zeichenfolge	Ja
category	Eine Kategorie, die den Hoteltyp angibt. Das erwartete Format 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.	Zeichenfolge	Nein
hotel_brand	Die Marke der Hotelkette. Beispiel: Fabrikam Residences by Contoso, wobei Contoso die Marke ist.	Zeichenfolge	Nein
star_rating	Die star Bewertung des Hotels. Mögliche Werte sind 1 bis 5.	Zeichenfolge	Nein

Hinweis

Die address Spalte und die addrSpalten , addr2, addr3, city, provinceund postal_code schließen sich gegenseitig aus. Geben Sie entweder die address Spalten oder die Adresskomponentenspalten an. Die Angabe der Adresskomponentenspalten wird bevorzugt.

Obwohl Sie entweder geografische Koordinaten oder eine Telefonnummer angeben können, sollten Sie beide angeben, um eine bessere Wahrscheinlichkeit zu gewährleisten, dass Eigenschaften in Bing Karten übereinstimmen.

Um eine Beschreibung, Bilder und Rezensionen für eine Auflistung einzuschließen, verwenden Sie eine XML-Feeddatei. Weitere Informationen finden Sie unter Erstellen einer XML-Hotelfeeddatei.

Im Folgenden sehen Sie einen Beispielheader im CSV-Format. Trennen Sie alle Spalten durch ein Komma. Schließen Sie nur Spalten ein, die Werte für mindestens ein Hotel enthalten.

id,name,addr1,city,province,postal_code,country,phone

Fügen Sie nach der Kopfzeile eine Zeile für jedes Hotel ein, das Sie ankündigen. Der Feed muss Einträge für alle Ihre Hotels enthalten. Der Feedprozess unterstützt keine Teilaktualisierungen. Schließen Sie keine leeren Zeilen in Ihren Feed ein.

Wenn ein Wert ein Komma enthält, müssen Sie den Wert in Anführungszeichen einschließen. Im Folgenden wird der Inhalt einer CSV-Beispieldatei veranschaulicht.

id,name,addr1,city,province,postal_code,country,latitude,longitude,phone
abc123,Great Ambers Getaway,1234 Porter Rd,Goldendale,WA,98234,US,47.694351,-122.451782,123-456-7890

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.

Nächste Schritte

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.