Meta Marketing API动态汽车目录广告创意预览报错求助

针对动态汽车目录广告预览报错“所选产品集中无有效产品”的问题，可按以下步骤排查解决：

1. 校验预览请求的上下文参数 #

预览API的受众上下文和实际投放的默认上下文存在差异，需确保：

• 显式指定preview_target参数，匹配产品集的受众设置（如地区、年龄、语言）。例如产品仅面向中国地区投放，预览时需指定country=CN，避免默认全局受众触发产品过滤。
• 确认调用预览API时使用的access_token对应的商务管理平台账号，拥有该产品集的查看权限（部分场景下投放账号权限足够，但预览账号缺少产品集访问权限）。

2. 验证产品集的实际有效产品 #

• 直接在Meta商务管理平台打开目标产品集，查看「已过滤产品」的具体原因（库存、可见性、过期时间等），确认是否存在隐藏的过滤规则导致无有效产品。
• 通过API调用直接查询产品集的有效产品，模拟预览时的过滤逻辑：

// PHP SDK 示例代码
$productSet = new ProductSet($accessToken);
$productSet->setId('{你的产品集ID}');
$validProducts = $productSet->getProducts([
    'fields' => 'id,title,availability,visibility,expiration_date',
    'filter' => [
        'availability' => 'in_stock',
        'visibility' => 'published',
        'expiration_date' => ['gt' => date('c')]
    ]
]);
// 若返回空数组，说明产品集本身无符合条件的产品

# Python SDK 示例代码
from facebook_business.adobjects.productset import ProductSet
import datetime

product_set = ProductSet(fbid='{你的产品集ID}', access_token=access_token)
valid_products = product_set.get_products(fields=[
    'id', 'title', 'availability', 'visibility', 'expiration_date'
], params={
    'filter': {
        'availability': 'in_stock',
        'visibility': 'published',
        'expiration_date': {'gt': datetime.datetime.now().isoformat()}
    }
})

3. 检查动态广告创意的参数配置 #

• 确认creative对象中的dynamic_ad_asset参数正确绑定了目标产品集，未误传其他产品集ID。
• 动态汽车广告需确保ad_format参数与产品资产匹配（如CAROUSEL格式需产品包含多张合规图片），避免格式不兼容触发过滤。
• 显式传递locale参数（如locale=zh_CN），部分产品的可见性与语言/地区强绑定，缺失该参数会导致预览时产品被过滤。

4. 触发目录同步并清除缓存 #

• 在Meta商务管理平台的目录设置中，手动点击「重新同步」，强制更新产品状态（部分场景下投放数据正常，但预览API缓存了旧的产品状态）。
• 若手动同步无效，可通过API触发目录同步：

// PHP SDK 示例
$catalog = new Catalog($accessToken);
$catalog->setId('{你的目录ID}');
$catalog->sync();

5. 升级SDK版本 #

检查使用的Facebook Business PHP/Python SDK是否为最新版本，旧版本SDK可能存在预览API参数处理的bug，导致过滤逻辑异常。

内容的提问来源于stack exchange，提问作者soulglow1985