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

Prerequisites

Before you begin, check the Pinterest Conversions API prerequisites.

Step 1: Create a connector profile

If you already deliver audiences through the Pinterest Connector, you can reuse your existing profile and skip this step.
1

Navigate to the connector

In Narrative, go to Installed Apps and select Pinterest Connector.
2

Connect your Pinterest account

In the Profiles tab, click Connect and authorize Narrative to access your Pinterest Business account.
3

Select your ad account

In the Ad Accounts tab, choose the ad account where conversion events should be delivered.

Step 2: Create your dataset

Your dataset must be mapped to the pinterest_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 requires your dataset to include pinterest_conversion_event and at least one supported user identifier for user matching. 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 Pinterest 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.
4

Connect

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

Pinterest Conversions API Connector

Requirements, settings, and reference details