Send events to Pinterest Tag via the web device mode.
4 minute read
RudderStack lets you send your event data to Pinterest Tag using Pinterest’s pintrk conversion tag via device mode.
Find the open source JavaScript SDK code for this destination in the GitHub repository.
Identify
The identify call lets you create new or update existing customers and record the traits about them like their name, email address, etc.
When you make an identify call with a user’s email address and traits, RudderStack triggers the Pinterest set() method. This saves the identification parameters to be sent with the next events, so it is recommended to set the values as early as possible.
If you make an identify call without email, the identification parameter will not be set.
In the above example, the identification parameter will be set to alex@example.com and the successive calls will be an Enhanced Match.
After an identify call is made, nothing appears in the network tab in your browser or in the tag helper extension. 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 user actions along with the properties associated with these actions.
You can use the Ecommerce Events Specification for sending the events while instrumenting your site with the RudderStack SDK.
The following table mentions some sample track events mapped to the Pinterest events:
RudderStack event
Pinterest event
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 the conversion reporting. It will be mapped to a custom Pinterest event, for example:
rudderanalytics.track("custom event")
You can map your event to a specific Pinterest event by adding it in the Map Your Events To Pinterest Events section while configuring the Pinterest destination in RudderStack.
Standard Pinterest events
Pinterest supports the following nine standard events that can be mapped and tracked for reporting. Any event apart from these is treated as a user-defined event.
Checkout
AddToCart
PageVisit
SignUp
WatchVideo
Lead
Search
ViewCategory
Custom
Property mapping
RudderStack maps the following properties to the Pinterest properties:
RudderStack property
Pinterest property
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 ecommerce products array:
RudderStack property
Pinterest property
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
Custom properties
You can send the custom properties to Pinterest by adding them in the Custom Properties section while configuring the Pinterest destination in RudderStack.
A sample snippet with custom properties is shown below:
For the above snippet, the following properties must be added in the Custom Properties section:
customProperty.customValue
someRandomMailId
Page
The page call lets you record your website’s page views with any additional relevant information about the viewed page.
Pinterest’s pintrk conversion tag sends any one of the following events when you make a page call:
ViewCategory: RudderStack sends this event if both the name and category fields are present. The below sample event contains both the fields and is mapped to the Pinterest’s ViewCategory event:
rudderanalytics.page("Best Seller","Games",{path:"/best-seller/games/1",url:"https://www.estore.com/best-seller/games/1",title:"Best selling games offered by EStore",search:"estore bestseller games",referrer:"https://www.google.com/search?q=estore+bestseller",testDimension:"true",})
PageVisit: RudderStack sends this event if only name field is present and drops any additional properties. The below sample event contains only name and is mapped to the Pinterest’s PageVisit event:
Starting January 1, 2023, you can use Pinterest’s Limited Data Processing (LDP) flag to limit how Pinterest uses certain data to help the advertisers comply with the users’ privacy settings in accordance with the CCPA (California Consumer Privacy Act).
The following table lists the event properties required to enable Limited Data Processing and their mappings with the Pinterest fields:
This site uses cookies to improve your experience while you navigate through the website. Out of
these
cookies, the cookies that are categorized as necessary are stored on your browser as they are as
essential
for the working of basic functionalities of the website. We also use third-party cookies that
help
us
analyze and understand how you use this website. These cookies will be stored in your browser
only
with
your
consent. You also have the option to opt-out of these cookies. But opting out of some of these
cookies
may
have an effect on your browsing experience.
Necessary
Always Enabled
Necessary cookies are absolutely essential for the website to function properly. This
category only includes cookies that ensures basic functionalities and security
features of the website. These cookies do not store any personal information.
This site uses cookies to improve your experience. If you want to
learn more about cookies and why we use them, visit our cookie
policy. We'll assume you're ok with this, but you can opt-out if you wish Cookie Settings.