Dimension list for Facebook Ads

176 dimensions available

CategoryFieldCodeDescription
TIMEYearYearYear, e.g. 2017
Year of week (Mon-Sun)YearOfISOweek
Year of week (Sun-Sat)Yearofweek
Year & monthYearmonthYear and month, e.g. 2017|06
Year & week (Mon-Sun)YearweekISOYear and week for ISO weeks, e.g. 2017|08
Year & week (Sun-Sat)YearweekYear and week for US weeks, e.g. 2017|08
MonthMonthMonth, e.g. 6
Week (Mon-Sun)WeekISOISO week number, e.g. 51
Week (Sun-Sat)WeekUS week number, e.g. 51
Day of weekDayOfWeek
DateDateDate, e.g. 2017-01-31
Hour (advert account time zone)hourly_stats_aggregated_by_advertiser_time_zone
Hour (viewer's time zone)hourly_stats_aggregated_by_audience_time_zone
ACCOUNT STRUCTUREAccount nameaccount_nameThe name of your ad account, which groups your advertising activity.
Account IDaccount_idThe ID number of your ad account, which groups your advertising activity.
Campaign namecampaign_group_nameThe name of the advertising campaign that you're viewing in reporting.
Campaign IDcampaign_group_idThe unique ID number of the advertising campaign that you're viewing in reporting.
Ad set namecampaign_nameThe name of the ad set that you're viewing in reporting.
Ad set IDcampaign_idThe unique ID of the ad set you're viewing in reports.
Ad nameadgroup_nameThe name of the ad that you're viewing in the report.
Ad IDadgroup_idThe unique ID of the ad that you're viewing in reporting.
IMPRESSIONImpression deviceimpression_device
Placementplacement
Place page IDplace_page_id
Publisher platformpublisher_platformDistinguishes between platforms like Facebook and Instagram
Platform positionplatform_position
Device platformdevice_platform
USERGendergender
Ageage
Countrycountry
Regionregion
DMAdmaDesignated Market Area
PRODUCTProduct IDproduct_id
ACTION/CONVERSIONAction typeActionTypeWithCustomLabelsThe kind of actions taken on your ad, Page, app or event after your ad was served to someone, even if they didn't click on it. Action types include Page likes, app installs, conversions, event responses and more. Custom conversion types will be listed by their label.
Action type (with custom conv. IDs)ActionTypeThe kind of actions taken on your ad, Page, app or event after your ad was served to someone, even if they didn't click on it. Action types include Page likes, app installs, conversions, event responses and more. Custom conversion types will be listed by their ID number.
Action target IDActionTargetID
Action deviceActionDevice
Canvas component nameActionCanvasComponentName
ACCOUNT DETAILSBusiness namebusiness_name
Business countrybusiness_country_code
Business citybusiness_city
Account statusaccount_status
Account edit linkaccount_edit_linkLink to edit the Facebook Ads account.
Account currencycurrency
Account timezonetimezone_name
Account timezone IDtimezone_id
Account timezone offset from UTCtimezone_offset_hours_utc
Account usersusers
Account spend capspend_cap
Account amount spentamount_spent
Account balancebalance
Account funding sourcefunding_source
CAMPAIGN DETAILSCampaign objectivecampaignobjectiveThe objective you selected for your campaign. Your objective reflects the goal you want to achieve with your advertising.
Campaign status (effective status)campaignstatus
Campaign edit linkcampaign_edit_linkLink to edit the campaign in Facebook Ads.
Campaign configured statuscampaignconfigured_status
Campaign buying typecampaignbuyingtypeThe method by which you pay for and target ads in your campaigns: through dynamic auction bidding, fixed-price bidding, or reach and frequency buying.
Campaign spending limitcampaignspend_cap
Campaign start datecampaign_start_date
Campaign end datecampaign_end_date
Campaign start date & timecampaign_start_time
Campaign end date & timecampaign_end_time
Campaign daily budgetcampaign_daily_budget
Campaign lifetime budgetcampaign_lifetime_budget
Campaign budget remainingcampaign_budget_remaining
AD SET DETAILSAd set status (effective status)adsetstatus
Ad set edit linkad_group_edit_linkLink to edit the ad set in Facebook Ads.
Ad set configured statusadsetconfigured_status
Bid typebidtype
Bid amountbidamount
Ad set bid infobidinfo
Start dateadsetstart_time
End dateadsetend_time
Start date & timeadsetstart_time_exact
End date & timeadsetend_time_exact
Daily budgetadsetdaily_budget
Lifetime budgetadsetlifetime_budget
Lifetime minimum spend targetlifetime_min_spend_targetLifetime minimum spend target for an ad set defined in your account currency. You must specify the lifetime budget at the ad campaign level.
Lifetime spend caplifetime_spend_capDaily spend cap of the ad set defined in your account currency. You must specify the daily budget in the campaign.
Budget remainingadsetbudget_remaining
Targetingadsettargeting
Promoted objectadsetpromoted_object
AD DETAILSAd status (effective status)adstatus
Ad configured statusadconfigured_status
Relevance score statusrelevance_statusRelevance score status
Ad bid infoadbid_info
Ad creative IDcreative_id
Ad creative namecreative_name
Ad titlecreative_title
Ad bodycreative_body
Ad creative image URLcreative_image_url
Object typecreative_object_type
Call-to-action typecreative_call_to_action_type
Ad creative thumbnail URLcreative_thumbnail_url
Ad creative image URLcreative_image_url
Destination URLdestinationURL
Internal destination URLcreative_link_url
External destination URLcreative_object_url
URL tagscreative_url_tags
Tracking template URLcreative_template_url
Tracking specsadtracking_specs
Conversion specsadconversion_specs
Review feedbackadreview_feedback
PROMOTED POSTPost IDpromoted_post_id
Post Instagram IDpromoted_post_id_ig
Post typepromoted_post_type
Post sourcepromoted_post_source
Post namepromoted_post_name
Post captionpromoted_post_caption
Post messagepromoted_post_message
Post storypromoted_post_story
Post descriptionpromoted_post_description
Promoted post destination URLpromoted_post_destination_url
Existing post destination URLpromoted_destination_url
Post privacypromoted_post_privacy
Post privacy descriptionpromoted_post_privacy_description
Post iconpromoted_post_icon
Post thumbnail URLpromoted_post_picture
Post image URLpromoted_post_full_picture
Post created datepromoted_post_created_time
Link to postpromoted_post_permalink_url
Link to Instagram postpromoted_post_permalink_url_ig
LEAD ADSLead form IDlead_form_id
Lead form namelead_form_name
Lead form statuslead_form_status
Lead createdlead_created_time
Lead IDlead_id
Lead infolead_info
Lead info (JSON)lead_info_json
Lead emaillead_email
Lead phone numberlead_phone_number
Lead full namelead_full_name
Lead company namelead_company_name
Lead countrylead_country
Lead statelead_state
Lead field 1 namelead_name_f1
Lead field 2 namelead_name_f2
Lead field 3 namelead_name_f3
Lead field 4 namelead_name_f4
Lead field 5 namelead_name_f5
Lead field 6 namelead_name_f6
Lead field 1 valuelead_value_f1
Lead field 2 valuelead_value_f2
Lead field 3 valuelead_value_f3
Lead field 4 valuelead_value_f4
Lead field 5 valuelead_value_f5
Lead field 6 valuelead_value_f6
REACH ESTIMATESReach estimate: usersreach_estimate_users
Reach estimate: min bid amountreach_estimate_bid_amount_min
Reach estimate: median bid amountreach_estimate_bid_amount_median
Reach estimate: max bid amountreach_estimate_bid_amount_max
Reach estimate: bid estimate curve JSONreach_estimate_bid_curve_json
Reach estimate: bid estimate curve for spendreach_estimate_bid_curve_spend
Reach estimate: bid estimate curve for reachreach_estimate_bid_curve_reach
Reach estimate: bid estimate curve for impressionsreach_estimate_bid_curve_impressions
Reach estimate: bid estimate curve for actionsreach_estimate_bid_curve_actions
PERFORMANCEQuality ranking (text)quality_score_organic_textAd's perceived quality compared with ads competing for the same audience.
Engagement Rate Ranking (text)quality_score_ectr_textAd's expected engagement rate compared with ads competing for the same audience.
Conversion Rate Ranking (text)quality_score_ecvr_textAd's expected conversion rate compared with ads that had the same optimisation goal and competed for the same audience.
DYNAMIC CREATIVE ADSBody asset IDbody_asset_idBody asset ID
Body asset textbody_asset_textBody asset text
Description asset IDdescription_asset_idDescription asset ID
Description asset textdescription_asset_textDescription asset ID
Image asset IDimage_asset_idID for an image asset
Image asset nameimage_asset_nameName for an image asset
Image asset hashimage_asset_hashHash for an image asset
Image asset URLimage_asset_urlURL for an image asset
Title asset IDtitle_asset_idTitle asset ID
Title asset texttitle_asset_textTitle asset ID
Call to action asset IDcall_to_action_asset_idCall to action asset asset ID
Call to action asset namecall_to_action_asset_nameCall to action asset name
Link asset IDlink_url_asset_idLink asset ID
Link asset website URLlink_url_asset_website_urlWebsite URL for a link URL asset
Link URL asset display URLlink_url_asset_display_urlLink URL asset display URL
DEPRECATEDRelevance score positive feedback (deprecated)relevance_positive_feedbackPlease note that this field will be removed on 2018-07-26.
Relevance score negative feedback (deprecated)relevance_negative_feedbackPlease note that this field will be removed on 2018-07-26.