Pinterest Walkthrough

Pinterest API version 5 is currently supported

Prerequisites

• Pinterest Connection

Pinterest Reports

Select the report to pull from the Report list:

• Ad Accounts
• Audience per Scope and Type
• Ads Delivery Report
• Delivery Metrics Definitions
• User Metrics
• Users Top Pin Metrics
• Users Top Video Pin Metrics 
• User Information
• Batch Advertiser Entities

Time-Dependent Reports

Some reports have time dependency where a defined time period is needed. All the time-dependent reports can be set using Rivery's built-in time functionalities.

Select a time period:

Time-dependent reports support two kinds of time-periods:

1. Date Range -
   • Pulls data in the date range between the start and end date provided, including the end date.
   • You must select a start date.
   • Leaving the end date empty will pull data up to the current time of the river's run.
   • Select a timezone offset to use dates considering the offset.
   • Use the "Last Days Back For Each Run" to expand the start date and pull data a given number of days back before the chosen start date.

Please Note:

The Start Date will not advance if a River run is unsuccessful. To change the default setting, click More Options and check the box to advance the start date even if the River run is unsuccessful.

In the example above the river will run with a date range between "01/03/2020" and "30/03/2020".

2. Predefined date - A date range defined by Rivery:
   • Day - Yesterday.
   • Week (From Monday to Sunday) - Week to date, Previous week, Previous week to date.
   • Month - Month to date, Previous month, Previous month to date.
   • Year - Year to date.

Ads Delivery Report

• Ads Delivery Report has a maximum time range of 30 days in each request. Therefore we set the default splitting time period to be 30 days.
• Getting each of the metric level attributions can be acquired with this button:

In this example, your mapping will have an additional record field named: pin_promotion_attributions holding all the information about it.

• There are several window days combinations not allowed in this report, with respect to (click window days, engagement window days, view window days):

(1, 30, 1), (1, 60, 1), (1, 60, 30), (14, 1, 1), (14, 1, 30), (14, 1, 60),(14, 30, 1), (14, 30, 30), (14, 30, 60), (14, 60, 1), (14, 60, 30), (14, 60, 60)

Here is an example of such case:

Troubleshooting

In Ads Delivery Report, if the columns parameter is left empty or has Total Impression columns as shown below, and the run fails with the following message: "Reach metrics cannot be requested for...", please remove those columns.