Pinterest walkthrough
Pinterest API version 5 is currently supported.
Prerequisites
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 a time dependency where you must define a time period. You can set all the time-dependent reports using Data Integration built-in time features.
Time-dependent reports support two kinds of time periods:
- 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 pulls data up to the current time of the river's run.
- Select a timezone offset to use dates based on 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.
The start date will not advance if a River run is unsuccessful. To change the default setting, click More Options and select the check box to advance the start date even if the River run is unsuccessful.
- Predefined date - a date range defined by Data Integration:
- 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
The Ads delivery report has a maximum time range of 30 days in each request. So, the default splitting time period is 30 days. The Get attributes from specific level button lets you acquire each metric-level attribute.
In the example, your mapping will have an additional record field: pin_promotion_attributions holding all the information about it.
Several window days combinations are not allowed in this report (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 a case:
Troubleshooting
In the Ads delivery report, if the columns parameter is empty or has Total Impression columns, and the run fails with the message: **Reach metrics cannot be requested for...**, remove these columns.
