Set up Pinterest Tag

Set up Pinterest Tag as a destination in RudderStack.

RudderStack supports sending event data to Pinterest Tag via the following connection modes:

Connection ModeWebMobileServer
Device ModeSupported--
Cloud ModeSupportedSupportedSupported
In a web device mode integration, that is, using JavaScript SDK as a source, the Pinterest Tag native SDK is loaded from domain. Based on your website’s content security policy, you might need to allowlist this domain to load the Pinterest Tag SDK successfully.

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, you will need to configure the following settings:

  • Tag ID: Enter your Pinterest Tag ID. This field is required only for sending events to Pinterest Tag via device mode.
For more information on obtaining the Pinterest Tag ID, refer to the FAQ section below.
  • App Store App ID: Enter the App Id from your App Store. This field is required only if you are using an iOS source to send the events.
  • Pinterest Advertiser ID: Enter the Advertiser ID of your Pinterest account. This field is required only for sending events to Pinterest Tag via cloud mode.

Other settings

  • Enable hashing for user data conversions: This setting is enabled by default and hashes your user data using SHA256 encoding.

  • Enable Event Deduplication: Enable this setting to deduplicate the events. If enabled, you need to enter the following:

    • Deduplication key: Enter the key using which Pinterest Tag should use to deduplicate the events.
  • Custom Properties: Enter any custom properties which should be sent to Pinterest. This field is applicable only for sending events to Pinterest Tag 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.
  • The event mapping specified in the above connection setting is given the highest priority.
  • If not specified, the standard ecommerce event mapping is considered.
  • If none of the above qualifies, RudderStack sends the event name as is, and it is shown as an unknown event in the Pinterest dashboard.
  • Enable Enhanced Match on Page Load: This setting is enabled 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 disabled, 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 enable Pinterest’s Enhanced Match, you can only collect this information for successive events. Pinterest does not retroactively update the values for the past events.

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 on this setting.


How do I get the Pinterest Tag ID?

To get your Pinterest Tag ID, follow these steps:

  1. Login to your Pinterest Ads dashboard.
  2. Click the Ads dropdown and go to Conversions. It will open the Pinterest Tag Manager.
  3. Click Get Started and you will see your Tag ID:

Questions? Contact us by email or on Slack