You need to enable JavaScript to run this app. 如何通过Facebook Marketing API按特定目标过滤广告账户广告活动?
优惠活动
大模型
产品
解决方案
定价
更多

如何通过Facebook Marketing API按特定目标过滤广告账户广告活动?

按特定广告目标筛选Campaign的实现方法

你在campaigns接口的参数列表里找不到对应过滤项是正常的:这个接口没有为objective(广告目标)设置单独的专属过滤参数,所有Marketing API的资源列表读取接口都支持通用的filter查询参数,完全可以实现筛选需求。

通用filter参数的使用规则

Facebook Marketing API的通用filter参数采用固定的JSON结构传值,SDK会自动完成URL编码,不需要手动拼接转义字符。每个筛选条件对应一个独立的结构块,包含三个固定字段:

  • field:要筛选的资源字段名,筛选广告目标时直接填objective
  • operator:匹配规则,筛选单个目标值用EQUAL,同时筛选多个目标值用IN
  • value:要匹配的目标枚举值,触达(Reach)对应的官方枚举值为全大写的REACH,传小写值会触发参数校验错误。

适配你现有PHP SDK v5.0.0版本的代码改造

你原有代码里的请求可以直接调整传参结构,不需要手动拼接编码后的查询字符串:

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/act_<AD_ACCOUNT_ID>/campaigns',
    [
      'effective_status' => ['ACTIVE', 'PAUSED'],
      'fields' => ['name', 'objective'],
      // 新增的目标筛选逻辑
      'filter' => [
        [
          'field' => 'objective',
          'operator' => 'IN',
          'value' => ['REACH'] // 多目标可直接追加枚举值,比如 ['REACH', 'BRAND_AWARENESS']
        ]
      ]
    ],
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

注意事项

  • 所有objective的枚举值均为全大写格式,常见对应关系:
    • 触达目标:REACH
    • 品牌认知:BRAND_AWARENESS
    • 链接点击:LINK_CLICKS
    • 转化量:CONVERSIONS
  • 如果需要跨字段组合筛选(比如同时按广告目标、投放状态过滤),只需要在filter对应的数组里追加多个条件块即可,不需要修改接口路径。
  • 不要采用“拉取全量campaign列表后本地过滤”的方案:当广告账户内campaign数量超过1000条时,全量拉取会触发多次分页请求,接口耗时会是服务端过滤的3-5倍。

内容的提问来源于stack exchange,提问作者Nisar Ahmed

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 07:24:01