Setup
Troubleshooting
Overview
Using the Pinterest Pixel integration, you can send rich cohort information to multiple Pinterest accounts for targeting. These audiences are passed to Pinterest in real-time, enabling you to run custom audiences and target promoted pins at Permutive cohorts. This integration is a Destination:- Destination: Permutive sends cohort entry and exit events to your Pinterest Tag ID, which you can use to build audiences for targeting in Pinterest advertising campaigns.
- Target Pinterest users with promoted pins based on Permutive cohorts
- Build custom audiences for Pinterest campaigns using real-time cohort data
- Activate cohorts to multiple Pinterest accounts for different brands or campaigns
- Retarget users who visited your website on Pinterest
Environment Compatibility
Prerequisites
- Pinterest Ads Account: You must have an active Pinterest Ads account.
- Pinterest Tag ID: You need to obtain your unique Tag ID from Pinterest. To find this:
- Log in to your Pinterest Ads account
- Click Ads in the top left-hand corner and select Conversion tags
- Choose to Create new Pinterest Tag (if you do not have one created already)
- You’ll receive a Tag ID - save this for the integration setup
Setup
- Primary Setup Steps
- Web
- iOS
- Android
1
Enable in Permutive Dashboard
Navigate to the Permutive Dashboard and go to Settings > Integrations.Click Add Integration and select Pinterest.You’ll need to configure the integration with your unique Tag ID obtained from Pinterest (see Prerequisites).Click Add Pinterest to complete the setup.
The integration will be available for use in approximately 20 minutes.
2
Activate Cohorts to Pinterest
Once the integration is enabled, you can activate cohorts to your default Pinterest account:
- Navigate to a cohort in the Permutive Dashboard
- Toggle on the Pinterest activation for that cohort
- The cohort will be sent to Pinterest in real-time
3
Verify Setup
- Open your website with your browser’s developer tools open, and filter network requests for
ct.pinterest.com - When a user enters an activated cohort, you should see a request with
event=PermutiveSegmentEntryanded[segment_id]set to the cohort code - In your Pinterest Ads account, check that the
PermutiveSegmentEntryevents are being received for your Tag ID
Permutive doesn’t create audiences in Pinterest for you. Build each audience in your Pinterest Ads account from the
PermutiveSegmentEntry events sent to your Tag ID, using the segment_id value to select the cohort.Data Types
The Pinterest integration is a Destination integration that sends cohort membership data from Permutive to Pinterest. It does not collect events into Permutive. When a cohort is activated to Pinterest, Permutive sends conversion events to your Tag ID. You build audiences in Pinterest from these events for targeting in ad campaigns.PermutiveSegmentEntry
PermutiveSegmentEntry
Troubleshooting
Integration not available after 20 minutes
Integration not available after 20 minutes
If the Pinterest integration does not become available after the expected 20-minute waiting period:
- Verify that you entered the correct Tag ID during setup
- Check that you saved the integration configuration in the Permutive Dashboard
- Ensure your Pinterest Ads account is active and in good standing
- Contact Permutive Support if the issue persists
Cohorts not appearing in Pinterest Ads Manager
Cohorts not appearing in Pinterest Ads Manager
If audiences built from Permutive events are not showing up or populating in Pinterest:
- Permutive doesn’t create audiences automatically. Check that you’ve built an audience in Pinterest from
PermutiveSegmentEntryevents with the cohort’ssegment_id - Confirm that you’ve toggled on the Pinterest activation for the cohort in Permutive
- Allow up to 24 hours for audiences to populate in Pinterest after first activation
- Verify that the Tag ID configured in Permutive matches the one in your Pinterest Ads account
- Check that your Pinterest Ads account has the necessary permissions to create custom audiences
- Ensure your cohort has a sufficient number of users (Pinterest may have minimum audience size requirements)
Multiple Pinterest accounts - wrong Tag ID being used
Multiple Pinterest accounts - wrong Tag ID being used
If cohorts are being sent to the wrong Pinterest account when using multiple accounts:
- When creating a cohort activation for an alternative Pinterest account, ensure you’ve entered the correct Tag ID in the activation configuration
- Remember that leaving the Tag ID field blank will use the default Tag ID from the integration setup
- Verify the Tag ID by checking your Pinterest Ads account under Ads > Conversion tags
- If you need to change which account receives cohorts, update the activation configuration with the correct Tag ID
Audience size is smaller than expected in Pinterest
Audience size is smaller than expected in Pinterest
If the audience size in Pinterest is significantly smaller than your cohort size in Permutive:
- Pinterest can only match users who have Pinterest accounts and have been identified by the Pinterest pixel
- Match rates vary based on your audience demographics and Pinterest usage patterns
- Consider the cookie-based nature of the integration - users need to be identified by both Permutive and Pinterest pixels
- Allow 24-48 hours for the audience to fully populate after first activation
Changelog
For detailed changelog information, visit our Changelog.