Meta Marketing API v27.0:两项默认开启(除非工具主动关闭),以及背后的日期
自 2026 年 11 月 4 日起,Meta Marketing API v27.0 可在新建广告与广告组上自动开启 Product showcase 与「Reach more people across other mobile devices」,除非集成方主动关闭;设备扩展默认值与类似受众地点字段变更约 90 天后覆盖所有 API 版本(Meta 写 2027 年 2 月,日期待确认),Graph API v21.0 于 2027 年 1 月 21 日移除。
2026 年 11 月 4 日改了什么
Meta for Developers 于 2026 年 11 月 4 日发布 "Introducing Graph API v27.0 and Marketing API v27.0",写明本版包含 "new capabilities, deprecations, and breaking changes"(新能力、弃用与破坏性变更)。多数变更只作用于 v27.0 调用;部分稍后覆盖所有版本。本文只讲会改变广告投放或让工具出错的几项。
默认 1 —— 新建 Sales 广告组的设备扩展
v27.0 changelog 写:创建符合条件的广告组而未设置 device 时,"Reach more people across other mobile devices is now turned on"(该设置现在默认开启);Meta "can then deliver your ads to people on other mobile devices and operating systems when that is likely to improve performance"(在可能提升效果时,把广告投给其他移动设备与操作系统上的人)。符合条件 = 属于 Sales 广告系列、未使用 Mobile App 转化位置、定向里包含设备或操作系统;Special Ad Categories 不可用。要只投放到所定向的设备,工具必须把 device 设为 0。现有广告组不变。changelog 写本项 "Will apply to all versions approximately 90 days after the v27.0 launch, date to be confirmed"(约在 v27.0 发布 90 天后覆盖所有版本,日期待确认);博客写 "February 2027"。
默认 2 —— 新建广告的 Product showcase
在 v27.0 上,若创意没有任何 Product showcase 设置,"Meta may now turn on Product showcase"(Meta 现在可能开启 Product showcase)。Meta 写明只在 "high confidence that a specific product set in your catalog matches the ad"(高度确信目录中某个商品组与该广告匹配)时才这样做,且 "will not select the catalog's All Products set"(不会选用目录的 All Products 商品组)。该设置会留在创意上,之后复用该创意的广告也会开启。关闭方式:在 creative features spec 中把 product_extensions.enroll_status 设为 OPT_OUT。Meta 还提供预览端点,可先查看可能被使用的商品组。v27.0 之前的版本不变。
两项会让工具出错的变更
其一,类似受众(Lookalike audiences):在 v27.0 上,lookalike_spec 含 country 或 location_spec 的请求 "are rejected immediately"(立即被拒),其余版本约 90 天后跟进(日期待确认);现有类似受众照常投放。其二,目录 /{catalog-id}/batch 端点已弃用,改用 /items_batch,在 v27.0+ 不再可用。
版本退役日期
Meta 公告写 Graph API v21.0 "is deprecated and removed on January 21, 2027"(2027 年 1 月 21 日弃用并移除),v22.0 于 2027 年 5 月 20 日移除;Graph API changelog 的版本表列出相同日期。
要核对什么
问清你的投放工具、脚本或代理集成调用的是哪个 Marketing API 版本。若升到 v27.0,核对:需要严格设备定向的地方是否发送 device: 0;不想在广告下方展示目录商品的地方是否发送 OPT_OUT。升级后抽查新的 Sales 广告;若扩展已开启,不要把设备定向组的结果当作「只投该设备」。把 2027 年 1 月 21 日(Graph API v21.0 移除)记进日历;「约 2027 年 2 月」在 Meta 公布具体日期前按未确认处理。Meta 公告描述的是 API 行为,没有写 Ads Manager 界面是否同样变化,请以你实际使用的界面为准。
本文摘要自 Meta for Developers 页面,不是 Meta 官方指引;请以实时 changelog 为准。
来源
- Meta for Developers,「Introducing Graph API v27.0 and Marketing API v27.0」(2026 年 11 月 4 日)(https://developers.facebook.com/blog/post/2026/11/04/introducing-graph-api-v27-and-marketing-api-v27/)
- Marketing API changelog, Version 27.0(https://developers.facebook.com/documentation/ads-commerce/marketing-api/marketing-api-changelog/version27.0)
- Marketing API changelog(https://developers.facebook.com/documentation/ads-commerce/marketing-api/marketing-api-changelog)
- Graph API changelog(https://developers.facebook.com/docs/graph-api/changelog/)。