Pinterest Audiences Connector Setup Guide
This article describes how to set up the Pinterest Audiences connector.
API Information
This connector uses the following vendor API:
- API Name: Pinterest Marketing API: Audience
- API Version: v4
- API Endpoint:
https://api.pinterest.com/ads/
- Documentation: Pinterest Marketing API: Audience
Batch Limits
This connector uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following 3 thresholds is met:
- 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
Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.
After adding the connector, configure the following settings:
- Advertiser I
- Required path parameter for all Advertiser API requests.
- Specified Advertiser ID must be associated with the authenticated user.
Action Settings - Parameters and Options
Click Next or go to the Actions tab. This is where you configure connector actions.
This section describes how to set up parameters and options for each action.
Action - Add User to Audience
Parameters
Parameter | Description |
---|---|
Customer Lists |
|
Email address (already hashed) |
|
Email address (apply SHA256 hash) |
|
Email address (apply MD5 hash) |
|
Mobile Ad ID (already hashed) |
|
Mobile Ad ID (apply SHA256 hash) |
|
Mobile Ad ID (apply SHA1 hash) |
|
Mobile Ad ID (apply MD5 hash) |
|
Action - Remove User from Audience
Parameters
Parameter | Description |
---|---|
Customer Lists |
|
Email address (already hashed) |
|
Email address (apply SHA256 hash) |
|
Email address (apply MD5 hash) |
|
Mobile Ad ID (already hashed) |
|
Mobile Ad ID (apply SHA256 hash) |
|
Mobile Ad ID (apply SHA1 hash) |
|
Mobile Ad ID (apply MD5 hash) |
|
This page was last updated: September 23, 2021