Getting started with Facebook and Instagram Shops

What is the Meta Business Extension?

The Meta Business Extension (MBE) is a popup-based, Meta-owned interface that lives on GoDataFeed sites as a plugin, and simplifies the overall integration process with Meta.

Connecting the MBE in GoDataFeed allows our platform to simplify the process of submitting the Facebook and Instagram Shops feed to your Commerce Manager, and syncing orders placed in Facebook and Instagram Shops back to your shopping cart platform. 

The graphic below outlines the steps included in the Meta Business Extension connection process.

How to connect the MBE in your Facebook and Instagram Shops feed 

Toggle through the steps from 'Start' to 'Finish' to see each step in detail. Follow the steps carefully to successfully connect the MBE within your Facebook feed:

• • In your Facebook and Instagram feed > click 'Meta Business Extension (MBE) Dashboard'
    
    
    
    
• • Click the blue "Connect" button
    
    
  
• • Proceed by clicking the "Connect MBE" button
    
    
• • If you are not logged into Facebook, you will be prompted to login to your Facebook account > once logged in, you will see a dialog pop-up page > click the "Continue as..." button
  
• • Select/unselect assets you would like to connect > click the "Get Started" button
  
• • Select your Business Manager account or create a new one > click the "Continue" button

  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.

  
  
  
  
• • Select a Facebook Page or create a new one > click the "Continue" button

  You can only connect to the page that has access to the Business Manager account you selected in the previous step.

  
  
• • Connect to an existing Instagram account or create a new one > click the "Continue" button
  
  
• • Select the Catalog or create a new on > click the "Continue" button

  Select a catalog so you can manage inventory and deliver ads that show your products.

  
  
  
  
• • Select your ad account, skip this step, or create a new one> click the "Continue" button

  Select the ad account your business uses to advertise products and services.

  
  
• • Select Meta Pixel or create new > click the "Continue" button

  Use data from the pixel to understand actions on your website and measure the results of your ads.

  
  
• • Connect your Commerce Account or create a new one > click the "Continue" button
  
  
• • Confirm all the permissions that GoDataFeed requested > click the "Continue" button

  Recommended: turn on all permissions to ensure all the future features work properly.

  
  
• • Congratulations! You are now connected to GoDataFeed > click the "Done" button
    
    
    
    
  • You will see 'Connection Successful' now on the 'Meta Business Extension (MBE) Dashboard' page of your Facebook feed
    
    

How to connect the MBE in the Orders page

Toggle through the steps from 'Start' to 'Finish' to see the steps to follow to successfully connect the MBE within your Orders page in GoDataFeed:

• • Click "Activate Order Sources" if you are setting up Order Sync for the first time, otherwise navigate to 'Marketplace Sources' in the left-side menu > click “+” to add a new Order Source > Select 'Meta'

  

• • Click on Meta > then click the blue "Connect" button

  

• • Walk through the prompts to connect -- if needed you can follow steps 2 – 13 above in the previous section of this article as the connection steps are the same as the Feed instructions

• Once completed you will automatically navigate back to Orders, and the access token and order external business id will appear

  
  

  

Developer references for the Meta Business Extension

Click the toggle to view more technical details of the MBE connection:

• 

  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.

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

  

  
  

  ---

  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