Facebook Lift Studies: Most-used fields#
The table below gives information about most-used fields that you can import from Facebook Lift Studies. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
account_id Dimension
The unique identifier for the ad account associated with the study cell.
account_name Dimension
The name of the ad account associated with the study cell.
advancedBrandLiftCILower Metric
The lower bound of the confidence interval for the advanced brand lift metric, indicating the minimum estimated incremental brand lift.
advancedBrandLiftCIUpper Metric
The upper bound of the confidence interval for the advanced brand lift metric, indicating the maximum estimated incremental brand lift.
advancedBreakthroughs.control Metric
Detailed breakdown of the outcome metric for the control group, segmented by specific demographics or other study dimensions.
advancedBreakthroughs.incremental Metric
This indicates the estimated additional impact on an advanced metric achieved by the advertisements, calculated as the difference between the test group and the control group.
advancedBreakthroughs.informativeSingleCellBayesianConfidence Metric
This provides a statistical confidence level, based on Bayesian methods, that the observed incremental results for an advanced metric in a specific test cell are genuinely greater than zero.
advancedBreakthroughs.test Metric
Detailed breakdown of the outcome metric for the test group, segmented by specific demographics or other study dimensions.
advancedCostPerIncrementalBreakthrough Metric
The average cost for each additional breakthrough event generated by the test ads.
advancedIsWinner.confidence_level Dimension
The confidence level associated with determining if a specific test group is considered a 'winner' in the lift study, based on the statistical significance of the results. This is analogous to 'conversions_confidence'.
advancedIsWinner.is_winner Dimension
A boolean indicator of whether the test group is statistically considered a 'winner' for the given objective in the lift study, often based on a predefined confidence threshold.
advancedScoreMean.control Metric
The average value of the outcome metric for the control group in the lift study.
advancedScoreMean.incremental Metric
The incremental average value of the outcome metric, representing the uplift attributable to the ad exposure in the test group compared to the control group.
advancedScoreMean.test Metric
The average value of the outcome metric for the test group in the lift study.
advancedScoreSum.control Metric
The total sum of the outcome metric for the control group in the lift study.
advancedScoreSum.incremental Metric
The incremental total sum of the outcome metric, representing the total uplift attributable to the ad exposure in the test group compared to the control group.
advancedScoreSum.test Metric
The total sum of the outcome metric for the test group in the lift study.
brandLiftCILower Metric
The lower bound of the confidence interval for the brand lift metric, indicating the minimum expected incremental brand lift.
brandLiftCIUpper Metric
The upper bound of the confidence interval for the brand lift metric, indicating the maximum expected incremental brand lift.
breakthroughs.control Metric
The number of breakthroughs observed in the control group, who were not exposed to the advertising campaign.
breakthroughs.incremental Metric
The incremental number of breakthroughs attributed to the advertising campaign, calculated as the difference between the test and control groups.
breakthroughs.pValue Metric
The frequentist probability of observing the difference, or a more extreme one, between the raw rate of breakthrough events of the test population and the control population, assuming the treatment had no impact.
breakthroughs.singleCellBayesianConfidence Metric
The Bayesian confidence level for breakthroughs, providing a probability that the observed incremental impact is not due to random chance.
breakthroughs.test Metric
The number of breakthroughs observed in the test group, who were exposed to the advertising campaign.
cell_campaigns_id Dimension
A list of campaign IDs associated with this cell in the lift study.
cell_id Metric
The unique identifier for a specific cell (test or control group) within a lift study.
cell_name Dimension
The descriptive name of the test or control group (cell).
cell_treatment_percentage Metric
The percentage of the audience within a cell that is exposed to the ads.
conversions_CPiC Dimension
The Cost Per Incremental Conversion, representing the cost incurred for each additional conversion generated by the campaign.
conversions_confidence Metric
The statistical confidence level for the conversion lift results.
conversions_control_raw_scaled Metric
The raw, scaled number of conversions observed in the control group.
conversions_control_scaled Metric
The scaled number of conversions observed in the control group, adjusted for comparison.
conversions_exposed Metric
The number of conversions from the population exposed to the ads.
conversions_incremental Metric
The incremental number of conversions attributed to the ad campaign, calculated as the difference between test and control groups.
conversions_incremental_lower Metric
The lower bound of the confidence interval for incremental conversions.
conversions_incremental_share Metric
The share of incremental conversions relative to total conversions.
conversions_incremental_upper Metric
The upper bound of the confidence interval for incremental conversions.
conversions_multicell_confidence Dimension
The statistical confidence level for conversion lift results across multiple cells in a study.
conversions_multicell_rank Metric
The ranking of a cell's conversion performance compared to other cells in a multi-cell study.
conversions_notExposed Metric
The number of conversions from the population not exposed to the ads.
conversions_raw_pValue Dimension
The raw p-value for conversions, indicating the statistical significance of the conversion lift.
conversions_test Metric
The number of conversions observed in the test group.
costPerIncrementalBreakthrough Metric
The cost incurred for each incremental breakthrough achieved, such as Cost Per Incremental Conversion (CPiC) or Cost Per Incremental Buyer (CPiB).
costPerIncrementalBreakthroughRegion Metric
The cost incurred to achieve one incremental breakthrough (e.g., a key conversion or desired action) in a specific geographical region, as measured by the lift study.
costPerIncrementalBreakthroughVertical Metric
The cost incurred to achieve one incremental breakthrough (e.g., a key conversion or desired action) within a specific industry vertical or business category, as measured by the lift study.
experiment_id Metric
The unique identifier for the lift study or experiment.
frequency Metric
The average number of times an individual in the target audience saw the ad during the study period.
impressions Metric
The total number of times ads in the study were viewed.
isWinner.confidence_level Dimension
The confidence level for the 'is winner' metric, indicating the statistical certainty that the test group outperformed the control group.
isWinner.is_winner Dimension
A boolean indicator specifying whether the test group is considered a 'winner' based on the lift study analysis, meaning it showed a statistically significant incremental impact.
objective_id Dimension
The unique identifier for the advertising objective being measured in the lift study.
objective_name Dimension
The name of the advertising objective.
objective_type Dimension
The type of advertising objective, such as CONVERSIONS, SALES, or BRAND.
population.control Metric
The number of unique Accounts Center accounts in the control group.
population.reached Metric
The number of unique Accounts Center accounts reached by the ads in the study.
population.test Metric
The number of unique Accounts Center accounts in the test group.
population_control Metric
The estimated number of people in the control group.
population_reached Metric
The estimated number of people reached by the ad campaign.
population_test Metric
The estimated number of people in the test group.
rawScoreSum.control Metric
The total sum of the raw (unadjusted) score for the control group in the lift study.
rawScoreSum.test Metric
The total sum of the raw (unadjusted) score for the test group in the lift study.
responders.control Metric
The number of individuals in the control group who took a desired action or converted. Similar to 'Buyers Control'.
responders.test Metric
The number of individuals in the test group who took a desired action or converted. Similar to 'Buyers Test'.
sales_ROAS Metric
Return on Ad Spend (ROAS) for sales generated by the campaign.
sales_confidence Metric
The statistical confidence level for the sales lift results.
sales_control_raw_scaled Metric
The raw, scaled sales value observed in the control group.
sales_control_scaled Metric
The scaled sales value observed in the control group, adjusted for comparison.
sales_exposed Metric
The sales generated by the group exposed to the advertisements. This corresponds to the 'test group' in Facebook Lift Studies.
sales_incremental Metric
The incremental sales value attributed to the ad campaign, calculated as the difference between test and control groups.
sales_incremental_lower Metric
The lower bound of the confidence interval for incremental sales.
sales_incremental_share Metric
The share of incremental sales relative to total sales.
sales_incremental_upper Metric
The upper bound of the confidence interval for incremental sales.
sales_multicell_confidence Dimension
The statistical confidence level for sales lift results across multiple cells in a study.
sales_multicell_rank Metric
The ranking of a cell's sales performance compared to other cells in a multi-cell study.
sales_notExposed Metric
The sales value from the population not exposed to the ads.
sales_raw_pValue Dimension
The raw p-value for sales, indicating the statistical significance of the sales lift.
sales_test Metric
The sales generated by the test group. In Facebook Lift Studies, the test group is the group exposed to the advertisements.
scoreMean.control Metric
The average value of a specific score metric within the control group.
scoreMean.incremental Metric
The incremental average value of a specific score metric attributed to the advertising campaign.
scoreMean.test Metric
The average value of a specific score metric within the test group.
scoreMeanRegion Metric
The average score (e.g., brand lift or conversion lift) for a specific geographical region, such as a country. Note: Breakdowns by country are not supported for studies started after July 13, 2021.
scoreMeanVertical Metric
The mean score or average metric observed for a lift study within a specific industry vertical. This can be used for benchmarking campaign performance against industry standards.
scoreSum.control Metric
The total sum of a specific score metric within the control group.
scoreSum.incremental Metric
The incremental total sum of a specific score metric attributed to the advertising campaign.
scoreSum.test Metric
The total sum of a specific score metric within the test group.
spend Metric
The total amount of money spent on ads for the lift study.
study_end_time Dimension
The end time of the campaign active period for the lift study.
study_id Metric
The unique identifier for the lift study.
study_name Dimension
The name of the lift study.
study_start_time Dimension
The start time of the campaign active period for the lift study.
study_type Dimension
The type of lift study conducted, such as 'LIFT' for conversion lift studies.