Pinterest Ads Release Notes

April 2022link

We have expanded the Create a Connector and Modify a Connector endpoints of our REST API. Now you can authorize the Pinterest Ads connector by adding the auth section to payloads.

February 2022link

We have upgraded our connector from Pinterest Ads API version 3 to version 4, because Pinterest has deprecated version 3. For more information, see Pinterest Ads’ API documentation.

We have made the following schema changes to support Pinterest Ads API version 4:

We have added two new tables, PRODUCT_ITEM_REPORT and CATALOG_PRODUCT_GROUPS_HISTORY.

We have added the following fields to the tables below:

• catalog_product_group_id to the PRODUCT_GROUP_HISTORY table
• billing_profile_status, billing_type, merchant_id, and status to the ADVERTISER_HISTORY table
• updated_time and created_time to the AUDIENCE_HISTORY table
• enhanced_match_status, last_fired_time_ms, status, and version to the CONVERSION_TAG_HISTORY table
• summary_status, status_time, end_time, and campaign_budget_optimization_enabled to the CAMPAIGN_HISTORY table

Pinterest has deprecated the following tables:

• TAG_HISTORY
• APP_EVENT_TRACKING_CONFIG_HISTORY
• ITEM_REPORT

Pinterest has deprecated the following fields, so we have removed them from the tables below:

• deleted, exclude, and new_match_type from the KEYWORD_HISTORY table

  NOTE: The deleted field was removed, but the archived field has similar usage. According to Pinterest, archiving a keyword effectively deletes it. The keywords no longer receive metrics and are no longer visible within the parent entity’s keywords list. For more information, see Pinterest’s documentation.

• valid and active from the PRODUCT_GROUP_HISTORY table
• test_account and is_one_tap from the ADVERTISER_HISTORY table
• rule from the AUDIENCE_HISTORY table
• num_matched_user_records and list_type from the CUSTOMER_LIST_HISTORY table
• verification_status, click_window_days, conversion_type, view_window_days, created_time, engagement_window_days, and updated_time from the CONVERSION_TAG_HISTORY table
• billing_group, product_filter, measurement_partner_campaign_id, and placement_exclusion from the CAMPAIGN_HISTORY table

We have updated the primary keys for the following tables:

• id, updated_time, advertiser_id, and audience_type is a new primary key for the AUDIENCE_HISTORY table
• date, product_group_id, advertiser_id, targeting_type, and targeting_value is a new primary key for the PRODUCT_GROUP_TARGETING_REPORT table

October 2021link

We now sync the pin_stats and influencer_pin_stats extra properties for the PIN_HISTORY table.

September 2021link

We now sync the PRODUCT_GROUP_TARGETING report.

We now sync the following Targeting type tables:

• TARGETING_AGE_BUCKET
• TARGETING_APP_TYPE
• TARGETING_GENDER
• TARGETING_GEO
• TARGETING_GEO_METRO
• TARGETING_GEO_REGION
• TARGETING_INTEREST
• TARGETING_LOCALE
• TARGETING_LOCATION

December 2020link

The Pinterest Ads connector now supports the 0-day conversion attribution window. You can sync your data based on your custom Pinterest click, engagement, or view attribution windows, such as 1-day click/0-day engagement/0-day view, or 7-day click/0-day engagement/0-day view.

September 2020link

We have released pre-built, dbt Core-compatible data models for Pinterest Ads. Find the models in Fivetran’s dbt hub or data models documentation. Learn more about our dbt Core integration in our Transformations for dbt Core documentation*.

* dbt Core is a trademark of dbt Labs, Inc. All rights therein are reserved to dbt Labs, Inc. Fivetran Transformations is not a product or service of or endorsed by dbt Labs, Inc.

July 2020link

The Pinterest Ads connector now supports priority-first sync. Priority-first syncs fetch your most recent data first so that it’s quickly ready for you to use. Pinterest Ads’s priority-first syncs fetch the most recent thirty days of data from the reporting tables.

To learn more, see our priority-first sync documentation.

May 2020link

You can now configure your Pinterest Ads connector using the Fivetran REST API. This feature is in BETA and available only for Standard and Enterprise accounts.

April 2020link

We have added a new table, KEYWORD_REPORT.

February 2020link

When setting up your connector, you can now select which advertisers you’d like to sync. Previously, Fivetran synced all advertisers by default.

January 2020link

We have deprecated the optimization_goal field in the CAMPAIGN_HISTORY table. This change is required to migrate our Pinterest connector to the Pinterest Ads API V3. For more details, see Pinterest Ads’ API documentation.

October 2019link

We have upgraded the Pinterest Ads API to version 3, since versions 1 and 2 of the API have been deprecated. For more details, see Pinterest Ads’ API documentation.

We have made a number of schema changes to support Pinterest Ads API version 3.

• The new objective_type field has replaced the optimization_goal field in the CAMPAIGN_HISTORY table. We will support the optimization_goal field for the next three months, and then it will be deprecated.

• The deprecated bid_type field has been reformatted and renamed to billable_event in the AD_GROUP_HISTORY table.

• We have added the following fields to the tables below:

  • billable_event to the AD_GROUP_HISTORY table
  • creative_type to the PIN_PROMOTION_HISTORY table

• Pinterest has deprecated the following fields, so we have removed them from the tables below:

  • bid_type from the AD_GROUP_HISTORY table
  • campaign_type, bid_type, is_one_tap, and upgrade_status from the CAMPAIGN_HISTORY table
  • upgrade_status from the PIN_PROMOTION_HISTORY table

July 2019link

• We released a new version of our Pinterest Ads connector, service version 1. You can now select how many months of data you’d like to include in your initial sync. Choose from the following options:

  • 3 months
  • 6 months
  • 12 months
  • 24 months
  • All time

October 2018link

We no longer process ITEM reports for advertisers who are not running shopping campaigns, because Pinterest only allows advertisers who are running shopping campaigns to access these reports.

July 2018link

The Pinterest Ads connector now syncs ITEM and PIN_PROMOTION_TARGETING reports.

June 2018link

The connector syncs Pinterest advertising meta-data related to Campaigns, AdGroups, Pin Promotions etc.

Link to Pinterest Ads Account documentation