2025 Out-of-cycle changes

{
regional_regulated_categories:["BRAZIL_REGULATION"],
regional_regulation_identities:{
"universal_beneficiary": <UNIVERSAL_BENEFICIARY_ID>,
"universal_payer": <UNIVERSAL_PAYER_ID>
}
}

• GET /{campaign-id}/insights
• GET /{ad-set-id}/insights
• GET /{ad-id}/insights

• Advantage+ catalog ads are now available for Threads ads. Only images and image carousels are currently supported. Slideshow, video and entry cards are not supported at this time. See Threads Advantage+ Catalog Ads for more information.

• Attribution Windows: Data for 7-day view-through (action_attribution_windows=7d_view) and 28-day view-through (action_attribution_windows=28d_view) attribution windows will no longer be available and will return no data
• Historical Data: Certain fields and breakdowns will have limited historical data retention and will return no data when queried with start_dates beyond their retention limits:
  • Limited to 13 months: All breakdowns for unique-count fields (like unique_actions and cost_per_unique_action_type); and hourly breakdowns for all fields (i.e., breakdowns=hourly_stats_aggregated_by_advertiser_time_zone)
  • Limited to 6 months: Frequency breakdowns (i.e., breakdowns=frequency_value)
• MMM Breakdowns: MMM breakdowns (i.e., breakdowns=mmm) will be limited to asynchronous jobs.

• GET /{ad-account-id}
• GET /{campaign-id}
• GET /{ad-set-id}
• GET /{ad-id}
• POST /{ad-account-id}
• POST /{campaign-id}
• POST /{ad-set-id}
• POST /{ad-id}

• GET /{ad-account-id}/adsets
• POST /{ad-account-id}/adsets
• GET /{ad-set-id}?fields=targeting

• Image carousel can now be used for Threads ads. Placement customization and allow product video are not supported. See Threads Carousel Ads for more information.

• POST /{ad_account_id}/campaigns
• POST /{ad_account_id}/ads
• POST /{ad_account_id}/adsets
• POST /{ad_account_id}/adcreatives

• POST /{product_catalog_id}/products
• POST /{product_item_id}
• GET /{product_item_id}
• POST /{product_catalog_id}/items_batch

• POST /{ad-account-id}/adsets

• GET /search

• POST /act_{ad-account-id}/campaigns

• Threads ads now supports video ads. See Threads ads creatives: Media requirements for more information.
• Threads has been added as a publisher_platform in the customization_spec for Placement Asset Customization. See Supported Fields in customization_spec for more information.

• GET /{ad-set-id}?fields=promoted_object{value_semantic_type}
• POST /{ad-set-id}

• The notification placement has been added to facebook_positions for placement targeting and placement asset customization.

• To reduce discrepancies with Meta Ads Manager, use_unified_attribution_setting and action_report_time parameters will be disregarded, and API responses will mimic Meta Ads Manager settings. To learn more, see the discrepancy with Ads Manager guidance.
• To improve overall API performance, reach will no longer be returned for queries that apply breakdowns and use start_dates more than 13 months old; developers may leverage asynchronous jobs to request such data. To learn more, see the Insights best practices.

• POST /{campaign-id}