Pinterest Ads Troubleshooting & Debugging

Symptom Library

• Pinterest Tag not firing: pintrk function undefined in console
• Conversion events missing from Ads Manager Event History
• Conversions API returning 400 or 403 errors
• Enhanced Match parameters not hashing correctly (match rate below 30%)
• Shopping catalog feed rejected with VALIDATION_ERROR entries
• Rich Pins showing stale or incorrect metadata
• Attribution discrepancies between browser-side tag and server-side API events

Debugging with Pinterest Tag Helper

The Pinterest Tag Helper Chrome extension is the fastest way to validate your implementation:

1. Install the extension from the Chrome Web Store.
2. Navigate to your site and trigger a conversion event (add to cart, purchase, etc.).
3. Click the Tag Helper icon. A green checkmark confirms the tag fired correctly. A red X indicates a failure.
4. Check the Event Details panel for each event. Verify:
   • event_id is present (required for deduplication with Conversions API)
   • value and currency are set for revenue events
   • line_items array is populated for Checkout events

// Correct Pinterest Tag event with Enhanced Match
pintrk('track', 'checkout', {
  value: 89.99,
  currency: 'USD',
  order_id: 'ORD-12345',
  event_id: 'evt-abc-123', // Required for API dedup
  line_items: [
    { product_id: 'SKU-001', product_name: 'Widget', product_price: 89.99, product_quantity: 1 }
  ]
});

Enhanced Match Parameter Validation

Enhanced Match improves attribution by sending hashed user data. Common issues:

• Unhashed email sent: Pinterest expects SHA-256 hashed values. Plaintext emails are silently dropped. Verify the em parameter is a 64-character hex string in Tag Helper.
• Phone number formatting: Strip all non-numeric characters and include the country code before hashing (12125551234, not (212) 555-1234).
• Match rates below 30% usually indicate hashing issues. Check Ads Manager > Conversions > Match Quality.

Event Deduplication Between Browser and API

If you send the same event via both the Pinterest Tag (browser) and the Conversions API (server), you must deduplicate:

1. Generate a unique event_id on the server and pass it to both the browser tag and the API call.
2. Pinterest deduplicates events with the same event_id within a 48-hour window.
3. If event_id is missing from either source, Pinterest counts both events, inflating your conversion numbers.
4. Check for duplicate counting in Ads Manager > Conversions > Event Source Comparison. If API events are roughly 2x what you expect, deduplication is failing.

Conversion Insights Discrepancies

When Ads Manager conversion numbers do not match your analytics platform:

• Attribution window: Pinterest defaults to 30-day click / 1-day view. Align with your analytics platform before comparing.
• Counting method: Pinterest counts "Total conversions" by default. Switch to "Unique conversions" in reporting for a fairer comparison.
• Time zone: Pinterest reports in the ad account's time zone. Confirm this matches your analytics platform.
• Data freshness: Conversion data may take up to 24 hours to process. Avoid comparing same-day numbers.

Shopping Catalog Feed Errors

Rich Pin Validation Issues

If Rich Pins display outdated or incorrect product metadata:

1. Validate markup using the Rich Pins Validator at https://developers.pinterest.com/tools/url-debugger/.
2. After fixing markup, resubmit the URL. Pinterest caches metadata for up to 7 days.
3. Ensure og:price:amount and og:price:currency are present for product pins.

Escalation & Communication

• Pinterest Business Support via Help Center: include your ad account ID and event name.
• For Conversions API errors, include the full API response body and your ad_account_id.
• Platform integration support (Shopify, WooCommerce) handles plugin-specific Pinterest tag issues.

Preventive Maintenance

• Weekly event volume monitoring in Ads Manager: flag any event dropping below 50% of its 7-day average.
• Monthly Enhanced Match quality review: target a match rate above 50%.
• Run Pinterest Tag Helper on all conversion pages after every site deployment.
• Quarterly catalog feed audit: check for stale products, broken links, and image quality.