Skip to main content
This guide connects a dataset of conversion events to the Meta Conversions API, so Meta can attribute conversions to your campaigns. Delivering conversion events to Meta involves three steps: creating a connector profile, preparing your dataset, and adding a connection.

​
Prerequisites

Before you begin, check the Meta Conversions API prerequisites.

​
Step 1: Create a connector profile

1

Navigate to the connector

In Narrative, go to Connectors and select Meta Connector.
2

Authenticate with Meta

Click Connect and sign in with your Meta account. During the OAuth flow, you will be prompted to:
  1. Select your business portfolio — Choose the Meta business portfolio that owns the ad accounts you want to deliver events to.
  2. Grant ad account access — Select the ad accounts that Narrative should be able to access. You must grant access to at least one ad account.
Make sure the ad accounts you select have an active dataset (pixel) configured in Meta Events Manager.
3

Select your ad account

Choose the ad account where conversion events should be delivered.

​
Step 2: Create your dataset

Your dataset must be mapped to the meta_conversion_event Rosetta Stone attribute. The recommended approach is to map your source data to this attribute and then materialize it using Data Studio or NQL.
The connector profile requires your dataset to include meta_conversion_event and at least one supported user identifier for user matching. Meta uses these identifiers to match conversion events to user accounts. Any dataset that contains the required attributes in the correct schema is eligible for delivery.
See the attribute schema for the full list of event fields, and Supported user identifiers for the identity attributes your dataset must include.

​
Step 3: Add a connection

1

Open your connector profile

Navigate to the Meta connector profile you created in Step 1.
2

Add a new connection

Click Add Connection and select Deliver Conversion Events as the connection type.
3

Configure delivery options

  • Deliver all data — Toggle on to deliver all data currently in the dataset. If off, only new data written after the connection is created will be delivered.
  • Test Event Code (optional) — Enter a test event code from Meta Events Manager. When provided, events are sent as test events and appear in Meta’s Test Events tab instead of being processed as real conversions. Use this to validate your setup before going live.
4

Connect

Click Connect to activate. Events will begin delivering on the next scheduled run.

​
Related content

Meta Conversions API Connector

Requirements, settings, and reference details