Pinterest Conversions API
Connect TrackFlow to Pinterest Conversions API to send conversion events directly from your server for improved attribution and optimization.
Why Use Pinterest Conversions API?
- Reliable tracking: Server-side events aren't blocked by browsers
- Better attribution: More accurate conversion data for reporting
- Enhanced optimization: Improved ad delivery with more data signals
- Privacy-compliant: Works with cookie restrictions
Step 1: Get Your Tag ID
- Go to Pinterest Ads Manager
- Click Ads → Conversions
- Select your Pinterest Tag (or create one)
- Copy your Tag ID (numeric string)
Step 2: Generate Conversions Access Token
- Go to Pinterest Developers
- Create or select your app
- Go to Access Tokens
- Generate a token with ads:write permission
- Copy the token (starts with "pina_")
Note
Make sure your Pinterest app has the ads:write scope enabled. You may need to request access if your app is new.
Step 3: Add Pixel to TrackFlow
- Go to your store in TrackFlow
- Click Pixels tab
- Click Add Pixel
- Select Pinterest Ads
- Enter your Tag ID and Access Token
- Click Save Pixel
Events Sent to Pinterest
| TrackFlow Event | Pinterest Event | Parameters |
|---|---|---|
| PageView | page_visit | event_source_url |
| ViewContent | view_category | product_id, product_price, currency |
| AddToCart | add_to_cart | product_id, product_price, currency, quantity |
| InitiateCheckout | checkout | product_id, value, currency, order_quantity |
| Purchase | checkout | product_id, value, currency, order_id, order_quantity |
User Data for Matching
TrackFlow sends hashed user data for enhanced matching:
- em: SHA256 hashed email (lowercase, trimmed)
- hashed_maids: Mobile advertising IDs if available
- client_ip_address: Customer IP
- client_user_agent: Browser info
- click_id: Pinterest click ID from URL (_epik parameter)
Troubleshooting
Events Not Appearing
- Verify your Tag ID is correct
- Ensure your access token has ads:write permission
- Check that the token hasn't expired
- Allow up to 24 hours for events to appear
Authentication Errors
- Regenerate your access token
- Verify your Pinterest app is approved
- Check that your ad account is linked to the app