Facebook Conversions

Use anonymous website visitors and warehouse conversion events for Meta measurement.

Connect this destination to export audience membership as an Audience Membership event, or to write warehouse conversion events onto your Facebook pixel, for use in Events Manager.

This destination writes to your Meta account and is a good fit when you want to:

  • Make anonymous website visitors available for Facebook ads
  • Get measurement from warehouse conversion events

This maps to GrowthLoop Audiences and Syncs:

Use it forAudiencesSyncs
Sending anonymous website visitors as an Audience Membership event
Sending conversion events for measurement
Sending events to the Advanced Measurement API

To export known customers with match fields, use Facebook Ads. Do not use that destination for anonymous visitors or conversion events.

Prerequisites

Make sure you have:

  • A Facebook business account and the Ad Account that should receive events.
  • Your Pixel ID. Create one with Meta's pixel instructions, or copy an existing ID from Ads Manager → Events Manager. See Meta's Events Manager help.

If you will export anonymous website visitors, you also need:

  • MetaRouter set up on your website or application so page views, clicks, and other activity flow into your warehouse. See MetaRouter's getting started guide. GrowthLoop can help you complete this setup.
  • Anonymous user and event data consolidated in your warehouse so you can build GrowthLoop datasets and filter audiences. GrowthLoop can help you structure that data.

If you will sync to the Advanced Measurement API, set Advanced Measurement Table when you connect the destination.

Set up Facebook Conversions as a destination

  1. In GrowthLoop, click the Destinations tab on the left sidebar.
  2. Click New Destination in the upper right corner.
  3. Search for Facebook Conversions and click Add Meta / Facebook Conversions.
Select Destination modal showing Facebook Conversions
  1. Log in to Facebook with the business account that owns the pixel and Ad Account.
  2. Enter the required information, then click Create.
Facebook Conversions destination setup form with the Facebook Pixel field
FieldDescription
Destination NameName this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "Facebook Conversions".
Sync FrequencySet the default frequency (for example, hourly or daily). You can override this setting for individual exports and syncs.
Select Ad AccountThe Ad Account that should receive events
Facebook PixelYour Facebook Pixel ID. Use the same Pixel ID for browser and server events. This field is required
Advanced Measurement Table (optional)Required later if you will sync to the Advanced Measurement API

GrowthLoop validates the connection. Facebook Conversions then appears in your list of connected destinations.

Export to Facebook Conversions

From within GrowthLoop, export from an audience built on the anonymous visitor datasets. See Export an audience if you need more information on these steps.

After building or selecting an audience, click Export, then search for your Facebook Conversions destination.

For the first export, use a test audience so you can verify the Audience Membership event in Meta.

Configure the export

SettingAudience export
Export NameDefaults to the audience name
Campaign typeChoose a one-time or ongoing export
ScheduleSet frequency, start date, end date, and days of the week for ongoing exports

Export behavior

BehaviorWhat happens
What GrowthLoop writesAn Audience Membership event to your Facebook pixel. Direction is GrowthLoop → Meta.
When it runsGrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes. The event can take about 1 hour to appear in Events Manager.
EventGrowthLoop names the event Audience Membership. You must verify and accept it in Meta before you can use it.
One-time exportsGrowthLoop sends current membership once.
Ongoing exportsGrowthLoop sends updated membership on each scheduled run.

This export does not send conversion events. To send conversion events, create a sync.

Create a sync in GrowthLoop

Create a sync from a warehouse table to write conversion events onto your Facebook pixel. See Syncs for information on how to complete those steps.

Select an Object Type:

ObjectUse it forSync modes
ConversionConversion events in Facebook Ads ManagerInsert
AMAPIEvents on the Facebook Advanced Measurement APIInsert

When you configure the sync:

  • Connection: Select your Facebook Conversions destination.
  • Object Type: Select Conversion or AMAPI.
  • Update Rule: Choose Insert. Conversion and AMAPI both support Insert only. See Sync behavior.
  • Dataset/Table: Select the warehouse table that holds the events.
  • Match Field: For Conversion, map an identifier Facebook Conversion API accepts, such as email, phone, External ID, Click ID, Browser ID, Subscription ID, Facebook Login ID, Lead ID, Client IP Address, or Client User Agent.
  • Sync frequency: Choose 15 minutes, 30 minutes, hourly, or daily.

After you map fields, click Save Sync. Enable the sync with the toggle at the top of the page.

Conversion fields

Destination fieldRequiredDescription
Event NameYesA standard event such as AddToCart, Purchase, or Search, or a custom event. See Meta standard events
Event IDYesA unique string for this event. Required for deduplication with browser or app events
Event TimeYesWhen the event occurred, in ISO 8601. Facebook converts this value to Unix
Action SourceYesWhere the conversion took place: email, website, app, phone_call, chat, physical_store, system_generated, or other

You can also map additional Conversion API parameters. See Meta's Conversions API parameters.

AMAPI fields

Destination fieldRequiredDescription
Event TimeYesWhen the event occurred. The API accepts events from the last 72 hours only
IdentifierYesOne of email, phone, city, state, country, first name, or last name

Set Advanced Measurement Table on the destination before you sync AMAPI.

Sync behavior

BehaviorWhat happens
When it runsGrowthLoop sends the sync as a batch on the next successful run.
InsertGrowthLoop adds new events. Existing events are not updated.
Conversion matchMap an identifier the Conversion API accepts, such as email or phone.
AMAPI matchMap Event Time and one identifier. Events older than 72 hours are rejected.
Audience membershipSyncs do not create an Audience Membership event or a targeting audience.
DeletesGrowthLoop does not delete previously uploaded events.

Rows without the required fields fail.

Confirm the export was successful

When the run finishes, confirm you can use the data in Facebook Conversions.

  • Audience export: Open Events Manager and look up the Audience Membership event. Verify and accept that event. After Meta accepts it, use Meta's audience creator to build an audience from Audience Membership.
  • Conversion sync: Open Events Manager and look up the conversion events.
  • AMAPI sync: Open Events Manager and look up the Advanced Measurement events.
Meta Events Manager showing received Facebook Conversions events

In GrowthLoop, review counts on the audience Exports tab, or confirm the sync appears in the Syncs table. See Export an audience or Syncs for more information.

Congrats on successfully exporting to Facebook Conversions!

Troubleshooting

These are the issues we see most often. You can always email us at [email protected] for help.

ProblemCauseResolution
Connection fails to validateFacebook Pixel is empty, or you signed in with the wrong accountEnter your Pixel ID and log in with the business account that owns the pixel and Ad Account
The Audience Membership event is missingYou are looking too soon, or you are not in Events ManagerWait about 1 hour, then open Events Manager and look for Audience Membership
You cannot build a Meta audienceThe Audience Membership event is not verifiedVerify and accept Audience Membership in Events Manager
The audience has no anonymous visitorsMetaRouter is not sending events to the warehouse, or the datasets are not set upConfirm MetaRouter is capturing activity, then build the audience on those datasets
A Conversion sync failsA required event field is missingMap Event Name, Event ID, Event Time, and Action Source
AMAPI rows failEvent Time is older than 72 hours, no identifier is mapped, or Advanced Measurement Table is emptyUse an event from the last 72 hours, map an identifier, and set Advanced Measurement Table on the destination
A sync did not create a targeting audienceSyncs send conversion events onlyExport an audience to send Audience Membership, then verify that event

What’s Next

Create a sync after you connect a destination

Did this page help you?