Skip to main content

Distribute Data to Pinterest

See the instructions below for distributing first-party data or Data Marketplace data to Pinterest.

Pinterest requires that an authorization using OAuth be performed by a user with the appropriate permission level before any distributions can be made to Pinterest. For more information, see the "Performing OAuth Authorization for Pinterest" section below.

Note

After you've run a Pinterest campaign, you're probably going to want to measure the effectiveness of that campaign. LiveRamp offers the Pinterest Offline Conversion Reporting program, which enables advertisers to send offline conversion data to Pinterest. Once the advertiser requests an attribution report based on their desired settings, Pinterest performs attribution analysis on the impact of that advertiser’s Pinterest campaign on offline conversions and sends them an offline conversion report. This allows advertisers to understand how Pinterest campaigns drive offline conversions and to find additional data to better optimize ad spend or customer experience. For more information, see "The Pinterest Conversions API Program for Offline Conversions".

Pinterest Destination Account Limits

Keep the following recommended limits in mind when adding segments to distribution for a Pinterest destination account:

Item

Limit

Maximum number of segments distributing in one destination account

500

Maximum number of segments added for distribution to a destination account per hour

200 per hour

Exceeding these limits might result in deliveries taking longer than our usual 12-72 hours expected processing time.

Distribute First-Party Data to Pinterest

When distributing your first-party data to Pinterest, two integration options are available:

  • A Record Sync-enabled first-party data integration, which keeps your data fresh at the destination by enabling data refreshes to utilize user deletions (see "Keep Destination Data Fresh with Record Sync" for more information).

    Note

    Record Sync is currently only available to US customers.

  • A first-party integration that is not enabled for Record Sync.

Configure the Required Properties

When activating a Pinterest First-Party Data destination account, use the following guidelines to configure the required properties:

  • Advertiser ID: Your Pinterest-provided advertiser account ID. Should be numeric.

  • Destination Account Name: Pick a unique and memorable name for this account. We'll suggest one for you but you can use any name you wish as long as it is less than 50 characters in length.

Enable and Validate an OAuth Connection

Follow the instructions in “Validate OAuth Connection During Destination Account Activation” and "Perform OAuth Authorization for Pinterest" below to enable and validate an OAuth connection for the Pinterest destination account.

Distribute Data Marketplace Data to Pinterest

When distributing Data Marketplace data to Pinterest, only one integration option is available: "Data Marketplace".

Note

Configure the Required Properties

When activating a Pinterest Data Marketplace destination account, use the following guidelines to configure the required properties:

  • Advertiser ID: Your Pinterest-provided advertiser account ID. Should be numeric.

  • Data Usage Reporting Requirement: Type "I Agree" in the text box to acknowledge that you will report the impressions and amount spent associated with this campaign to LiveRamp on a monthly basis. See “Report Usage for Data Marketplace Distributions to Advertiser Direct Destinations” for instructions on how to pull reports.

  • Payment Model: Type "I Agree" in the text box to acknowledge that the cost of all data used in this campaign will be calculated as a percentage of campaign spend, using the 'Amount Spent' column provided in monthly usage reporting.

  • Payment Requirement: Type "I Agree" in the text box to acknowledge that you will pay for the use of this data in accordance with the Consumer Social Amendment.

  • Reporting Contact Email: Enter the email addresses (comma separated if multiple email addresses) for the people who will be sending usage reports for the Advertiser ID listed above.

  • Destination Account Name: Pick a unique and memorable name for this account. We'll suggest one for you but you can use any name you wish as long as it is less than 50 characters in length.

Enable and Validate an OAuth Connection

Follow the instructions in “Validate OAuth Connection During Destination Account Activation” and "Perform OAuth Authorization for Pinterest" below to enable and validate an OAuth connection for the Pinterest destination account.

Performing OAuth Authorization for Pinterest

Pinterest requires that an authorization using OAuth be performed by a user with the appropriate permission level before any distributions can be made to Pinterest.

Within Connect, OAuth authorizations are performed by utilizing an OAuth "connection" and validating it with your destination-specific information. A connection can be created by any user with the appropriate permission level at Pinterest and can be reused for multiple Pinterest destination accounts. See "Managing OAuth Connections" for information on creating, viewing, and managing OAuth connections.

This validation must be done when the destination account is activated, either by using an existing Pinterest OAuth connection or by creating a new Pinterest connection during the activation process. You can also create a Pinterest OAuth connection outside of the destination account activation process. See the sections below for more information.

Whichever method you use, follow the instructions in "Perform OAuth Authorization for Pinterest" below once the Pinterest authorization dialog appears.

Validate OAuth Connection During Destination Account Activation

While performing the steps in “Activate a New Destination Account” and before attempting to finalize the activation:

Note

The instructions below are valid for any OAuth destination platform. The screenshots show the process for LinkedIn as an example.

  1. Select one of your existing OAuth connections for that destination from the OAuth Connection drop-down list, or select + New OAuth Connection to create a new connection for that destination and follow the authorization process at the destination's website (LinkedIn example shown).

    C-Activate_New_Destination_Account-Select_OAuth_Connection.jpg

    Note

    If creating a new connection, follow the instructions to perform the authorization in the dialog that opens for that destination. See the appropriate section below for authorization information for specific platforms.

  2. Enter the appropriate information in the other OAuth-related fields (LinkedIn example shown - required fields vary by destination).

    C-Activate_New_Destination_Account-OAuth_fields.jpg
  3. Click VALIDATE OAUTH CONNECTION.

    C-Activate_New_Destination_Account-Validate_OAuth_Connection_button.jpg

    Note

    When activating a TikTok destination account, no VALIDATE OAUTH CONNECTION button appears (unlike other OAuth platform’s destination accounts). Skip to the next step.

    After the validation process is completed, a validated check mark appears:

    C-Managing_OAuth_Connections-validate_checkmark.jpg

    Note

    If a system error occurs, an error banner appears:

    C-Managing_OAuth_Connections-validate_system_error_banner.jpg

    Try to validate again. If you continue to get this error, contact your LiveRamp representative.

    Note

    If the seat or account ID is incorrect, an error message appears:

    C-Managing_OAuth_Connections-validate_error_message.jpg

    Check that the ID is correct and try to validate again.

  4. Complete any additional steps to activate the destination account.

Perform OAuth Authorization for Pinterest

Permission level required: Admin or Audience level

OAuth expiration: None

Required destination account fields:

  • Advertiser ID: Your Pinterest-provided advertiser account ID. Should be numeric.

Steps to perform OAuth for Pinterest:

  1. After the Pinterest login dialog appears, enter your credentials and then click Log in.

    C-Authorize_DA_with_OAuth-Pinterest_login-screen.png
  2. From the Authorize app dialog, click Give access.

    C-Authorize_DA_with_OAuth-Pinterest_app_popup.png

You’ll be directed back to the destination account screen and should see the blue success banner at the top of the screen.