市场营销 API 版

市场营销 API 参考文档

本文将提供 Facebook 市场营销 API 的完整根节点列表,并包含各个根节点的参考文档链接。可用的连线会单独显示。如需了解关于 API 架构如何调用根节点及其连线的背景信息,请参阅使用图谱 API

主要的根节点包括:

根节点 表示的含义

/{USER}

创建广告的 Facebook 用户。每个广告用户可在多个广告帐户中拥有用户身份

/act_{AD_ACCOUNT_ID}

表示管理广告的商家实体

/{CAMPAIGN_ID}

定义广告系列目标。可包含一个或多个广告组

/{AD_SET_ID}

包含使用同一预算、排期、竞价和定位条件的所有广告

/{AD_ID}

包含广告信息,如创意装饰元素和成效衡量信息

用户

连线

连线 表示的含义

/adaccountgroups

与此用户关联的广告帐户组

/adaccounts

与此用户关联的所有广告帐户

/accounts

某用户是管理员的所有主页和地点

/promotable_events

您创建的所有可推广活动,或您担任管理员的主页中的可推广主页活动

/promotable_domains

此用户可推广的所有网域

广告帐户

市场营销 API 中属于同一广告帐户的所有广告对象集合。

连线

连线 表示的含义

/campaigns

定义广告系列目标,包含一个或多个广告组

/adsets

包含使用同一预算、排期、竞价和定位条件的所有广告

/ads

广告数据,例如创意装饰元素和成效衡量信息

/adcreatives

定义广告的展示效果和内容

/adimages

在广告创意中使用的图片库。可以单独上传和管理

/advideos

在广告创意中使用的视频库。可以单独上传和管理

/activities

对广告帐户的操作日志

/adtags

广告帐户中的一系列标签。用于标记相似的广告系列、广告组或广告

/adcampaignconversions

广告帐户中按广告组累计的转化数据

/adgroupconversions

广告帐户中按广告累计的转化数据

/customaudiences

广告帐户的自定义受众。这类受众可帮助您定位已与您的业务建立联系的用户群,以便向他们投放广告

/generatepreviews

生成广告预览

/offsitepixels

与此帐户关联的像素

/reachestimate

为使用特定定位参数的广告生成预估的覆盖人数

/reportstats

报告 API 可获取广告帐户数据并向您定期发送报告

/adcampaignstats

广告帐户中按广告组累计的一组统计数据

/adgroupstats

广告帐户中按广告累计的一组统计数据

/targetingsentencelines

生成人类可读的广告组定位说明

/users

与广告帐户关联的用户列表

/insights

成效分析界面。删除子对象的重复数据,提供整理好的异步报告。

广告系列

连线

连线 表示的含义

/adsets

包含使用同一预算、排期、竞价和定位条件的所有广告。

/ads

广告的必要数据,例如创意装饰元素和成效衡量信息

/adtags

广告系列标签。用于轻松查找相似的广告系列

返回按广告系列累计的一组统计数据

/insights

成效分析界面。功能包括删除子对象的重复数据,提供整理好的异步报告。

广告组

连线

连线 表示的含义

/ads

广告的必要数据,例如创意装饰元素和成效衡量信息

/adcreatives

定义广告的内容和展示效果

/activities

对广告组的操作日志

/adtags

广告组标签。用于轻松查找相似的广告组

/conversions

广告组的转化数据

/insights

成效分析界面。功能包括删除子对象的重复数据,提供整理好的异步报告。

连线

连线 表示的含义

/adcreatives

定义广告的展示效果和内容

/adtags

广告标签。用于查找相似广告

/conversions

广告的转化数据

/keywordstats

返回每个广告定位关键词的统计数据

/previews

通过现有广告生成广告预览

/reachestimate

获得广告的预估覆盖人数

广告的一组统计数据

/targetingsentencelines

获取人类可读的广告组定位说明

/trackingtag

为广告分配点击追踪标签。点击追踪标签可用于指定用户点击广告时触发的网址。

/insights

成效分析界面。功能包括删除子对象的重复数据,提供整理好的异步报告。

广告创意

连线

连线 表示的含义

/previews

通过现有的广告创意对象生成广告预览