Sync Audiences to Pinterest Audience
Beta5 minute read
This guide lists the steps to configure Pinterest Audience as a destination in RudderStack and sync the created audiences to it.
Pinterest Audience is separate from the Event Stream Pinterest Tag destination. Membership is synced to a Pinterest customer list audience.
Setup
- Set up an audience in RudderStack using the Audience Builder.
- Go to the Syncs tab of the audience page and click Add sync. Then, select Pinterest Audience.
- Click New destination — you can also select an already-configured destination here.
- Specify a unique name to identify this destination in RudderStack.
- In the Pinterest account section, click Select to choose an existing Pinterest account. To add a new account, click Add account and authenticate via OAuth by specifying the following settings:
| Setting | Description |
|---|---|
| Account name | Specify a unique account name. After you connect, RudderStack replaces it with your Pinterest username. |
| OAuth settings | Click Connect account, sign in to Pinterest, and give RudderStack the requested permissions. Sign in as a Pinterest user that owns or has access to the ad account you want to sync to. |
- Proceed to configure the mapping settings.
Configure sync
This section lists the settings to correctly configure your audience syncs to the Pinterest Audience destination.
Select ad account
Select the Pinterest ad account that owns the customer list and its audience. The list shows every ad account the connected Pinterest user owns or has access to.
Select audience
In this section, you can create a new audience or use an existing one:
- Create new audience: RudderStack creates a customer list and a customer list audience on it in the selected ad account. Enter a name of 3 to 500 characters.
- Use existing audience: Select an existing customer list audience in the selected ad account. Only customer list audiences are listed.
Pinterest needs at least 100 matched users before an audience can be used for targeting, and it can take 48–72 hours to process an upload.
Sync mode
Only Mirror mode is supported for this integration. Users who leave the audience are removed from the Pinterest customer list at the next run.
Map identifiers
Map your audience columns to the Pinterest identifiers. You must map at least one:
| Identifier | Description |
|---|---|
| The user’s email address. | |
| Mobile advertising ID (MAID) | The user’s mobile advertising ID, for example, an Android advertising ID (AAID). |
Pinterest matches a user if any identifier matches, so mapping both gives a better match rate. Phone numbers aren’t supported.
Don’t send IDFAs collected from activity in an iOS app or website. Pinterest’s policy forbids uploading them.
Advanced settings
| Setting | Description |
|---|---|
| Automatically hash PII data? | When set to Yes (default), RudderStack normalizes the mapped values and hashes them with SHA-256 before sending them to Pinterest. Set it to No only if your columns already hold SHA-256 hashes. See Data hashing for more information. |
Sync settings
Two options are available to schedule your audience syncs:
- Run syncs automatically based on a specified frequency (every 5 minutes, 10 minutes, 15 minutes, 30 minutes, 1 hour, 3 hours, 6 hours, 12 hours, or 24 hours) and a specific time (in UTC).
- Run syncs manually — trigger a sync from the sync details page. You will need to run the sync each time.
Sync observability settings
| Setting | Description | ||||||
|---|---|---|---|---|---|---|---|
| Retain sync logs | This setting is toggled on by default and instructs RudderStack to store the sync logs in your warehouse. You can also configure the below settings:
| ||||||
| Retry failed records | This setting is toggled on by default and causes RudderStack to continually retry sending the failed records. | ||||||
| Retain and show failures | This setting is toggled off by default. Turn it on to have RudderStack write the error recorded for every failed record to a failed records table in your warehouse and show it in the sync’s failed records view. It applies from the next sync and can take up to a minute to reach your data plane.
|
Storing sync logs, snapshot tables, and failed records may incur additional warehouse costs.
Enable sync
Once the setup is complete, enable the sync.
FAQ
Why is my audience not ready in Pinterest yet?
Pinterest processes each upload. A new audience is usually ready within 48 to 72 hours, and its size updates within 24 to 48 hours. An audience with fewer than 100 matched users can’t be used for targeting. See Pinterest processing and audience size.
Why do some rows fail?
A row fails if it has no valid email address or MAID after normalization, or if its values don’t match the Automatically hash PII data? setting. See Troubleshooting for each error and how to fix it.
What happens if I delete the sync?
RudderStack stops updating the customer list. The customer list and its audience stay in Pinterest, even if RudderStack created them. Delete them in Pinterest Ads Manager if you no longer need them.
