Pinterest Tag Setup Guide

[#1]

This article describes how to set up the Pinterest Tag tag in your Tealium iQ Tag Management account.

In this article:

Table of Contents Placeholder

Prerequisites

• Pinterest Business Account
• Pinterest Tag and Tag identifier

Tag Tips

• Includes support for "Enhanced Match" when you map to the "Email Address" parameter
• Conversion fires when Order ID is set.
• Supports these E-Commerce extension parameters:
  • Order ID (_corder)
  • Sub Total (_csubtotal)
  • Currency (_ccurrency)
  • Promo Code (_cpromo)
  • List of Product IDs (_cprod)
  • List of Names (cprodname)
  • List of Brands (_cbrand)
  • List of Categories (_ccat)
  • List of Quantities (_cquan)
  • List of Prices (_cprice)

Tag Configuration

First, go to Tealium's tag marketplace and add the Pinterest Tag tag (Learn more about how to add a tag).

After adding the tag, configure the following settings:

• Pinterest Tag ID
  • Your Pinterest Tag ID.
  • Your Pinterest Tag ID is different from any existing or previous conversion tag IDs.

Load Rules

Load Rules determine when and where to load an instance of this Tag on your site.

Recommended Rule: Create a custom Rule to load it on the page(s) where you want to track specific actions, events, and conversions.

Data Mappings

Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For instructions on how to map a variable to a tag destination, see Data Mappings.

The available categories are:

Standard

Variable	Description
tag_id	Tag ID. Unique identifier of your Pinterest tag (not the old Conversion tag).
email_address	Email Address
property	Property. The action, item, or event being tracked.
search_query	Search query. Search Keyword(s).
product_variant_id	Array. List of Product Variant IDs. Unique identifiers of the variants available for the same product.
product_variant	Array. List of product variants. List of variants available for the same product.
page_name	Page name. Name of the page as it appears in your site.
page_category	Page Category. Category of the page.
page_title	Page Title. Name of the page where the event or action occurred.
video_title	Video Title. Title of the video watched by the user.
lead_type	Lead Type. Type of product or service the user is interested in.

E-Commerce

Since the Pinterest Tag is e-commerce enabled, it will automatically use the default E-Commerce Extension mappings. Manually mapping in this category is generally not needed unless you want to override any Extension mappings or your desired e-commerce variable is not offered in the extension.

E-Commerce

Variable	Description
order_id	Order ID. Unique identifier assigned to the final order Overrides _corder.
order_subtotal	Order subtotal. Subtotal amount of the final order Overrides _csubtotal.
order_currency	Order currency. Currency used in the payment Overrides _ccurrency.
order_coupon_code	Promo code. Overrides _cpromo.
product_id	Array. List of product IDs. Unique identifiers of each product in the product array. Overrides _cprod
product_name	Array. List of names. Name of each product in the product array. Overrides _cprodname.
product_brand	Array. List of brands. Brand of each product in the product array. Overrides _cbrand.
product_category	Array. Name of each product in the product array. Overrides _ccat.
product_quantity	Array. Quantity of each product in the product array. Overrides _cquan.
product_unit_price	Array. Unit price of each product in the product array. Overrides _cprice.

Events

Map to these destinations for triggering events when your specified trigger value is found on the page.

Checkout event is automatically triggered if an order id value is available on the page.

Here's how to map an event:

1. Select an event from the drop-down list.
   You can choose from the pre-defined list or create a custom event.
   

   Variable	Description
   PageVisit	Visit to a page.
   ViewCategory	Category viewed.
   Search	Search
   AddToCart	Added to cart
   Checkout	Check out
   WatchVideo	Video watched
   Signup	Signed up
   Lead	Lead source
   Custom	Create custom event

2. For Custom event, enter a name with which to identify it.
3. In the Trigger field, enter the value of the variable you are mapping to this destination.
   When the value is found, the event triggers on the page.
4. To map more events, click the plus (+) button and repeat Steps #1 and #2.
5. Click Apply.

When you are done mapping, perform a save and publish. That's it! You have successfully set up the Tag in your profile.

Vendor Documentation

• About Pinterest Tag
• Pinterest Ads Manager Guide