This preview of pull request 1639 is meant for internal use only.

Pinterest Audiences Destination

Pinterest Audiences quick info

Pinterest Audiences accepts Track calls. If you reference it in the Integrations object, call it “Pinterest Audiences”.

Pinterest Audiences accepts data from any Segment mobile or server source in cloud mode. It does not accept data from a web source, and does not offer device-mode connections.

Pinterest Ads provides a way to target advertisements on Pinterest to a global audience. Segment’s Pinterest Audiences integration allows Segment Personas customers to sync audiences from Personas to Pinterest for better retargeting and higher-performing ads.

For more information about advertising with Pinterest, see:

Details

Requirements

  • Personas enabled with an existing Personas space
  • A Pinterest Ads account with the owner, admin, or audience_manager role

Supported identifiers

  • Email
  • iOS IDFA
  • Android ID

Note: The Segment iOS SDK version 4.0 and up does not collect automatically collect IDFA. For more information, see the iOS 14 Guide.

Connection type

  • Server-side

Set up

The Pinterest Audiences destination syncs data from Segment Personas to Pinterest Ads. To begin:

  1. Navigate to the Destinations section of your Personas space, and click Add Destination.
  2. Search for Pinterest Audiences and click Configure Pinterest Audiences.
  3. Confirm the Source. The default value is the source connected to the Personas space to which you’re adding the destination.
  4. On the Pinterest Audiences configuration screen, click Connect to Pinterest Audiences. Log in to Pinterest with an account that has access to the Pinterest Ads dashboard. Once authenticated, confirm the connection to Segment.
  5. Select the Pinterest Ad account that will receive audience data. This account may be your personal Pinterest account, but it must have an ad account attached. After you select the account, the destination is active.
  6. Add the Pinterest Audiences destination to an existing Personas Audience.
    1. Navigate to the Personas space that contains the audience, and select it from the Audiences tab.
    2. Click Add Destination.
    3. The configured Pinterest Audiences destination should appear in the Send as User List category of available destinations.
    4. Select the destination, and click Add Destination.

The initial synchronization of audience data may take several hours, depending on the size of the audience. Once the initial sync occurs, you’ll see a new audience in the Pinterest Audiences dashboard.

FAQ

What does the audience size represent?

The audience size represented in Pinterest is the final count of matched users between your customer profiles in Segment and Pinterest users. This number denotes your targetable audience size within Pinterest.

The initial synchronization of audience data may take several hours, depending on the size of the audience. Once the initial sync occurs, you’ll see a new Audience in the Pinterest Audiences dashboard.

Are lists/audiences processed on some interval, or on customer list update? Do we need to wait 24-48 hours every time we add/remove identifiers from a list?

Processing happens regularly and automatically throughout the day - but can take up to 24 hours.

You do not need to wait to continue sending data; however, any campaigns using those audiences will not see the changes until after processing (they’ll continue running against whatever users have already been matched).

Personas

You can send computed traits and audiences generated using Segment Personas to this destination as a user property. To learn more about Personas, contact us for a demo.

For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Personas sends an Identify call with the property order_completed_last_30days: true. When the user no longer satisfies this condition (for example, it’s been more than 30 days since their last order), Personas sets that value to false.

When you first create an audience, Personas sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.

Supported Sources and Connection Modes

Before you start, make sure Pinterest Audiences supports the source type and connection mode you’ve chosen to implement. You can learn more about connection modes here.

Web Mobile Server
📱 Device-mode ⬜️ ⬜️ ⬜️
☁️ Cloud-mode ⬜️

Settings

Segment lets you change these destination settings from the Segment app without having to touch any code.

account

You can find your Account ID on the Account Settings page of your Pinterest Ads account. It should be a series of numbers, like 319762813599.

This page was last modified: 22 Apr 2021



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account