Für die gewerbliche Veröffentlichung von Immobilieninseraten muss dein Unternehmen verifiziert sein.
Schritt 1: Erstelle einen Katalog mit Immobilieninseraten.
Schritt 2: Richte Inserate und Preisgestaltung ein.
Schritt 3: Aktualisiere Optionen.
Schritt 4: Filtere den Inseratskatalog für das eingerichtete Inserat.
Schritt 5: Sende Offline-Konversionen (optional)
Schritt 6: Erstelle deine Zielgruppe für Immobilien. Anders als bei Immobilienanzeigen, die von Nutzern veröffentlicht werden, werden für Partner-Integrationen Leads über das Lead-Formular anstatt über den Messenger-Chat gesendet. Erfahre mehr über das Abrufen von Leads für den Handel.
Schritt 7: Erstelle Werbeanzeigen für deine Immobilienanzeigen und liefere sie aus.
Schritt 8: Erhalte Auslieferungsinformationen, um die Interaktion mit deinen Anzeigen auf Facebook zu sehen. Siehe Werbeanzeigen-Insights.
Schritt 9: Verwende Debugging-Tools, um Probleme zu diagnostizieren und zu beheben. Siehe Debugging-Tools für Advantage+ Catalog Ads.
Dein Katalog muss eine Liste mit Eigenschaften enthalten, die du bewerben möchtest. Siehe Katalogreferenz.
Lege für die Erstellung eines Katalogs für Immobilieninserate für Advantage+ Catalog Ads für vertical
home_listings
fest:
curl \
-F 'name=Home Listing Catalog Name' \
-F 'vertical=home_listings' \
-F 'access_token=<ACCESS TOKEN>' \
https://graph.facebook.com/<API_VERSION>
Um die Katalog-API verwenden zu können, benötigst du Marketing API-Zugriffsstufe und musst die Nutzungsbedingungen akzeptieren, indem du deinen ersten Katalog mit dem Business Manager erstellst.
Anleitungen zur Erstellung eines Katalogs für den Handel findest du in der Marketplace-Plattform-Dokumentation.
Dein Inserat enthält Informationen zu Immobilien, wie z. B. Inserats-ID, Name, Verfügbarkeit, Beschreibung, Adresse, Schlafzimmer, Badezimmer usw. Du kannst über einen Satz Inserate verfügen, die von deinem Unternehmen hochgeladen oder abgerufen wurden. Ein Inseratsobjekt ist eine einzelne Immobilie, die auf deiner Webseite oder in deiner App aufgeführt ist.
Du kannst einen einzelnen Feed für alle Immobilien in deinem Katalog verwenden. Du kannst jedoch auch mehrere Feeds verwenden, die beispielsweise Immobilien in einem bestimmten Land, für eine bestimmte Immobilienfirma oder einen bestimmten Makler darstellen.
Für Advantage+ Catalog Ads musst du den Inserat-Feed ein einem der folgenden Formate bereitstellen:
Datei-Format | Beschreibung | Beispieldatei |
---|---|---|
XML | Wird in der Regel durch automatisierte Feed-Anbietersysteme generiert. Ein | |
CSV, TSV | Die erste Zeile muss die gewählten Feldnamen in der Reihenfolge aufführen, in der die Werte angegeben sind. In den nachfolgenden Zeilen stehen die entsprechenden Werte für jedes Immobilieninserat. Verschachtelte Felder oder Felder mit mehreren Werten, wie z. B. 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. | Herunterladen (CSV) |
Für Handel: Du musst das Inserats-Feed im XML-Format bereitstellen:
Datei-Format | Beschreibung |
---|---|
XML | Wird in der Regel durch automatisierte Feed-Anbietersysteme generiert. Ein |
CSV, TSV, JSON | Diese Formate werden derzeit nicht unterstützt. |
Unser Feed-Parser erkennt UTF8
-, UTF16
- oder UTF32
-Textcodierungen automatisch, wobei standardmäßig LATIN1
angenommen wird, wenn eine unerwartete Bytesequenz auftritt.
<?xml version="1.0" encoding="UTF-8"?> <listings> <title>example.com Feed</title> <link rel="self" href="http://www.example.com"/> <listing> <home_listing_id>12345678</home_listing_id> <name>1 Hacker Way, Menlo Park, CA 94025</name> <availability>for_rent</availability> <description>An amazing listing</description> <address format="simple"> <component name="addr1">1 Hacker Way</component> <component name="city">Menlo Park</component> <component name="region">California</component> <component name="country">United States</component> <component name="postal_code">94025</component> </address> <latitude>1.11414</latitude> <longitude>-1.835003</longitude> <neighborhood>Menlo Oaks</neighborhood> <image> <url>http://example.com/12345678-1.jpg</url> </image> <image> <url>http://example.com/12345678-2.jpg</url> </image> <image> <url>http://example.com/12345678-3.jpg</url> </image> <listing_type>for_rent_by_agent</listing_type> <num_baths>6</num_baths> <num_beds>5</num_beds> <num_units>1</num_units> <price>110000 USD</price> <property_type>house</property_type> <url>http://www.example.com/link_to_listing</url> <year_built>2007</year_built> </listing> </listings>
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 Immobilienanzeigen.
Unser Feed-Parser erkennt UTF8
-, UTF16
- oder UTF32
-Textcodierungen automatisch, wobei standardmäßig LATIN1
angenommen wird, wenn eine unerwartete Bytesequenz auftritt. Obwohl Text in Feldern in einer beliebigen Sprache eingegeben werden kann, müssen die Feldnamen genau wie unten aufgeführt in Englisch angegeben werden.
Feldname und -typ | Beschreibung |
---|---|
Typ: string | Erforderlich für Advantage+ Catalog Ads und Handel. Eindeutige Inserat-ID für Immobilie (Wohnung/Appartement); möglichst granulare ID. Beispiel: |
Typ: string | Nicht anwendbar auf Advantage+ Catalog Ads. Für den Handel optional. Eindeutige ID des Gebäudes oder der Wohnung. Muss für jede Gruppe eindeutig sein. |
Typ: string | Erforderlich für Advantage+ Catalog Ads und Handel. Titel des Immobilieninserats. Beispiel: |
Typ: string | Erforderlich für Advantage+ Catalog Ads und Handel. Aktuelle Verfügbarkeit für das Immobilieninserat. Unterstützte Werte sind: |
Typ: string | Erforderlich für Advantage+ Catalog Ads und Handel. Straße des Objekts, die sich in den Standort auflösen lässt. Siehe Adressobjektparameter. Beispiel: |
Typ: string | Erforderlich für Advantage+ Catalog Ads und Handel. Stadt, in der sich das Objekt befindet. Siehe Adressobjektparameter. Beispiel: |
Typ: string | Erforderlich für Advantage+ Catalog Ads und Handel. Bundesland, Kanton, Bundesstaat oder sonstige Region des Objekts. Siehe Adressobjektparameter. Beispiel: |
Typ: object | Erforderlich für Advantage+ Catalog Ads und Handel. Land, in dem sich das Objekt befindet. Siehe Adressobjektparameter. Beispiel: |
Typ: string | Erforderlich für Advantage+ Catalog Ads und Handel. Land, in dem sich das Objekt befindet. Siehe Adressobjektparameter. Beispiel: |
Typ: Float | Erforderlich für Advantage+ Catalog Ads und Handel. Breitengrad des Inserats. Beispiel: |
Typ: Float | Erforderlich für Advantage+ Catalog Ads und Handel. Längengrad des Inserats. Beispiel: |
Typ: string | Erforderlich für Advantage+ Catalog Ads. Optional, aber für Handel sehr empfohlen. Max. zulässige Stadtteile: 20 Nachbarschaft des Inserats für das Objekt. Für das Objekt sind mehrere Nachbarschaften möglich. Wenn es mehr als eine Nachbarschaft gibt, kannst du für jede weitere eine zusätzliche Spalte hinzufügen und JSON-Pfadsyntax in jedem Spaltennamen verwenden, um die Anzahl der Nachbarschaften anzugeben. Beispiel: |
Typ: string | Erforderlich für Advantage+ Catalog Ads und Handel. Verkaufs- oder Mietpreis des Objekts. Preise sind im Formar des Betrags gefolgt vom [3-digit ISO currency code](https://en.wikipedia.org/wiki/ISO_4217?fbclid=IwAR0_xYfUmL3kIUA6sMeEaFAzbJa4MLeMiPDPrftFSX6wkKiTXxPinC-5j70"> einzugeben, mit einem Leerzeichen zwischen Betrag und Währung. Beispiel: |
Typ: object | Erforderlich für Advantage+ Catalog Ads und Handel. Maximale Anzahl Bilder: 20 Maximale Größe: 4 MB Die URL für das Bild, das in deiner Werbeanzeige verwendet wird.
Beispiel: Siehe Bildobjektparameter. |
Typ: string | Erforderlich für Advantage+ Catalog Ads und Handel. Link zur Seite mit der Immobilienanzeige. Muss eine gültige URL sein. Siehe Bildobjektparameter. Beispiel: |
Typ: string | Optional für Advantage+ Catalog Ads. Erforderlich für Handel. Max. Zeichen: 5.000 Beschreibung des Objekts.
|
Typ: Float | Optional für Advantage+ Catalog Ads. Erforderlich für Handel. Anzahl Schlafzimmer. Kann für Studios Beispiel: |
Typ: Float | Optional für Advantage+ Catalog Ads. Anzahl der Badezimmer. Für den Handel muss es mindestens |
Typ: Float | Nicht anwendbar für Advantage+ Catalog Ads. Erforderlich für Handel. Anzahl Zimmer des Objekts. |
Typ: string | Optional für Advantage+ Catalog Ads. Art der Immobilie. Unterstützte Werte für Advantage+ Catalog Ads: |
Typ: string | Optional für Advantage+ Catalog Ads. Art der Immobilienanzeige. Unterstützte Werte für Advantage+ Catalog Ads: |
Typ: Ganzzahl | Nicht anwendbar für Advantage+ Catalog Ads. Erforderlich für Handel. Fläche oder Raum des Grundrisses des Inserats. |
Typ: string | Nicht anwendbar für Advantage+ Catalog Ads. Erforderlich für Handel. Die Einheiten (Quadratfuß oder Quadratmeter) für den Flächenwert. Unterstützte Werte: |
Typ: string | Nicht anwendbar für Advantage+ Catalog Ads. Für den Handel optional. Art der Klimaanlage. Unterstützte Werte: |
Typ: string | Nicht anwendbar für Advantage+ Catalog Ads. Für den Handel optional. Im Objekt verfügbare Möbelart. Unterstützte Werte: |
Typ: string | Nicht anwendbar für Advantage+ Catalog Ads. Für den Handel optional. Im Objekt installierte Heizungsart. Unterstützte Werte: |
Typ: string | Nicht anwendbar für Advantage+ Catalog Ads. Für den Handel optional. Verfügbare Waschmöglichkeit. Unterstützte Werte: |
Typ: Ganzzahl | Optional für Advantage+ Catalog Ads und Handel. Gesamtanzahl der verfügbaren Einheiten (Wohnungen, Appartements) zur Miete. Beispiel: |
Typ: string | Nicht anwendbar für Advantage+ Catalog Ads. Für den Handel optional. Am Objekt verfügbarer Parkplatztyp. Unterstützte Werte: |
Typ: string | Nicht anwendbar für Advantage+ Catalog Ads. Für den Handel optional. Angabe, ob das Partnerunternehmen das Inserat verifiziert hat. Unterstützte Werte: |
Typ: string | Baujahr des Objekts im Format JJJJ (4-stelliges Jahr). Beispiel: 1994. |
Typ: string | Nicht zutreffend für Advantage+ Catalog Ads. Für den Handel optional. Angabe, ob Haustiere im Objekt erlaubt sind: |
Typ: object | Auflistung von Daten und Preisen, für die ein Inserat verfügbar ist. Wenn du Werte bereitstellst, kann Facebook Inserate basierend auf den verfügbaren Daten und der dynamisch angezeigten Preis in deiner Anzeige empfehlen. |
Typ: object | App-Link zum Inserat. |
Type: 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 |
Besuche die Marketplace-Plattform-Dokumentation für länderspezifische Anforderungen für den Handel.
Feldname und -typ | Beschreibung |
---|---|
Typ: string | Erforderlich für Advantage+ Catalog Ads und Handel. Quell-URL des Bilds. Beachte die folgenden Spezifikationen für Bilder:
|
Typ: string | Optional für Advantage+ Catalog Ads und Handel. An das Bild angehängtes Tag, das den Bildinhalt zeigt. Du kannst mehrere Tags mit einem Bild verknüpfen. Beispiele:
|
Feldname und -typ | Beschreibung |
---|---|
Typ: string | Erforderlich. Straße und Hausnummer des Hotels. 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 des Hotels. Beispiel: |
Typ: string | Postleitzahl des Objekts. Erforderlich, außer wenn das Land nicht über ein PLZ-System verfügt. Beispiele: |
Mit available_dates_price_config
kannst du die Verfügbarkeit und die Preise der einzelnen Objekte für einen bestimmten Zeitraum bereitstellen. Wenn du Datumsbereiche in diesem Feld angibst, berücksichtigt Facebook diese Verfügbarkeit in unseren Produktempfehlungen und zeigt Inserate an, die für die auf deiner Website gesuchten Daten verfügbar sind. Optional können wir auf in deiner Anzeigengestaltung auch datumsspezifische Preise anzeigen, wenn du Preise angibst. Um diese Funktion zu aktivieren, musst du Facebook lease_start_date
und lease_end_date
in deine Pixel-Events senden.
Feldname und -typ | Beschreibung |
---|---|
Typ: string | Optional, wenn Anfang des verfügbaren Datumsbereichs im ISO-8601-Format; inklusive des Startdatums. Wenn du nur Beispiel: |
Typ: string | Optional, wenn Ende des verfügbaren Datumsbereichs im ISO-8601-Format; exklusive des Enddatums. Wenn du nur Beispiel: |
Typ: string | Integer-Preis des Inserats während dieses Zeitraums. Beispiel: |
Typ: string | Erforderlich, wenn du ISO-4217-Währungscode. Beispiel: |
Typ: string | Aufenthaltsdauer für den angegebenen Preis. Zulässige Werte sind: |
Dies ist ein Beispiel für die Verfügbarkeit eines Inserats und die Darstellung in JSON:
"available_dates_price_config": [ { // available until 11/01 at $150/night "end_date": "2018-11-01", "rate": "15000", "currency": "USD", "interval": "nightly", }, { // available from 11/01 - 12/01 at $200/night "start_date": "2018-11-01", "end_date": "2018-12-01", "rate": "20000", "currency": "USD", "interval": "nightly", }, { // available from 11/01 onward at $500/week "start_date": "2018-11-01", "rate": "50000", "currency": "USD", "interval": "weekly", }, ]
Gib Deep Links im Feed an und befolge dabei die App-Links-Spezifikation. Deep Link-Informationen im Feed haben Vorrang vor Informationen, die Facebook mit App-Links-Metadaten mit dem Webcrawler sammelt.
Wenn du bereits Deep Link-Informationen aus App-Links hast, musst du diese Daten nicht angeben. Facebook verwendet Informationen aus App-Links, um den richtigen Deeplink anzuzeigen. Wie du Deeplinks in deinen Anzeigen einblendest, erfährst du in Advantage+ Catalog Ads, Anzeigenvorlage.
Für Advantage+ Catalog Ads hast du folgende Möglichkeiten, Informationen zu den Objektinseraten im Katalog durch einen direkten Upload zu aktualisieren. Siehe Direkter Upload von Feed-Referenzen
Beispiel – Du kannst einmalig einen manuellen Upload durchführen:
curl \
-F "url=http://www.example.com/sample_feed.xml" \
-F "access_token=
Für Handel: Du kannst die Informationen zum Immobilieninserat im Katalog aktualisieren, indem du einen wiederkehrenden (geplanten) Feed-Upload einrichtest und deinen Feed aktualisierst. Im Marketplace empfehlen wir dir sehr, die Option zum Festlegen eines Zeitplans zu verwenden.
Commerce unterstützt eine mehrsprachige Erfahrung. Wenn du einen Sekundärsprachen-Feed zu einem Katalog hinzufügst, kannst du einen anderen Feed mit der zweiten Sprache aus diesem Einzel-Katalog erstellen. Die Informationen aus den sekundären Feeds überschreiben dann deine Standardsprache, wenn die entsprechende Zielgruppe deine Inserate sieht.
Diese Funktion ist nur für spezifische Länderpartner verfügbar. Bitte kontaktiere deinen Facebook-Vertreter, um herauszufinden, ob dies in deinem Markt möglich ist.
Dies ist eine Gruppe von Positionen in einem Katalog, den du in deinen Advantage+ Catalog Ads bewirbst. Jede Inseratskatalog kann viele Inseratsgruppen enthalten.
curl \
-F "name=test set" \
-F 'filter={"availability":{"eq":"for_sale"}}' \
-F "access_token=" \
https://graph.facebook.com/
Der oben aufgeführte filter
setzt sich aus den folgenden Operatoren und Daten zusammen:
Operatoren | Filtertyp |
---|---|
| Enthält einen Substring (ohne Beachtung der Groß-/Kleinschreibung) |
| Enthält keinen Substring (ohne Beachtung der Groß-/Kleinschreibung) |
| Enthält einen Substring (mit Beachtung der Groß-/Kleinschreibung) |
| Enthält keinen Substring (mit Beachtung der Groß-/Kleinschreibung) |
| Ist gleich (Groß-/Kleinschreibung egal) |
| Ist nicht gleich (Groß-/Kleinschreibung egal) |
| Kleiner als (nur numerische Felder) |
| Kleiner als oder gleich (nur numerische Felder) |
| Größer als (nur numerische Felder) |
| Größer als oder gleich (nur numerische Felder) |
Daten | Zu filternde Daten |
---|---|
| Inseratsverfügbarkeit. Beispiel: |
| Inseratstyp. Beispiel: |
| Immobilienart. |
| Inseratspreis |
| Name |
| Ort |
| Land |
| Region oder Bundesstaat |
| Postleitzahl |
| Anzahl der Betten |
| Anzahl der Badezimmer |
Du kannst Offline-Conversion-Events senden und sehen, wie viele Kunden Facebook-Werbeanzeigen und Handelsinserate vor der Conversion angesehen oder angeklickt haben. Verwende die Offline Conversions API und füge die folgenden Felder in Schritt 4 hinzu. Offline-Events hochladen.
Abgleichsschlüssel vergleichen eine Conversion mit einem Nutzer.
Schlüssel | Beschreibung |
---|---|
| E-Mail-Adresse(n) Hash |
| Telefonnummer(n) Hash |
| Vorname Hash |
| Nachname Hash |
| Apple- oder Android-Werbe-ID Hash |
| PLZ(en) Hash |
| Ort Hash |
| Bundesstaat Hash |
| Land Hash |
| Geburtsdatum (tt-Format) Hash |
| Geburtsdatum (JJJJ-Format) Hash |
| Geschlechterkonzept Hash |
| Alter Hash |
| Lead-ID für Marketplace-Leads |
Selbstdefinierte Daten vergleichen eine Conversion mit einem Händler.
Feld | Beschreibung |
---|---|
|
|
| Auf |
Event-Details beschreiben das Offline-Conversions-Event, das stattgefunden hat. Die Upload-Frequenz ist täglich, innerhalb von 48 Stunden nach dem Event.
Feld | Beschreibung |
---|---|
| Erforderlich Event-Typ-Enum:
|
| Erforderlich Event-Zeitpunkt |
| Erforderlich Mietwert. Lege |
| Erforderlich Währungscode |