What is FBE?
The Facebook Business Extension (FBE) is a popup-based, Meta-owned interface that lives on GoDataFeed sites as a plugin and simplifies the overall integration process with Meta. MBE allows businesses to easily set up the Meta Pixel, Catalog, and Shops. It helps businesses connect their products and services with Facebook and Instagram channels on your platform. Once connected, GoDataFeed can help users utilize a large suite of powerful features.
Note: FBE is recommended to simplify the overall integration process.
The Commerce onboarding flow allows businesses to set up or integrate the following:
- Business Manager*
- Commerce Manager
- Catalog
- Ad account
- Facebook Page Shop
- Instagram Shop**
- Meta Pixel
After completion, any of the businesses can start an MBE onboarding flow without existing assets,
such as catalog, Business Manager, ads accounts, and more. Businesses can then create all
required assets within the MBE flow. See Facebook help article for more information.
Authentication
Business Login
Business Login (commonly known as Facebook Login) is an entry point that allows
business owners to connect their business on GoDataFeed platform to their Facebook or
Instagram profiles, using a connect button placed on the Feeds or orders page. After the user logs in,
GoDataFeed will ask for the user’s permission to access the Catalog, Page, and Orders.
Note: Please don't turn off any of the permissions to make sure the connection works properly.
The diagram below explains how GoDataFeed will use these permissions.
Business Login will be launched after the user clicks on Connect Meta MBE button. The
MBE Installation URL will be tied with this connect button.
Currently supporting the following scopes:
- Catalog_management [required]
- Manage_business_extension [required]
- Commerce_manage_accounts
- Commerce_account_read_settings
- Commerce_account_manage_orders
- Commerce_account_read_orders
Setup MBE installation URL configurations
The Business Login via URL has a few required query parameters: client_id, display,
redirect_uri, response_type, scope, extras, setup, business_config
The extras parameter will contain two required fields, which are set up and business config.
In the setup field, we will pass in dynamic externalBusinessId and storeDomain values. Business_vertical and channel will be set as “ECOMMERCE” and “COMMERCE”. For more information on how to configure this, please click here.
Updated Business Login URL
Exchange Access Token
After the user finishes the MBE flow, we will get back the code that will be used to exchange.
access_token
MBE Connection
How to connect to MBE in Feed
1. Navigate to Feed > Click “+” to add new feed > Search “Facebook” > Select any Facebook Feed
2. Navigate to Meta MBE Dashboard
3. Click on Connect > Navigate to Authorize page
- Here users can check out our help article or go back to check on their Meta account
access permissions
4. Proceed to click on Connect Meta MBE button > Load Business Login URL
- If the user is not logged in, there will be a login form for the user to log in
- Once logged in, the user will see a dialog pop-up page below
5. Continue with the connected account > Select/unselect assets you would like to connect to Shop >
Next, click on Get Started
6. Select Business Manager account or create a new one > Continue
- Choose the account where you manage business assets like Page, Pixel, and Catalog. The assets
you create/connect will be owned by this Business Manager.
7. Select Facebook Page or create a new one > Continue
- User can only connect to the page which has access to the selected business manager account
(from previous selection)
8. Connect to Instagram existed account or create a new one > Continue
9. Select the catalog or create new > Continue
- Select a catalog so you can manage inventory and deliver ads that show your products.
10. Select your ad account, skip this step, or create a new one> Continue
- Select an ad account for your business to advertise products and services.
11. Select Meta Pixel or create new > Continue
- Use data from the pixel to understand actions on your website and measure the results of
your ads.
12. Connect your Commerce Account or create a new one > Continue
13. Confirm all the selected options > Continue
14. Confirm all the permissions that GoDataFeed requested > Continue
- Recommended: turn on all permissions to ensure all the future features work properly.
15. Congratulations! You are now connected to GoDataFeed > Done
16. Automatically return to Meta MBE Dashboard, but now you are authorized, you will see
Successful Connection page with 3 options for FBE Settings: Edit, Manage, and Uninstall.
- Edit: (Not yet supported) You will be able to create a custom feature management view to
enable and disable MBE features - Manage: Launch a pop-up management view belonging to the authorized business. This page
allows your businesses to further configure features (beyond what you specify for them in
business_config during installation) - Uninstall: Disconnect the MBE connection
17. Management View
18. On the left side panel, select Settings to find the access token and external_business_id
How to connect to MBE in Order
1. Navigate to Order > Click “+” to add new Order Source > Select Meta
2. Click on Meta > Connect
3. You can follow steps 3 – 15 above as they are the same as the Feed instructions > Done
- You will automatically navigate back to Meta Order with the access token and order
external business id
Webhook
GoDataFeed will receive webhook updates from Facebook about installations,
uninstallations, and reconfigurations of MBE.
Depending on the methods or the events, we will parse the data and process it.
Setup endpoints for webhook
GET Method – Verification Requests
Anytime we change our endpoint URL in the app, a GET request will be sent to the
new endpoint and this endpoint must validate the verified token and respond with the hub
challenge from Facebook.
POST Method – Event Notifications
INSTALL Event
Upon receiving a webhook notification of an install, GoDataFeed will parse the
response and save asset ids into our database.
UNINSTALL Event
Upon receiving a webhook notification of an uninstall, GoDataFeed will disconnect the
integration and call UNINSTALL MBE API to disable all the granted features.
CHANGE Event
Upon receiving a webhook notification of the change, GoDataFeed will update the
recorded features that have been granted and save the new changes to our database.
Subscribed Webhook Events
Below are our current subscribed webhook events
- USER Object
- PERMISSION Object
- COMMERCE ACCOUNT Object
Comments
0 comments
Please sign in to leave a comment.