Pinterest tag helper Chrome extension

Extension Summary

To understand the value Pinterest is driving to you as a Partner, 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 helps you do just that.

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, but it also helps you validate whether you are sending the correct Enhanced Match value on any given page of your website.

Download the Pinterest Tag Helper now by going to the Chrome Web Store.

Using the extension

Event tag verification & QA use case

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.

  1. Go to your website in Chrome.
  2. The Pinterest Tag Helper Icon becomes red and a gray number box appears to indicate the number of tag events firing. 
  3. Click the icon for more information; a message box will appear.
  4. A drop-down arrow will appear next to the event name when Enhanced Match and/or event data is present.Any standard event data sent back through your event tag will show with the values assigned to them for that specific page. For example, 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 probably be:
    1. value: 100
    2. order_quantity: '2' 
  5. 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.

Enhanced Match verification & QA use case

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.

  1. Go to your website in Chrome.
  2. The Pinterest Tag Helper Icon becomes red and a gray number box appears to indicate the number of tag events firing. 
  3. Click the icon for more information, a message box will appear.
  4. A drop-down arrow will appear next to the event name when Enhanced Match and/or event data is present.
  5. If Enhanced Match is present, 1 of 2 outputs will show:

    1. If the em parameter is empty or is assigned “undefined”, “n/a”, “null”, or an incorrectly hashed value, a warning will show (not always a problem, your website might not be able to send email addresses to the tag on some pages--for example, if the user is not logged in).
    2. 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.
  6. If the dialog box appears, you can test the Enhanced Match hashed value by signing into your website. Input the same email you’re signed in with on the website into the dialog box. The extension will hash your address and compare it to the value sent by the partner. (We want a match.)

Warnings/Errors

The em value provided by your Pinterest Tag is "", "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 one of the above null parameters or the hash of one of the above null parameters. If the value is blank, you’re just not sending any value. This may also mean you’re not signed in currently.

The em value provided by your Pinterest Tag hasn’t been hashed. It should be a SHA-256 hash.

  • 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.

  • 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'.

  • 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.

Known Concerns

(Observed unexpected output based on website semantics)

  • 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.
  • 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 (like in the example image below), please manually inspect what the Pinterest Tag is passing.

Still need help?
Contact us