Digital Marketing Support

Conversion Tag Event Code Generator for Pinterest Ads

Generate Pinterest tag event code for checkout, add to cart, lead, sign-up and the other events — with value, order_quantity, currency, order_id, line items, an event_id for the Conversions API and the <noscript> image — or check the tag code you already have.

Runs in your browser. Nothing is uploaded.For Pinterest

1 Build or check

What do you want to do?

product_id must match the ID in your Pinterest catalog.

2 Your Pinterest tag code / check results

Fill in the settings above — your result appears here instantly.

Next step Send the same checkout from your server with the same event_id, so Pinterest keeps one.

Build the Conversions API payload

Rules last checked: against the official pages:

How to use the conversion tag generator for Pinterest

Pick an event and this conversion tag generator for Pinterest writes the pintrk('track', …) call, the matching <noscript> image and, if you want it, the enhanced match line. Field names, the three accepted spellings of the event ID and the image format come from Pinterest's Add event codes help page.

  1. Choose the event and your campaign objective. Catalog sales campaigns have stricter needs, and the checks follow them.
  2. Enter the order details — or leave value and order_quantity empty and let the tool total your line items.
  3. Add line items with the product IDs from your Pinterest catalog.
  4. Set an event ID when your server also sends the event through the Conversions API.
  5. Copy the code. To audit an existing setup, paste it into Check my code, including the image tag.
Conversion tag generator for Pinterest showing a checkout pintrk event with line items, the noscript image and passed checks

What to do next: add the event code to your site

Only one copy of the Pinterest base code is needed per site, in the <head> of every page. Event code always comes after it.

Plain HTML

  1. Paste the script and the <noscript> image on the order confirmation page, below the base code.
  2. Have your server print each order's real total, quantity and number into both — they must match.

To verify, open the network tab, filter for ct.pinterest and complete a test order: the request should show your event and its ed data. Pinterest says a new tag should verify within 3 hours. Turn on enhanced match in Ads Manager under Conversions › Event quality.

Common Pinterest tag errors and fixes

Pinterest checkout event value sent as text

value: '$109.99' is a string with a symbol. Send value: 109.99 and put the code in currency; order_quantity must be a whole number.

Pinterest tag event_id deduplication not working

The ID field is case-sensitive and accepts only eventID, event_id or eid, so eventId isn't read as the event ID. The same value must reach the Conversions API as event_id, with the same event name.

Spaces in the image tag

Pinterest warns that whitespace in the image's src breaks it. Spaces inside values become +, and the whole URL stays on one line.

A plain email in the image

The JavaScript tag hashes emails for you; the image doesn't. pd[em] must carry a hash, never an address.

Product fields outside line_items

product_id and product_price belong inside line_items. That is where Pinterest's examples put them, and catalog sales campaigns need product_id to match your catalog.

Frequently asked questions

What is the Pinterest conversion tag?

The Pinterest tag is a small piece of JavaScript from Ads Manager. Its base code loads on every page and records page visits. Event code — pintrk('track', 'checkout', {…}) — tells Pinterest when someone buys, adds to cart, signs up or becomes a lead, so those actions show up as conversions.

How do I set up the Pinterest tag?

Copy the base code from Ads Manager and paste it between <head> and </head> on every page, once. Then add event code after it on the pages or clicks that matter. Pinterest says the tag should be verified within 3 hours of its first use.

Which events can the Pinterest tag track?

Pinterest lists 20 event types, including a custom one. The tag strings in its examples are pagevisit, viewcategory, search, addtocart, checkout, watchvideo, signup, lead, addpaymentinfo, initiatecheckout, subscribe, viewcontent and AddToWishList. Contact, Schedule, StartTrial and a few newer types have no published code example yet.

Which parameters should the checkout event include?

value, order_quantity and currency at least — only value and order quantity feed conversion reporting. Add order_id for conversion analysis, line_items with each product_id for catalog sales, and an event ID if your server also sends the purchase.

Why does Pinterest say my conversion source needs attention?

Check the basics first: is the base code on every page and loading before the events, does the event name match Pinterest’s list, and do events send value and currency? In your browser’s network tab, filter for ct.pinterest and look for the event and ed values in each request.

What is enhanced match in the Pinterest tag?

It adds the customer’s email to the base code’s load line — pintrk('load', 'TAG_ID', { em: … }) — so Pinterest can match more conversions. The JavaScript tag hashes raw emails with SHA-256 before sending. Turn it on in Ads Manager under Conversions › Event quality.

Guide: Pixel Event Codes for Seven Ad Platforms: One Cheat Sheet

Need help setting this up? Talk to EmproIT