facebook graph api高级检索之filtering

Facebook Graph API 的 Filtering 功能允许你在请求数据时,通过指定条件来筛选返回的结果。有很多应用场景,比如通过名称去检索推广系列,检索正在投放中的推广系列等等。

1. 语法

在 Graph API 请求中,可以通过 filtering 参数来指定筛选条件。语法如下:

jsx 复制代码
/endpoint?filtering=[{field:<field_name>,operator:<operator>,value:<value>}]
  • field:要筛选的字段名称。
  • operator :筛选操作符(例如,EQUALGREATER_THANCONTAIN 等)。
  • value:筛选的值。

2. 操作符

以下是常用的筛选操作符:

  • EQUAL:等于。
  • NOT_EQUAL:不等于。
  • GREATER_THAN:大于。
  • GREATER_THAN_OR_EQUAL:大于或等于。
  • LESS_THAN:小于。
  • LESS_THAN_OR_EQUAL:小于或等于。
  • IN:在某个集合中。
  • NOT_IN:不在某个集合中。
  • CONTAIN:包含。
  • NOT_CONTAIN:不包含。

3. 使用案例

jsx 复制代码
https://graph.facebook.com/v21.0/{adAccountId}/campaigns?
fields=name%2Cid
&limit=25
&access_token=<accessToken>
&filtering=[{'field':'name','operator':'CONTAIN','value':'0214_tiktok_app_install_sa'}]

上述就是一个用来通过名称检索推广系列的。

这个的使用场景在于,如果你通过api创建推广系列完成后,由于网络问题,导致你没有收到响应结果,或者在业务处理过程中,出现了导致你未能存储推广系列信息到你本地数据库,这个时候你重新执行任务就会导致重复创建。

4. 多条件检索

由于filtering使用的是中括号,所以可以进行多条件检索

你可以通过数组形式指定多个筛选条件。例如,获取状态为 ACTIVE 且预算大于 $50 的广告组:

复制代码
GET /act_{ad_account_id}/adsets?filtering=[
  {field:"status",operator:"EQUAL",value:"ACTIVE"},
  {field:"daily_budget",operator:"GREATER_THAN",value:"50"}
]

5. 注意事项

Filtering 的注意事项

  • 字段支持:并非所有字段都支持筛选功能,具体支持的字段请自行尝试,毕竟facebook的文档很垃圾。
  • 性能优化:随着广告数据越来越多,增量检查才是王道,所以要用好filtering。针对删除的广告,可以通过activities进行获取用户操作。
  • 权限要求:某些字段可能需要特定的权限才能访问(同一个accessToken,针对不同的广告账户,可以查询的字段也不一样(坑))
相关推荐
dingzd951 天前
通过 Web3 区块链安全评估,领先应对网络威胁
安全·web3·区块链·facebook·tiktok·instagram·clonbrowser
Min_Fox3 天前
【web页面接入Apple/google/facebook三方登录】
前端·facebook
船长@Quant3 天前
Facebook 开源多季节性时间序列数据预测工具:Prophet 快速入门 Quick Start
facebook·时序建模·时序预测·prophet·预测工具
清 晨4 天前
Web3与区块链如何革新网络安全——走在前沿
web安全·web3·区块链·facebook·tiktok·instagram·clonbrowser
船长@Quant7 天前
Facebook 开源多季节性时间序列数据预测工具:Prophet 饱和预测 Saturating Forecasts
facebook·时序预测·时序模型·prophet·预测工具
dingzd9510 天前
借助它,在Web3投资赛道抢占先机
web3·互联网·facebook·tiktok·instagram·指纹浏览器·clonbrowser
清 晨11 天前
Web3 支付系统:面向企业和消费者的全面概述
web3·互联网·facebook·tiktok·instagram·指纹浏览器·clonbrowser
dingzd9517 天前
了解去中心化金融在现代经济中的作用——安全交易新时代
安全·金融·web3·去中心化·facebook·tiktok·instagram
罗光记19 天前
PHP诞生30周年
前端·数据库·百度·facebook·twitter
音程23 天前
BlenderBot对话机器人大模型Facebook开发
facebook