评估参数筛选条件

在排期类规则中,可以使用更高级的筛选条件字段类型。

带前缀的成效分析字段

您可以为成效分析筛选条件设置特定类型的前缀。这种前缀与为元数据筛选条件设置的前缀类似,可用于执行多层级筛选。

您可以在筛选条件中设置对象层级前缀,以利用成效分析多层级筛选功能。例如,您可以按广告组或广告系列表现筛选广告规则。您也可以在筛选条件中指定统计时间窗前缀和时间预设前缀。这可用于覆盖此特定筛选条件的广告规则统计时间窗和时间预设。

用途

前缀为可选项。一个字段可以包含以下前缀:

  • 1 个对象层级前缀
  • 1 个统计时间窗前缀
  • 1 个时间预设前缀

字段可以同时包含所有上述前缀、不包含任何前缀,或使用任何前缀组合,只要保持上述顺序即可。字段应采用以下格式:

{ object_level_prefix? } {attribution_window_prefix?} { time_preset_prefix? } { field_name }

请在下方查看带前缀成效分析字段的正确和错误示例。我们还提供带前缀元数据字段的正确和错误示例,以展示我们支持的元数据筛选条件。

spent 成效分析字段示例
正确示例

adset.yesterday_spent:昨天广告组层级的已花费金额总数

adset.spent:广告组层级的已花费金额总数

yesterday_spent:昨天的已花费金额总数

campaign.28d_view_1d_click:lifetime_results:广告组层级在整个投放期内的总成效,统计时间窗为浏览后 28 天内和点击后 1 天内

campaign.lifetime_spent:广告系列层级在整个投放期内的已花费金额总数

错误示例

lifetime_campaign.spent:时间预设前缀不能位于对象层级前缀之前

lifetime_today_spent:不能有两个时间预设前缀

ad.adset.spent:不能有 2 个对象层级前缀

yesterday.adset_spent:分隔符错误


daily_budget 元数据字段示例
正确示例

adset.daily_budget:广告组的单日预算

daily_budget:单日预算

错误示例

yesterday_daily_budget:不能在元数据字段中使用时间预设前缀

ad.daily_budget:广告不含单日预算

对象层级前缀

前缀对象类型适用的对象类型

ad.

广告

广告

adset.

广告组

广告、广告组

campaign.

广告系列

广告、广告组、广告系列

统计时间窗前缀

统计时间窗前缀 描述

account_default:

使用账户层级统计时间窗设置

default:

Facebook 默认的统计时间窗为浏览后 1 天和点击后 28 天

inline:

仅限内联归因(0 天浏览量、0 天点击量)

1d_view:

浏览后 1 天和点击 0 天

7d_view:

浏览后 7 天和点击 0 天

28d_view:

浏览后 28 天和点击 0 天

1d_click:

浏览后 0 天和点击 1 天

7d_click:

浏览后 0 天和点击 7 天

28d_click:

浏览后 0 天和点击 28 天

1d_view_1d_click:

浏览后 1 天和点击 1 天

7d_view_1d_click:

浏览后 7 天和点击 1 天

28d_view_1d_click:

浏览后 28 天和点击 1 天

1d_view_7d_click:

浏览后 1 天和点击 7 天

7d_view_7d_click:

浏览后 7 天和点击 7 天

28d_view_7d_click:

浏览后 28 天和点击 7 天

7d_view_28d_click:

浏览后 7 天和点击 28 天

28d_view_28d_click:

浏览后 28 天和点击 28 天

时间预设前缀

此列表与有效时间预设值列表相同,但使用的是小写形式,而且末尾附加分隔符。

前缀 描述

lifetime_

对象的投放期

today_

当天,从广告账户所在时区的午夜开始计算

last_2_days_

YESTERDAYTODAY

last_3_days_

过去整整 2 天和 TODAY

last_7_days_

过去整整 6 天和 TODAY

last_14_days_

过去整整 13 天和 TODAY

last_28_days_

过去整整 27 天和 TODAY

last_30_days_

过去整整 29 天和 TODAY

this_month_

本月,包含 TODAY

this_week_mon_today_

本周,以周一作为一周的第一天,包括 TODAY

this_week_sun_today

本周,以周日作为一周的第一天,包括 TODAY

yesterday_

过去整整 1 天,不包括 TODAY

last_2d_

过去整整 2 天,不包括 TODAY

last_3d_

过去整整 3 天,不包括 TODAY

last_7d_

过去整整 7 天,不包括 TODAY

last_14d_

过去整整 14 天,不包括 TODAY

last_28d_

过去整整 28 天,不包括 TODAY

last_30d_

过去整整 30 天,不包括 TODAY

last_nd_14_8_

14 天前到 7 天前,适用于广告花费回报 (ROAS)

last_nd_30_8_

30 天前到 7 天前,适用于广告花费回报 (ROAS)

last_nd_60_8_

60 天前到 7 天前,适用于广告花费回报 (ROAS)

last_nd_120_8_

120 天前到 7 天前,适用于广告花费回报 (ROAS)

last_nd_180_8_

180 天前到 7 天前,适用于广告花费回报 (ROAS)

last_nd_lifetime_8_

从开始投放到 7 天前,适用于广告花费回报 (ROAS)

last_nd_60_29_

60 天前到 28 天前,适用于广告花费回报 (ROAS)

last_nd_120_20_

120 天前到 28 天前,适用于广告花费回报 (ROAS)

last_nd_180_29_

180 天前到 28 天前,适用于广告花费回报 (ROAS)

last_nd_lifetime_29_

从开始投放到 28 天前,适用于广告花费回报 (ROAS)

汇总

您可以汇总多个广告对象的部分成效分析字段。通过此操作,您可以针对特定广告对象子集的指标创建筛选条件。例如,多个广告的总覆盖人数或不同广告组的总点击量。

虽然部分指标(如 clicks)是使用简单求和的方式计算,但其他指标(如 reach)的计算方式则有所不同。由于 reach 基于独立展示次数,系统将在对多个广告对象进行汇总时移除重复用户。

用途

汇总字段采用的形式为 aggregate({ field })field 可以包含统计时间窗和时间预设前缀。要汇总的不同广告对象将由另外一个必要的筛选条件字段 aggregation_id 决定。

汇总字段示例

正确示例

aggregate(reach)

aggregate(lifetime_reach)

错误示例

aggregate(daily_budget)

aggregate(adset.reach)

汇总编号筛选条件

aggregation_id 筛选条件用于指定要汇总的广告对象。此筛选条件仅支持 IN 运算符,并且仅支持使用编号列表作为其值。这些编号可以是广告编号、广告组编号或广告系列编号,但所有编号必须属于相同的对象层级。

aggregation_id 筛选条件示例

{
  "field": "aggregation_id",
  "operator": "IN",
  "value": [1234, 5678]
},
{
  "field": "aggregate(reach)",
  "operator": "GREATER_THAN",
  "value": 100
}

支持的字段

  • clicks
  • cpc
  • cpm
  • cpp
  • ctr
  • frequency
  • impressions
  • mobile_app_purchase_roas
  • reach
  • result_rate
  • spent
  • unique_clicks
  • unique_impressions
  • website_purchase_roas
  • cost_per_unique_click

公式字段

您可以将简单的算术表达式设置为一个字段。例如,公式字段可用于确定两个数值字段之间的比率。

这适用于成效分析字段和数值元数据字段的子集。以下是受支持字段的完整列表。

用途

公式字段由字段(或常数)以及语法正确的运算符组成,不同项之间使用空格分隔。这类字段支持的运算符包括 +-*/。例如,您可以添加常数来计算特定字段的权重或作为偏移量。

在这种情况下,您可以为这类字段添加完整前缀,以便添加有效的对象层级和时间预设前缀。

我们目前允许在一个公式中最多添加 6 个非常数字段。您可以根据需要添加任意数量的常数。

today_spent / adset.today_spent

0.8 * cpc + 0.2 * cpm

{ field_or_constant_1 } { + | - | * | / } { field_or_constant_2 }

公式示例

正确示例

today_spent / adset.daily_budget:单日花费百分比

clicks / adset.clicks:点击量与广告组点击量的比率

today_impressions / yesterday_impressions:今日展示次数与昨日展示次数的比率

today_impressions / aggregate(today_impressions):今日展示次数与汇总展示次数的比率

(adset.spent - spent):可以使用括号;在 API 响应中接收公式时,系统将为这类公式添加括号

错误示例

(clicks + cpc + cpm + ctr + cpa + cpp) / cost_per:使用的字段数量不能超过 6

today_impressions/yesterday_impressions:不同项之间必须使用空格分隔

有效的数值元数据字段

字段适用的对象类型

bid_amount

广告、广告组

daily_budget

广告组

lifetime_budget

广告组

spend_cap

广告系列