2024 Out-Of-Cycle Changes
2024 out-of-cycle changes to Marketing API.
12 ноября 2024 г.
Ad Asset Promotional Metadata
Касается версий all versions.
The coupon_codes field will be added to the AdAssetPromotionalMetadata API. This field stores the coupon codes and their detection sources that the advertiser opted in to during ad creation.
7 октября 2024 г.
New available category for Special Ad Categories
Касается версий all versions.
There is a new special ad category input for the special_ad_categories field. This input is FINANCIAL_PRODUCTS_SERVICES representing the Financial products and services category, and will eventually replace the CREDIT input on January 14, 2025. This change is part of an upcoming expansion of special ad categories to include financial products and services in early 2025. Learn more about the update here.
CREDIT is still a valid special ad category selection until it is deprecated on January 14, 2025. Developers must have migrated to the FINANCIAL_PRODUCTS_SERVICES input prior to the deprecation. It is recommended that you prioritize this update well in advance of the deprecation date to minimize disruption for your customers.
It is important to note that CREDIT and FINANCIAL_PRODUCTS_SERVICES cannot be selected at the same time for a single campaign. Only one (CREDIT or FINANCIAL_PRODUCTS_SERVICES) may be used of the two choices.
Businesses that have selected the FINANCIAL_PRODUCTS_SERVICES input must comply with audience restrictions, similar to housing and employment.
POST/{campaign-id}
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_clickonsite_conversion_messaging_first_replyonsite_conversion_total_messaging_connectionoutbound_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_infoadd_to_cartapp_custom_eventapp_custom_event.fb_mobile_achievement_unlockedapp_custom_event.fb_mobile_activate_appapp_custom_event.fb_mobile_add_payment_infoapp_custom_event.fb_mobile_add_to_cartapp_custom_event.fb_mobile_add_to_wishlistapp_custom_event.fb_mobile_complete_registrationapp_custom_event.fb_mobile_content_viewapp_custom_event.fb_mobile_d2_retentionapp_custom_event.fb_mobile_d7_retentionapp_custom_event.fb_mobile_initiated_checkoutapp_custom_event.fb_mobile_level_achievedapp_custom_event.fb_mobile_purchaseapp_custom_event.fb_mobile_rateapp_custom_event.fb_mobile_searchapp_custom_event.fb_mobile_spent_creditsapp_custom_event.fb_mobile_tutorial_completionapp_custom_event.otherapp_engagementapp_installcall_confirm_groupedcheckinclick_to_call_call_confirmclick_to_call_callback_request_submittedclick_to_call_native_20s_call_connectclick_to_call_native_60s_call_connectclick_to_call_native_call_placedclick_to_join_new_channel_membercommentcommerce_eventcomplete_registrationcredit_spentgroup_joininitiate_checkoutlanding_page_viewleadleadgen_groupedlikemobile_app_installoffline_conversionoffline_conversion.add_payment_infooffline_conversion.add_to_cartoffline_conversion.add_to_wishlistoffline_conversion.complete_registrationoffline_conversion.initiate_checkoutoffline_conversion.leadoffline_conversion.otheroffline_conversion.purchaseoffline_conversion.searchoffline_conversion.view_contentoffsite_conversionoffsite_conversion.fb_pixel_add_payment_infooffsite_conversion.fb_pixel_add_to_cartoffsite_conversion.fb_pixel_add_to_wishlistoffsite_conversion.fb_pixel_complete_registrationoffsite_conversion.fb_pixel_customoffsite_conversion.fb_pixel_initiate_checkoutoffsite_conversion.fb_pixel_leadoffsite_conversion.fb_pixel_purchaseoffsite_conversion.fb_pixel_searchoffsite_conversion.fb_pixel_view_contentomni_achievement_unlockedomni_activate_appomni_add_to_cartomni_add_to_wishlistomni_app_installomni_complete_registrationomni_customomni_initiated_checkoutomni_level_achievedomni_purchaseomni_rateomni_searchomni_spend_creditsomni_tutorial_completionomni_view_contentonsite_app_add_to_cartonsite_app_purchaseonsite_app_view_contentonsite_conversion.add_to_cartonsite_conversion.add_to_wishlistonsite_conversion.click_to_callonsite_conversion.donateonsite_conversion.find_locationonsite_conversion.flow_completeonsite_conversion.initiate_checkoutonsite_conversion.leadonsite_conversion.lead_groupedonsite_conversion.message_to_buyonsite_conversion.messaging_20s_call_connectonsite_conversion.messaging_60s_call_connectonsite_conversion.messaging_blockonsite_conversion.messaging_business_calling_call_answeredonsite_conversion.messaging_business_calling_call_initiatedonsite_conversion.messaging_business_calling_call_missedonsite_conversion.messaging_business_calling_opt_in_acceptedonsite_conversion.messaging_business_calling_opt_in_deniedonsite_conversion.messaging_business_calling_opt_in_sentonsite_conversion.messaging_conversation_replied_7donsite_conversion.messaging_conversation_started_7donsite_conversion.messaging_order_created_v2onsite_conversion.messaging_order_shipped_v2onsite_conversion.messaging_user_call_placedonsite_conversion.messaging_user_depth_2_message_sendonsite_conversion.messaging_user_depth_3_message_sendonsite_conversion.messaging_user_subscribedonsite_conversion.messaging_welcome_message_viewonsite_conversion.otheronsite_conversion.post_saveonsite_conversion.purchaseonsite_conversion.view_contentonsite_web_add_to_cartonsite_web_app_add_to_cartonsite_web_app_purchaseonsite_web_app_view_contentonsite_web_leadonsite_web_purchaseonsite_web_view_contentpage_engagementphoto_viewpostpost_engagementpost_reactionpurchasersvpsearchvideo_viewview_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:
11 марта 2024 г.
Ad
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: