Graph API Version

Targeting

Reading

Targeting result

Parameters

This endpoint doesn't have any parameters.

Fields

Field	Description
`adgroup_id` id	ID of the ad group Default
`age_max` unsigned int32	Targeting user maximum age Default
`age_min` unsigned int32	Targeting user minimum age Default
`age_range` list<unsigned int32>	Suggested targeting user minimum and maximum age range Default
`alternate_auto_targeting_option` string	Alternative Auto Targeting (eg: lal, none) Default
`app_install_state` string	Targeting whether an app is installed or not on a device Default
`audience_network_positions` list<enum>	The specified Audience Network positions to which the adset will deliver Default
`behaviors` list<IDName>	Behaviors to target Default
`brand_safety_content_filter_levels` list<string>	Brand Safety Content Filter levels for contextual placements (Instream Video, Instant Article, Audience Network Default
`brand_safety_content_severity_levels` list<string>	Content Severity levels for Brand Safety placements (Instream Video, Instant Article, Audience Network) Default
`catalog_based_targeting` CatalogBasedTargeting	Specs defining how your catalog will be used to target ads Default
`cities` list<IDName>	Targeting cities Default
`college_years` list<unsigned int32>	Targeting user year in college Default
`connections` list<ConnectionsTargeting>	Targeting connections Default
`contextual_targeting_categories` list<IDName>	Categories for contextual targeting Default
`countries` list<string>	Targeting countries Default
`country` list<string>	Targeting country Default
`country_groups` list<string>	Targeting groups of countries Default
`custom_audiences` list<RawCustomAudience>	Custom list of users to target to Default
`device_platforms` list<enum {mobile, desktop, connected_tv}>	The user specified device platforms on which the ad set will be delivered Default
`direct_install_devices` bool	Direct Install Devices Default
`dynamic_audience_ids` list<numeric string>	Dynamic audience IDs Default
`education_majors` list<IDName>	Majors during education Default
`education_schools` list<IDName>	Schools attended Default
`education_statuses` list<unsigned int32>	Targeting user education statuses Default
`effective_audience_network_positions` list<enum>	The actual Audience Network positions to which the adset will deliver
`effective_brand_safety_content_filter_levels` list<string>	Read-only. The effective brand safety content filter levels applied to ad delivery, computed as the most conservative merge of account-level and campaign-level settings. Uses the same values as brand_safety_content_filter_levels.
`effective_device_platforms` list<enum {mobile, desktop, connected_tv}>	The actual device platforms on which the ad set will be delivered
`effective_facebook_positions` list<enum>	The actual Facebook positions that the adset will be delivered to
`effective_instagram_positions` list<enum>	The actual Instagram positions that the adset will be delivered to
`effective_messenger_positions` list<enum>	The actual Messenger positions that the adset will be delivered to
`effective_publisher_platforms` list<enum>	The actual platforms on which the ad set will be delivered
`effective_threads_positions` list<enum>	The actual Threads positions to which the adset will deliver
`effective_whatsapp_positions` list<enum>	The actual WhatsApp positions to which the adset will deliver
`engagement_specs` list<TargetingDynamicRule>	Engagement activities that people matched based on their online behaviors. e.g. video they watched, pages visited, ads clicked, etc Default
`ethnic_affinity` list<IDName>	Ethnic affinities to target Default
`exclude_reached_since` list<string>	Exclude users reached by this account since given date Default
`excluded_brand_safety_content_types` list<string>	Excluded Brand Safety content types, for example Instream live gaming Default
`excluded_connections` list<ConnectionsTargeting>	Connections to exclude targeting to Default
`excluded_custom_audiences` list<RawCustomAudience>	Custom list of users to exclude targeting to Default
`excluded_dynamic_audience_ids` list<numeric string>	Excluded dynamic audience IDs Default
`excluded_engagement_specs` list<TargetingDynamicRule>	Similar to engagement_specs, but instead of include people who have performed certain activities, target the people who have not performed the specified activities Default
`excluded_geo_locations` TargetingGeoLocation	Excluded locations for ads targeting Default
`excluded_mobile_device_model` list<string>	Excluded mobile device models Default
`excluded_product_audience_specs` list<TargetingProductAudienceSpec>	Similar to product_audience_specs, but instead of including the people who have performed certain actions, excluding them Default
`excluded_publisher_categories` list<string>	Excluded publisher categories, for example app categories on Audience Network Default
`excluded_publisher_list_ids` list<numeric string>	Excluded publisher list IDs on Audience Network Default
`excluded_user_device` list<string>	Excluded user mobile devices Default
`exclusions` FlexibleTargeting	Excluded targeting rules and clusters Default
`facebook_positions` list<enum>	The specified Facebook positions that the adset will be delivered to Default
`family_statuses` list<IDName>	Status of family Default
`fb_deal_id` numeric string	Deal Id for predefined deals between advertisers and publishers (eg: Instant Articles, Video Home, Audience Network) Default
`flexible_spec` list<FlexibleTargeting>	Flexible combination of targeting rules and clusters Default
`friends_of_connections` list<ConnectionsTargeting>	Friends of connections to target to Default
`genders` list<unsigned int32>	Targeting genders Default
`generation` list<IDName>	Generations to target Default
`geo_locations` TargetingGeoLocation	Locations used for ad targeting Default
`home_ownership` list<IDName>	Home owership types to target Default
`home_type` list<IDName>	Home types to target Default
`home_value` list<IDName>	Home values to target Default
`household_composition` list<IDName>	Household compositions to target Default
`income` list<IDName>	Income to target Default
`industries` list<IDName>	Industries to target Default
`instagram_positions` list<enum>	The specified Instagram positions that the adset will be delivered to Default
`install_state_application` numeric string	Application to be used for install state exclusion Default
`instream_video_skippable_excluded` bool	The opt-out option for advertisers to opt out from the in-stream skippable ads Default
`instream_video_sponsorship_placements` list<string>	Instream Video placements to target, pre-roll/mid-roll/ Default
`interested_in` list<unsigned int32>	Targeting gender of person user is interested in Default
`interests` list<IDName>	Targeting user interests Default
`is_whatsapp_destination_ad` bool	Targeting users who is eligible for WhatsApp destination ad
`keywords` list<string>	Targeting keywords Default
`life_events` list<IDName>	Events in life Default
`locales` list<unsigned int32>	Targeting user locales Default
`messenger_positions` list<enum>	The specified Messenger positions that the adset will be delivered to Default
`moms` list<IDName>	Types of moms to target Default
`net_worth` list<IDName>	Net worth to target Default
`office_type` list<IDName>	Office types to target Default
`place_page_set_ids` list<numeric string>	Targeting a set of locations (local pages) under a main page Default
`political_views` list<unsigned int32>	Targeting user political views Default
`politics` list<IDName>	Politics to target Default
`product_audience_specs` list<TargetingProductAudienceSpec>	A JSON spec that is used to describe the people who have performed certain actions on a set of products Default
`prospecting_audience` TargetingProspectingAudience	Advertiser specified prospecting audience specs Default
`publisher_platforms` list<enum>	The user specified platforms on which the ad set will be delivered Default
`radius` numeric string	Targeting user located within a radius of the location Default
`regions` list<IDName>	Targeting regions Default
`relationship_statuses` list<unsigned int32>	Targeting relationship statuses Default
`site_category` list<string>	The site category
`targeting_automation` TargetingAutomation	targeting_automation Default
`targeting_optimization` string	Relax targeting constraints to hints Default
`targeting_relaxation_types` TargetingRelaxation	Allow passing of multiple targeting relaxations via a map Default
`threads_positions` list<enum>	The specified Threads positions to which the adset will deliver Default
`user_adclusters` list<IDName>	Targeting user ad clusters Default
`user_age_unknown` bool	Advertiser selects to target users whose age is unknown Default
`user_device` list<string>	User mobile device Default
`user_event` list<unsigned int32>	User event Default
`user_os` list<string>	User mobile OS Default
`whatsapp_positions` list<enum>	The specified WhatsApp positions to which the adset will deliver Default
`wireless_carrier` list<string>	The wireless carrier Default
`work_employers` list<IDName>	Employers Default
`work_positions` list<IDName>	Positions at work Default
`zips` list<string>	Targeting locations' zip codes Default

Creating

You can't perform this operation on this endpoint.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.