Skip to main content
All CollectionsData ConnectorsCustom Connectors
How to request Facebook Ads budget data in Funnel
How to request Facebook Ads budget data in Funnel

Leverage your Facebook Ads (by Meta) budget data in Funnel via Custom Connectors.

Kelsey Maynard avatar
Written by Kelsey Maynard
Updated over 7 months ago

If your use case requires this in Funnel, you can request it as a Custom Connector.

Custom Connectors and the Custom Connector Request feature are available in the following plans: Business and Enterprise. See our Pricing page for more details.


How Does It Work?

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 considered metadata, we can only obtain information about the current budget state. Unfortunately, this means we can't retrieve historical data showing what the budget was at a specific time in the past. While knowing the current budget is useful, it's also valuable to track changes in your budget over time.

Our Custom Connector is unique because it can request your daily budget every day and associate it with that specific day. This process allows you to generate a historical report of your daily budget for each date since you started using the Custom Connector. In simpler terms, it's like keeping a diary of your budget, showing how it has changed over time!


Available Budget Reports

All reports are available at the campaign and ad set level. Each level (campaign vs. ad set) requires it's own Data source in Funnel.

Daily Budget

This data source shows the current budget information for campaigns or ad sets on a daily basis. It includes the Daily, Lifetime, and Remaining Budget metrics. The data updates every 4 hours. For more information on data sources that don't have specific dates, check out the article "Dateless data in Funnel".

Dimensions and Metrics

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're viewing in reporting. Your campaign contains ad sets and ads.

  • Campaign Name: The name of the ad campaign you're 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'll 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're 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're 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're 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've selected.

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 and Metrics

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're viewing in reporting. Your campaign contains ad sets and ads.

  • Campaign Name: The name of the ad campaign you're 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'll 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're 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're 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're 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've selected.

  • Spend: The estimated total amount of money you've 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 and is dateless. More details on this type of data source can be found in the article "Dateless data in Funnel".

Dimensions and Metrics

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're viewing in reporting. Your campaign contains ad sets and ads.

  • Campaign Name: The name of the ad campaign you're 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'll 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're 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're 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're 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.

  • 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.

  • 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've selected.

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


How to Request this Custom Connector

To request Facebook Ads (by Meta) budget data, submit a Custom Connector Request (see link here for instructions).


Please Include the Following Information in your Custom Connector Request

  • Under "Where does the data come from?" enter "Facebook Budget"

  • The list of Facebook Data Sources budget data is required for.

  • For each Facebook Data Source, is budget set at the Campaign or Ad Level

  • Permission to use credentials from Core Data Source for Custom Connector

For pricing questions or to request access to Custom Connectors please reach out to your Customer Success Partner or the Funnel Support team.

Did this answer your question?