Pinterest Tag Helper Chrome extension

It looks as though you're viewing this from a region where Pinterest Tag isn't available yet. See where Pinterest Tag is available to Pinterest Business accounts.

Learn more

The Pinterest Tag Helper is a Google Chrome extension that helps you check that your tag has been set up properly and is passing back data successfully.

You can use this extension to make sure you're sending the correct event data and Enhanced Match value on any page of your website.

How to use the extension

If you haven't already done so, download the Pinterest Tag Helper from the Chrome Web Store.

Verify event data

You added event tags and you want to verify that the event tags are passing back the expected event data correctly by testing a few pages on your site.

  1. Go to your website in Google Chrome.
  2. Pinterest Tag Helper icon will indicate the number of events by turning red and displaying the number of events in grey. 
  3. Click the icon to show more information in a message box.
  4. Each event will have a drop-down arrow you can use to see more information, including data assigned to the event. For example, a checkout tag should send back the value and quantity of the purchase, so if you spent $100 on two items, the message box might look like this: Pinterest Tag Helper Chrome Extension

If you can’t see event data you’ve implemented, 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 passing back hashed emails correctly by testing a few pages on your site

  1. Go to your website in Google Chrome.
  2. When the Pinterest Tag Helper icon becomes red, click the icon to bring up more information in a message box. 
  3. A drop-down arrow will appear next to the event name when enhanced match and/or event data is present.
  4. If enhanced match is present, 1 of 2 outputs will be shown:

    • If the em parameter is empty or is assigned “undefined”, “n/a”, “null” or an incorrectly hashed value, a warning will appear. This is 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 isn't logged in. Pinterest Tag Helper Chrome extension using enhanced match showing that the em paramater is empty.
    • If the em parameter value string is an email or a SHA-256 hashed email, a dialogue box will appear to test an email against the value.                 Pinterest Tag Helper Chrome extension using enhanced match showing that the em parameter value string is an email or a hashed email
  5. If the dialogue box appears, you can test the enhanced match hashed value by signing in to your website. Enter the same email address you’re signed in with on the website into the dialogue box. The extension will hash your address and compare it with the value sent by the partner (we need a match).
    Pinterest Tag Helper Chrome extension using enhanced match testing the hashed value

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 sign-up 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 basket event occurred with no product ID Sending back product_id data with the addtobasket 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 similar products.
Expected event data error Add to basket event occurred without a product category Product category is useful for audience creation where you can create an audience for similar 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 similar 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 unrecognised value, 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 unrecognised value, 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 unrecognised 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 unrecognised value, 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 basket.
 
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, it’s likely that a static email address was entered for the email dynamic variable, or a dynamic variable is broken. 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, 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.
  • 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 unrecognisable currency code We support a selected list of currency codes, if you send us one we don’t support, we can’t store the value of your conversions properly.

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. If some event data exposed by the tag helper looks incorrect, please inspect what the Pinterest Tag is passing manually.
Still need help?
Contact us