Skip to content
Meta

Magento Meta Conversions API Advanced Matching

Send hashed customer information from Magento orders with every Meta Conversions API event (Advanced Matching), only when the visitor allowed ad user data.

Every event Product Metrics sends through the Meta Conversions API carries customer information so Meta can match it to a person (Advanced Matching): on Magento, the Magento order, plus the logged-in customer’s details and the guest email that the module passes to the script, hashed with SHA-256, plus the visitor’s IP address and browser. There is no extra switch: once the destination is saved, every consented event carries it.

Magento

The module, installed once by a developer.

Meta

Your pixel ID and a Conversions API access token.

Result

Hashed customer data for Advanced Matching on every Meta event.

Prerequisites

  • Workspace admin in Product Metrics (editor is enough for the store and destination steps), with Pro (Full Signal Tracking).
  • Server-side tracking for Magento in Meta set up first.
  • Your Magento store view connected: Magento 2.4, 2.0 or 1.9 / OpenMage, Magento Admin access, the public HTTPS shop address and the store-view ID, and a developer with access to your server who installs the Product Metrics module (Composer or ZIP), adds the store view’s private configuration file and keeps Magento cron running. The connection reads Active before you link your property. See Magento.

In the app

1. Check the Meta Conversions API is connected

In Product Metrics, open Tracking → Meta Conversions API.

The Add Meta destination form with Pixel or Dataset ID, Access token, Test event code (optional) and the Send events to Meta switch, then the saved Meta Conversions API destination showing Active, the access token Accepted by Meta and Sending On.The Add Meta destination form with Pixel or Dataset ID, Access token, Test event code (optional) and the Send events to Meta switch, then the saved Meta Conversions API destination showing Active, the access token Accepted by Meta and Sending On.
Add Meta destination: paste the Pixel or Dataset ID and access token, keep Send events to Meta on.

You should see: your Meta pixel is connected and enabled. Not there yet? Follow server-side tracking for Magento in Meta.

In Tracking → Configure consent, choose the banner your shop shows: OneTrust, Cookiebot, Usercentrics or Osano. Magento’s own cookie restriction notice does not grant consent. With any other banner, your developer passes the visitor’s choices to Product Metrics: see Consent. Without either, ad user data stays denied and no customer data is sent.

Meta has no consent mode, so without ad user data the event isn’t sent at all. What each choice lets through: Consent.

You should see: Tracking → Configure consent names the banner your store view actually shows.

3. Send a test event

In Tracking → Meta Conversions API, send a test event. It checks the connection only.

You should see: Meta accept the test event.

4. Check an order

To see the customer information on a real event, place a paid test order in the connected store view with your payment provider’s test mode, and allow a few minutes for cron.

You should see: under Manage Magento, the desired and active revision numbers are the same, and the order appears for the linked property.

Meta refuses events more than 7 days old, so an order paid more than a week after checkout never reaches Meta.

Set it up with AI

Connect your assistant

First time? Add the Product Metrics MCP server to your assistant, then paste the prompt below.

In Claude, choose Add custom connector; in ChatGPT, Settings → Apps & Connectors. Paste this URL:

https://www.productmetrics.io/mcp

Claude Code: run this in your terminal.

claude mcp add --transport http product-metrics https://www.productmetrics.io/mcp

CodexAll clients and details →

Paste the prompt into your assistant.

Check that Product Metrics sends customer data with my Meta Conversions API events from my Magento store. Check my setup status first, walk me through each open step, and give me the link when I need to click something.
Check that Product Metrics sends customer data with my Meta Conversions API events from my Magento store. Check my setup status first, walk me through each open step, and give me the link when I need to click something.
Check that Product Metrics sends customer data with my Meta Conversions API events from my Magento store. Use the Product Metrics MCP server, or the productmetrics CLI with --json and the Product Metrics skills if they are installed (run `productmetrics help agents` first), and tell me when a step needs me in a browser.
Check that Product Metrics sends customer data with my Meta Conversions API events from my Magento store. Use the Product Metrics MCP server, or the productmetrics CLI with --json and the Product Metrics skills if they are installed (run `productmetrics help agents` first), and tell me when a step needs me in a browser.

Fields sent

Customer information parameterWhere it comes from on MagentoSent as
Email, phoneThe Magento order; the module also passes the guest emailem, ph: hashed; phone as digits with the country code
First name, last name, postcode, countryThe Magento order’s addressfn, ln, zp, country: hashed
Customer IDYour Magento customer ID, when the order has oneexternal_id: hashed
IP address, user agentThe visitor’s browserclient_ip_address, client_user_agent: not hashed, as Meta requires
Browser and click IDsMeta’s _fbp and _fbc cookiesfbp, fbc, with ad storage consent

Product Metrics only sends what the order already has. It adds no checkout fields and guesses nothing. Sent events aren’t revised after a refund.

Troubleshooting

ProblemFix
Orders are missing in MetaCheck that Tracking → Configure consent names the banner your store actually shows (step 2).

FAQ

Does this replace my Meta pixel?

No. You can keep your browser pixel: Meta counts an event once when the pixel and the Meta Conversions API send the same event name and event ID within 48 hours.

Are guest checkout orders matched in Meta?

Yes. The module passes the guest email, which Advanced Matching receives hashed as em, with the name, postcode and country from the Magento order’s address.

No. Choose OneTrust, Cookiebot, Usercentrics or Osano, or have your developer pass the visitor’s choices. Meta has no consent mode, so without ad user data no event is sent.

Are past orders and refunds sent to Meta?

No. Meta accepts events up to 7 days old, so past orders aren’t imported, and later refunds and cancellations don’t revise events already sent.

Where next

On the website: Full Signal Tracking, first-party cookie, Product Metrics for Magento

Developers: do the same with the CLI or the API.