Get information on key updates to an ad account and ad objects associated with it. Please note that this API returns one week’s data by default. Information returned includes major account status changes, updates made to budget, campaign, targeting, audiences and so on.

Reading

Ad Activity

Parameters

This endpoint doesn't have any parameters.

Fields

Field	Description
`actor_id` numeric string	Actor ID
`actor_name` string	Actor Name
`application_id` numeric string	Application ID
`application_name` string	Application Name
`date_time_in_timezone` string	Date/Time string in account timezone
`event_time` datetime	Timestamp default
`event_type` enum {ad_account_update_spend_limit, ad_account_reset_spend_limit, ad_account_remove_spend_limit, ad_account_set_business_information, ad_account_update_status, ad_account_add_user_to_role, ad_account_remove_user_from_role, add_images, edit_images, delete_images, ad_account_update_audience_type_url_parameter, adaccount_update_audience_segment, create_adaccount_agency_fee, update_adaccount_agency_fee, update_adaccount_agency_fee_status, ad_account_billing_charge, ad_account_billing_charge_failed, ad_account_billing_chargeback, ad_account_billing_chargeback_reversal, ad_account_billing_decline, ad_account_billing_refund, billing_event, add_funding_source, remove_funding_source, create_campaign_group, update_campaign_name, update_campaign_run_status, update_campaign_group_spend_cap, create_campaign_legacy, update_campaign_budget, campaign_ended, update_campaign_group_ad_scheduling, update_campaign_group_delivery_type, update_campaign_budget_optimization_toggling_status, update_budget_flex_toggle_status, update_delivery_type_cross_level_shift, update_campaign_group_high_demand_periods, update_campaign_group_budget_scheduling_state, create_campaign_group_agency_fee, update_campaign_group_agency_fee, create_ad_set, update_ad_set_bidding, update_ad_set_bid_strategy, update_ad_set_budget, update_ad_set_duration, update_ad_set_run_status, update_ad_set_name, update_ad_set_optimization_goal, update_ad_set_target_spec, update_ad_set_ad_keywords, update_ad_set_bid_adjustments, update_campaign_ad_scheduling, update_campaign_delivery_destination, update_campaign_delivery_type, update_campaign_schedule, update_ad_set_spend_cap, update_ad_set_min_spend_target, update_ad_set_learning_stage_status, update_campaign_high_demand_periods, update_campaign_budget_scheduling_state, update_campaign_conversion_goal, update_campaign_value_adjustment_rule, update_ad_set_value_rules, update_ad_set_cost_bidding_mode, merge_campaigns, update_campaign_budget_split, create_ad, ad_review_approved, ad_review_declined, update_ad_creative, edit_and_update_ad_creative, update_ad_bid_info, update_ad_bid_type, update_ad_run_status, update_ad_run_status_to_be_set_after_review, update_ad_friendly_name, update_ad_targets_spec, update_adgroup_stop_delivery, update_ad_audience_persona, first_delivery_event, create_audience, update_audience, delete_audience, share_audience, receive_audience, unshare_audience, remove_shared_audience, create_custom_audience_appeal, reject_custom_audience_appeal, accept_custom_audience_appeal, apply_restrictions_custom_audience, unknown, account_spending_limit_reached, campaign_spending_limit_reached, lifetime_budget_spent, conversion_event_updated, funding_event_initiated, funding_event_successful, update_ad_labels, di_ad_set_learning_stage_exit}	Event types by category: ACCOUNT `ad_review_approved`: Ad approved `ad_review_declined`: Ad not approved `ad_account_set_business_information`: Account business information updated `ad_account_update_status`: Account status updated `ad_account_add_user_to_role`: Person added to account `ad_account_remove_user_from_role`: Person removed from account `add_images`: Image added to the library `edit_images`: Image edited in library AD `ad_review_approved`: Ad approved `ad_review_declined`: Ad not approved `create_ad`: Ad created `update_ad_creative`: Ad updated `update_ad_friendly_name`: Ad name updated `update_ad_run_status`: Ad status updated `update_ad_run_status_to_be_set_after_review`: Updated status of ad after it finishes Ad Review AD_KEYWORDS `update_ad_set_ad_keywords`: Ad set audience prioritization updated AD_SET `create_ad_set`: Ad set created `update_ad_set_bidding`: Ad set bidding updated `update_ad_set_bid_strategy`: Ad set bid strategy updated `update_ad_set_bid_adjustments`: Ad set bid adjustments updated `update_ad_set_budget`: Ad set budget updated `update_ad_set_duration`: Ad set schedule updated `update_ad_set_name`: Ad set name updated `update_ad_set_run_status`: Ad set status updated `update_ad_set_target_spec`: Ad set targeting updated `update_ad_set_ad_keywords`: Ad set audience prioritization updated AUDIENCE `create_audience`: Custom audience created `update_audience`: Custom audience updated `delete_audience`: Custom audience deleted `share_audience`: Custom audience shared `receive_audience`: Custom audience received `unshare_audience`: Custom audience unshared `remove_shared_audience`: Shared custom audience removed `update_adgroup_stop_delivery`: Shared audience ad stopped BID `update_ad_bid_info`: Bid updated `update_ad_bid_type`: Bidding type updated `update_ad_set_bidding`: Ad set bidding updated `update_ad_set_bid_strategy`: Ad set bid strategy updated `update_ad_set_bid_adjustments`: Ad set bid adjustments updated BUDGET `ad_account_billing_charge`: Account billed `ad_account_billing_chargeback`: Bank refund `ad_account_billing_chargeback_reversal`: Paid (Bank refund cancelled) `ad_account_billing_decline`: Account payment method declined `ad_account_billing_refund`: Account refunded `ad_account_remove_spend_limit`: Spending limit removed `ad_account_reset_spend_limit`: Spending limit reset `ad_account_update_spend_limit`: Spending limit updated `add_funding_source`: Payment method added `billing_event`: Billing Event `funding_event_initiated`: Funding Event Initiated `funding_event_successful`: Money added to balance `remove_funding_source`: Payment method removed `update_ad_set_budget`: Ad set budget updated `update_campaign_budget`: Campaign budget updated `update_campaign_group_spend_cap`: Campaign spending limit updated CAMPAIGN `create_campaign_legacy`: Campaign created `create_campaign_group`: Campaign created `update_campaign_duration`: Campaign schedule updated `update_campaign_name`: Campaign name updated `update_campaign_run_status`: Campaign status updated DATE `update_campaign_duration`: Campaign schedule updated `update_ad_set_duration`: Ad set schedule updated STATUS `ad_account_update_status`: Account status updated `update_ad_run_status`: Ad status updated `update_ad_run_status_to_be_set_after_review`: Updated status of ad after it finishes Ad Review `update_ad_set_run_status`: Ad set status updated `update_campaign_run_status`: Campaign status updated TARGETING `update_ad_set_target_spec`: Ad set targeting updated `update_ad_targets_spec`: Ad targeting updated default
`extra_data` string	JSON encoded extra information
`object_id` numeric string	Object ID
`object_name` string	Object Name
`object_type` string	Object Type
`translated_event_type` string	Translated event type

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.

Did you find this page helpful?