如何通过PHP SDK统一Facebook Lead Ads表单字段语言？

方案1：固定字段名映射转换 #

直接建立多语言字段到CRM标准字段的映射表，把不同语言的字段名统一转换成你需要的固定键名（比如统一用英文键名）。

实现步骤 #

1. 定义映射规则
   整理所有可能出现的多语言字段，映射到统一的键名：

$fieldMapping = [
    // 姓名
    'nome_completo' => 'full_name',
    'full_name' => 'full_name',
    // 电话
    'numero_telefone' => 'phone_number',
    'phone_number' => 'phone_number',
    // 补充其他业务需要的字段
    'endereco' => 'address',
    'address' => 'address',
    'email' => 'email'
];

2. 转换原始字段数据
   拿到Facebook SDK返回的表单数据后，遍历完成转换：

// $leadFields 是从Facebook获取的原始表单字段数组
$normalizedFields = [];

foreach ($leadFields as $originalKey => $value) {
    // 优先用映射后的键名，无匹配则保留原键名（可根据需求调整）
    $normalizedKey = $fieldMapping[$originalKey] ?? $originalKey;
    $normalizedFields[$normalizedKey] = $value;
}

// 转换后的$normalizedFields可直接传入CRM系统

方案2：基于字段ID的可靠映射（进阶） #

Facebook Lead Ads的每个表单字段都有唯一固定的id（不受表单语言影响），可以通过字段ID来做映射，避免遗漏或新增字段的问题。

实现步骤 #

1. 获取表单字段元数据
   通过Facebook Graph API调用，获取目标表单的所有字段ID和对应多语言名称：

// 用Facebook PHP SDK获取表单字段列表
$formFields = $fb->get("/{你的表单ID}/fields")->getGraphEdge()->asArray();

// 建立字段ID到CRM字段名的映射（提前整理好）
$idToCrmField = [
    '123456789' => 'full_name', // 替换为实际字段ID
    '987654321' => 'phone_number'
];

2. 通过字段ID转换数据

$normalizedFields = [];
// 先建立「字段名→字段ID」的临时映射
$nameToFieldId = array_column($formFields, 'id', 'name');

foreach ($leadFields as $originalKey => $value) {
    $fieldId = $nameToFieldId[$originalKey] ?? null;
    if ($fieldId && isset($idToCrmField[$fieldId])) {
        $normalizedKey = $idToCrmField[$fieldId];
        $normalizedFields[$normalizedKey] = $value;
    } else {
        // 处理未匹配的字段，可选择保留原键或抛出提示
        $normalizedFields[$originalKey] = $value;
    }
}

注意事项 #

• 方案1适合字段少、固定的场景，实现简单；方案2适合字段多、可能新增的场景，稳定性更高
• 测试不同语言创建的表单，确保所有业务字段都被覆盖到映射规则中

内容的提问来源于stack exchange，提问作者Matheus Sena dos Passos