The Pinterest Budget connector brings the budget, spend cap and bid settings of your Pinterest Ads campaigns or ad groups into Funnel. Use it to compare what you planned to spend with what you actually spend, or to keep a daily record of budget changes.
How do you get these dimensions and metrics in your workspace? | What do you need? |
Submit a data request. See Request new data in Funnel. | Business or Enterprise plan |
Reports
There is one report, the Budget report. When you set up a data source you choose two options:
Option | Choices | What it means |
Level | Campaign or Ad Group | Whether you get one row per campaign or one row per ad group. |
Date setting | Snapshot or Historical Snapshot | Snapshot shows only the current budget values. It works like a lookup table and has no date. Historical Snapshot saves the budget values each day Funnel fetches data, so you can see how budgets change over time. |
Dimensions
Campaign level
Dimension | What it is |
Date | The day Funnel fetched the budget values. Only in Historical Snapshot data sources. |
Currency | The currency of the Pinterest ad account. |
Campaign ID | The unique ID Pinterest gives the campaign. |
Campaign Name | The name of the campaign. |
Campaign Status | The status of the campaign, for example |
Campaign Objective Type | The campaign objective, for example |
Campaign Is Flexible Daily Budgets | Whether the campaign uses flexible daily budgets (also called Pinterest Performance+ budgets). |
Is Campaign Budget Optimization | Whether the campaign uses campaign budget optimization, where Pinterest sets ad group budgets from the campaign budget. |
Campaign Start Time | When ads in the campaign are scheduled to start showing. |
Campaign End Time | When ads in the campaign are scheduled to stop showing. Empty if the campaign has no end date. |
Is Performance Plus | Whether the campaign is a Pinterest Performance+ campaign. |
Is Automated Campaign | Whether the campaign was created with Pinterest's automated campaign flow. |
Ad group level
Dimension | What it is |
Date | The day Funnel fetched the budget values. Only in Historical Snapshot data sources. |
Currency | The currency of the Pinterest ad account. |
Ad Group ID | The unique ID Pinterest gives the ad group. |
Ad Group Name | The name of the ad group. |
Campaign ID | The ID of the campaign the ad group belongs to. |
Campaign Name | The name of the campaign the ad group belongs to. |
Campaign Status | The status of the campaign the ad group belongs to. |
Ad Group Created Time | When the ad group was created. |
Ad Group Updated Time | When the ad group was last changed. |
Ad Group Start Time | When ads in the ad group are scheduled to start showing. |
Ad Group End Time | When ads in the ad group are scheduled to stop showing. Empty if the ad group has no end date. |
Ad Group Status | The status of the ad group, for example |
Ad Group Budget Type | How the ad group budget works: |
Ad Group Billable Event | What you pay for: |
Ad Group Placement Group | Where the ads can show: |
Ad Group Pacing Delivery Type | How the budget is spent: |
Ad Group Summary Status | Pinterest's overall delivery status for the ad group, for example |
Ad Group Placement Traffic Type | Which feed the ads can show in: |
Ad Group Bid Strategy Type | The bid strategy: |
Metrics
Campaign level
Metric | What it measures |
Lifetime Spend Cap | The most the campaign can spend over its whole run time. Zero or empty if not set. |
Daily Spend Cap | The most the campaign can spend per day. Zero or empty if not set. |
Ad group level
Metric | What it measures |
Budget in Micro Currency | The ad group's budget. Whether it is a daily or lifetime budget is shown in Ad Group Budget Type. |
Bid in Micro Currency | The bid set for the ad group. |
The metrics appear in Funnel in a group named after the level and date setting: Campaign Budget, Historical Campaign Budget, Ad Group Budget or Historical Ad Group Budget.
Notes on this connector
Each data source connects to one Pinterest ad account. To get both campaign and ad group data, or both Snapshot and Historical Snapshot data, set up one data source for each.
Snapshot data sources always show today's values. Older values are replaced each time Funnel fetches new data.
Historical Snapshot data sources start recording on the day you set them up. They can't be backfilled, so there is no budget history from before that day.
Budget values are settings, not spend. In Historical Snapshot data, the same budget is recorded again each day. Don't add budget values up across several days. Look at one day at a time, or use the latest date.
Pinterest only returns campaigns and ad groups with the status
ACTIVEorPAUSED. Archived and draft campaigns and ad groups are not included.Budget and bid values use the currency of your Pinterest ad account.
Start, end, created and updated times are shown as date and time (
YYYY-MM-DD HH:MM:SS).
How to request this data
To get Pinterest Budget data, submit a data request.
Include this information in your data request
In Where does the data come from?, enter Pinterest Budget.
The name and ID of each Pinterest ad account you want budget data for.
The level you want: Campaign or Ad Group.
The date setting you want: Snapshot (current values only) or Historical Snapshot (a daily record that starts on the day the data source is set up).
The connector uses your Pinterest login, the same as the Pinterest Ads connector. Make sure the Pinterest user you connect with has access to the ad accounts.
For pricing or access to custom connectors, contact your Customer Success Partner or Funnel Support.