Facebook Marketplace

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.

Prerequisites

1. Facebook Business Manager Account: Ensure you have access to the Facebook catalog in a Business Manager account.

2. Developer App: Create or use an existing app in the Meta Developer Portal.

3. Catalog Access: Ensure you have the appropriate permissions (Manage catalog) for the catalog in Business Manager.

Plugin Activation

• Navigate to Admin → Plugins → Data Sources

• Click on Facebook Marketplace and then the green +Activate button

catalogId

Required.

1. Visit Business Manager

2. Go to Commerce Manager > Catalogs

3. Select the catalog to use and note the Catalog ID

accessToken

Required.

Step 1: Create a System User in Business Manager

1. Go to Meta Business Suite

2. Navigate to Business Settings > Users > System Users

3. Click Add and give the system user a name (e.g., CatalogManager)

4. Assign the role Admin or Employee

Step 2: Assign the Catalog to the System User

1. Under System Users, select the system user from Step 1

2. Click Add Assets

3. Select your Catalog, assign it to the system user, and grant permission to Manage catalog

4. 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

1. In Business Settings, under the selected system user, click Generate New Token

2. Select token expiration as Never

3. Select your app

4. Select the permission catalog_management

5. 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.