---
title: Pinterest Tag Setup Guide
description: This article describes how to set up the Pinterest Tag in your Tealium iQ Tag Management account.
url: https://docs.tealium.com/client-side-tags/pinterest-tag/
---
## Requirements

* 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

Go to the tag marketplace to add a new tag. For more information about how to add a tag, see [Manage tags](https://docs.tealium.com/manage-tags/).

When 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.
* **Generate Event ID**
  * Automatically generate an Event ID for every Pinterest tracking event. The default value is `True`.
* **Auto Page Visit Event**
  * When set to `true`, automatically generates Page Visit events. The default is true. When **Auto Page Visit Event** is set to `true`, do not map the `PageVisit` event variable.

### Conversions API for Web

To support the Pinterest Conversions API for Web, the tag generates a unique event ID for each event tracked and sends it to Tealium EventStream for use in the Pinterest Conversions connector. The event ID may be mapped in the connector to synchronize the web-based on server-based integrations. This feature requires an active [Tealium Collect tag](https://docs.tealium.com/tealium-collect-tag/).

The tag emits new event attributes using the following naming convention:

```nohl
pinterest_event_id_{PINTEREST_EVENT}_{TAG_UID}
```

For example: `pinterest_event_id_Checkout_32 = "11563522"`

For more information, see [pinterest-conversions-connector](https://docs.tealium.com/pinterest-conversions-connector/).

## Load rules

Load the tag on all pages or set conditions for when your tag loads. For more information about load rules, see the [Load Rules](https://docs.tealium.com/about-load-rules/) documentation.

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](https://docs.tealium.com/data-layer-variables/) to the corresponding destination variable of the vendor tag. For instructions on how to map a variable to a tag destination, see [Data Mappings](https://docs.tealium.com/iq-tag-management/data-mappings/manage/).

The available categories are:

### Standard

|Variable| Description|
|---| ---|
| `tag_id` |  <ul><li>Tag ID.</li><li>Unique identifier of your Pinterest tag (not the old Conversion tag).</li></ul> |
| `event_id` |  <ul><li>Event ID.</li><li>Unique identifier of the event.</li><li>This value overrides the value generated by the **Generate Event ID** configuration option.</ul> |
| `email_address` |  <ul><li>Email Address</li></ul> |
|`property`|  <ul><li>Property.</li><li>The action, item, or event being tracked.</li></ul> |
|`search_query`|  <ul><li>Search query.</li><li>Search Keyword(s).</li></ul> |
|`product_variant_id`|  <ul><li>Array.</li><li>List of Product Variant IDs.</li><li>Unique identifiers of the variants available for the same product.</li></ul> |
|`product_variant`|  <ul><li>Array.</li><li>List of product variants.</li><li>List of variants available for the same product.</li></ul> |
|`page_name`|  <ul><li>Page name.</li><li>Name of the page as it appears in your site.</li></ul> |
|`page_category`|  <ul><li>Page Category.</li><li>Category of the page.</li></ul> |
|`page_title`|  <ul><li>Page Title.</li><li>Name of the page where the event or action occurred.</li></ul> |
|`video_title`|  <ul><li>Video Title.</li><li>Title of the video watched by the user.</li></ul> |
| `lead_type` |  <ul><li>Lead Type.</li><li>Type of product or service the user is interested in.</li></ul> |
| `generate_event_id` |  <ul><li>Generate Event ID.</li><li>Automatically generate an Event ID for every Pinterest tracking event.</li></ul> |

### E-Commerce

Since the Pinterest Tag is e-commerce enabled, it automatically uses the default [E-Commerce Extension](https://docs.tealium.com/e-commerce-extension/) mappings. Manually mapping in this category is generally not needed unless you want to override any Extension mappings or an e-commerce variable is not offered in the extension.

### E-Commerce Variables

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

### Events

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


<blockquote>
Checkout event is automatically triggered if an order id value is available on the page.
</blockquote>


|Variable| Description|
|---| ---|
|PageVisit| Visit to a page. To avoid duplicate events, do not map `PageVisit` when **Auto Page Visit Event** is set to **true**. |
|ViewCategory| Category viewed.|
|Search| Search.|
|AddToCart| Added to cart.|
|Checkout| Check out.|
|WatchVideo| Video watched.|
|Signup| Signed up.|
|Lead| Lead source.|
|AddToWishList| Added to wish list.|
|InitiateCheckout| Initiated checkout.|
|Subscribe| Subscribed.|
|ViewContent| Viewed content.|
|Custom| Create custom event.|

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. 
1. For Custom event, enter a name with which to identify it.
1. 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.
1. To map more events, click the plus (**+**) button and repeat Steps #1 and #2.
1. 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.

### Limited Data Processing (LDP)

| Variable | Type | Description |
|:---------|:------------|:------------|
| `opt_out_type` | String | Opt out type.   |
| `st` | String | Opt out state.  | 
| `country` | String | Opt out country.   | 

## Vendor documentation

* [Pinterest: About Pinterest Tag](https://help.pinterest.com/en/articles/website-conversion-tracking)
* [Pinterest: Ads Manager Guide](https://business.pinterest.com/sites/business/files/pinterest-ads-manager-guide.pdf)