Marketing API Version

Ad Account, Activities

Get information on key updates to an ad account and ad objects associated with it. Includes major account status changes, updates made to budget, campaign, targeting, audiences and so on. For example, to retrieve ad activities:

Reading

Ad Activity

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

FieldDescription

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

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_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, campaign_ended, create_campaign, create_campaign_legacy, update_campaign_budget, update_campaign_duration, create_ad_set, update_ad_set_bidding, update_ad_set_budget, update_ad_set_duration, update_ad_set_run_status, update_ad_set_name, create_ad, update_ad_creative, edit_and_update_ad_creative, update_ad_bid_info, update_ad_bid_type, update_ad_run_status, update_ad_friendly_name, update_ad_targets_spec, update_adgroup_stop_delivery, update_ad_set_target_spec, ad_review_approved, ad_review_declined, first_delivery_event, create_audience, update_audience, delete_audience, share_audience, receive_audience, unshare_audience, remove_shared_audience, unknown, account_spending_limit_reached, campaign_spending_limit_reached, lifetime_budget_spent, funding_event_initiated, funding_event_successful, update_ad_labels}

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

AD
ad_review_approved: Ad approved
ad_review_declined: Ad not approved
add_images: Image added to the library
create_ad: Ad created
edit_images: Image edited in library
update_ad_creative: Ad updated
update_ad_friendly_name: Ad name updated
update_ad_run_status: Ad status updated

AD_SET
create_ad_set: Ad set created
update_ad_set_bidding: Ad set bidding 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

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

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: Deprecated. Use update_ad_set_budget instead
update_campaign_group_spend_cap: Campaign spending limit updated

CAMPAIGN
create_campaign: Campaign created
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_ad_set_duration: Ad set schedule updated
update_campaign_duration: Campaign schedule updated

STATUS
ad_account_update_status: Account status updated
update_ad_run_status: Ad status updated
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

extra_data

string

JSON encoded extra information

object_id

numeric string

Object ID

object_name

string

Object Name

translated_event_type

string

Translated event type

Edges

No edges

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.