Real Estate Ads - Get Started

Step 1: Create a Home Listing catalog.

Step 2: Set up listing and pricing.

Step 3: Update options.

Step 4: Filter listing catalog to listing set.

Step 5: Send Offline Conversions (Optional)

Step 6: Build your Audience for Real Estate. Differently from what happens with real estate listings published by users, for partner integrations, leads are sent to partners via lead form, rather than via Messenger chat. Learn more about Retrieving Leads for commerce.

Step 7: Create and deliver ads for your home listings.

Step 8: Get delivery information to see how people on Facebook are engaging in you ads. See Ads Insights.

Step 9: Use debugging tools to diagnose and resolve problems. See Advantage+ Catalog Ads Debugging Tools.

Step 1: Create a Home Listing Catalog

For Advantage+ Catalog Ads

Your catalog should contain a list of properties that you want to advertise. See Catalog Reference.

To create a home listing catalog for Advantage+ catalog ads, set vertical to home_listings:

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

To use the catalog API, you need Marketing API Access Level and accept the Terms of Service by creating your first catalog through Business Manager.

For commerce

For instructions on how to create a catalog for commerce, visit the Marketplace Platform documentation.

Step 2: Set Up Listing and Prices

Your listing contains information for properties, such as listing ID, name, availability, description, address, bedrooms, bathrooms, and so on. You can have a set of listings uploaded or fetched from your business. A listing item is a single property presented in your website or app.

Supported Feed Formats

You can have a single feed for all properties in your catalog, or you can have multiple feeds where one feed represents properties in a single country, for a single real estate agency, or for one broker.

For Advantage+ catalog ads, you must provide the listing feed in one of these formats:

For commerce, you must provide the listing feed in XML format:

Our feed parser automatically detects UTF8, UTF16 or UTF32 text-encodings, falling back to LATIN1 if unexpected byte sequences appear.

Feed XML example

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

Supported Fields - Home Listings

The following supported fields are designed for items you add to your product catalog.

For localized catalogs, see supported fields for home listings.

Our feed parser automatically detects UTF8, UTF16 or UTF32 text-encodings, falling back to LATIN1 if unexpected byte sequences appear. While text in field values can be given in any language, field names must be given exactly as below, in English.

Country-Specific Required Fields — Commerce Only

Visit the Marketplace Platform documentation for commerce country-specific required fields.

Image Object Parameters

Address Object Parameters

Available Dates Price Config

With available_dates_price_config, you can provide the availability and prices of each property for a given date range. When you include date ranges in this field, Facebook factors this availability into our product recommendations and tries to show listings that are available for the dates someone searched on your site. Optionally, if you include pricing we can also show date-specific prices in your ad creative. To enable this feature, you must also send Facebook lease_start_date and lease_end_date in your pixel events.

Available Dates Object Parameters

This is an example of a listing's availability and how it appears 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",
    },
]

Product Deep Links

Provide deep links in feed following the App Links specification. Deep link information in feed takes precedence over any information Facebook collects with App Links metadata with our web crawler.

If you already have deep link information from App Links, you don't need to specify this data. Facebook uses information from App Links to display the correct deep link. To display deep links in your ads, see Advantage+ Catalog Ads, Ad Template.

Step 3: Update Options

Advantage+ Catalog Ads

For Advantage+ catalog ads, you can refresh home listing info in the catalog through the following ways with direct upload. See Direct Upload Feed Reference

Example — You can manually do a one-time upload:

curl \
  -F "url=http://www.example.com/sample_feed.xml" \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_FEED_ID>/uploads

Commerce

For commerce, You can refresh home listing info in the catalog by setting up a recurring (scheduled) feed upload and updating your feed. In Marketplace, we highly recommend to use the Set a Schedule option.

Set a Schedule for Your Catalog Data Feed Upload

1. Go to Commerce Manager.
2. Click Data Sources.
3. Click Add Data Source.
4. Click Use Data Feeds and click Next.
5. Click Set a schedule.
   
6. Choose how frequently you want Facebook to check your data feed for updates: Daily, Hourly ,and Weekly. If you choose Hourly or Weekly as your frequency, you can also specify when your scheduled upload repeats.
7. Enter the direct URL for your feed. You can use URLs that use HTTP, HTTPS, FTP, or SFTP. Note: The URL should point directly to your data feed file; otherwise, the upload may fail.
8. (Optional) Enter the username and password for the data feed provider. This is different than the username and password you use to access your Facebook ad account.
9. Enter a name for your data feed.
10. Choose the currency type for your data feed. The currency type is used for your data feed if you don't specify it in your data feed file.
11. Click Next.
12. Review your data feed file for any errors. If you're missing any required columns in your file, or there are columns that Facebook doesn't recognize, you can map them to the appropriate columns here. Any columns mapped here are saved for future data feed uploads.
13. Click Next.

Multilanguage Feed Upload

Commerce supports a multilanguage experience. When you add a secondary language feed to a catalog, you can create another feed with the second language from that single catalog. The information on the secondary feeds overrides your default language when the relevant audience sees your listings.

This feature is applicable only for the specific country partners. Please contact to your Facebook representative to find out possibility in your market.

1. Create a catalog with a data feed for your default language and country.
2. Create an XML file only with the listing ID (home_listing_id) and additional fields that required local language overwrite like name, description or additional fields. To overwrite information, the home_listing_id must match the ones in your original catalog data feed.
3. Add the additional information feed from the Commerce Manager.
   
   Add the additional feed from the Commerce Manager [Add Home Listing Information] - [Add Language Information]
   
   
   
4. Confirm the 2 data sources within the same catalog.
   

Step 4: Filter Listing Catalog to Listing Set

This is a group of items in a catalog that you advertise in your Advantage+ catalog ads. Each listing catalog can have many listing sets.

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

The above filter is made up of the following operators and data:

Step 5: Send Offline Conversions

You can send offline conversion events and see how many customers viewed or clicked on Facebook ads and commerce listings before converting; use the Offline Conversions API and add the following fields in step 4. Upload Offline Events.

Match Keys

Match keys compare a conversion to a user.

Custom Data

Custom data compares a conversion to a dealer.

Event Details

Event details describe the offline conversion event that took place. The upload frequency is daily, within 48 hours of the event.