Pinterest CAPI Integration

Send server-side conversions to Pinterest Ads

Pinterest Conversions API Integration

Connect Anacoic to Pinterest Ads to send server-side conversion events for improved campaign attribution and optimization.

Prerequisites

Before you begin:

A Pinterest Business account
A Pinterest Tag (recommended)
Access to Pinterest API for Conversions

Setup Instructions

Step 1: Find Your Tag ID

Log in to Pinterest Business Hub
Go to Ads → Conversions
Select your Tag or create a new one
Copy the Tag ID (13-digit number)

Step 2: Get Your Access Token

Go to Business Hub → Developers
Create a new app or select existing
Navigate to API Access
Generate an access token with ads:write scope
Copy the token

Note: Pinterest tokens expire after 30 days and must be refreshed.

Step 3: Configure in Anacoic

Go to your Gateway → Integrations tab
Find Pinterest and click Connect
Enter:
- Tag ID: From Step 1
- Access Token: From Step 2
Toggle Enable Integration on
Click Save Configuration

Event Mapping

Anacoic automatically maps events to Pinterest’s taxonomy:

Anacoic Event	Pinterest Event
`Pageview`	`page_visit`
`View Content`	`view_category`
`Search`	`search`
`Add to Cart`	`add_to_cart`
`Add to Wishlist`	`add_to_wishlist`
`Initiate Checkout`	`checkout`
`Purchase`	`purchase`
`Lead`	`lead`
`Sign Up`	`signup`
`Watch Video`	`watch_video`

User Data Requirements

Pinterest requires hashed user data for privacy:

Automatically Hashed Fields:

Email (em)
Phone number (ph)
Gender (ge)
Birthdate (db)
First name (fn)
Last name (ln)
City (ct)
State (st)
ZIP code (zp)
Country (country)
External ID (external_id)

Example Event:

anacoic.track('Purchase', {
  value: 75.00,
  currency: 'USD',
  order_id: 'ORDER-456',
  user: {
    email: '[email protected]',      // Will be hashed
    phone: '+1-555-0199',               // Will be hashed
    firstName: 'Jane',
    lastName: 'Smith',
    city: 'New York',
    state: 'NY',
    zip: '10001',
    country: 'US',
    external_id: 'cust_789'
  }
});

E-commerce Data

Pinterest supports rich product data:

anacoic.track('Purchase', {
  value: 150.00,
  currency: 'USD',
  order_id: 'ORDER-123',
  content_ids: ['PROD-001', 'PROD-002'],
  content_name: 'Summer Collection',
  content_category: 'Clothing',
  num_items: 2,
  contents: [
    { id: 'PROD-001', item_price: 75.00, quantity: 1, item_name: 'Summer Dress' },
    { id: 'PROD-002', item_price: 75.00, quantity: 1, item_name: 'Beach Hat' }
  ]
});

Search Events

For search tracking, include the search query:

anacoic.track('Search', {
  search_string: 'summer dresses',
  query: 'summer dresses'  // Alternative field name
});

Testing Your Integration

Live Logs Method

Go to Gateway → Live Logs
Trigger a test event
Look for “Pinterest” destination with status 200

Pinterest Events Manager

Go to Business Hub → Analytics → Conversions
Click on your Tag
View the Event History
Look for “API” as the source

Match Quality

Pinterest uses advanced matching to connect events to users:

User Data	Match Strength
Email	High
Email + Phone	Very High
Email + Phone + External ID	Maximum

Tip: Enable Auto-Enrichment to automatically capture available user data from your e-commerce platform.

Troubleshooting

”401 Unauthorized”

Token expired (valid for 30 days)
Generate a new token and update configuration

”400 Bad Request”

Invalid event format
Check Live Logs for detailed error messages
Ensure required fields are present

Events Not Showing

Verify Tag ID is correct
Check that integration is enabled
Allow up to 15 minutes for Pinterest processing

Data Retention

Pinterest retains conversion data for:

Attribution window: Configurable (default 30 days)
Reporting: Up to 1 year

Privacy & Compliance

All PII fields are SHA256 hashed
Pinterest is GDPR and CCPA compliant
Supports user opt-out via opt_out_type field

Opt-Out Example:

anacoic.track('Pageview', {
  opt_out_type: 'LDU'  // Limited Data Use for CCPA
});

Best Practices

Send complete user data when available for better matching
Use consistent user identifiers across events
Test before launching campaigns
Monitor match rates in Pinterest Analytics
Keep tokens refreshed (30-day expiration)

Support

Need help? Contact us or visit our troubleshooting guide.