Connect this destination to write warehouse conversion events onto Pinterest Ads, for use in campaign measurement.

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

Get measurement for web, in-app, or offline conversions in Pinterest
Use a warehouse table that has an event name, event time, event ID, and a match identifier

This maps to GrowthLoop Syncs:

Use it for	Syncs
Sending conversion events for measurement	✓

You already connected Pinterest as a destination. Do not use this workflow to add contacts to a customer list. To activate customers for targeting, use Pinterest.

Prerequisites

Make sure you have:

Pinterest connected as a destination.
A Conversion Access Token from Pinterest. In Ads Manager, open Conversions under Manage Business, then Set up API under Conversion API, and generate a token.
A warehouse table of conversion events.

Create a sync in GrowthLoop

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

Select an Object Type:

Object	Use it for	Sync modes
Conversion Event	Web, in-app, or offline conversion events	Insert

When you configure the sync:

Connection: Select your Pinterest destination.
Object Type: Select Conversion Event.
Update Rule: Choose Insert. This destination adds new conversion events and does not update or remove previously uploaded events. See Sync behavior.
Dataset/Table: Select the table that holds your conversion events. Use a unique event key so you do not re-send the same conversion.
Match Field: Map Emails, Hashed MAID (List), or Client IP address.

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

When you update mappings on an existing sync, choose Updates only unless you need Back-fill. Back-fill rewrites already synced rows and can be expensive on your warehouse.

Conversion fields

Destination field	Required	Description
Action Source	Yes	Where the event occurred, such as web or offline
Event Name	Yes	Event type, such as checkout, page visit, or search
Event ID	Yes	Unique ID for the event
Event Time (timestamp)	Yes	When the event happened, as a Unix timestamp
Emails	No	Email addresses. Map this, Hashed MAID (List), or both Client IP address and Client User Agent. GrowthLoop hashes emails as SHA-256
Hashed MAID (List)	No	Mobile advertising IDs. GrowthLoop hashes values that are not already SHA-256
Client IP address	No	Required together with Client User Agent when you do not map email or MAID
Client User Agent	No	Required together with Client IP address when you do not map email or MAID
Event URL	No	Page URL for the event
Opt-out	No	Opt-out flag
Partner Name	No	Partner name
App ID, App Name, App Version	No	App identifiers
Device Brand, Device Carrier, Device Model, Device Type, OS version, WIFI, Language	No	Device and locale fields

See Pinterest's conversion events API.

Sync behavior

Behavior	What happens
When it runs	GrowthLoop sends the sync as a batch on the next successful run.
Insert	GrowthLoop adds new conversion events. Syncs do not update or remove previously uploaded events.
Match	Map Emails, Hashed MAID (List), or both Client IP address and Client User Agent.
Audience membership	This sync does not create a Pinterest customer list.
Deletes	GrowthLoop does not delete previously uploaded conversion events.

Rows without Action Source, Event Name, Event ID, or Event Time fail. Rows also fail when none of the match options above are mapped.

Confirm the export was successful

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

Conversion sync: From Account Overview, open Conversions under Business and look up the events.

This workflow does not create a targeting audience.

In GrowthLoop, confirm the sync appears in the Syncs table. See Syncs for more information.

Congrats on successfully exporting to Pinterest Conversions!

Troubleshooting

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

Problem	Cause	Resolution
You do not have a Pinterest destination	The Ads destination is not connected yet	Connect Pinterest first
A conversion sync fails with a token error	Conversion Access token is missing on the destination	Edit the Pinterest destination and paste the conversion access token
A conversion sync fails	A required event field is missing, or no match identifier is mapped	Map Action Source, Event Name, Event ID, and Event Time, plus Emails, Hashed MAID (List), or both IP and user agent
A sync did not change Audiences	This sync writes conversion events, not customer lists	Export an audience on Pinterest to create or update a customer list