Pinterest V3 to V5 Migration - Functionality Changes

Updated 

We would like to inform you about an important upgrade to the Pinterest API in Sprinklr. This upgrade involves transitioning from Pinterest v3 to v5.

If you currently have Pinterest accounts added in Sprinklr, please be aware that as part of this change, you will need to re-add your Pinterest Accounts between June 26th and June 30th. This is necessary due to the updated authentication process.

It is crucial to note that the v3 API will be deprecated on June 30th, 2023. As a result, any existing accounts that have not been successfully migrated by this date will be deactivated. However, once you re-add your accounts, they will function normally again.

We appreciate your attention to this matter and encourage you to take the necessary steps to ensure a smooth transition to the new Pinterest v5 API endpoints. If you have any questions or need assistance, please reachout to your Success Manager.

Changes in Publishing

The following options will no longer be available to users while publishing on Pinterest due to this migration:

  1. Going forward, users will not be able to Share pins to Facebook and Twitter, while publishing them from Sprinklr.

    image

  2. Users will not be able to select Category while publishing a board from Sprinklr.

    Note: This functionality is deprecated natively as well.

image

Changes in Engagement

The following details will no longer be available to users while Engaging with Pins on Pinterest due to this migration:

  1. First Name, Last Name & Full Name won't be available now in the Pinterest Profile details.

  2. Profile creation date will also not be available.

Changes in Reporting

The following details will no longer be available to users while Reporting on Pinterest due to this migration:

Following Reporting Metrics will be deprecated:

  • Pinterest Pin Last 90 days Closeups

  • Pinterest Pin Last 90 days Video Watch Time in milliseconds

  • Pinterest Pin Repins

  • Pinterest Pin Last 90 Days Engagement

  • ​Pinterest User Likes​

  • ​Pinterest User Low Engagement Board Count​

These metrics will hold the historical data. Once the account is re-added for Pinterest the above metrics would be appended with a deprecated tag. This would enable users to distinguish between existing and deprecated metrics.

New additional metrics that would be added post v5 migration:

Category

Metric

Post

Pinterest Pin Profile Visits

Post

Pinterest Pin video 95% viewed

Post

Pinterest Pin Save Rate

Post

Pinterest Pin Followers Gained

Post

Pinterest Pin video views (10 seconds or more)

Post

Pinterest Pin Average Video Play Time

Post

Pinterest Pin Video Starts

Post

Pinterest Pin Video 50% viewed

Post

Pinterest Parent Pin Id

Account

Pinterest Daily Full Screen Playtime

Account

Pinterest Daily Video Average watch Time

Account

Pinterest Daily Video Starts

Account

Pinterest Daily Clickthroughs

Account

Pinterest Daily Video Views

Account

Pinterest Daily Video 50% Viewed

Account

Pinterest Daily Closeups

Account

Pinterest Daily Closeup Rate

Account

Pinterest Daily Full Screen Plays

Account

Pinterest Daily Video Views (10 seconds)

Account

Pinterest Daily 95% Video Viewed

Apart from the above new metrics, here is the list of all exhaustive metrics available:

Metric Name

Description

Pinterest Pin Impression

The Number of times the Pin was viewed by users

Pinterest Pin Outbound Clicks

The number of times people perform actions that lead them to a destination off Pinterest.

Note: Outbound clicks are measured starting from the date the link is added.

Pinterest Pin Clicks

The total number of clicks on your Pin or ad so it opens in closeup.

Pinterest Pin Profile Visits

The number of times people visited your profile after viewing one of your Pins

Pinterest Pin video 95% viewed

The number of times your video was viewed to 95% of its length

Pinterest Pin Saves

The number of times people saved your Pin to a board.

Pinterest Pin Save Rate

The total saves of your Pins divided by the total number of times your Pins were on screen.

Pinterest Pin Followers Gained

The number of times people followed you after viewing one of your Pins.

Pinterest Pin video views (10 seconds or more)

The number of times your video was viewed for at least 10 seconds or more.

Pinterest Pin Average Video Play Time

The average time someone spent playing the video and static image cards included in your Pin.

Pinterest Pin Video Views

The amount of views for at least 2 seconds with 50% of video in view

Pinterest Pin Video Starts

The number of times your video was started

Pinterest Pin Video 50% viewed

The number of times your video was viewed to 50% of its length.

Pinterest Parent Pin Id

The Id of the parent pin which was saved

Pinterest Pin Comments

Total number of Comments on your Pin

Pinterest Pin Reactions

Total number of Reactions on your Pin

Pinterest Daily Engagements

-

Pinterest Daily Engagement Rate

-

Pinterest Daily Impressions

-

Pinterest Daily Outbound Clicks

-

Pinterest Daily Outbound Click Rate

-

Pinterest Daily clicks

-

Pinterest Daily Click rate

-

Pinterest Daily Saves

-

Pinterest Daily Save Rate

-

Pinterest Daily Full Screen Playtime

-

Pinterest Daily Video Average watch Time

-

Pinterest Daily Video Starts

-

Pinterest Daily Clickthroughs

-

Pinterest Daily Video Views

-

Pinterest Daily Video 50% Viewed

-

Pinterest Daily Closeups

-

Pinterest Daily Closeup Rate

-

Pinterest Daily Full Screen Plays

-

Pinterest Daily Video Views (10 seconds)

-

Pinterest Daily 95% Video Viewed

-

Pinterest Total Board Count

-

Pinterest Total Pin Count

-

Pinterest Follower Count

-

Pinterest Following Count

-

Please reach out in our #ask-social-channels forum tagging in the following POCs for any queries.

Social: Kushal Rathi, Paras Garg

Reporting: Vishwajeet Rajeghatge

Ads: Nachiketa Rajhans

Channel: Sreekar Maganti