Frequently asked questions about Marketplace Vehicles.
In the "Partner model" integration the page linked to the listings (see
fb_page_id field in feed upload) is used to pull some information about you, such as name, logo and number of likes. It will be shown in the vehicle detail page of the listing.
If you are implementing a "Dealer model" integration, every listing will still have a page linked, and if you have the right permissions granted, the dealership information taken from their professional page will be shown.
Marketplace Vehicles allows two models, chat and lead form. The first one uses Facebook Messenger, and you'll receive user messages directly in the page linked to the listings (specified in
fb_page_id field in the feed. The second model shows to the user a form similar to the following one:
The leads are received by the page linked to the listings. They can be accessed via webhook or Leads APIs, more information here.
Please notice that for both models you should have set the right page permissions.
You can choose which model you want to use by setting the value of
dealer_communication_channel field in your feed.
Yes, just go to your page, you must be admin. Then click on Publishing Tools in the top header bar:
From the Publishing Tools page, click on "Forms Library" under the section "Lead Ads Form", on the left hand side. In the Forms Library table, you will find a form called "Marketplace Autos Lead Gen Form":
by clicking "Download", a dialog will appear, asking if you want to download new leads or leads within a specific time range. After selecting your preference, you will be able to download leads in CSV or XLS format.
Companies working with user data require verification. You need business verification if you are using Facebook APIs to:
To use Facebook APIs you must have an app. Hence, to start a business verification, you must have an app associated to your business. You can associate an app to your business from your Business Settings > Accounts > Apps section:
After adding your app here, you will be able to start your business verification from the Business Settings > Business Info:
Please notice that verification documents will be sent to the business owner's email address.
You can find more info on business verification here: https://www.facebook.com/business/help/2058515294227817.
The criteria to determine if you need an app review are the same for the verified business. You will need an app review to:
You can start an app review by clicking on "App review" from the navigation menu in your app's Dashboard. You can access all your apps from https://developers.facebook.com/apps.
The permission that you will need are
page_messaging (in case of chat integration),
leads_retrival (in case of lead form integration).
Your app is probably going to be just code: in the screencast you can show the portions of code related to the calls you want to make. You don't need a long recording, just be sure to cover the most sensitive areas, especially where user data is accessed and manipulated.
A good explanation example is:
"We are [COMPANY], a Marketplace Motors partner. We offer [SERVICE (e.g. publish feed on marketplace)] to our clients, and we are requesting an app review to access [DATA (e.g. leads)] for [PURPOSE (e.g. redirect them the dealerships, our clients)]"
In case of issues during the process you will receive an explanation of what's missing; anyway, by following these guidelines, your review should be generally quickly granted.
You can find more info on app review here: https://developers.facebook.com/docs/apps/review.
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.
A listing with good image quality converts better. To be on marketplace, listings should have two or more images (up to 20), and they should show the actual vehicle. Images with banners, text or placeholder images are generally not allowed, and may be banned.Learn more on Marketplace Vehicles best practices.
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.
No, you can also handle everything with a single catalog. In the feed upload section you can find two fields:
dealer_id: a unique identifier for the dealership. This value is a string, usually coming from your database.
fb_page_id: the Facebook professional page id of the dealers. Marketplace leads will be sent to this page. If you chose partner integration model (more info on integration models), put your Facebook page ID here. You'll receive all the leads, and based on the
vehicle_idyou will be able to understand its owner dealership. For dealer integration model, put the dealer's Facebook page ID, and the leads will be sent directly to their page. Please notice that you should have the right permissions to publish on behalf of this page to successfully ingest their listings.
If you prefer to keep things separated, you can also create a catalog for each dealership.
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.
There can be many reasons why this happens. The first thing to check is the health check status of the vehicle. In the catalog (Vehicles section) you should be able to check the status of every listing. If you see a red dot, with the label "Issues detected", you can move the cursor over the label, and get a more detailed description of the error. In many cases these issues will solve automatically in 24-48 hours, if this is not the case, please contact Facebook support.
If the vehicle has been correctly ingested, you'll see a green dot, and by clicking on it you'll see the Marketplace listing.
Common failure reasons include:
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.
The top reasons why individual vehicles are rejected by Marketplace after being uploaded to the catalog are: