Facebook Product Catalog
This page describes how to use Census with Facebook Product Catalog.
🏃♀️ Getting Started
In this guide, we will show you how to connect Facebook Product Catalog to Census and create your first sync.
- Have your Facebook Business Manager account ready.
- Have the proper credentials to access to your data source. See our docs for each supported data source for further information:
This connector relies on a Facebook System User token for authenticating requests. A regular system user is recommended over an admin system user. You can use an existing system user or create a new one with the following steps:
- 1.If you don't have one already the first thing you need to generate a system token is an application
- Open your Business Manager
- Navigate to Business Settings > Accounts > Apps
- Click Add and then Create New App ID
- For use case select Other
New app usecase screen- Then for Type select Business
New app type- Then fill out the relevant details and press Create App
New app details - 2.Now you can generate a system user for the app. Go to your Business Manager and navigate to Business Settings > Users > System Users
Business Manager Navigation Panel - 3.Above your list of system users click Add to create a new System User
- 4.Provide a name and role. Census does not need an
Adminrole,Employeeis sufficient. - 5.Once the system user is created click on Add Assets and assign the relevant Product Catalogs that you want Census to sync to. Make sure to assign full control of the catalog to the system user.
- 6.Now generate a token for the System User by pressing Generate New Token, select the relevant app you created earlier, select the relevant scopes, and then press Generate Token
- You will need to provide at least the
business_managementandcatalog_managementscopes for Census to sync to your product catalogs - Make sure to select
Neverfor token expiration so you do not need to manually reauthorize your Census connection every 60 days.
Token Expiration & Scopes Page
- 7.Once your token is generated be sure to save it in a safe place. This is the token you must provide to Census as a credential for your connection.
If you already have a system user you can use it by simply generating a new token with the correct permissions. Census needs the
business_management and catalog_management scopes. Also be sure to assign the catalog asset to your system user so Census can sync to it.You are now ready to set up a connection. Head to the Census Connections page and press New Destination. From the list select Facebook Product Catalog.
You will need to provide the System User Token you generated earlier along with your Business Account Id and the Catalog Id you want associated with this specific connection. You can find those in your Business Settings in Business Info and Data Sources > Catalogs respectively.
New Facebook Product Catalog connection page
Each Facebook Product Catalog supports products for a specific vertical. Each vertical is a variant on the base product object within the Facebook system. Currently we support the following variants with more to come. If there's a variant you would like to sync to please contact us about making it happen.
Object Name | Supported? | Identifiers |
Product Item | ✅ | Retailer Id |
Hotel | ✅ | Hotel Id |
Hotel Room | 🔜 | |
Flight | 🔜 | |
Destination | 🔜 | |
Home Listing | 🔜 | |
Vehicle | 🔜 | |
Behaviors | Supported? | Objects |
Update or Create | ✅ | Product Item, Hotel |
Mirror | ✅ | Product Item, Hotel |
Last modified 23d ago