마케팅 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' 필드는 다음 'actin_type' 분석 데이터만 반환합니다. * link_click * onsite_conversion_messaging_first_reply * onsite_conversion_total_messaging_connection * outbound_click 따라서, 다음의 action_type 분석 데이터는 API의 unique_actions 및cost_per_unique_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 위의 변경 사항은 'actions', 'action_values', 'cost_per_action_type'와 같은 다른 광고 인사이트 API에는 영향을 미치지 않습니다. 영향을 받는 엔드포인트는 다음과 같습니다. * 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