Facebook Marketplace
Last updated
Last updated
If you do not already have a Facebook Marketplace account please sign up before proceeding.
This plugin sends campaign products (offers) to Facebook Marketplace every hour. The products are sent with a link to a CheckoutChamp page for checkout.
Facebook Business Manager Account: Ensure you have access to the Facebook catalog in a Business Manager account.
Developer App: Create or use an existing app in the Meta Developer Portal.
Catalog Access: Ensure you have the appropriate permissions (Manage catalog) for the catalog in Business Manager.
Navigate to Admin → Plugins → Data Sources
Click on Facebook Marketplace and then the green +Activate button
catalogId
Required.
Visit Business Manager
Go to Commerce Manager > Catalogs
Select the catalog to use and note the Catalog ID
accessToken
Required.
Step 1: Create a System User in Business Manager
Go to Meta Business Suite
Navigate to Business Settings > Users > System Users
Click Add and give the system user a name (e.g., CatalogManager)
Assign the role Admin or Employee
Step 2: Assign the Catalog to the System User
Under System Users, select the system user from Step 1
Click Add Assets
Select your Catalog, assign it to the system user, and grant permission to Manage catalog
Select your App, assign it to the system user, and grant permission to Manage app
Step 3: Generate an Access Token for the System User
In Business Settings, under the selected system user, click Generate New Token
Select token expiration as Never
Select your app
Select the permission catalog_management
Copy the generated token and save it securely. This is your access token to enter on the plugin
pageUrl
Required.
Enter the CheckoutChamp page on which to redirect Facebook Marketplace for checkout. The url must start with https://.
The page can be a Product Detail, Lead, or Checkout page. Lead and Checkout pages must support dynamic content.
The url will be automatically appended with ?productId=[campaignProductId] when sent to Facebook Marketplace. Do not include the ? or anything after it in pageUrl.
campaignId
Required. Enter the numeric CheckoutChamp campaignId for which to send products.
productTag
Optional. Enter a product tag to limit the range of products sent.
syncAll
Sync all products on the campaign to Facebook Marketplace. On steady-state only products with updates are sent.
