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.

API name	Adverity UI name	Description	Use in Adverity
account_id	account_id	The unique identifier for the ad account associated with the lift study cell.	dimension
account_name	account_name		dimension
advancedBrandLiftCILower	advancedBrandLiftCILower	The lower bound of the confidence interval for an advanced brand lift metric, indicating the minimum expected incremental impact based on a more sophisticated model.	metric
advancedBrandLiftCIUpper	advancedBrandLiftCIUpper	The upper bound of the confidence interval for an advanced brand lift metric, indicating the maximum expected incremental impact based on a more sophisticated model.	metric
advancedBreakthroughs.control	advancedBreakthroughs.control		metric
advancedBreakthroughs.incremental	advancedBreakthroughs.incremental		metric
advancedBreakthroughs.informativeSingleCellBayesianConfidence	advancedBreakthroughs.informativeSingleCellBayesianConfidence		metric
advancedBreakthroughs.test	advancedBreakthroughs.test		metric
advancedCostPerIncrementalBreakthrough	advancedCostPerIncrementalBreakthrough	The cost incurred for each incremental breakthrough achieved, calculated using advanced methodologies.	metric
advancedIsWinner.confidence_level	advancedIsWinner.confidence_level		metric
advancedIsWinner.is_winner	advancedIsWinner.is_winner		metric
advancedScoreMean.control	advancedScoreMean.control		metric
advancedScoreMean.incremental	advancedScoreMean.incremental		metric
advancedScoreMean.test	advancedScoreMean.test		metric
advancedScoreSum.control	advancedScoreSum.control		metric
advancedScoreSum.incremental	advancedScoreSum.incremental		metric
advancedScoreSum.test	advancedScoreSum.test		metric
brandLiftCILower	brandLiftCILower	The lower bound of the confidence interval for the brand lift metric, indicating the minimum expected incremental impact.	metric
brandLiftCIUpper	brandLiftCIUpper	The upper bound of the confidence interval for the brand lift metric, indicating the maximum expected incremental impact.	metric
breakthroughs.control	breakthroughs.control		metric
breakthroughs.incremental	breakthroughs.incremental		metric
breakthroughs.pValue	breakthroughs.pValue	The p-value associated with the breakthrough metric, indicating the statistical significance of the observed incremental impact.	metric
breakthroughs.singleCellBayesianConfidence	breakthroughs.singleCellBayesianConfidence	A confidence score for a breakthrough metric, likely calculated using a Bayesian method for a single study cell.	metric
breakthroughs.test	breakthroughs.test		metric
cell_campaigns_id	cell_campaigns_id	A list of campaign IDs associated with this cell in the lift study.	dimension
cell_id	cell_id	The unique identifier for a specific cell (test or control group) within the lift study.	dimension
cell_name	cell_name	The name of the cell (test or control group) in the lift study.	dimension
cell_treatment_percentage	cell_treatment_percentage	The percentage of the total audience that is assigned to the treatment group for a given cell.	metric
conversions_CPiC	conversions_CPiC	The Cost Per Incremental Conversion (CPiC), which measures the cost efficiency of generating additional conversions due to the advertising campaign.	metric
conversions_confidence	conversions_confidence	The confidence level for the conversion lift measurement, indicating the statistical certainty of the results.	metric
conversions_control_raw_scaled	conversions_control_raw_scaled	The raw number of conversions in the control group, scaled to match the test group’s population for a fair comparison.	metric
conversions_control_scaled	conversions_control_scaled	The number of conversions in the control group, scaled to the test group’s population.	metric
conversions_exposed	conversions_exposed	The number of conversions from the exposed (test) group.	metric
conversions_incremental	conversions_incremental	The additional number of conversions attributed to the advertising campaign (test group conversions minus scaled control group conversions).	metric
conversions_incremental_lower	conversions_incremental_lower	The lower bound of the confidence interval for incremental conversions.	metric
conversions_incremental_share	conversions_incremental_share	The share of total conversions that are incremental.	metric
conversions_incremental_upper	conversions_incremental_upper	The upper bound of the confidence interval for incremental conversions.	metric
conversions_multicell_confidence	conversions_multicell_confidence	The confidence level for conversions in a multicell study, used to compare multiple test groups.	dimension
conversions_multicell_rank	conversions_multicell_rank	The rank of the cell’s conversion performance within a multicell study.	metric
conversions_notExposed	conversions_notExposed	The number of conversions from users who were not exposed to the ad campaign, typically part of the control group.	metric
conversions_raw_pValue	conversions_raw_pValue	The raw p-value for the conversion lift, indicating the statistical significance of the observed difference.	dimension
conversions_test	conversions_test	The number of conversions from the test group.	metric
costPerIncrementalBreakthrough	costPerIncrementalBreakthrough	The cost incurred for each incremental breakthrough achieved, such as Cost Per Incremental Conversion (CPiC) or Cost Per Incremental Buyer (CPiB).	metric
costPerIncrementalBreakthroughRegion	costPerIncrementalBreakthroughRegion		metric
costPerIncrementalBreakthroughVertical	costPerIncrementalBreakthroughVertical		metric
experiment_id	experiment_id	The unique identifier for the lift study or experiment.	dimension
frequency	frequency		metric
impressions	impressions	The total number of times an ad was shown to individuals in the study.	metric
isWinner.confidence_level	isWinner.confidence_level	The confidence level indicating the statistical certainty that the test group outperformed the control group.	metric
isWinner.is_winner	isWinner.is_winner		metric
objective_id	objective_id	The unique identifier for an objective within a lift study.	dimension
objective_name	objective_name	The name of the objective defined for the lift study.	dimension
objective_type	objective_type	The type of advertising objective, such as CONVERSIONS, SALES, NONSALES, MAI, or BRAND.	dimension
population.control	population.control	The number of unique Accounts Center accounts in the control group.	metric
population.reached	population.reached	The number of unique Accounts Center accounts reached by the ads in the study.	metric
population.test	population.test	The number of unique Accounts Center accounts in the test group.	metric
population_control	population_control	The number of unique Accounts Center accounts in the control group.	metric
population_reached	population_reached	The number of unique Accounts Center accounts reached by the ads in the study.	metric
population_test	population_test	The number of unique Accounts Center accounts in the test group.	metric
rawScoreSum.control	rawScoreSum.control	The sum of raw scores for the control group before any scaling or advanced processing.	metric
rawScoreSum.test	rawScoreSum.test	The sum of raw scores for the test group before any scaling or advanced processing.	metric
responders.control	responders.control	The number of users in the control group who responded to a specific action or event, such as making a purchase.	metric
responders.test	responders.test	The number of users in the test group who responded to a specific action or event, such as making a purchase.	metric
sales_ROAS	sales_ROAS	The Return on Ad Spend (ROAS) for sales, measuring the revenue generated for every dollar spent on advertising.	dimension
sales_confidence	sales_confidence	The confidence level for the sales lift measurement, indicating the statistical certainty of the results.	dimension
sales_control_raw_scaled	sales_control_raw_scaled	The raw sales value in the control group, scaled to match the test group’s population for a fair comparison.	dimension
sales_control_scaled	sales_control_scaled	The sales value in the control group, scaled to the test group’s population.	dimension
sales_exposed	sales_exposed	The sales value from the exposed (test) group.	dimension
sales_incremental	sales_incremental	The additional sales value attributed to the advertising campaign (test group sales minus scaled control group sales).	dimension
sales_incremental_lower	sales_incremental_lower	The lower bound of the confidence interval for incremental sales.	dimension
sales_incremental_share	sales_incremental_share	The share of total sales that are incremental.	dimension
sales_incremental_upper	sales_incremental_upper	The upper bound of the confidence interval for incremental sales.	dimension
sales_multicell_confidence	sales_multicell_confidence	The confidence level for sales in a multicell study, used to compare multiple test groups.	dimension
sales_multicell_rank	sales_multicell_rank	The rank of the cell’s sales performance within a multicell study.	dimension
sales_notExposed	sales_notExposed	The total sales generated from users who were not exposed to the ad campaign, typically part of the control group.	dimension
sales_raw_pValue	sales_raw_pValue	The raw p-value for the sales lift, indicating the statistical significance of the observed difference.	dimension
sales_test	sales_test	The sales value from the test group.	dimension
scoreMean.control	scoreMean.control		metric
scoreMean.incremental	scoreMean.incremental		metric
scoreMean.test	scoreMean.test		metric
scoreMeanRegion	scoreMeanRegion		metric
scoreMeanVertical	scoreMeanVertical		metric
scoreSum.control	scoreSum.control		metric
scoreSum.incremental	scoreSum.incremental		metric
scoreSum.test	scoreSum.test		metric
spend	spend	The total amount of money spent on the ads within the study.	metric
study_end_time	study_end_time	The end date and time of the lift study.	dimension
study_id	study_id	The unique identifier for the lift study.	dimension
study_name	study_name	The name of the lift study.	dimension
study_start_time	study_start_time	The start date and time of the lift study.	dimension
study_type	study_type	The type of lift study conducted, typically ‘LIFT’ for conversion lift measurements.	dimension