Inserzioni per il settore immobiliare - Primi passi

Passaggio 1: crea un catalogo di annunci immobiliari.

Passaggio 2: configura annuncio e prezzo.

Passaggio 3: aggiorna le opzioni.

Passaggio 4: filtra il catalogo di annunci per creare un insieme di annunci.

Passaggio 5: invia conversioni offline (facoltativo)

Passaggio 6: crea il tuo pubblico per il settore immobiliare. A differenza di quanto accade con gli annunci immobiliari pubblicati dagli utenti, per le integrazioni di partner, i contatti vengono inviati ai partner tramite moduli per l'acquisizione di contatti, anziché tramite chat di Messenger. Scopri di più sul recupero dei contatti per i cataloghi di vendita.

Passaggio 7: crea e pubblica inserzioni per i tuoi annunci immobiliari.

Passaggio 8: ottieni informazioni sulla pubblicazione per vedere come le persone su Facebook interagiscono con le tue inserzioni. Consulta Insight sulle inserzioni.

Passaggio 9: usa strumenti di debug per diagnosticare e risolvere i problemi. Consulta Strumenti di debug per le inserzioni del catalogo Advantage+.

Passaggio 1: crea un catalogo di annunci immobiliari

Per inserzioni del catalogo Advantage+

Il tuo catalogo deve contenere una lista di proprietà che desideri pubblicizzare. Consulta Riferimento per il catalogo.

Per creare un catalogo di annunci di immobili per le inserzioni del catalogo Advantage+, imposta vertical su home_listings:

curl \
  -F 'name=Home Listing Catalog Name' \
  -F 'vertical=home_listings' \
  -F 'access_token=<ACCESS TOKEN>' \
  https://graph.facebook.com/<API_VERSION>

Per utilizzare l'API del catalogo, hai bisogno del livello di accesso all'API Marketing e devi accettare le Condizioni d'uso creando il primo catalogo attraverso Business Manager.

Per i cataloghi di vendita

Per istruzioni su come creare un catalogo di vendita, consulta la documentazione della piattaforma Marketplace.

Passaggio 2: configura annunci e prezzi

Il tuo annuncio contiene informazioni sulle proprietà, come ID annuncio, nome, disponibilità, descrizione, indirizzo, camere da letto, bagni e così via. Puoi avere un gruppo di annunci caricati o presi dalla tua azienda. Un annuncio è una singola proprietà presentata nel tuo sito web o nella tua app.

Formati di elenco supportati

Puoi avere un singolo elenco per tutte le proprietà nel tuo catalogo oppure diversi elenchi in cui un elenco rappresenta le proprietà in un singolo paese, per una singola agenzia immobiliare o per un broker.

Per le inserzioni del catalogo Advantage+, devi fornire l'elenco degli annunci in uno di questi formati:

Per i cataloghi di vendita, devi fornire l'alimentazione l'elenco degli annunci in formato XML:

Il nostro parser di elenchi rileva automaticamente codifiche di testo UTF8, UTF16 o UTF32, che ritornano a LATIN1 se appaiono sequenze di byte non previste.

Esempio di elenco XML

<?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>

Campi supportati - Annunci immobiliari

I seguenti campi supportati sono pensati per gli elementi che aggiungi al catalogo prodotti.

Per i cataloghi localizzati, vedi i campi supportati per gli annunci immobiliari.

Il nostro parser di elenchi rileva automaticamente codifiche di testo UTF8, UTF16 o UTF32, che ritornano a LATIN1 se appaiono sequenze di byte non previste. Il testo all'interno dei valori campo può essere inserito in qualsiasi lingua, ma i nomi del campo devono essere esattamente come riportato di seguito, in inglese.

Campi specifici richiesti per Paese - Solo vendita

Visita la documentazione della piattaforma Marketplace per i campi obbligatori specifici per Paese per i cataloghi di vendita.

Parametri dell'oggetto image

Parametri dell'oggetto address

Available Dates Price Config

Con available_dates_price_config, puoi fornire la disponibilità e i prezzi di ogni proprietà per un intervallo di date specifico. Quando includi intervalli di date in questo campo, Facebook tiene conto di questa disponibilità nei consigli sui prodotti e prova a mostrare gli annunci la cui disponibilità rientra nelle date che una persona ha cercato sul tuo sito. Facoltativamente, se fornisci i prezzi possiamo anche mostrare i prezzi specifici per data nella tua creatività dell'inserzione. Per abilitare questa funzione, devi inviare a Facebook anche lease_start_date e lease_end_date negli eventi del pixel.

Parametri dell'oggetto available dates

Questo è un esempio di disponibilità di un annuncio e come viene visualizzato 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",
    },
]

Deep link dei prodotti

Fornisci i deep link nell'elenco seguendo la specifica App Links. Le informazioni sui deep link nell'elenco hanno la precedenza su qualsiasi informazione raccolta da Facebook con i metadati App Links con il nostro crawler web.

Se disponi già di informazioni sui deep link provenienti da App Links, non devi specificare questi dati. Facebook usa le informazioni provenienti da App Links per visualizzare il deep link corretto. Per visualizzare i deep link nelle tue inserzioni, consulta Inserzioni del catalogo Advantage+, modello di inserzione.

Passaggio 3: aggiorna le opzioni

Inserzioni del catalogo Advantage+

Per le inserzioni del catalogo Advantage+, puoi aggiornare le informazioni relative all'annuncio immobiliare nel catalogo nei seguenti modi con il caricamento diretto. Consulta Riferimento per elenco con caricamento diretto

Esempio: puoi effettuare manualmente un caricamento una tantum:

curl \
  -F "url=http://www.example.com/sample_feed.xml" \
  -F "access_token=

Vendite

Per i cataloghi di vendita, puoi aggiornare le informazioni dell'annuncio immobiliare nel catalogo impostando un caricamento dell'elenco ricorrente (programmato) e aggiornando il tuo elenco. Nel Marketplace, consigliamo vivamente di utilizzare l'opzione Imposta una programmazione.

Impostare una programmazione per il caricamento dell'elenco di dati del catalogo

1. Vai al Gestore delle vendite.
2. Clicca su Origine dei dati.
3. Clicca su Aggiungi origine dei dati.
4. Clicca su Usa gli elenchi di dati e quindi su Avanti.
5. Clicca su Imposta una programmazione.
   
6. Scegli la frequenza con cui desideri che Facebook controlli il tuo elenco di dati per eventuali aggiornamenti: Giornaliero, Orario e Settimanale. Se selezioni Orario o Settimanale come frequenza, puoi anche specificare quando viene ripetuto il tuo caricamento programmato.
7. Inserisci l'URL diretto per il tuo elenco. Puoi usare URL che impiegano HTTP, HTTPS, FTP o SFTP. Nota: l'URL deve puntare direttamente al file con elenco di dati; in caso contrario, il caricamento potrebbe non andare a buon fine.
8. (Facoltativo) Immetti il nome utente e la password del fornitore dell'elenco di dati. Queste credenziali sono diverse da quelle che utilizzi per accedere al tuo account pubblicitario Facebook.
9. Immetti un nome per l'elenco di dati.
10. Scegli il tipo di valuta per l'elenco di dati. Il tipo di valuta viene utilizzato per il tuo elenco di dati se non lo specifici nel file dell'elenco.
11. Clicca su Avanti.
12. Controlla il file con elenco di dati per verificare la presenza di eventuali errori. Se nel file mancano colonne obbligatorie o ci sono colonne che Facebook non riconosce, puoi associarle alle colonne appropriate qui. Tutte le colonne associate qui vengono salvate per caricamenti futuri dell'elenco di dati.
13. Clicca su Avanti.

Caricamento di elenchi multilingue

I cataloghi di vendita supportano un'esperienza multilingua. Quando aggiungi un elenco in una lingua secondaria a un catalogo, puoi creare un altro elenco con la seconda lingua da quel singolo catalogo. Le informazioni sugli elenchi secondari hanno la priorità rispetto alla lingua predefinita quando il pubblico rilevante vede i tuoi annunci.

Questa funzione è applicabile solo per partner nazionali specifici. Contatta il tuo rappresentante Facebook per conoscere le possibilità nel tuo mercato.

1. Crea un catalogo con un elenco di dati per la tua lingua e il tuo Paese predefiniti.
2. Crea un file XML solo con l'ID annuncio (home_listing_id) e campi aggiuntivi che richiedono la sovrascrittura in lingua locale come nome, descrizione o campi aggiuntivi. Per sovrascrivere le informazioni, home_listing_id deve corrispondere a quello indicato nell'elenco di dati del catalogo originale.
3. Aggiungi l'elenco di informazioni aggiuntivo dal Gestore delle vendite.
   
   Aggiungi l'elenco aggiuntivo dal Gestore delle vendite [Aggiungi informazioni sull'annuncio immobiliare] - [Aggiungi informazioni linguistiche]
   
   
   
4. Conferma le 2 origini dei dati all'interno dello stesso catalogo.
   

Passaggio 4: filtra il catalogo di annunci per creare un gruppo di annunci

Si tratta di un gruppo di articoli in un catalogo che pubblicizzi nelle tue inserzioni del catalogo Advantage+. Ciascun catalogo di annunci può includere diversi gruppi di annunci.

curl \
  -F "name=test set" \
  -F 'filter={"availability":{"eq":"for_sale"}}' \
  -F "access_token=" \
  https://graph.facebook.com/

Il filter qui sopra è composto dai seguenti operatori e dati:

Passaggio 5: invia conversioni offline

Puoi inviare eventi di conversione offline e vedere quanti clienti hanno visualizzato o cliccato sulle inserzioni di Facebook e sugli annunci del catalogo di vendita prima della conversione; usa l'API Offline Conversions e aggiungi i campi seguenti nel passaggio 4. Carica eventi offline

Chiavi di corrispondenza

Le chiavi di corrispondenza confrontano una conversione con un utente.

Dati personalizzati

I dati personalizzati confrontano una conversione con un rivenditore.

Dettagli dell'evento

I dettagli dell'evento descrivono l'evento di conversione offline avvenuto. La frequenza di caricamento è giornaliera, entro 48 ore dall'evento.