Um dein Hotelangebot auf Facebook zu bewerben, musst du Facebook Informationen zu deinen Hotels mitteilen. Hierfür erstellst du einen Hotelkatalog und trägst Hotels ein. Es gibt zwei Möglichkeiten, den Katalog zu füllen und aktuell zu halten:
Du kannst deine Hotelkataloge in deinem Commerce Manager erstellen und verwalten.
Wenn du zur Verwaltung deines Katalogs die API verwenden möchtest, führe folgende Schritte durch:
Ein Hotel-Feed ist eine Datei, die deine Hotelelemente enthält. Hierbei steht jede Zeile bzw. jedes Element in der Datei für ein Hotel. Du kannst einen oder mehrere Hotel-Feeds verwenden, solange alle Feeds gemeinsam alle Hotelelemente enthalten.
CSV-Beispiel | TSV-Beispiel (Flat File) | TSV-Beispiel (JSON-Stil)
"
doppelte Anführungszeichen"
gesetzt werden. address
, neighborhood
oder image
, können mithilfe von JSON-codierten Werten oder durch eine Gruppe reiner Textspalten im Flat-Format dargestellt werden, die mit der JSON-Pfadsyntax, wie z. B. address.city
, neighborhood[0]
, image[0].url
, image[0].tag[0]
oder image[0].tag[1]
, gekennzeichnet wurden. Du kannst beide Konventionen in einer Datei verwenden.<listings>
-XML-Stammknoten umfasst eine Gruppe von <listing>
-Knoten, von denen jeder für ein Hotel steht.<?xml
-Deklarations-Tag beginnen. Der Feed-Parser erkennt automatisch UTF8
-, UTF16
- oder UTF32
-Textkodierungen und verwendet standardmäßig LATIN1
, wenn eine unerwartete Byte-Sequenz erkannt wird. Du kannst Text in Feldwerten in jeder beliebigen Sprache angeben. Die Feldnamen müssen jedoch wie unten beschrieben auf Englisch angegeben werden.
Die folgenden unterstützten Felder sind für Elemente vorgesehen, die du deinem Produktkatalog hinzufügst.
Lokalisierte Kataloge findest du in den unterstützten Feldern für Hotel Ads.
Feld und Typ | Beschreibung |
---|---|
Typ: String | Erforderlich. Maximale Länge: 100 Deine eindeutige ID für das Hotel im Katalog. Diese ID wird mit den Beispiel: |
Typ: String | Erforderlich, wenn Hotelzimmerinformationen hinzugefügt werden. Gib eine eindeutige ID für die Art des Hotelzimmers ein. Max. Zeichenanzahl: 100 Beispiel: |
Typ: String | Erforderlich. Der gebräuchlichste Name des Hotels. Beispiel: |
Typ: String | Erforderlich. Max. Größe: 5.000 Kurze Beschreibung des Hotels. Beispiel: |
Typ: String | Erforderlich, wenn Hotelzimmerinformationen hinzugefügt werden. Anreisedatum für den Hotelaufenthalt. Du kannst einen Wert von bis zu 180 Tagen ab dem Datum angeben, an dem der Feed hochgeladen wird. Verwendet den ISO-8601-Standard ( Beispiel: |
Typ: String | Erforderlich, wenn Hotelzimmerinformationen hinzugefügt werden. Anzahl der Übernachtungen für den Hotelaufenthalt. Beispiel: |
Typ: String | Erforderlich, wenn Hotelzimmerinformationen hinzugefügt werden. Basispreis für das Hotelzimmer pro Übernachtung. Denke daran, den Währungstyp für den Preis hinzuzufügen (z. B. USD für US-Dollar). Formatiere den Preis als die Kosten gefolgt vom ISO-Währungscode mit einem Leerzeichen zwischen dem Betrag und der Währung. Beispiel: |
Typ: String | Erforderlich, wenn Hotelzimmerinformationen hinzugefügt werden. Gesamtpreis der Hotelübernachtung basierend auf Beispiel: |
Typ: String | Erforderlich, wenn Hotelzimmerinformationen hinzugefügt werden. Geltender Steuersatz für den Preis. Formatiere den Preis als die Kosten gefolgt vom ISO-Währungscode mit einem Leerzeichen zwischen dem Betrag und der Währung. Beispiel: |
Typ: String | Erforderlich, wenn Hotelzimmerinformationen hinzugefügt werden. Geltende Gebühren für den Preis. Formatiere den Preis als die Kosten gefolgt vom ISO-Währungscode mit einem Leerzeichen zwischen dem Betrag und der Währung. Beispiel: |
Typ: String | Erforderlich. Link zur externen Webseite, auf der ein Hotelzimmer gebucht werden kann. Mit Beispiel: |
Typ: Objekt | |
Typ: Objekt | |
Typ: String | Erforderlich. Markenname der Hotelkette. Beispiel: |
Typ: Objekt | |
Typ: String | Erforderlich. Max. zulässige Stadtteile: 20 Stadtteil, in dem sich das Hotel befindet. Wenn es mehr als einen Stadtteil gibt, kannst du für jeden weiteren eine zusätzliche Spalte hinzufügen und JSON-Pfadsyntax in jedem Spaltennamen verwenden, um die Anzahl der Stadtteile anzugeben. Beispiel: |
Typ: Gleitkommazahl | Erforderlich. Breitengrad des Hotels. Beispiel: |
Typ: Gleitkommazahl | Erforderlich. Längengrad des Hotels. Beispiel: |
Typ: String | Optional. Angebotspreis pro Nacht für die Hotelübernachtung basierend auf Beispiel: |
Typ: Objekt | |
Typ: Objekt | |
Typ: Gleitkommazahl | |
Typ: String | Optional. Das Treueprogramm, für das Gäste mit einer Übernachtung im Hotel Punkte sammeln. Beispiel: |
Typ: Ganzzahl | Optional. Indikator der Rentabilität des Hotels von 1 bis 10. Beispiel: |
Typ: String | Optional. Primäre Telefonnummer des Hotels. Beispiel: |
Typ: Objekt | Optional. Deep Link direkt zur Seite mit Hoteldetails in deiner mobilen App mithilfe von App-Links. Du kannst Deep Links in folgender Rangfolge angeben (von höchster zu niedrigster):
Erfahre mehr über Deep Links für Produkte. |
Typ: Ganzzahl | Optional. Ein Indikator für die Priorität des Hotels mit Werten von 0 (niedrigste Priorität) bis 5 (höchste Priorität). Beispiel: |
Typ: String | Optional. Art der Unterkunft. Die Kategorie kann eine interne Beschreibung beliebiger Art sein. Beispiel: |
Typ: Ganzzahl | Optional. Gesamtzahl der Zimmer/Einheiten, die dieses Hotel anbietet. Beispiel: |
Typ: String | Damit kontrollierst du, ob ein Artikel in deinem Katalog aktiv oder archiviert ist. Nur aktive Artikel werden unseren Nutzer*innen in deinen Werbeanzeigen, Shops oder auf anderen Kanälen angezeigt. Unterstützte Werte: Beispiel: Hinweis: Bei einigen Partner-Plattformen wie Shopify heißt der Status möglicherweise Staging, aber wenn dein Katalog synchronisiert wird, verhält sich dieser genauso wie Dieses Feld hieß zuvor |
Typ: String | Max. Zeichenanzahl: 100 Bis zu fünf selbstdefinierte Felder für zusätzliche Informationen, nach denen du Artikel filtern möchtest, wenn du Produktpaletten erstellst. Ein Beispiel: Mithilfe eines selbstdefinierten Feldes kannst du alle Zimmer kennzeichnen, die Teil einer Sommeraktion sind, und diese dann in eine Produktpalette filtern. Dieses Feld unterstützt die Angabe von Textwerten, einschließlich Zahlen. Beispiel: Dieses Feld wird von zusätzlichen Feeds unterstützt. |
Typ: Ganzzahl | Bis zu fünf selbstdefinierte Felder für zusätzliche zahlenspezifische Informationen, nach denen du Artikel filtern möchtest, wenn du Produktpaletten erstellst. Mit diesem Feld kannst du Nummernbereiche filtern (größer als und kleiner als), wenn du eine Produktpalette erstellst. Ein Beispiel: Mithilfe eines selbstdefinierten Feldes kannst du das Eröffnungsjahr eines Hotels angeben und dann einen bestimmten Jahresbereich in eine Produktpalette filtern. Dieses Feld unterstützt ganze Zahlen zwischen 0 und 4294967295. Negative Zahlen, Dezimalzahlen oder Kommawerte werden nicht unterstützt, z. B.: -2, 5.5 oder 10,000. Beispiel: |
Typ: String | Füge interne Labels hinzu, um beim Erstellen von Produktauswahlen nach Artikeln zu filtern. Beispiel: Mithilfe des selbstdefinierten Labels „summer“ (Sommer) könntest du alle Artikel kennzeichnen, die Teil einer Sommeraktion sind, und diese dann in eine Produktauswahl filtern. Labels sind nur für dich sichtbar. Jedes Label muss in einfachen Anführungszeichen (') stehen und mehrere Labels müssen durch Kommata (,) getrennt sein. Weder am Anfang noch am Ende darf es Leerräume bzw. überflüssige Leerzeichen geben. Zeichenlimit: bis zu 5.000 Labels pro Produkt und 110 Zeichen pro Label. Beispiel (TSV, XLSX, Google Sheets): ['summer','trending'] Beispiel (CSV): “['summer','trending']” Hinweis: Wenn du derzeit selbstdefinierte Labels ( Dieses Feld hieß zuvor |
Feldname und -typ | Beschreibung |
---|---|
Typ: String | Erforderlich. Maximale Anzahl: 20. URL-Link zum Bild, das in den Anzeigen zu sehen ist. Beachte die folgenden Spezifikationen für Bilder:
Beispiel: Beispiel: |
Typ: String | Optional. An das Bild angehängtes Tag, das den Bildinhalt zeigt. Du kannst mehrere Tags mit einem Bild verknüpfen. Beispiele:
|
Verschachtelte Felder oder Felder mit mehreren Werten, wie z. B. address
, können mithilfe von JSON-codierten Werten oder durch eine Gruppe reiner Textspalten im Flat-Format dargestellt werden, die mit der JSON-Pfadsyntax, wie z. B.address.region
, gekennzeichnet wurden. Du kannst beide Konventionen in einer Datei verwenden.
Feldname und -typ | Beschreibung |
---|---|
Typ: Objekt | Erforderlich. Primäre Straße und Hausnummer des Hotels. Beispiel: |
Typ: Objekt | Optional. Sekundäre Straße und Hausnummer des Hotels. Beispiel: |
Typ: Objekt | Optional. Tertiäre Straße und Hausnummer des Hotels. Beispiel: |
Typ: String | Optional. Wert, der in der Deep-Link-URL Beispiel: |
Typ: String | Erforderlich. Stadt, in der sich das Hotel befindet. Beispiel: |
Typ: String | Erforderlich. Bundesland, Kanton, Bundesstaat oder sonstige Region des Hotels. Beispiel: |
Typ: String | Erforderlich. Land, in dem sich das Hotel befindet. Beispiel: |
Typ: String | Erforderlich für Länder mit Postleitzahlen. Postleitzahl des Hotels. Beispiele: |
Feldname und -typ | Beschreibung |
---|---|
Typ: Objekt | Optional. Bewertung des Hotels. Wenn angegeben, musst du außerdem Beispiel: |
| Optional. Gesamtzahl der Personen, die dieses Hotel bewertet haben. Beispiel: |
Typ: String | Optional. System, das für Gästebewertungen verwendet wird. Beispiele: |
Typ: Ganzzahl | Erforderlich. Höchster Wert der Hotelbewertung. Muss größer oder gleich 0 sowie kleiner oder gleich 100 sein. Beispiel: |
Du kannst die Hotel API verwenden, um Hotels direkt zu deinem Katalog hinzuzufügen, sie zu bearbeiten oder zu entfernen. Weitere Informationen zur Verwaltung von Hotels mithilfe der API findest du in der Referenz zur Hotel API.
Die folgenden Abschnitte sind nur relevant, wenn du deine Kataloge mithilfe dieser API verwaltest.
Ein Hotelkatalog ist ein Container für deine Hotelelemente. Um die Catalog API zu verwenden, benötigst du die erforderlichen Marketing API-Zugriffsberechtigungen und musst die Nutzungsbedingungen akzeptieren, indem du deinen ersten Katalog über Business Manager erstellst.
Um einen Hotelkatalog für Hotel Ads zu erstellen, lege vertical
auf hotels
fest:
curl -X POST \ -F 'name="Test Hotel Catalog"' \ -F 'vertical="hotels"' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v10.0/BUSINESS_ID/owned_product_catalogs
Sobald du den Katalog erstellt hast, musst du deine Hotel-Feeds auf Facebook hochladen. Verwende die API, um ein Feed-Objekt für jeden Feed zu erstellen, den du hochladen möchtest. Wir unterstützen geplante und direkte Uploads.
Eine Hotelauswahl ist eine Untergruppe deines Katalogs. Um Hotel Ads einzurichten, benötigst du eine Hotelauswahl. Deshalb musst du mindestens eine erstellen.
Hotelauswahlen werden durch Filter definiert, die auf den Hotelkatalog angewendet werden. Du kannst beispielsweise eine Hotelauswahl mit allen Hotels erstellen, die eine star_rating
von mehr als 3 aufweisen. Hinweis: Du kannst auch eine Hotelauswahl ohne Filter erstellen. In diesem Fall enthält die Hotelauswahl alle Hotels deines Katalogs.
So erstellst du eine Hotelauswahl, die alle Hotels enthält, die die im brand
-Feld enthaltene Beispielmarke beinhalten:
curl -X POST \
-F 'name="Test Hotel Set"' \
-F 'filter={
"brand": {
"i_contains": "sample brand"
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<PRODUCT_CATALOG_ID>/product_sets
Der filter
-Parameter besteht aus folgenden Operatoren und Daten:
Operatoren | Filtertyp |
---|---|
| Enthält Substring. Beim Operator muss die Groß- und Kleinschreibung nicht beachtet werden. |
| Enthält keinen Substring. Beim Operator muss die Groß- und Kleinschreibung nicht beachtet werden. |
| Enthält Substring. Beim Operator muss die Groß- und Kleinschreibung nicht beachtet werden. |
| Enthält keinen Substring. Beim Operator muss die Groß- und Kleinschreibung nicht beachtet werden. |
| Gleich. Beim Operator muss die Groß- und Kleinschreibung nicht beachtet werden. |
| Ungleich. Beim Operator muss die Groß- und Kleinschreibung nicht beachtet werden. |
| Kleiner als. Nur für numerische Felder. |
| Kleiner oder gleich. Nur für numerische Felder. |
| Größer als. Nur für numerische Felder. |
| Größer oder gleich. Nur für numerische Felder. |
Daten | Daten, die gefiltert werden |
---|---|
| Deine eindeutige ID für das Hotel im Katalog. |
| Marke der Hotelkette. |
| Der Basispreis pro Nacht dieses Hotels. Der Preis wird in Cent angegeben (4999 entspricht 49,99 USD). |
| Übernachtungspreis für dieses Hotel. Der Preis wird in Cent angegeben (4999 entspricht 49,99 USD). |
| Währung |
| Stadt, in der sich das Hotel befindet. |
| Land des Hotels. |
| Der gebräuchlichste Name des Hotels. |
| Sternebewertung des Hotels. Gültige Werte reichen von 1 bis 5 (in Schritten von 0,5). |