创建LinkedIn广告系列时触发MULTIPLE_VALIDATIONS_FAILED错误求助

问题概述 #

使用LinkedIn广告系列API（adCampaignsV2）创建广告系列时，当locale.country设为GB（英国）会触发MULTIPLE_VALIDATIONS_FAILED错误，返回400 Bad Request；但将country改为US或CN时可正常创建，且广告账户本身是英国地区创建的。

错误信息 #

顶层校验错误提示：

Multiple errors occurred during the input validation. Please see errorDetails for more information

GuzzleHttp捕获的详细错误：

GuzzleHttp\Exception\ClientException: Client error: POST https://api.linkedin.com/v2/adCampaignsV2 resulted in a 400 Bad Request response:
{"errorDetailType":"com.linkedin.common.error.BadRequest","code":"MULTIPLE_VALIDATIONS_FAILED","message":"Multiple error (truncated...)

请求Payload（原代码） #

$formData = [
    "account" => "XXXXXXX",
    "campaignGroup" => "urn:li:sponsoredCampaignGroup:XXXXXXX",
    "audienceExpansionEnabled" => false,
    "costType" => "CPC",
    "creativeSelection" => "OPTIMIZED",
    "totalBudget" => [
        "amount" => "51.00",
        "currencyCode" => "GBP"
    ],
    "locale" => [
        "country" => "GB",
        "language" => "en"
    ],
    "name" => "Testing Campaign Name",
    "offsiteDeliveryEnabled" => false,
    "runSchedule" => [
        "end" => 1690022880000,
        "start" => 1689850080000,
    ],
    "targetingCriteria" => [
        "include" => [
            "and" => [
                [
                    "or" => [
                        "urn:li:adTargetingFacet:locations" => [
                            "urn:li:geo:101165590"
                        ]
                    ]
                ],
            ]
        ]
    ],
    "type" => "SPONSORED_UPDATES",
    "unitCost" => [
        "amount" => "2.00",
        "currencyCode" => "GBP"
    ],
    "status" => "ACTIVE"
];

排查与解决步骤 #

1. 修正Locale地区代码 #

LinkedIn API文档标注英国的地区代码为GB，但实际接口可能存在兼容问题，尝试将locale.country改为UK：

"locale" => [
    "country" => "UK",
    "language" => "en"
],

2. 简化定向条件嵌套结构 #

原Payload中targetingCriteria多了一层不必要的or嵌套，单个位置条件无需or逻辑，修正后结构：

"targetingCriteria" => [
    "include" => [
        "and" => [
            [
                "urn:li:adTargetingFacet:locations" => [
                    "urn:li:geo:101165590"
                ]
            ]
        ]
    ]
],

3. 调整预算与出价的格式 #

将amount的字符串类型改为数值类型，避免字符串格式导致的校验失败：

"totalBudget" => [
    "amount" => 51.00,
    "currencyCode" => "GBP"
],
"unitCost" => [
    "amount" => 2.00,
    "currencyCode" => "GBP"
],

4. 校验运行时间范围 #

确认runSchedule的时间戳符合要求：

• start时间需晚于当前时间
• end时间需晚于start时间
• 投放周期不能超过LinkedIn允许的最大范围（通常不超过1年）

5. 检查广告系列类型限制 #

SPONSORED_UPDATES类型在英国地区可能存在投放限制，尝试更换为SPONSORED_CONTENT类型测试：

"type" => "SPONSORED_CONTENT",

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