Setup Guide

Set up Pinterest Tag as a destination in RudderStack.

This guide will help you set up Pinterest Tag as a destination in the RudderStack dashboard. It also lists the configuration settings required to correctly send data from the supported sources to Pinterest.

Connection compatibility

Destination info
  • Status: Generally Available
  • Supported sources: Android, iOS , Web, Unity, AMP , Cloud, Warehouse, React Native , Flutter, Cordova, Shopify
  • Refer to it as PINTEREST_TAG in the Integrations object.

Connection modes
SourceCloud modeDevice modeHybrid mode
AMPsupportednot supportednot supported
Androidsupportednot supportednot supported
Cloudsupportednot supportednot supported
Cordovasupportednot supportednot supported
Fluttersupportednot supportednot supported
iOSsupportednot supportednot supported
React Nativesupportednot supportednot supported
Shopifysupportednot supportednot supported
Unitysupportednot supportednot supported
Warehousesupportednot supportednot supported
Websupportedsupportednot supported
Supported message types
SourceIdentifyPageTrackScreenGroupAlias
Cloud mode
Supported sourcesnot supportedsupportedsupportedsupportednot supportednot supported
Device mode
Websupportedsupportedsupportednot supportednot supportednot supported
info

In the web device mode integration, that is, using JavaScript SDK as a source, RudderStack loads the Pinterest Tag native SDK from the https://s.pinimg.com/ domain.

Based on your website’s content security policy, you might need to allowlist this domain to load the Pinterest Tag SDK successfully.

Get started

Once you have confirmed that the source platform supports sending events to Pinterest Tag, follow these steps:

  1. From your RudderStack dashboard, add a source. Then, from the list of destinations, select Pinterest Tag.
  2. Assign a name to the destination and click Continue.

Connection settings

To successfully configure Pinterest Tag as a destination, configure the following settings:

  • Tag ID: Enter your Pinterest Tag ID (required only for sending events via device mode).

  • App Store App ID: Enter the App Id from your App Store (required only for sending events using an iOS source).

  • API Version: Select the Pinterest Tag API version from the dropdown and enter the following values (required only for sending events via cloud mode):

    V3(deprecating soon):

    • Pinterest Advertiser ID: Enter the Advertiser ID of your Pinterest account.

    V5:

Other settings

  • Send as test event: RudderStack marks the event as test requests if this setting is turned on. It does not record the event but the API still returns the same response messages.
info
Use this setting to verify if your requests are working and the events are constructed correctly.
  • Enable hashing for user data conversions: This setting is on by default and hashes your user data using SHA256 encoding.

  • Enable Event Deduplication: Turn on this setting to deduplicate the events. Then, specify the following:

    • Deduplication key: Enter the key using which Pinterest Tag should use to deduplicate the events.
  • Enable Enhanced Match on Page Load: This setting is on by default and attaches the hashed email address on the initial page load. Any further calls made to Pinterest will be an Enhanced Match.

    When turned off, all visits made to your site become anonymous. However, you can still identify any user by making the identify() call.

    RudderStack supports Pinterest Enhanced Match when the following conditions are met:

    • A user is identified every time they visit your site.
    • A user visits your site anonymously but is identified at a later stage by making an identify() call.

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

  • Send external_id for user: Turn on this setting to send the user’s external_id to Pinterest Tag (applicable only for sending events via cloud mode).

  • Send as custom event: Turn on this setting to send an unmapped event as a Pinterest custom event. If an event is neither mapped in the Map Your Events To Pinterest Events dashboard setting nor is one of the ecommerce tracking events, it will be sent as a custom event.

  • Custom Properties: Enter any custom properties which should be sent to Pinterest (applicable only for sending events via device mode). For more information on using the custom properties, refer to the Custom properties section.

  • Map Your Events To Pinterest Events: Use this field to map RudderStack events to Pinterest Standard Conversion Events.

info

Note that RudderStack gives the highest priority to the event mapping specified in this setting.

  • If not specified, it gives priority to the standard ecommerce event mappings.
  • If Send as custom event toggle is turned on, then RudderStack sends the event with name custom to Pinterest.
  • If none of the above qualifies:
    • RudderStack sends the event name to Pinterest as is and it is shown as an unknown event in the Pinterest dashboard.

Client-side events filtering

This setting is applicable only if you are sending events to Pinterest Tag via device mode. Refer to the Client-side Event Filtering guide for more information.

Configure the consent management settings for the specified source by choosing the consent management provider from the dropdown. If you choose Custom, make sure to pass the custom consent data to SDK. |

Web SDK Settings

  • Use device-mode to send events: If you are using the JavaScript SDK as a source, this setting is on by default and cannot be turned off.

FAQ

How do I get the Pinterest Tag ID?

  1. Log in to your Pinterest Ads dashboard.
  2. Click the Ads dropdown and go to Conversions.
  3. In the Pinterest Tag Manager, click Get Started and you will see your Tag ID:

How do I get the Ad account ID?

Refer to the Pinterest documentation to get the Pinterest Ad account ID.

How to get the conversion token?

Refer to the Pinterest documentation to get the conversion token associated with your account.


Questions? Contact us by email or on Slack