市场营销 API

细分定位

通过定位搜索，您可以在单个 API 调用中查找一种定位类型的定位设置。借助细分定位 API，您可以在一个请求中同时搜索多种定位类型，还可以获得系统针对自己的查询所提供的建议。

细分定位 API 有四个端点：搜索、建议、浏览和验证。

这些端点的响应包含以下内容：

名称 描述

id

类型：字符串

目标受众的编号

name

类型：字符串

目标受众的名称

audience_size_lower_bound

整数

目标受众规模的预估值下限

audience_size_upper_bound

整数

目标受众规模的预估值上限

path

类型：字符串数组

包括定位隶属的类别及任何父类别

description

类型：字符串

有关目标受众的简短描述

如果您不提供 limit_type，对于不足 2,000 人的结果，我们会按以下四个类别进行筛选：work_employers、work_positions、education_majors、education_schools。否则，您得到的结果就没那么有意义。如果您使用 limit_type，我们会筛选出这四个类别中的一个类别，而不会返回所有这些类别。

为您的广告检索符合搜索查询的目标受众。您可以在此端点提供以下参数：

curl -G \
-d "q=harvard" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsearch
名称 描述

q

类型：字符串

必要。

查询字符串

limit

类型：整数

可选。

结果的数量

limit_type

类型：字符串

可选。

限制要检索的受众类型。默认为所有类型。

有效值包括：

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

类型：字符串

可选。

显示受众名称和描述时要使用的语言（如有）。默认为广告账户的语言

建议

返回您根据自己提供的几个选定受众可定位的更多受众。

curl -G \
-d "targeting_list=[{'type':'interests','id':6003263791114}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsuggestions

提供以下参数：

名称 描述

targeting_list

类型：{'type':'{TYPE}', 'id':{ID}} 数组

必要。

{'type':'{TYPE}', 'id':{ID}} 对的数组，作为建议的输入受众。

limit

类型：整数

可选。

结果的数量。默认值为 30。不得超过 45。

limit_type

类型：字符串

可选。

限制要检索的受众类型。默认为所有类型

有效值包括：

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

类型：字符串

可选。

显示受众名称和描述时要使用的语言。默认为广告账户的语言

浏览

使用一种结构化分类法来获取 Facebook 类别、第三方数据提供方和一些兴趣的定位设置。此端点返回的结果会显示在广告管理工具“细分定位用户界面”组件的“浏览”功能中。

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingbrowse

提供以下可选参数：

名称 描述

limit_type

类型：字符串

限制要检索的受众类型。默认为所有类型。

locale

类型：字符串

显示受众名称和描述时要使用的语言。默认为广告账户的语言

验证

验证某个受众是否对定位有效。如果您已创建广告组，并想确认其定位参数是否仍然有效，执行验证将有所帮助。如果定位无效，应将其从定位参数中删除。

curl -G \
-d "targeting_list=[{'type':'interests','id':6003283735711}, {'type':'relationship_statuses','id':100}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingvalidation

除了标准的细分定位响应字段外，此端点还会返回：

名称 描述

valid

类型：布尔值

定位受众是否有效

以下是输入参数清单：

名称 描述

targeting_list

类型：{'type':'{TYPE}', 'id':{ID}} 数组

用于验证的 {'type':'{TYPE}', 'id':{ID}} 对的数组。优先使用项。

id_list

类型：字符串数组

用于验证的编号数组。仅在某个编号在我们的受众数据库中是不重复的可识别标记时才能成功

name_list

类型：字符串数组

用于验证的字符串数组。仅限兴趣，不区分大小写

locale

类型：字符串

显示受众名称和描述时要使用的语言。默认为广告账户的语言

至少提供以下值之一：targeting_list、id_list 和 name_list。