Learn how Singular pulls data from Pinterest and displays it in your reports.
Quick Details
| Data Connector Technology | API (V4 API documentation) |
| Data breakdown (segmentation) |
Data from Pinterest is broken down by:
In addition, you can choose one of the following breakdowns:
For more information, see the Data Mapping table below. |
| Time Zone | UTC |
| Is data available on the creative level? | Yes |
| Does Singular show your creative assets? | Yes |
Data Mapping
For descriptions of each field in Singular reporting, see the Singular Metrics and Dimensions Glossary.
| Field in Singular UI | Field in Singular API | Field in Pinterest |
| Dimensions | ||
| Date | date | DATE |
| Account ID |
adn_account_id |
id |
| Account Name |
adn_account_name |
name |
| Country |
country_field |
country |
| Creative ID |
creative_id |
PIN_PROMOTION_ID |
| Creative Name |
creative_name |
PIN_PROMOTION_NAME |
| Keyword |
keyword |
TARGETING_VALUE |
| Keyword ID |
keyword_id |
KEYWORD_ID |
| Network Campaign ID | adn_campaign_id | CAMPAIGN_ID / PCAMPAIGN_ID |
| Network Campaign Name | adn_campaign_name |
CAMPAIGN_NAME |
| Network Sub Campaign ID |
adn_sub_campaign_id | AD_GROUP_ID / PIN_PROMOTION_AD_GROUP_ID |
| Network Sub Campaign Name |
adn_sub_campaign_name | AD_GROUP_NAME |
| Network Creative ID | adn_creative_id | PIN_PROMOTION_ID |
| Network Creative Name | adn_creative_name | PIN_PROMOTION_NAME |
| Original Bid Amount | original_bid_amount | bid_in_micro_currency |
| Bid Strategy | bid_strategy | bid_strategy_type |
| Metrics | ||
| Network Clicks | adn_clicks | CLICKTHROUGH_1 |
| Network Impressions | adn_impressions | IMPRESSION_1 |
| Original Cost |
adn_original_cost |
SPEND_IN_MICRO_DOLLAR |
| Original Currency | adn_original_currency | currency |
| Completed Video Views | completed_video_views |
VIDEO_P100_COMBINED_1 |
| Video Views | video_views |
VIDEO_MRC_VIEWS_1 |
| Video Views 25% | video_views_25pct |
VIDEO_P25_COMBINED_1 |
| Video Views 50% | video_views_50pct | VIDEO_P50_COMBINED_1 |
| Video Views 75% | video_views_75pct | VIDEO_P75_COMBINED_1 |
Additional Metrics (Conversion Events)
Singular pulls metrics from the Pinterest for Business metrics list. By default, regular events are pulled from the "in-app events metrics" section. In addition to these, you can pull any metric by creating a conversion event in Singular.
To create a conversion event:
- In Singular, go to Settings > Events. If you have both Custom Events and Conversion Events tabs, select Conversion Events.
- Click New Event.
- In the Pinterest dropdown, select the desired metric.
The next day, when Singular pulls daily data for your account, it will pull completions as well.
After the new event is populated with some data, run a report on the Reports page, and choose the conversion event you created from the Events dropdown.