市场营销 API

2024 年不定期更改 2024 年市场营销 API 的不定期更改。

2024年11月12日

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.

下列端点受到影响：

2024年10月7日

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.

下列端点受到影响：
* November 15, 2024 - Changelog entry updated with the date for this upcoming change as previously noted would occur.

2024年8月1日

广告成效分析 API #### 独立指标停用 适用于 2024 年 10 月 30 日的所有版本。 2024 年 10 月 30 日，所有版本的广告成效分析 API 中的一些独立指标都将弃用。了解详情。 更新后，API 的 unique_actions 和 cost_per_unique_action_type 字段将仅返回以下 action_type 细分数据：* link_click * onsite_conversion_messaging_first_reply * onsite_conversion_total_messaging_connection * outbound_click 因此，API 的 unique_actions 和 cost_per_unique_action_type 字段中的以下 action_type 细分数据将被弃用：* 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 请注意，上述更改不会影响其他广告成效分析 API 字段，例如 actions、action_values 或 cost_per_action_type。以下端点受到影响：* GET /{ad-account-id}/insights * GET /{ad-id}/insights * GET /{ad-set-id}/insights * GET /{campaign-id}/insights * GET /{ad-report-run-id}/insights

2024年6月24日

Ad Scheduling

应用到 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.

下列端点受到影响：

2024年3月11日

广告 从 2024 年 3 月 11 日开始，我们将不再支持在广告上提供 bid_amount 值。请改用广告组中的 bid_amount 值作为可信数据源。如果 API 调用尝试更新广告的 bid_amount，将导致错误。以下端点受到影响：* GET /{ad-account-id}/ads * POST /{ad-account-id}/ads