Ads and Commerce
Ads and Commerce
Resources

Business Ad Studies

Updated: Mar 24, 2026

Reading

This business owns these ads-related studies. Includes lift studies, split tests and so on.

Example

GET /v25.0/{business-id}/ad_studies HTTP/1.1
Host: graph.facebook.com
Try it in Graph API Explorer
If you want to learn how to use the Graph API, read our Using Graph API guide

Parameters

This endpoint doesn't have any parameters.

Fields

Reading from this edge will return a JSON formatted result: 
{
"data": [],
"paging": {}
}
data
A list of AdStudy nodes.
paging
For more details about pagination, see the Graph API guide.

Error Codes

Error Code Description
200
Permissions error
100
Invalid parameter
80004
There have been too many calls to this ad-account. Wait a bit and try again. For more info, please refer to /docs/graph-api/overview/rate-limiting#ads-management.
104
Incorrect signature

Creating

/{business_id}/ad_studies

You can make a POST request to ad_studies edge from the following paths:
When posting to this edge, an AdStudy will be created.

Parameters

Parameter Description
cells
list<Object>
Describes the cells in the study.
required
description string
id int64
name string
creation_template enum {AUTOMATIC_PLACEMENTS, BRAND_AWARENESS, FACEBOOK, FACEBOOK_AUDIENCE_NETWORK, FACEBOOK_INSTAGRAM, FACEBOOK_NEWS_FEED, FACEBOOK_NEWS_FEED_IN_STREAM_VIDEO, IN_STREAM_VIDEO, INSTAGRAM, MOBILE_OPTIMIZED_VIDEO, PAGE_POST_ENGAGEMENT, REACH, TV_COMMERCIAL, TV_FACEBOOK, VIDEO_VIEW_OPTIMIZATION, LOW_FREQUENCY, MEDIUM_FREQUENCY, HIGH_FREQUENCY}
adaccounts list<int64>
ads list<numeric string or integer>
adsets list<numeric string or integer>
campaigns list<numeric string or integer>
control_percentage float with at most two digits after decimal point
treatment_percentage float with at most two digits after decimal point
Show child parameters
client_business
numeric string or integer
Business associated with the study.
confidence_level
float
Confidence level used in power calculations and final study report.
cooldown_start_time
integer
Start of the pre-measurement cool-down period. This period ends when the study period starts.
creative_test_config
JSON object
(Optional) Configuration for launching a 2-5 cell creative test. Specify either daily_budget or lifetime_budget_percentage to set the budget allocation for the study across the cells' ads. The study's "type" field must also be defined as SPLIT_TEST_V2 when creative_test_config is included in the request.
description
string
The purpose of the study.
end_time
integer
Time when the study period ends.
required
name
string
Name of the study.
required
objectives
list<Object>
A vector of objects describing the objectives assigned to this study.
id numeric string or integer
is_primary boolean
name string
type enum {SALES, NONSALES, MAE, TELCO, FTL, MAI, PARTNER, BRANDLIFT, BRAND, MPC_CONVERSION, CONVERSIONS}
offsite_datasets list<JSON or object-like arrays>
id numeric string or integer
required
event_names list<string>
Show child parameters
adspixels list<JSON or object-like arrays>
id numeric string or integer
required
event_names list<string>
Show child parameters
customconversions list<JSON or object-like arrays>
id numeric string or integer
required
event_names list<string>
Show child parameters
applications list<JSON or object-like arrays>
id numeric string or integer
required
event_names list<string>
Show child parameters
offline_conversion_data_sets list<JSON or object-like arrays>
id numeric string or integer
required
event_names list<string>
Show child parameters
product_sets list<JSON or object-like arrays>
id numeric string or integer
required
event_names list<string>
Show child parameters
product_catalogs list<JSON or object-like arrays>
id numeric string or integer
required
event_names list<string>
Show child parameters
Show child parameters
observation_end_time
integer
The end of the observation period for this study. This period starts when the study period ends.
start_time
integer
The time when the study period starts.
required
type
enum {LIFT, SPLIT_TEST, CONTINUOUS_LIFT_CONFIG, GEO_LIFT, BACKEND_AB_TESTING, CREATIVE_SPEND_ENFORCEMENT, PORTFOLIO_OPTIMIZER, VERSION_CONTROL}
The type of ad study, such as SPLIT_TEST or LIFT.
viewers
list<int>
This study is shared with these people.

Return Type

This endpoint supports read-after-write and will read the node represented by id in the return type. 
Struct  {
id: numeric string,
}

Error Codes

Error Code Description
100
Invalid parameter
200
Permissions error

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.
Did you find this page helpful?
Thumbs up icon
Thumbs down icon