Hotel Ads – Datumsgebundene Preisgestaltung

In einem statischen Hotel-Feed bietest du einen einzigen Preis für jedes Hotel. Du kannst keine unterschiedlichen Preise basierend auf Check-In-Datum, Länge des Aufenthalts oder Zimmertyp anbieten. Um in deinen Anzeigen detailliertere Preise basierend auf diesen Variablen anzuzeigen, kannst du die dynamische (datumsgebundene) Preisgestaltung verwenden und Preise für verschiedene Daten, Zimmertypen und Aufenthaltslängen bereitzustellen. Sobald du sie einmal bereitgestellt hast, kannst du Hotelvorlagen-Tags verwenden, um diese Preise in deinen Anzeigen anzuwenden.

Verwende die Option Batch-Upload für Zimmertypen und Preisgestaltungsdaten, um Preisgestaltungsinformationen für Facebook freizugeben.

Eine Erklärung aller Parameter findest du unter Parameter für Zimmer und Preisgestaltung.

Batch-Upload für Zimmertypen und Preisgestaltungsdaten

Der Batch-Upload besteht aus zwei Teilen:

Zimmertypen hochladen
Preise hochladen

Wenn du den Batch-Upload verwendest, beschränke den Upload auf 50 MB pro Datei und ca. 50.000 Elemente pro Datei. Wir empfehlen häufigere, kleinere Updates für Preisgestaltungsvariablen.

Zimmertypen hochladen

Lade eine oder mehrere Datei(en) mit Zimmertypen hoch und verwende dabei die Hotel Rooms Batch API.

Hinweis: Wenn du keine unterschiedlichen Zimmertypen hast, kannst du diesen Schritt überspringen.

curl \
  -X POST \
  -F file=@hotel_rooms_data_xml.xml \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/hotel_rooms_batch

Format der Zimmertypendatei

Du kannst Zimmertypen im XML-Format bereitstellen, siehe Beispiel.

Du musst die einzelnen Hotels anhand von <property> im <PropertyDataSet>-XML-Node identifizieren und den Zimmertyp über <RoomData> angeben. Deine Datei muss mit dem Deklarations-Tag <?xml beginnen.

Weitere Informationen zum Aktualisieren und Löschen von Zimmertypen über die Batch API findest du unter Hotelzimmer, Batch-Referenz.

Preise hochladen

Lade eine oder mehrere Datei(en) mit Preisgestaltungsdetails hoch und verwende dabei die Pricing Variable Batch API. Du kannst Preisgestaltungsdetails mit oder ohne Zimmertypen hochladen.

Hinweis: Wenn du über sehr wenige Zimmer verfügst, kannst du zum Erstellen von Zimmertypen und Festlegen von Preisen auch die Hotel Room API verwenden.

curl \
  -X POST \
  -F file=@pricings_data_xml.xml \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/pricing_variables_batch

Format der Preisgestaltungsdatei

Bevor du Zimmertypen hochlädst, stelle sicher, dass die Hotels für diese Zimmer bereits im Katalog vorhanden sind. Du kannst Preisgestaltungsvariablen im folgenden Format bereitstellen:

Dateiformat und -beispiel Beschreibung

Dateiformat und -beispiel	Beschreibung
XML-Datei mit Zimmertypen \| XML-Beispiel	Vergewissere dich, dass die Zimmertypen, für die du Preise angeben möchtest, bereits vorhanden sind. Lege Preise (`<Baserate>`) für jeden Zimmertypen fest (`<RoomBundle>`), die auf deine Kombination aus Check-In-Datum (`<Checkin>`) und der Länge des Aufenthalts (`<Nights>`) basieren. Die Datei muss mit dem Deklarations-Tag `<?xml` beginnen.
XML-Datei ohne Zimmertypen \| XML-Beispiel	Lege Preise (`<Baserate>`) für jede Kombination aus Hotel-ID (`<Property>`), Check-In-Datum (`<Checkin>`) und Länge des Aufenthalts (`<Nights>`) fest. Die Datei muss mit dem Deklarations-Tag `<?xml` beginnen.

XML-Datei mit Zimmertypen | XML-Beispiel

Vergewissere dich, dass die Zimmertypen, für die du Preise angeben möchtest, bereits vorhanden sind.

Lege Preise (<Baserate>) für jeden Zimmertypen fest (<RoomBundle>), die auf deine Kombination aus Check-In-Datum (<Checkin>) und der Länge des Aufenthalts (<Nights>) basieren.

Die Datei muss mit dem Deklarations-Tag <?xml beginnen.

XML-Datei ohne Zimmertypen | XML-Beispiel

Lege Preise (<Baserate>) für jede Kombination aus Hotel-ID (<Property>), Check-In-Datum (<Checkin>) und Länge des Aufenthalts (<Nights>) fest.

Die Datei muss mit dem Deklarations-Tag <?xml beginnen.

Weitere Informationen zum Aktualisieren und Löschen von Preisgestaltungsvariablen im Stapel findest du unter Preisgestaltungsvariable, Batch-Referenz

Parameter für Zimmer und Preise

Feldname und -typ Beschreibung

Feldname und -typ	Beschreibung
`Property` Typ: String	Erforderlich. Eine eindeutige Kennung des Hotels, die vom Werbetreibenden als `hotel_id` im Hotel-Feed bereitgestellt wird.
`RoomID` Typ: String	Erforderlich. Eine eindeutige Kennung des Zimmertyps, die vom Werbetreibenden bereitgestellt wird.
`Name` Typ: String	Erforderlich. Name des Zimmertyps.
`Description` Typ: String	Erforderlich. Beschreibung des Zimmertyps.
`BasePrice` Typ: Float	Erforderlich. Der niedrigste Preis des Hotelzimmers. Gib außerdem die Währung an. Beispiel: `159 USD`
`URL` Typ: String	Link zur Hotelzimmerseite.
`CheckinDate` Typ: Datum	Erforderlich. Anreisedatum für den `price`. Ab dem Upload-Datum des Feeds wird ein Zeitraum von bis zu 180 Tagen unterstützt. Verwende den Standard ISO 8601 (JJJJ-MM-TT)
`Nights` Typ: Ganzzahl	Erforderlich. Anzahl der Übernachtungen im Hotel für den `price`. Maximaler Wert: 14
`Baserate` Typ: Float	Erforderlich. Preis basierend auf `checkin_date` und `length_of_stay`. Beispiel: `180`
`Tax` Typ: Float	Erforderlich. Steuerwert für den Aufenthalt.
`OtherFees` Typ: Float	Erforderlich. Anfallende Gebühren für den Aufenthalt.
`SalePrice` Typ: Float	Der ermäßigte Preis (sofern verfügbar). Beispiel: `159`
`SalePriceTax` Typ: Float	Der Steuerwert des ermäßigten Preises.

Property

Typ: String

Erforderlich. Eine eindeutige Kennung des Hotels, die vom Werbetreibenden als hotel_id im Hotel-Feed bereitgestellt wird.

RoomID

Typ: String

Erforderlich. Eine eindeutige Kennung des Zimmertyps, die vom Werbetreibenden bereitgestellt wird.

Name

Typ: String

Erforderlich. Name des Zimmertyps.

Description

Typ: String

Erforderlich. Beschreibung des Zimmertyps.

BasePrice

Typ: Float

Erforderlich. Der niedrigste Preis des Hotelzimmers. Gib außerdem die Währung an.

Beispiel: 159 USD

URL

Typ: String

Link zur Hotelzimmerseite.

CheckinDate

Typ: Datum

Erforderlich. Anreisedatum für den price. Ab dem Upload-Datum des Feeds wird ein Zeitraum von bis zu 180 Tagen unterstützt. Verwende den Standard ISO 8601 (JJJJ-MM-TT)

Nights

Typ: Ganzzahl

Erforderlich. Anzahl der Übernachtungen im Hotel für den price. Maximaler Wert: 14

Baserate

Typ: Float

Erforderlich. Preis basierend auf checkin_date und length_of_stay.

Beispiel: 180

Tax

Typ: Float

Erforderlich. Steuerwert für den Aufenthalt.

OtherFees

Typ: Float

Erforderlich. Anfallende Gebühren für den Aufenthalt.

SalePrice

Typ: Float

Der ermäßigte Preis (sofern verfügbar).

Beispiel: 159

SalePriceTax

Typ: Float

Der Steuerwert des ermäßigten Preises.