Pinterest Data Connector

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:

  • Campaign
  • Sub Campaign (Ad Group)

In addition, you can choose one of the following breakdowns:

  • Keywords (default)
  • Country

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:

  1. In Singular, go to Settings > Events. If you have both Custom Events and Conversion Events tabs, select Conversion Events.
  2. Click New Event.
  3. 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.

Was this article helpful?