使用Facebook Business API创建动态广告遇Transformer无效错误求助

我之前在做动态广告API集成时也碰到过类似的诡异问题，特别是涉及到URL模板和转换器组合的时候，给你几个实用的排查和解决思路：

问题核心回顾 #

你创建汽车类Facebook动态广告时，95%的调用正常，但当URL路径包含VehicleSearchResults时，调用返回错误码100（子码1487893），提示The transformer you selected is invalid，移除该字符串后恢复正常，即使你已经按照文档使用了urlencode转换器。

可能的解决方案 #

1. 避免手动拼接JSON字符串，用序列化工具处理转义 #

你的参数中object_story_spec和template_url_spec是手动拼接的JSON字符串，很容易出现转义冲突（比如URL中的&和模板语法的{{}}混在一起时，解析逻辑会混乱）。建议用Python的json.dumps来自动序列化字典，确保转义正确：

import json

# 先构造干净的URL模板
link_template = "https://www.mywebpage.com/VehicleSearchResults?search=preowned&model={{vehicle.model | urlencode}}"

# 构造object_story_spec的字典结构
object_story_dict = {
    "page_id": "1234567890",
    "template_data": {
        "call_to_action": {
            "type": "SHOP_NOW",
            "value": {"link": link_template}
        },
        "description": "",
        "link": link_template,
        "message": "",
        "name": "{{vehicle.price}} - {{vehicle.title}}"
    }
}

# 构造template_url_spec的字典结构
template_url_dict = {
    "web": {"url": link_template}
}

# 最终参数用json.dumps序列化，避免手动转义错误
params = {
    'name': '{{vehicle.price}} - {{vehicle.title}}._CREATIVE',
    'product_set_id': '1234567890',
    'url_tags': '',
    'object_story_spec': json.dumps(object_story_dict),
    'template_url_spec': json.dumps(template_url_dict),
    'applink_treatment': 'web_only'
}

手动拼接JSON时，很容易出现&被错误解析的情况，用json.dumps能保证所有特殊字符都被正确转义，符合Facebook API的要求。

2. 绕开Facebook的urlencode转换器，手动预编码字段 #

如果上面的方法还是不行，可能是Facebook的urlencode转换器对VehicleSearchResults这个路径有特殊处理逻辑（比如误判为内部关键词）。这时候可以提前在你的数据源中预编码model字段：

• 在产品目录或数据feed中，新增一个字段（比如model_encoded），提前对model的值做URL编码（比如把Toyota Camry转换成Toyota%20Camry）。
• 然后把模板中的{{vehicle.model | urlencode}}替换为{{vehicle.model_encoded}}，完全绕开Facebook的转换器逻辑。

3. 测试路径字符串，排查Facebook的内部规则 #

尝试把URL中的VehicleSearchResults改成其他类似字符串（比如VehicleSearchResultsTest），如果修改后不再报错，说明Facebook的模板解析器对这个特定字符串有特殊限制。这种情况下：

• 可以考虑修改你的URL路径（比如简化为VehicleSearch）。
• 或者直接提交工单给Facebook支持团队，说明这个特殊的兼容性问题，请求官方修复。

总结 #

最常见的原因是手动拼接JSON导致的转义错误，优先尝试用json.dumps序列化参数。如果问题仍然存在，预编码字段是最可靠的绕开方案。

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