Help Center

FBE Commerce Onboarding

Yesenia DeSalle
Yesenia DeSalle
  • Updated

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.

FBE_1.png

 

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.

FBE_2.png

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

FBE_3.png

Exchange Access Token

After the user finishes the MBE flow, we will get back the code that will be used to exchange.

access_token

FBE_4.png

 

MBE Connection

How to connect to MBE in Feed

1. Navigate to Feed > Click “+” to add new feed > Search “Facebook” > Select any Facebook Feed

FBE_5.png

 

2. Navigate to Meta MBE Dashboard

FBE_6.png

 

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

FBE_7.png

 

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

FBE_8.png

 

5. Continue with the connected account > Select/unselect assets you would like to connect to Shop >
Next, click on Get Started

FBE_9.png

 

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.

FBE_10.png

 

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)

FBE_11.png

 

8. Connect to Instagram existed account or create a new one > Continue

FBE_12.png

 

9. Select the catalog or create new > Continue
- Select a catalog so you can manage inventory and deliver ads that show your products.

FBE_13.png

 

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.

FBE_14.png

 

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.

FBE_15.png

 

12. Connect your Commerce Account or create a new one > Continue

FBE_16.png

 

13. Confirm all the selected options > Continue

FBE_17.png

 

14. Confirm all the permissions that GoDataFeed requested > Continue
- Recommended: turn on all permissions to ensure all the future features work properly.

FBE_18.png

 

15. Congratulations! You are now connected to GoDataFeed > Done

FBE_19.png

 

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

FBE_20.png

 

17. Management View

FBE_21.png

 

18. On the left side panel, select Settings to find the access token and external_business_id

FBE_22.png

 

How to connect to MBE in Order

1. Navigate to Order > Click “+” to add new Order Source > Select Meta

FBE_23.png

 

2. Click on Meta > Connect

FBE_24.png

 

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

FBE_25.png

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.

FBE_26.png

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

FBE_27.png

  • PERMISSION Object

FBE_28.png

  • COMMERCE ACCOUNT Object

FBE_29.png

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.