Pinterest Tag

Step-by-step guide to send your event data from RudderStack to Pinterest.

The Pinterest Ads Tag is a piece of code that, when added to your website, allows Pinterest to track your visitors as well as their actions. It gives you a detailed conversion report related to any and all customer activities like signups or buying a product.

RudderStack supports Pinterest as a destination to which you can send your customer events in real-time, through Pinterest's pintrk conversion tag.

Find the implementation of this integration on our GitHub.

Getting Started

To enable sending data to Pinterest, you will first need to add it as a destination to the source from which you are sending your event data. Once the destination is enabled, events from RudderStack will start flowing to Pinterest.

Before configuring your source and destination on the RudderStack, please verify if the source platform is supported by Pinterest Tag, by referring to the table below:

Connection Mode	Web	Mobile	Server
Device Mode	Supported	-	-
Cloud Mode	-	-	-

To know more about the difference between Cloud mode and Device mode in RudderStack, read the RudderStack connection modes guide.

Once you have confirmed that the platform supports sending events to Pinterest, perform the steps below:

• Choose a source to which you would like to add Pinterest as a destination.

• After configuring your source, select the destination as Pinterest Tag. Give this destination a name and then click on Next.

• On the Connection Settings page, enter the relevant settings in the fields - including the Pinterest Tag ID - and then click on Next.

Enable Enhanced Match

Rudderstack supports Pinterest Enhanced Match in the following two scenarios:

• Where a user is identified every time they visit your site.

• When a user visits your site anonymously but is identified at some later point by making an identify() call.

To support Pinterest Enhanced Match, go to the Pinterest Tag destination settings in the RudderStack dashboard and turn on the Enable Enhanced Match on Page Load option.

Enable Enhanced Match on Page Load

When enabled, this configuration will attach the hashed email address on the initial page load. Now any call made to Pinterest will be an Enhanced Match.

If this setting is not enabled, all the visits made to your site will be anonymous. But you can still identify any user by making the identify() call.

If you use Rudderstack's identify() method to enable Pinterest’s Enhanced Match, you can only collect this information for successive events. Pinterest does not update the values for the past events retroactively.

Identify

When you make an identify() call with the user’s email address and traits, RudderStack triggers a Pinterest set() method. This saves the identification parameters to be sent with the next events, so it’s important to set the values as early as possible.

If you make an identify call without the email, then the identification parameter will not be set.

rudderanalytics.identify("sample_user_id", {
  name: "Test name",
  email: "[e-mail]",
})

This call will set the identification parameters to [e-mail] and any successive calls made will be an Enhanced Match.

Nothing appears in the network tab in your browser or in the tag helper extension after identify() is called. However, a hashed value for an em parameter is added in the next event call, in a JSON object encoded in the URL.

Track

The track call allows you to capture any action that the user might perform, along with any properties that are associated with that action. Each action is considered to be an event.

A sample track call looks like the following:

rudderanalytics.track("Track me")

RudderStack's SDK will send the track event name and any properties as custom properties to Pinterest.

E-Commerce

RudderStack supports E-Commerce conversion tracking for Pinterest. Use the RudderStack eCommerce Specification for sending the events while instrumenting your site with the RudderStack SDK.

Below are some examples of the track event names that are passed to the Pinterest event:

RudderStack event name	Pinterest event name
Order Completed	Checkout
Product Added	AddToCart
Products Searched	Search
Product List Filtered	Search

You can also track a custom event that you want to include in your conversion reporting. This will get mapped to a custom Pinterest event. An example is as shown:

rudderanalytics.track("custom")

If you wish to map your event to a specific Pinterest event, you can do so by adding it in the Map Your Events To Pinterest Events section while configuring your Pinterest destination in RudderStack.

Map Your Events To Pinterest Events

Pinterest supports following 9 standard events that one can map and track them for reporting.

• Checkout

• AddToCart

• PageVisit

• SignUp

• WatchVideo

• Lead

• Search

• ViewCategory

• Custom

Apart from that if the event sent is not found in our list we pass those events and Pinterest treats them as user-defined events. Note, these events aren’t available for conversion reporting.

Properties Mapping

Rudderstack automatically binds the following properties to the Pinterest event properties:

RudderStack property name	Pinterest property name
query	search_query
value	value
order_quantity	order_quantity
currency	currency
order_id	order_id
promo_code	promo_code
property	property
video_title	video_title
lead_type	lead_type
coupon	coupon

The following properties are nested within the E-Commerce products array:

RudderStack Property Name	Pinterest Property Name
product_id	product_id
sku	product_id
name	product_name
price	product_price
category	product_category
variant	product_variant
quantity	product_quantity
brand	product_brand

If you wish to pass any extra properties other than what we support, you can use our Custom Properties section while configuring your Pinterest destination in RudderStack.

Custom Properties

If you wish to send your defined properties to Pinterest, you can do so by using the Custom Properties section. Just add those properties in the given field and you are good to go.

Here is an example of how it all works:

rudderanalytics.track("Event", {
  customProperty: {
    customValue: 2,
  },
  someRandomMailId: "[e-mail]",
})

For streaming the above properties in Pinterest, you will need to add the following two properties:

• customProperty.customValue

• someRandomMailId

Page

Pinterest's pintrk sends any one following of two events every time you make a page call.

When making a page call you can provide the name, category, and any other additional properties. RudderStack sends the ViewCategory event if both the name and category fields are present. In case only name is present, RudderStack sends a PageVisit event and drops any additional properties.

In case you want to send any additional properties to Pinterest, you need to mention them in the Custom Properties section while configuring the Pinterest destination in the RudderStack dashboard.

rudderanalytics.page("I am new page", "new page category", {
  path: "path",
  url: "url",
  title: "title",
  search: "search",
  referrer: "referrer",
  testDimension: "true",
})

This above example will map to Pinterest ViewCategory event.

rudderanalytics.page("I am new page with no name", {
  path: "path",
})

The above example will map the event to Pinterest PageVisit event.

FAQs

How do I get the Pinterest Tag ID?

• Login to your Pinterest Ads dashboard.

• Click on the Ads dropdown and go to Conversions. It will open the Pinterest Tag Manager.

• Now click on Generate Pinterest Tag and you will see your Tag ID.

• This Tag ID should be 10-15 digit number.

Contact Us

If you come across any issues while configuring Pinterest with RudderStack, please feel free to contact us or start a conversation in our Slack community. We will be happy to help you.