如何通过Facebook Marketing API按特定目标过滤广告账户广告活动?
按特定广告目标筛选Campaign的实现方法
你在campaigns接口的参数列表里找不到对应过滤项是正常的:这个接口没有为objective(广告目标)设置单独的专属过滤参数,所有Marketing API的资源列表读取接口都支持通用的filter查询参数,完全可以实现筛选需求。
通用filter参数的使用规则
Facebook Marketing API的通用filter参数采用固定的JSON结构传值,SDK会自动完成URL编码,不需要手动拼接转义字符。每个筛选条件对应一个独立的结构块,包含三个固定字段:
field:要筛选的资源字段名,筛选广告目标时直接填objectiveoperator:匹配规则,筛选单个目标值用EQUAL,同时筛选多个目标值用INvalue:要匹配的目标枚举值,触达(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
相关产品推荐
相关产品推荐

