Skip to main content

How to request Facebook Ads budget data in Funnel

List of Facebook Ads budget dimensions and metrics available through a data request in Funnel.

How to 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

  • Include the following information in your data request: + Under Where does the data come from? enter Facebook Budget + The list of Facebook Ads data sources you need budget data for + For each Facebook Ads data source, whether the budget is set at the Campaign or Ad Set level + Permission to use credentials from the connector for the data request

You can set an overall budget for your campaign with Meta Advantage campaign budget (previously known as campaign budget optimization), or set individual budgets for your ad sets. For both campaign budgets and ad set budgets, you can choose whether your budget applies to each day, or over the entire lifetime of the campaign or ad set.

​

Because the budget is metadata, Facebook only provides the current budget. You can't get historical data showing what the budget was at a specific time in the past. The Facebook Ads budget data request records your daily budget every day and attributes it to that day, so you build up a history of your budget from the day you start using it.

​

Facebook Ads connector or custom connector?

The standard Facebook Ads connector includes Daily Budget and Lifetime Budget when you connect at the Campaign or Ad Set level. These fields only show the current budget, so you can't see what a budget was on a past date. For the full field list, see Facebook Ads: Dimensions and metrics.

​

To track how your budgets change over time, request the Facebook Ads budget custom connector described in this article. It records your budget every day, starting from the day you begin using it.

​

Which report type should you choose?

All reports are available at the Campaign and Ad Set level. Each level needs its own data source in Funnel.

Report type

When to use it

Daily Budget

Use this to keep a daily history of your budgets. Each day, Funnel records the current budget and attributes it to that date.

Lifetime of Daily Budget

Use this to compare your daily budget with what you spent. It combines a Daily Budget data source with a Spend data source.

Lifetime Budget

Use this to see the current lifetime budget with lifetime spend, impressions and link clicks. This data source is dateless and only shows the current values.

Daily Budget

This data source records the current budget for each campaign or ad set every day. It includes the Daily Budget, Lifetime Budget and Budget Remaining metrics. The data updates every 4 hours.

​

Dimensions

The following dimensions are available at the Campaign and Ad Set level:

​

  • Date: The day Funnel recorded the budget.

  • Account ID: The ID number of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.

  • Account Name: The name of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.

  • Campaign ID: The unique ID number of the ad campaign you are viewing in reporting. Your campaign contains ad sets and ads.

  • Campaign Name: The name of the ad campaign you are viewing in reporting. Your campaign contains ad sets and ads.

  • Delivery Status: The status of your campaigns, ad sets and ads can be turned on or off. Keep in mind that if your campaign is Off you will need to turn it On before your ad sets and ads can run.

  • Effective Status: The effective status of the campaign or ad set.

  • Delivery Level: The level of the data source: Campaign or Adset.

  • Start Time: The start time of the campaign or ad set.

  • End Time: The end time of the ad set.

  • Stop Time: The stop time of the campaign.

  • Updated Time: The last time the campaign or ad set was updated.

  • Currency: The currency of your ad account.

​

The following dimensions are available at the Ad Set level:

​

  • Ad Set ID: The unique ID of the ad set you are viewing in reporting. An ad set is a group of ads that share the same budget, schedule, delivery optimization and targeting.

  • Ad Set Name: The name of the ad set you are viewing in reporting. An ad set is a group of ads that share the same budget, schedule, delivery optimization and targeting.

​

Metrics

The following metrics are available at the Ad Set and Campaign level:

​

  • Daily Budget: The daily budget is the average amount you indicated you are willing to spend on a specific ad set per day. Each ad set will have its own separate budget, so keep this in mind if you have more than one active ad set in your account.

  • Lifetime Budget: A Lifetime budget lets you set an amount to spend over the lifetime of an ad set. Our technologies will automatically try to evenly spread the amount you spend across the period of time that you have selected.

  • Budget Remaining: The amount of the budget that is left to spend.

​

Lifetime of Daily Budget

This consists of two data sources. The first one displays the Daily Budget for campaigns or ad sets, while the second brings in Spend data. It automatically calculates the percentage Share of the Budget Spend.

​

Dimensions

The following dimensions are available at the Campaign and Ad Set level:

​

  • Account ID: The ID number of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.

  • Account Name: The name of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.

  • Campaign ID: The unique ID number of the ad campaign you are viewing in reporting. Your campaign contains ad sets and ads.

  • Campaign Name: The name of the ad campaign you are viewing in reporting. Your campaign contains ad sets and ads.

  • Delivery Status: The status of your campaigns, ad sets and ads can be turned on or off. Keep in mind that if your campaign is Off you will need to turn it On before your ad sets and ads can run.

​

The following dimensions are available at the Ad Set level:

​

  • Ad Set ID: The unique ID of the ad set you are viewing in reporting. An ad set is a group of ads that share the same budget, schedule, delivery optimization and targeting.

  • Ad Set Name: The name of the ad set you are viewing in reporting. An ad set is a group of ads that share the same budget, schedule, delivery optimization and targeting.

​

Metrics

The following metrics are available at the Ad Set and Campaign level:

​

  • Daily Budget: The daily budget is the average amount you indicated you are willing to spend on a specific ad set per day. Each ad set will have its own separate budget, so keep this in mind if you have more than one active ad set in your account.

  • Lifetime Budget: A Lifetime budget lets you set an amount to spend over the lifetime of an ad set. Our technologies will automatically try to evenly spread the amount you spend across the period of time that you have selected.

  • Spend: The estimated total amount of money you have spent on your campaign, ad set or ad during its schedule. This metric is estimated.

​

Example of Lifetime of Daily Budget data

Each day we ingest the current Daily Budget and Spend for each campaign within your Facebook Ad Account. We then calculate the Share of Budget Spend.

​

This feature grants you the capability to review historical modifications in the budget. You have the flexibility to delve deeper into a specific campaign.

​

Lifetime Budget

This data source presents the current Lifetime Budget along with metrics such as Lifetime Spend, Lifetime Impressions, and Lifetime Inline Link Clicks. Like the Daily Budget, it updates every 4 hours. It is dateless. More details on this type of data source can be found in the article Dateless data in Funnel.

​

Dimensions

The following dimensions are available at the Campaign and Ad Set level:

​

  • Account ID: The ID number of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.

  • Account Name: The name of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.

  • Campaign ID: The unique ID number of the ad campaign you are viewing in reporting. Your campaign contains ad sets and ads.

  • Campaign Name: The name of the ad campaign you are viewing in reporting. Your campaign contains ad sets and ads.

  • Delivery Status: The status of your campaigns, ad sets and ads can be turned on or off. Keep in mind that if your campaign is Off you will need to turn it On before your ad sets and ads can run.

  • Effective Status: The effective status of the campaign or ad set.

  • Delivery Level: The level of the data source: Campaign or Adset.

  • Start Time: The start time of the campaign or ad set.

  • End Time: The end time of the ad set.

  • Stop Time: The stop time of the campaign.

  • Updated Time: The last time the campaign or ad set was updated.

  • Currency: The currency of your ad account.

​

The following dimensions are available at the Ad Set level:

​

  • Ad Set ID: The unique ID of the ad set you are viewing in reporting. An ad set is a group of ads that share the same budget, schedule, delivery optimization and targeting.

  • Ad Set Name: The name of the ad set you are viewing in reporting. An ad set is a group of ads that share the same budget, schedule, delivery optimization and targeting.

​

Metrics

The following metrics are available at the Ad Set and Campaign level:

​

  • Daily Budget: The daily budget is the average amount you indicated you are willing to spend on a specific ad set per day. Each ad set will have its own separate budget, so keep this in mind if you have more than one active ad set in your account.

  • Lifetime Budget: A Lifetime budget lets you set an amount to spend over the lifetime of an ad set. Our technologies will automatically try to evenly spread the amount you spend across the period of time that you have selected.

  • Budget Remaining: The amount of the budget that is left to spend.

  • Spend: The estimated total amount of money you have spent on your campaign, ad set or ad during its schedule. This metric is estimated.

  • Impressions: The number of times your ads were on screen.

  • Inline Link Clicks: The number of clicks on links to select destinations or experiences, on or off Facebook-owned properties. Inline link clicks use a fixed 1-day-click attribution window.

​

Notes

  • Monetary values use the currency of your Facebook ad account.

  • For pricing questions or to request access to custom connectors, reach out to your Customer Success Partner or the Funnel Support team.

​

API documentation

For full field definitions and updates, see the Meta Marketing API documentation.

Did this answer your question?