Alterações fora de ciclo de 2024 Alterações fora de ciclo da API de Marketing em 2024.

12 de novembro de 2024

Ad Asset Promotional Metadata

Aplica-se a 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.

Os seguintes pontos de extremidade foram afetados:

7 de outubro de 2024

New available category for Special Ad Categories

Aplica-se a 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.

Os seguintes pontos de extremidade foram afetados:
* November 15, 2024 - Changelog entry updated with the date for this upcoming change as previously noted would occur.

1 de agosto de 2024

API de Insights sobre Anúncios#### Métricas únicas que se tornarão obsoletas Aplicável a todas as versões a partir de 30 de outubro de 2024. Em 30 de outubro de 2024, várias métricas únicas da API de Insights sobre Anúncios se tornarão obsoletas em todas as versões da API. Saiba mais. Após a atualização, os campos unique_actions e cost_per_unique_action_type da API retornarão apenas os seguintes detalhamentos de action_type: * link_click * onsite_conversion_messaging_first_reply * onsite_conversion_total_messaging_connection * outbound_click Consequentemente, estes detalhamentos de action_type não estarão mais disponíveis para os campos unique_actions e cost_per_unique_action_type da API: * 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 Observe que as alterações acima não afetam outros campos da API de Insights sobre Anúncios, como actions, action_values ou cost_per_action_type. Os seguintes pontos de extremidade serão afetados: * GET /{ad-account-id}/insights * GET /{ad-id}/insights * GET /{ad-set-id}/insights * GET /{campaign-id}/insights * GET /{ad-report-run-id}/insights

24 de junho de 2024

Ad Scheduling

Aplica-se a 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.

Os seguintes pontos de extremidade foram afetados:

11 de março de 2024

Anúncio A partir de 11 de março de 2024, não será mais possível fornecer um valor bid_amount em anúncios. Como alternativa, use o valor bid_amount no conjunto de anúncios como a fonte da verdade. As chamadas de API que tentarem atualizar o bid_amount em um anúncio resultarão em erro. Estes pontos de extremidade serão afetados: * GET /{ad-account-id}/ads * POST /{ad-account-id}/ads