Pinterest Audiences Connector Setup Guide
This article describes how to set up the Pinterest Audiences connector.
This article provides information about using the latest version of the Pinterest Audiences connector. The previous version of the Pinterest Audiences connector is still available, but eventually will be deprecated.
To update your Pinterest Audiences connector, authenticate it, and add mappings again.
API Information
This connector uses the following vendor API:
- API Name: Pinterest REST API
- API Version: v5
- API Endpoint:
https://api.pinterest.com/v5/ - Documentation: Pinterest Audiences
Batch Limits
This connector uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:
- Max number of requests: 10000
- Max time since oldest request: 10 minutes
- Max size of requests: 1 MB
Connector Actions
| Action Name | AudienceStream | EventStream |
|---|---|---|
| Add User to Audience | ✓ | ✗ |
| Remove User from Audience | ✓ | ✗ |
Configure Settings
Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see About Connectors.
When you add this connector you are prompted to accept the vendor’s data platform policy.
After adding the connector, configure the following settings:
- Ad Account ID
Required. Unique identifier of an ad account. You can find this identifier with the following methods:- Log in to the Pinterest account that owns your advertiser account and then navigate to https://ads.pinterest.com/. In the top navigation section, click Viewing. The ad account ID will be the number underneath the ad account name in the drop-down list.
- Navigate to Ads > Overview and locate the ad account ID in the URL path. The URL uses the following format:
ads.pinterest.com/advertiser/{ad_account_id}/?....
Action Settings - Parameters and Options
Enter a name for the action and select the action type from the drop-down list.
The following section describes how to set up parameters and options for each action.
Action - Add User to Audience
Parameters
| Parameter | Description |
|---|---|
| Customer List | Select the list to add records to. Customer lists are a type of audience. For more information, see Audience targeting or the Audiences section of the ads management guide. |
| Email Address (plain text) | Provide a plain text email address (must include an @). |
| Email Address (already hashed) | Provide an email address which has been already whitespace trimmed, lowercased, and MD5, SHA1 or SHA256 hashed. |
| Email Address (apply MD5 hash) | Provide a plain text email address (must include an @) and the connector will whitespace trim, lowercase, and hash this value using MD5 hash. |
| Email Address (apply SHA1 hash) | Provide a plain text email address (must include an @) and the connector will whitespace trim, lowercase, and hash this value using SHA1 hash. |
| Email Address (apply SHA256 hash) | Provide a plain text email address (must include an @) and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash. |
| Apple IDFA (already hashed) | Provide an Identifier for Advertisers which has been already whitespace trimmed, and MD5, SHA1 or SHA256 hashed. |
| Apple IDFA (apply MD5 hash) | Provide an Identifier for Advertisers and the connector will whitespace trim and hash this value using MD5 hash. |
| Apple IDFA (apply SHA1 hash) | Provide an Identifier for Advertisers and the connector will whitespace trim and hash this value using SHA1 hash. |
| Apple IDFA (apply SHA256 hash) | Provide an Identifier for Advertisers and the connector will whitespace trim and hash this value using SHA256 hash. |
| Mobile Ad ID (already hashed) | Provide a Mobile Ad ID which has been already whitespace trimmed and MD5, SHA1 or SHA256 hashed. |
| Mobile Ad ID (apply MD5 hash) | Provide a Mobile Ad ID and the connector will whitespace trim and hash this value using MD5 hash. |
| Mobile Ad ID (apply SHA1 hash) | Provide a Mobile Ad ID and the connector will whitespace trim and hash this value using SHA1 hash. |
| Mobile Ad ID (apply SHA256 hash) | Provide a Mobile Ad ID and the connector will whitespace trim and hash this value using SHA256 hash. |
Action - Remove User from Audience
Parameters
| Parameter | Description |
|---|---|
| Customer List | Select the list to remove records from. Customer lists are a type of audience. For more information, see Audience targeting or the Audiences section of the ads management guide. |
| Email Address (plain text) | Provide a plain text email address (must include an @). |
| Email Address (already hashed) | Provide an email address which has been already whitespace trimmed, lowercased, and MD5, SHA1 or SHA256 hashed. |
| Email Address (apply MD5 hash) | Provide a plain text email address (must include an @) and the connector will whitespace trim, lowercase, and hash this value using MD5 hash. |
| Email Address (apply SHA1 hash) | Provide a plain text email address (must include an @) and the connector will whitespace trim, lowercase, and hash this value using SHA1 hash. |
| Email Address (apply SHA256 hash) | Provide a plain text email address (must include an @) and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash. |
| Apple IDFA (already hashed) | Provide an Identifier for Advertisers which has been already whitespace trimmed and MD5, SHA1 or SHA256 hashed. |
| Apple IDFA (apply MD5 hash) | Provide an Identifier for Advertisers and the connector will whitespace trim and hash this value using MD5 hash. |
| Apple IDFA (apply SHA1 hash) | Provide an Identifier for Advertisers and the connector will whitespace trim and hash this value using SHA1 hash. |
| Apple IDFA (apply SHA256 hash) | Provide an Identifier for Advertisers and the connector will whitespace trim and hash this value using SHA256 hash. |
| Mobile Ad ID (already hashed) | Provide a Mobile Ad ID which has been already whitespace trimmed and MD5, SHA1 or SHA256 hashed. |
| Mobile Ad ID (apply MD5 hash) | Provide a Mobile Ad ID and the connector will whitespace trim and hash this value using MD5 hash. |
| Mobile Ad ID (apply SHA1 hash) | Provide a Mobile Ad ID and the connector will whitespace trim and hash this value using SHA1 hash. |
| Mobile Ad ID (apply SHA256 hash) | Provide a Mobile Ad ID and the connector will whitespace trim and hash this value using SHA256 hash. |
This page was last updated: April 4, 2023