Frequently asked questions about Marketplace Real Estate.
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.
We try to publish your listings or associated updates 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.
Leads API always check the partner's webhook response. If it's not successful, or if it's delayed (e.g. for network congestion, webhook down, etc.) we send the lead again after some time. This way we make sure that no leads are lost. Anyway, the side effect of this protection mechanism is that you may receive duplicates from time to time. The suggestion is to implement a filter on your webhook code, so you can check if a lead has been already received and discard possible copies of it.
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 compare a conversion to a user
Key | Description |
---|---|
| Email address(es) Hash |
| Phone number(s) Hash |
| First name Hash |
| Last name Hash |
| Apple or Android advertising ID Hash |
| ZIP code(s) Hash |
| City Hash |
| State Hash |
| Country Hash |
| Date of birth (DD format) Hash |
| Date of birth (YYYY format) Hash |
| Gender Hash |
| Age Hash |
| Lead ID of Marketplace leads |
Custom data compares a conversion to a dealer
Field | Description |
---|---|
|
|
| Set to |
Event details describe the offline conversion event that took place
Upload frequency:Daily, within 48 hours of the event
Field | Description |
---|---|
| Event type enum:
Required |
| Time of the event Required |
| Rent value. Set to |
| Currency code Required |