FAQs

Frequently asked questions about Marketplace Real Estate.

General questions

The main criterion used is to maximize the possibility that the user that performed the search would convert to a lead. This means that the search result ranking is customized per user, so different users could see different results.

Catalog

  1. go to https://developers.facebook.com/tools/explorer/ with a developer account. The account must have admin access to the catalog.
  2. request a token with ads_management permissions.
  3. make a GET call to /{PRODUCT_FEED_ID}/uploads. Here you can retrieve the id of your last upload session (the topmost one)
  4. make a POST call to /{UPLOAD_SESSION_ID}/error_report
  5. make a GET call to /{UPLOAD_SESSION_ID}?fields=error_report

In case the report is not ready, repeat the last call after a few seconds. Otherwise you should find a URL that you can download (e.g with wget, curl, etc.). The downloaded file will contain the full error report.

If you want to automate this flow, you can use an app.

If you get the error: "Cannot access an object not managed by the business owning this app", please make sure that the app you're using belongs to the business (Business Settings > Account > Apps).

We suggest you to update the catalog daily. You should schedule the feed upload in replace mode, so that every day Facebook will read the whole feed again, updating listings with changes, adding the new ones, skipping the non updated ones and removing the deleted ones.

Description is a field limited to 5000 characters. It's crucial to ensure a high quality listing, and it should be used to add all the useful information about the listing. HTML is not supported, but you can use new line (\n) characters to better structure your description.

Facebook catalog scheduled upload could be set in two modes: update and replace. The easiest way to configure a catalog is to select the replace mode. In this way, the catalog will be fully replaced at every upload (e.g. daily). If you want to remove a listing from Marketplace, simply remove it from your feed, and at the next upload it will be marked as removed. The listing may still be visible into Marketplace for the 24 hours that follow the upload.

At the moment we share some basic daily metrics in CSV format, you can access them from your catalog's Settings page.

Troubleshooting

We try to publish your listings, or updates to them, as soon as possible. Anyway, for optimization purposes, this process is asynchronous, which means that you won't be able to see the updates straight away after the feed upload. Changes to the catalog could take up to 24 hours to show up.

Offline Conversion API

Using these APIs, you will be able to send offline conversion events and see how many customers viewed or clicked on Facebook ads and Marketplace listings before converting.

Marketplace Real Estate follows the standard Offline Conversion API, adding certain Real Estate specific fields. In order to implement the Real Estate Conversion API, visit https://developers.facebook.com/docs/marketing-api/offline-conversions and add the following fields on step 4. Upload Offline Events:

Match keys

Match keys compare a conversion to a user

KeyDescription

email

Email address(es)

Hash

phone

Phone number(s)

Hash

fn

First name

Hash

ln

Last name

Hash

madid

Apple or Android advertising ID

Hash

zip

ZIP code(s)

Hash

ct

City

Hash

st

State

Hash

country

Country

Hash

dob

Date of birth (DD format)

Hash

doby

Date of birth (YYYY format)

Hash

gen

Gender

Hash

age

Age

Hash

lead_id

Lead ID of Marketplace leads

Custom data

Custom data compares a conversion to a dealer

FieldDescription

content_ids

home_listing_id from the catalog upload

content_type

Set to APARTMENT

Event details

Event details describe the offline conversion event that took place

Upload frequency:

Daily, within 48 hours of the event

FieldDescription

event_name

Event type enum:

ViewContent

Search

AddToCart

AddToWishlist

Lead = Had a phone call or other qualified lead

CompleteRegistration = Appointment setup

InitiateCheckout = Agency visit

AddPaymentInfo = Property viewing

Purchase = Lease signed

Other


Required

event_time

Time of the event

Required

value

Rent value. Set to 0 for non-lease events.

Required

currency

Currency code

Required