Pinterest Ads Troubleshooting & Debugging | OpsBlu Docs

Pinterest Ads Troubleshooting & Debugging

Fix Pinterest Tag firing issues, Conversions API errors, and Enhanced Match failures with Ads Manager diagnostic steps.

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

Error Code Fix
MISSING_REQUIRED_FIELD Populate title, description, link, and image_link
INVALID_PRICE_FORMAT Use 29.99 USD format, not $29.99
IMAGE_TOO_SMALL Use images at least 600x600px
LANDING_PAGE_ERROR Fix 404 errors or redirects on product pages
AVAILABILITY_MISMATCH Sync feed updates at least every 6 hours

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.
Back to top