Skip to content

magento/meta-for-magento2

Repository files navigation

Facebook & Instagram for Magento

The official extension from Meta. Seamlessly manage your Facebook & Instagram presence from one place.

Extension Overview

Meta builds technologies that help people connect, find communities and grow businesses.

The Facebook & Instagram Extension enables users to set up Conversions API, Pixel, Catalog, and enables Adobe Commerce ( on-prem) and Magento Open Source users to create and manage a checkout-enabled Shop on Facebook & Instagram. This extension will help you:

  • Grow your business on Facebook & Instagram while managing orders, returns, and more from one place.
  • Reach new customers and offer a seamless in-app shopping experience, from discovery to checkout.
  • Optimize your ads using AI and easily promote your products and optimize your ads using powerful sales and marketing tools.
  • Automatically sync eligible product offerings, inventory, promotions, and orders between your Magento system and Meta.
  • Gain better data insights and understand meaningful business outcomes.

Installation Assets

(a) Meta Business Extension

Meta Business Extension is a popup-based solution that allows users to easily set up the Conversions API, Meta Pixel, and Catalog, and allows Adobe Commerce (on-prem) and Magento Open Source users to create and manage a checkout-enabled Shop on Facebook & Instagram.

(b) Conversions API

Conversions API is designed to create a direct connection between your marketing data and the systems that help optimize ad targeting, decrease cost per result and measure outcomes across Meta technologies.

(c) Meta Pixel

Meta Pixel is a piece of code that you put on your website that allows you to measure the effectiveness of your advertising by understanding the actions people take on your website.

(d) Catalog

Catalog is a container that holds information about the items you want to advertise or sell across Facebook and Instagram. You can create catalogs for different types of items, such as products, hotels, flights, destinations, home listings or vehicles.

(e) Checkout

Checkout allows customers to buy products directly from a shop on Facebook or Instagram and enables your business to run Shops Ads.

Usage Instructions

Complete usage guide HERE.

Meta Business Extension - Installation steps

INSTALL META BUSINESS EXTENSION FROM ZIP FILE ON YOUR DEV INSTANCE. TEST THAT THE EXTENSION WAS INSTALLED CORRECTLY BEFORE SHIPPING THE CODE TO PRODUCTION

Before installing, verify your Magento cron job is up and running, read more about it on this page.

Login to your server instance.

INSTALLATION

Magento Marketplace Installation

You can download and install our extension in Magento marketplace if you have a marketplace account.

Composer Installation

  • Go to your magento root path
  • Execute command cd /var/www/Magento or cd /var/www/html/Magento based on your server Centos or Ubuntu.
  • run composer command: composer require meta/meta-for-magento2 -W
  • To enable modules execute php bin/magento module:enable Meta_BusinessExtension Meta_Catalog Meta_Conversion Meta_Promotions Meta_Sales
  • Execute php bin/magento setup:upgrade
  • Optional php bin/magento setup:static-content:deploy
  • Execute php bin/magento setup:di:compile
  • Execute php bin/magento cache:clean

Manual Installation

  • extract files from an archive.
  • Execute command cd /var/www/Magento/app/code or cd /var/www/html/Magento/app/code based on your server Centos or Ubuntu.
  • Move all files from the app/code/* directory in your extracted archive to the app/code directory in your Magento project. Your Magento directory should now have a subdirectory named app/code/Meta/BusinessExtension.
ENABLE EXTENSION
  • Make sure you have correct read/write permissions on your Magento root directory. Read about them here.
  • Move to magento root folder by executing command cd ../../
Enable Extension By Running Script

You can install the extension with a bash script.

  • Copy the install-facebook-business-extension.sh script to your Magento root folder.
  • Give it execute permission with chmod +x install-facebook-business-extension.sh (you may have to log in as root user to do it).
  • Switch to Magento files owner user and run: ./install-facebook-business-extension.sh.
  • You should read Installation finished when the script is done.
Enable Extension By Running Commands Manually

Execute the following commands to manually install Meta Business Extension.

  • Install the Facebook Business SDK for PHP: composer require facebook/php-business-sdk. This dependency is used by the extension.
  • You will see a message similar to: Installing facebook/php-business-sdk (8.0.0): Downloading (100%)
  • Execute php bin/magento module:status
  • You should see Meta_BusinessExtension in the list of disabled modules.
  • To enable modules execute php bin/magento module:enable Meta_BusinessExtension Meta_Catalog Meta_Conversion Meta_Promotions Meta_Sales
  • Execute php bin/magento setup:upgrade
  • Optional php bin/magento setup:static-content:deploy
  • Execute php bin/magento setup:di:compile
  • Execute php bin/magento cache:clean

Verify Installation

  • Upon successful installation, login to your Magento Admin panel.
  • You should see a "Facebook & Instagram" Icon on the left hand side.
  • Click "Overview" to link a Meta Account.

Update Installation

Composer Update

  • Go to your Magento root path.
  • Execute command cd /var/www/Magento or cd /var/www/html/Magento based on your server Centos or Ubuntu.
  • Run composer command: composer update meta/meta-for-magento2.

Manual Update

  • Extract files from the latest archive.
  • Execute command cd /var/www/Magento/app/code or cd /var/www/html/Magento/app/code based on your server Centos or Ubuntu.
  • Replace all files in the app/code directory of your Magento project with the files from the app/code/* directory of your extracted archive.

Need help?

Visit Facebook's Advertiser Help Center.

Requirements

Meta Business Extension For Magento 2 requires

  • Magento version 2.4.2-2.4.6
  • PHP 7.4 or greater
  • Memory limit of 1 GB or greater (2 GB or higher is preferred)

Contributing

See the CONTRIBUTING file for how to help out.

License

Meta Business Extension For Magento2 is Platform-licensed.