這份文件已更新。
中文(香港) 的翻譯尚未完成。
英文更新時間:10月13日

2024 年不分版本變更 2024 年行銷 API 不分版本變更。

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 版本的一些不重複衡量指標。 瞭解詳情。 更新後,API 的 unique_actionscost_per_unique_action_type 欄位將僅傳回以下 action_type 資料解析:* link_click * onsite_conversion_messaging_first_reply * onsite_conversion_total_messaging_connection * outbound_click 因此,API 的 unique_actionscost_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 欄位,例如 actionsaction_valuescost_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 值作為來源。嘗試更新廣告之 bid_amount 的 API 呼叫將導致錯誤。以下端點受到影響:* GET /{ad-account-id}/ads * POST /{ad-account-id}/ads