Pinterest tag helper Chrome extension

To understand the value Pinterest provides 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’re sending the correct, intended event data, but it also helps you validate whether you’re sending the correct Enhanced Match value on any given page of your website.

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

How to use the extension

You added 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

You added 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.)

Extension error messages

Error type Warning What it means Suggested action
Event data error The Enhanced Match value provided by your Pinterest Tag is "", "undefined", "n/a", or "null". It should be a SHA-256, SHA-1 or MD5 hash.
  • You’ve implemented the Enhanced Match parameter but we’re not getting any data back for it. In some cases, this might be expected because the person on the site isn’t currently logged in.
  • It’s also possible that the email address variable was set up incorrectly or a static value was implemented instead of a dynamic variable. 
To make sure Enhanced Match is working properly using the Pinterest tag helper chrome extension, go to your site and sign in. If you don’t have a sign-in functionality, go to a place where your users provide you an email address like a newsletter signup or checkout. Trigger the event you’ve set up and use the instructions above to test the hashed email address value being sent back.
Expected event data error The same Product ID is being passed for many events Products on different pages (URLs) may have the same product_id. Often this isn’t the case and in fact the same product ID is being passed back for different products in error Make sure the value assigned to product_id is a dynamic variable and written with the correct syntax by checking with your developer
Expected event data error A Page Visit event occurred with no Product ID Sending back product_id data with the page visit tag is a requirement for dynamic retargeting. Sending back product_id data with your conversions is necessary to access that feature, but not required.
Expected event data error Add to Cart event occurred with no Product ID Sending back product_id data with the addtocart tag is a requirement for dynamic retargeting. Sending back product_id data with your conversions is necessary to access that feature, but not required.
Expected event data error A Checkout event occurred with no Product ID Sending back product_id data with the checkout tag is a requirement for dynamic retargeting. Sending back product_id data with your conversions is necessary to access that feature, but not required.
Expected event data error  A Page Visit event occurred without a Product Category Product Category is useful for Audience creation where you can create an audience for like products.
Expected event data error Add to Cart event occurred without a Product Category Product Category is useful for Audience creation where you can create an audience for like products. 
Expected event data error A Checkout event occurred with no Product Category Product Category is useful for Audience creation where you can create an audience for like products. 
Expected event data error A Checkout event occurred with no checkout value Sending back value (revenue) data on your checkout conversions is a basic step in understanding the return on your investment in ad spend. If we detect a null, zero, or unrecognized value, then the data being sent back to Pinterest can’t be used to measure your ad performance and report on it in Ads Manager. This usually occurs because the dynamic variable used to populate the value is incorrectly written or configured. Review the event data variables in your event tags by checking with your developer to make sure those variables are configured correctly 
Expected event data error A Checkout event occurred with 0 checkout value Sending back value (revenue) data on your checkout conversions is a basic step in understanding the return on your investment in ad spend. If we detect a null, zero, or unrecognized value, then the data being sent back to Pinterest can’t be used to measure your ad performance and report on it in Ads Manager. This usually occurs because the dynamic variable used to populate the value is incorrectly written or configured. Review the event data variables in your event tags by checking with your developer to make sure those variables are configured correctly 
Expected event data error A Checkout event occurred with unrecognized value Sending back value (revenue) data on your checkout conversions is a basic step in understanding the return on your investment in ad spend. If we detect a null, zero, or unrecognized value, then the data being sent back to Pinterest can’t be used to measure your ad performance and report on it in Ads Manager. This usually occurs because the dynamic variable used to populate the value is incorrectly written or configured. Review the event data variables in your event tags by checking with your developer to make sure those variables are configured correctly 
Expected event data error Checkout events have Value > 150,000 (P0) There are very few cases where someone is going to spend even close to $150,000 online in one purchase. We'll warn you if we see a value associated with a checkout event greater than $150,000. Typically the problem in this case is that the checkout value isn't properly populating decimal places or is omitting them Check the script or data layer setup you've set up for Value and make sure it'll populate a checkout value that matches your customer’s actual cart.
 
Static event data error The email address provided is the same for all events The various conversions made on your site are actioned by different users. If we detect the same hashed email address value passed back using Enhanced Match for all of your conversion events, then it’s likely that a static email address was input for the email dynamic variable or a dynamic variable is broken. Check to make sure the value assigned to “em” in your Pinterest tag code is a dynamic variable. It shouldn’t be your email address, the company’s email address or any static value. The hash of the email address we receive should change for every user that hits your site.
Static event data error The same Order ID is being passed for many events We assume that a unique order_id is assigned to each conversion event, but if we detect that the same order_id value is assigned multiple times, that means we’re either getting duplicate data or your data layer isn’t populating correctly.
  • When a checkout event tag is being fired multiple times for the same conversion event, check to make sure the tag won’t fire again when a user reloads the checkout confirmation page or visits it again to check information. If you’re developing your own site, javascript functions can help.
  • Check to make sure you didn’t accidentally put a static value for your order_id variable. The proper value should be a dynamic variable that changes for each unique event.
Static event data error Checkout event value has unrecognizable currency code We support a select list of currency codes, if you send us one we don’t support, we can’t properly store the value of your conversions.

Check our list of supported currency codes and make sure your event tag is using the appropriate one:

AED, AMD, ARS, AUD, AZN, BAM, BGN, BHD, BMD, BND, BOB, BRL, BSD,CAD, CHF, CLP, CNY, COP, CRC, CZK, DKK, DOP, EGP, EUR, FJD, GBP, GEL, GIP, HKD, HNL, HRK, HUF, IDR, ILS, INR, ISK, JMD, JPY, KGS, KRW, KWD, KZT, MAD, MDL, MOP, MXN, MYR, NOK, NZD, OMR, PAB, PEN, PHP, PKR, PLN, QAR, RON, RSD, RUB, SAR, SEK, SGD, THB, TRY, TWD, UAH, USD, UYU, VND, ZAR

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