如何通过Facebook Graph API关联线索表单与广告系列/组/广告数据？

1. 线索表单绑定的广告组查询 #

获取活跃线索表单列表时，在请求字段里加上adgroup_ids，接口返回的每个表单对象会包含绑定的所有广告组ID：
GET /{page-id}/leadgen_forms?fields=id,name,adgroup_ids
拿到这些ID后，直接和你从广告账户接口获取的广告组ID匹配，再通过广告组的campaign_id关联到广告系列，通过广告的adgroup_id关联到具体广告。

2. 单个线索的广告关联字段 #

获取指定表单的线索数据时，必须显式请求ad_id、adgroup_id、campaign_id这几个字段：
GET /{leadgen-form-id}/leads?fields=id,created_time,field_data,ad_id,adgroup_id,campaign_id
返回的每条线索都会携带对应的广告、广告组、广告系列ID，直接和你已有的广告数据做关联即可。

3. 反向关联：从广告组找线索表单 #

如果手里有广告组ID，也可以直接查询它绑定的线索表单：
GET /{adgroup-id}?fields=leadgen_form_id
这个接口会返回该广告组关联的线索表单ID，适合从广告维度回溯线索来源。

.NET代码示例（简化实现） #

下面是获取线索时携带广告关联字段的示例代码：

using System.Net.Http;
using System.Threading.Tasks;

public async Task<string> GetLeadsWithAdData(string formId, string accessToken)
{
    using var client = new HttpClient();
    var requestUrl = $"https://graph.facebook.com/v18.0/{formId}/leads?fields=id,field_data,ad_id,adgroup_id,campaign_id&access_token={accessToken}";
    var response = await client.GetAsync(requestUrl);
    response.EnsureSuccessStatusCode();
    return await response.Content.ReadAsStringAsync();
}

拿到返回数据后，解析出ad_id等字段，和你已存储的广告、广告组、广告系列数据关联即可。

注意：你的访问令牌必须同时拥有ads_read和leadgen_read权限，否则无法获取这些关联字段。

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