Pinterest Conversions

Learn how to send conversion events to Pinterest Ads via Growthloop

In this article, we'll walk you through syncing conversion events to Pinterest for a more comprehensive view of your campaign performance. Let's get started!

Supported Objects

GrowthLoop enables syncing to the following Pinterest object:

ObjectDescriptionSync ModesField Mappings (Required)Field Mappings (Optional)
ConversionSync and track web, in-app, and offline behaviorsInsert (adds new events)Action Source: Where the conversion event occurred, such as web, offline, etc

Event Name: The type of the user event, such as checkout, page_visit, search, etc

Event ID: The unique id string that identifies the event

Event Time (timestamp): The time when the event happened in Unix format

User Data: At least one piece of user data for matching, like hashed email or or both Client IP Address and Client User Agent
See full list of parameters here

Prerequisites

  • Have a Pinterest Ads Manager account. Create one here!
  • Created a Conversion Access Token. To create one, open the main dropdown in the upper left corner, click Conversions under Manage Business, then click Set up API under Conversion API, and finally, select Generate New Token.

Set up connection

  1. To begin, sign into the GrowthLoop Platform and navigate to the Destinations tab on the left sidebar. Click New Destination in the top right corner.

  2. In the Select Destination window that appears, just type Pinterest into the search bar. Then, click Add Pinterest.

  3. In the window, please enter the following information to set up the connection to the destination.

    • Destination Name: This is how the destination will be named and referred to in the app going forward.
    • Sync Frequency: Choose between Hourly or Daily to determine how frequently GrowthLoop exports audiences to Pinterest.
    • Select Ad Account: Choose the account where you would like to receive GrowthLoop audiences.
    • Conversion Access Token: Enter your Conversion Access Token here to send conversion events to Pinterest Ads.
    • Access & Refresh tokens: These tokens are automatically generated when you authorize the app.
  4. Once you've entered the information, click on Create. We'll check to make sure we have all the necessary permissions to send audience data to Pinterest. If everything is in order, you'll now find the new Pinterest Destination in your list of connected destinations.

Set up sync

  1. To route the latest conversion events (e.g., web, in-app, offline) to Pinterest, go to the Syncs tab on the left sidebar and click Create Sync in the top right corner.
  2. Clicking Create Sync will require you to select/insert the following information:
    1. Route Name:
      1. Name: A friendly name for the signal route.
      2. Sync Frequency: The default frequency for syncing the latest conversion info to a destination.
      3. Update Rule: The default operation for syncing the latest user info to a destination. Pinterest supports only the Insert rule, which means new data is added to the destination without updating or overwriting existing data.
    2. Source:
      1. Source Dataset/Table: The table that holds the latest user info. Usually, it's organized within an Events table.
      2. Dataset Unique Field(s): The column that contains values that are distinct for each user in the table.
      3. Match Field: The column used to match and identify users from your source table in the destination system. Please select the column that contains either MAID, Hashed Email, Client IP Address.
    3. Destinations:
      1. Connection: The destination you will sync data to. Please select the Pinterest destination you set up in the previous step.
      2. Object Type: The object you want to send data to. Please select Conversion Event.
      3. Match Field: The column used to match and identify users from the destination system in your source table. Depending on what you selected as your Source Match Field, choose MAID, Hashed Email, or Client IP Address.
  3. Once you finish selecting/inserting the required fields, click Save Route.
  4. It's time to add the field mappings to activate your signal route. The following fields are required: Action Source, Event Name, Event ID, and Event Time (timestamp). In addition, you must select either Emails or Hashed MAID (List) or both Client IP Address and Client User Agent.
  5. To map the fields, navigating to the Field Mapping section. Choose the columns that correspond to the required Destination Fields from the drop-down menu under Source.
  6. To include extra mappings for the other fields, click on Add Mapping. This will generate a new row for Source > Destination.
  7. Look for and choose the fields in your source table for the remaining items.
  8. Finally, click the toggle at the top of the page to enable the sync!

πŸ‘

Success

You have successfully created a conversion sync to Pinterest!

To confirm that your event data has been received, log in to your Ads account, navigate to the Account Overview menu and select Conversions under Business.


πŸ“˜

Note:

If you experience any issues when connecting to or creating syncs to Pinterest Conversions, please reach out to us atΒ [email protected], and we’ll be in touch shortly to help resolve the matter!