Skip to content

Developer Platform

Search docs & API
Log in
Sign up

Use Pinterest tag helper

Google Chrome Extension

To understand the value Pinterest is driving, it's critical that your Pinterest Tag is properly set up and successfully passing back data. The Pinterest Tag Helper is a Google Chrome extension that can help check whether your tag has been set up properly.
The extension not only helps make sure you are sending the correct, intended event data by showing the data that's passed on a Pinterest Tag event, it also helps validate whether you are sending the correct enhanced match value on any given page of your website.
  • Install the Pinterest Tag Helper by going to the Chrome Web Store.

Verify event tags or enhanced match

  • In Google Chrome, navigate to your website where the Pinterest Tag has been installed.
  • In your extensions bar the Pinterest Tag Helper icon should be red with a gray number box. The number in the box indicates the number of tagged events firing.
  • Click the icon for more information
  • The following message box should appear
Image showing Pinterest Tag Helper results for a particular page and event.
  • A drop-down arrow appears next to the event name when Enhanced Match and/or event data is present.
Image showing Pinterest Tag Helper results for a particular page and event.

Event tag verification and QA

You have implemented event tags and you want to verify that the event tags are correctly passing back the expected event data by testing a few pages on your site.
  • Follow the steps above.
  • Click on the drop-down arrow next to the event name. Any standard event data sent back through your event tag will be shown, along with the values assigned to them for that specific page.
  • A checkout tag should send back the value and quantity of the purchase, so if you spent $100 on two items the event data should be something like this.
    value: 100
    order_quantity: 2
Image of the Pinterest Tag Helper showing an issue with the Tag
  • If you don't see event data you've implemented, check to make sure the event data name and value adhere to our specifications.
Make sure the event data values match what you expect for the current page.
Make sure the event data values match what you expect for the current page.

Enhanced match verification and QA

You have implemented Enhanced Match and you want to verify that your Pinterest tag is correctly passing back hashed emails by testing a few pages on your site.
  • Follow same four steps above.
  • If Enhanced Match is present, 1 of 2 outputs will show: a warning, or a test to allow you to confirm your hash is working correctly.

Warnings and errors

The em value provided by your Pinterest Tag is
""
(the empty string),
undefined
,
n/a
, or
null
. It should be a SHA-256 hash.
The em value provided by your Pinterest Tag is
""
(the empty string),
undefined
,
n/a
, or
null
. It should be a SHA-256 hash.
This means the value sent by your tag in the
em
parameter is either:
  • One of the above empty values.
  • The hash of one of the above empty values.
  • If the value is blank, you're just not sending any value. This may also mean you're not currently signed in.
Image of Pinterest Tag Helper showing an email hash validation
The em value provided by your Pinterest Tag hasn't been hashed. It should be a SHA-256 hash.
The em value provided by your Pinterest Tag hasn't been hashed. It should be a SHA-256 hash.
  1. This means you're sending some string in the
    em
    parameter, but it is not a SHA-256 hashed value.
The email you've provided doesn't match the Pinterest Tag.
The email you've provided doesn't match the Pinterest Tag.
  1. This means that the email address you're using to validate Enhanced Match doesn't correspond to what's being passed in the
    em
    parameter of the Pinterest Tag.
There's something wrong with your Pinterest Tag encoding for line item
Product Name
.
There's something wrong with your Pinterest Tag encoding for line item
Product Name
.
  1. The percent-encoding of the event data item is not what we expect: make sure your values are properly percent-encoded to ensure clean data. This warning could occur for other data items as well.

Confirming your email and email hash

If the
em
parameter value string is an email or a SHA-256 hashed email, a dialog box will appear to test an email against the value.
  1. Test the Enhanced Match hashed value by signing into your website, inputting the same email you are signed into the website with in the dialog box.
  2. The extension will hash your address and compare it to the value sent by the partner and we want a match.
Pinterest Tag helper

Known concerns

These are observed, unexpected outputs based on website semantics:
  1. Websites with asynchronous view changes (i.e., view changes without page loads) report all tags that persist through navigation. So as you navigate through such a site, the number of tag events registered by the Tag Helper accumulates.
  2. We do some validation of event data passed by the Pinterest Tag--but not too much. So if some event data exposed by the Tag Helper looks off (see example below), please manually inspect what the Pinterest Tag is passing.
Example of a problematic Pinterest Tag Helper response
Was this page helpful?