Skip to content

META Ads Integration

Set up Facebook and Instagram ads tracking in Sesamy.

Built-in integration

This is a built-in integration. See Integration Concepts for shared concepts like event types and error handling.

Overview

With Sesamy's built-in Conversion API and Pixel integration, your purchase events flow straight into META's Event Manager so you can track what is working and optimise campaigns with confidence.

Learn more: Facebook's Conversion API Documentation

Getting Started

  1. Set up a META Pixel in your Business Manager.
  2. Enable the Conversion API. Full instructions here: Get Started with the Conversion API.
  3. Share your Pixel ID and Access Token with Sesamy Support. (You'll find both in META's "Get Started" guide.)

Once that is done, Sesamy will take care of the rest.

What We Send

Every time a purchase happens, Sesamy instantly sends a Purchase event back to META. The event includes:

  • Email -- linked to the buyer's account.
  • Country -- where the purchase was made.
  • IP address -- of the buyer.
  • User-Agent -- browser/device used.
  • FBC & FBP -- automatically captured by sesamy.js and our checkout components. (For custom setups, add them as query parameters.)
  • Currency -- used in the transaction.

This data helps META match conversions to your ads, giving you sharper reporting and smarter optimisation.

Confirming Events

Once your integration is enabled, you can confirm that purchases are being tracked:

  1. Open Events Manager in your Business account.
  2. Check the Overview or Data Sources view to see incoming Purchase events.

Data may take 30 minutes or more to appear in your analytics after setting up your event. In the meantime, you can use the Test Events tool in Events Manager to quickly verify that events are firing.

Next Steps

Released under the MIT License.