2024 Out-Of-Cycle Changes

2024 out-of-cycle changes to Marketing API.

August 1, 2024

Ads Insights API

Unique Metrics Deprecation

Applies to all versions on October 30, 2024.

On October 30, 2024, a number of the unique metrics will be deprecated from the Ads Insights API for all API versions. Learn more.

After the update, the API's unique_actions and cost_per_unique_action_type fields will return only the following action_type breakdowns:

link_click
onsite_conversion_messaging_first_reply
onsite_conversion_total_messaging_connection
outbound_click

Accordingly, the following action_type breakdowns will be deprecated from the API’s unique_actions and cost_per_unique_action_type fields:

add_payment_info
add_to_cart
app_custom_event
app_custom_event.fb_mobile_achievement_unlocked
app_custom_event.fb_mobile_activate_app
app_custom_event.fb_mobile_add_payment_info
app_custom_event.fb_mobile_add_to_cart
app_custom_event.fb_mobile_add_to_wishlist
app_custom_event.fb_mobile_complete_registration
app_custom_event.fb_mobile_content_view
app_custom_event.fb_mobile_d2_retention
app_custom_event.fb_mobile_d7_retention
app_custom_event.fb_mobile_initiated_checkout
app_custom_event.fb_mobile_level_achieved
app_custom_event.fb_mobile_purchase
app_custom_event.fb_mobile_rate
app_custom_event.fb_mobile_search
app_custom_event.fb_mobile_spent_credits
app_custom_event.fb_mobile_tutorial_completion
app_custom_event.other
app_engagement
app_install
call_confirm_grouped
checkin
click_to_call_call_confirm
click_to_call_callback_request_submitted
click_to_call_native_20s_call_connect
click_to_call_native_60s_call_connect
click_to_call_native_call_placed
click_to_join_new_channel_member
comment
commerce_event
complete_registration
credit_spent
group_join
initiate_checkout
landing_page_view
lead
leadgen_grouped
like
mobile_app_install
offline_conversion
offline_conversion.add_payment_info
offline_conversion.add_to_cart
offline_conversion.add_to_wishlist
offline_conversion.complete_registration
offline_conversion.initiate_checkout
offline_conversion.lead
offline_conversion.other
offline_conversion.purchase
offline_conversion.search
offline_conversion.view_content
offsite_conversion
offsite_conversion.fb_pixel_add_payment_info
offsite_conversion.fb_pixel_add_to_cart
offsite_conversion.fb_pixel_add_to_wishlist
offsite_conversion.fb_pixel_complete_registration
offsite_conversion.fb_pixel_custom
offsite_conversion.fb_pixel_initiate_checkout
offsite_conversion.fb_pixel_lead
offsite_conversion.fb_pixel_purchase
offsite_conversion.fb_pixel_search
offsite_conversion.fb_pixel_view_content
omni_achievement_unlocked
omni_activate_app
omni_add_to_cart
omni_add_to_wishlist
omni_app_install
omni_complete_registration
omni_custom
omni_initiated_checkout
omni_level_achieved
omni_purchase
omni_rate
omni_search
omni_spend_credits
omni_tutorial_completion
omni_view_content
onsite_app_add_to_cart
onsite_app_purchase
onsite_app_view_content
onsite_conversion.add_to_cart
onsite_conversion.add_to_wishlist
onsite_conversion.click_to_call
onsite_conversion.donate
onsite_conversion.find_location
onsite_conversion.flow_complete
onsite_conversion.initiate_checkout
onsite_conversion.lead
onsite_conversion.lead_grouped
onsite_conversion.message_to_buy
onsite_conversion.messaging_20s_call_connect
onsite_conversion.messaging_60s_call_connect
onsite_conversion.messaging_block
onsite_conversion.messaging_business_calling_call_answered
onsite_conversion.messaging_business_calling_call_initiated
onsite_conversion.messaging_business_calling_call_missed
onsite_conversion.messaging_business_calling_opt_in_accepted
onsite_conversion.messaging_business_calling_opt_in_denied
onsite_conversion.messaging_business_calling_opt_in_sent
onsite_conversion.messaging_conversation_replied_7d
onsite_conversion.messaging_conversation_started_7d
onsite_conversion.messaging_order_created_v2
onsite_conversion.messaging_order_shipped_v2
onsite_conversion.messaging_user_call_placed
onsite_conversion.messaging_user_depth_2_message_send
onsite_conversion.messaging_user_depth_3_message_send
onsite_conversion.messaging_user_subscribed
onsite_conversion.messaging_welcome_message_view
onsite_conversion.other
onsite_conversion.post_save
onsite_conversion.purchase
onsite_conversion.view_content
onsite_web_add_to_cart
onsite_web_app_add_to_cart
onsite_web_app_purchase
onsite_web_app_view_content
onsite_web_lead
onsite_web_purchase
onsite_web_view_content
page_engagement
photo_view
post
post_engagement
post_reaction
purchase
rsvp
search
video_view
view_content

Please note that the above changes do not affect other Ads Insights API fields, such as actions, action_values or cost_per_action_type.

The following endpoints are affected:

June 24, 2024

Ad Scheduling

Applies to All versions

The fields ad_schedule_start_time and ad_schedule_end_time will become available for Manual sales campaigns, Manual app campaigns, and Advantage+ app campaigns.

The following endpoints are affected:

GET /{ad-id}
POST /{ad-id}

March 11, 2024

Starting March 11th, 2024, we will no longer support providing a bid_amount value on ads. Instead please use the bid_amount value in the ad set as the source of truth. API calls attempting to update the bid_amount for an ad will result in an error.

The following endpoints are affected: