There are several ways to create a dataset and set up the Conversions API, depending on the types of events that you want to send. Use the table below to learn which Conversions API setup options are available.
Note: If you've already set up the Conversions API using a direct integration, you can update your setup with new types of events. To update an existing integration, follow steps 1 and 2 below. For step 3, update your Conversions API setup by adding the new events to your code. Certain parameters are required and vary by event type. Learn which parameters are required for events sent through the Conversions API.
Step 1: Determine which events you want to send. | Step 2: Create a dataset. | Step 3: Set up the Conversions API. |
|---|
App only | Create a dataset through an existing app and select Create new when prompted. Learn more. | - Go to Events Manager and select the dataset that you just created. You'll use this new dataset ID to set up the Conversions API and your events.
- Create personalised direct integration instructions in Events Manager and send the instructions to your developer. Learn more.
If you don't want to create personalised instructions, you can visit Meta for Developers for instructions on how to set up a direct integration. Learn more. |
Website only | You don't need to create a dataset, but you should create and install the Meta pixel if you haven't already. Learn more. | Choose from a supported setup option. Learn more. Use your Meta pixel ID to set up the Conversions API and your events. |
Offline only | Create a dataset during offline event set creation. Learn more. | - Go to Events Manager and select the dataset that you just created. You'll use this new dataset ID to set up the Conversions API and your events.
- Create personalised direct integration instructions in Events Manager and send the instructions to your developer. Learn more.
|
App and website | Create a dataset through an existing app and select Create from a pixel ID when prompted. Learn more. | - Go to Events Manager and select the dataset that you just created. You'll use this new dataset ID to set up the Conversions API and your events.
Note: Your new dataset ID is the same as your pixel ID, and your app ID will stay the same. - Create personalised direct integration instructions in Events Manager and send the instructions to your developer. Learn more.
|
App and offline | Create a dataset during offline event set creation. Then link an app to your dataset. Learn more. | - Go to Events Manager and select the dataset that you just created. You'll use this new dataset ID to set up the Conversions API and your events.
- Create personalised direct integration instructions in Events Manager and send the instructions to your developer. Learn more.
|
Website and offline | Create a dataset during offline event set creation. Learn more. | - Go to Events Manager and select the dataset that you just created. You'll use this new dataset ID to set up the Conversions API and your events.
- Create personalised direct integration instructions in Events Manager and send the instructions to your developer. Learn more.
|
Website, app and offline | Create a dataset through an existing app and select Create from a pixel ID when prompted. Learn more. | - Go to Events Manager and select the dataset that you just created. You'll use this new dataset ID to set up the Conversions API and your events.
Note: Your new dataset ID is the same as your pixel ID, and your app ID will stay the same. - Create personalised direct integration instructions in Events Manager and send the instructions to your developer. Learn more.
|
Messaging only, or messaging and website | Create a dataset during messaging event set creation. Learn more. | - Go to Events Manager and select the dataset that you just created. You'll use this new dataset ID to set up the Conversions API and your events.
- Create personalised direct integration instructions in Events Manager and send the instructions to your developer. Learn more.
|
Messaging, website, app and offline | Create a dataset during messaging event set creation. Then link an app to your dataset. Learn more. | - Go to Events Manager and select the dataset that you just created. You'll use this new dataset ID to set up the Conversions API and your events.
- Create personalised direct integration instructions in Events Manager and send the instructions to your developer. Learn more.
|
chevron-down
chevron-down
