Filtros de la especificación de evaluación

En las reglas basadas en programaciones, es posible usar tipos más avanzados de campos de filtros.

Campos de insights con prefijos

Puedes establecer tipos específicos de prefijos para los filtros de insights. Esto es similar a los prefijos que se establecen para los filtros de metadatos con el fin de filtrar en varios niveles.

Puedes establecer un prefijo de nivel de objeto en un filtro para usar la filtración de varios niveles de insights. Por ejemplo, una regla de anuncios se puede filtrar por el rendimiento del conjunto de anuncios o la campaña publicitaria. También puedes especificar prefijos de intervalo de atribución y valor predefinido de tiempo en un filtro. Esto se usa para anular el intervalo de atribución y el valor predefinido de tiempo de la regla para este filtro concreto.

Uso

Los prefijos son opcionales. Un campo puede tener:

  • Un prefijo de nivel de objeto.
  • Un prefijo de intervalo de atribución.
  • Un prefijo de valor predefinido de tiempo.

Puedes tener todas las opciones anteriores, ninguna o una combinación de ellas siempre y cuando sigan ese orden. El campo debe tener el siguiente formato:

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

Consulta a continuación ejemplos de campos de insights prefijados correcta e incorrectamente. También proporcionamos ejemplos de campos de metadatos prefijados correcta e incorrectamente para mostrar los filtros de metadatos que admitimos.

Ejemplos para el campo de insights spent
Ejemplos correctos

adset.yesterday_spent: importe total gastado ayer en el nivel de conjunto de anuncios.

adset.spent: importe total gastado en el nivel de conjunto de anuncios.

yesterday_spent: importe total gastado ayer.

campaign.28d_view_1d_click:lifetime_results: total de resultados en el nivel de conjunto de anuncios durante su ciclo de vida, con el intervalo de atribución de 28 días después de la visualización y un día después del clic.

campaign.lifetime_spent: importe total gastado en el nivel de campaña de anuncios durante su ciclo de vida.

Ejemplos incorrectos

lifetime_campaign.spent: los prefijos de valor predefinido de tiempo no pueden preceder a los prefijos de nivel de objeto.

lifetime_today_spent: no puede haber dos prefijos de valor predefinido de tiempo.

ad.adset.spent: no puede haber dos prefijos de nivel de objeto.

yesterday.adset_spent: delimitador incorrecto.


Ejemplos para el campo de metadatos daily_budget
Ejemplos correctos

adset.daily_budget: presupuesto diario del conjunto de anuncios.

daily_budget: presupuesto diario.

Ejemplos incorrectos

yesterday_daily_budget: no se pueden usar prefijos de valor predefinido de tiempo en los campos de metadatos.

ad.daily_budget: los anuncios no tienen un presupuesto diario.

Prefijos de nivel de objeto

PrefijoTipo de objetoVálido en tipos de objetos

ad.

Anuncio

Anuncio

adset.

Conjunto de anuncios

Anuncio, conjunto de anuncios

campaign.

Campaña

Anuncio, conjunto de anuncios, campaña

Prefijos de intervalo de atribución

Prefijo de intervalo de atribución Descripción

account_default:

Usa la configuración de intervalo de atribución de nivel de cuenta.

default:

El intervalo de atribución predeterminado de Facebook es un día después de la visualización y 28 días después del clic.

inline:

Solo atribución insertada (cero días después de la visualización, cero días después del clic).

1d_view:

Un día después de la visualización, cero días después del clic.

7d_view:

Siete días después de la visualización, cero días después del clic.

28d_view:

28 días después de la visualización, cero días después del clic.

1d_click:

Cero días después de la visualización, un día después del clic.

7d_click:

Cero días después de la visualización, siete días después del clic.

28d_click:

Cero días después de la visualización, 28 días después del clic.

1d_view_1d_click:

Un día después de la visualización, un día después del clic.

7d_view_1d_click:

Siete días después de la visualización, un día después del clic.

28d_view_1d_click:

28 días después de la visualización, un día después del clic.

1d_view_7d_click:

Un día después de la visualización, siete días después del clic.

7d_view_7d_click:

Siete días después de la visualización, siete días después del clic.

28d_view_7d_click:

28 días después de la visualización, siete días después del clic.

7d_view_28d_click:

Siete días después de la visualización, 28 días después del clic.

28d_view_28d_click:

28 días después de la visualización, 28 días después del clic.

Prefijos de valor predefinido de tiempo

Esta lista es la misma que la de valores predefinidos de tiempo válidos, pero en este caso están en minúsculas y se añade un delimitador.

Prefijo Descripción

lifetime_

Total del objeto.

today_

Día actual a partir de medianoche en la zona horaria de la cuenta publicitaria.

last_2_days_

YESTERDAY y TODAY.

last_3_days_

Últimos dos días completos y TODAY.

last_7_days_

Últimos seis días completos y TODAY.

last_14_days_

Últimos 13 días completos y TODAY.

last_28_days_

Últimos 27 días completos y TODAY.

last_30_days_

Últimos 29 días completos y TODAY.

this_month_

Este mes, TODAY incluido.

this_week_mon_today_

Esta semana con el lunes como primer día de la semana, TODAY incluido.

this_week_sun_today

Esta semana con el domingo como primer día de la semana, TODAY incluido.

yesterday_

Día anterior completo, TODAY excluido.

last_2d_

Últimos dos días completos, TODAY excluido.

last_3d_

Últimos tres días completos, TODAY excluido.

last_7d_

Últimos siete días completos, TODAY excluido.

last_14d_

Últimos 14 días completos, TODAY excluido.

last_28d_

Últimos 28 días completos, TODAY excluido.

last_30d_

Últimos 30 días completos, TODAY excluido.

last_nd_14_8_

De los últimos 14 días a los últimos siete días, para ROAS.

last_nd_30_8_

De los últimos 30 días a los últimos siete días, para ROAS.

last_nd_60_8_

De los últimos 60 días a los últimos siete días, para ROAS.

last_nd_120_8_

De los últimos 120 días a los últimos siete días, para ROAS.

last_nd_180_8_

De los últimos 180 días a los últimos siete días, para ROAS.

last_nd_lifetime_8_

Total hasta los últimos siete días, para ROAS.

last_nd_60_29_

De los últimos 60 días a los últimos 28 días, para ROAS.

last_nd_120_20_

De los últimos 120 días a los últimos 28 días, para ROAS.

last_nd_180_29_

De los últimos 180 días a los últimos 28 días, para ROAS.

last_nd_lifetime_29_

Total hasta los últimos 28 días, para ROAS.

Agregación

Puedes agregar varios campos de insights de diversos objetos de anuncio. De esta forma, puedes crear filtros en métricas de un subconjunto específico de objetos de anuncio. Por ejemplo, el alcance total de varios anuncios o el número total de clics de varios conjuntos de anuncios diferentes.

Aunque algunas métricas como clicks se calculan con una suma sencilla, otras métricas como reach se calculan de forma diferente. Como reach se basa en impresiones únicas, los usuarios duplicados se quitan de la agregación de varios objetos de anuncio.

Uso

Un campo agregado adopta la forma de aggregate({ field }). field puede contener prefijos de intervalo de atribución y valor predefinido de tiempo. El conjunto de objetos de anuncio que se va a agregar se determina mediante otro campo de filtro obligatorio (aggregation_id).

Ejemplos de campos de agregación

Ejemplos correctos

aggregate(reach)

aggregate(lifetime_reach)

Ejemplos incorrectos

aggregate(daily_budget)

aggregate(adset.reach)

Filtro de identificador de agregación

El filtro aggregation_id especifica los objetos de anuncio que agregar. Solo admite el operador IN y una lista de identificadores como valor. Los identificadores pueden ser de anuncios, conjuntos de anuncios o campañas publicitarias, pero todos deben pertenecer al mismo nivel de objeto.

Ejemplo de filtro aggregation_id

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

Campos admitidos

  • 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

Campos de fórmula

Puedes establecer expresiones aritméticas sencillas en forma de campo. Por ejemplo, esto se puede usar para buscar la relación entre dos campos numéricos.

Funciona en campos de insights y en un subconjunto de campos de metadatos numéricos. A continuación se incluye la lista completa de valores admitidos.

Uso

Un campo de fórmula consta de campos o constantes y operadores correctos desde el punto de vista sintáctico que están separados por espacios. Admite los operadores +, -, * y /. Puedes añadir constantes, por ejemplo, para ponderar campos específicos o para actuar como desplazamientos.

En este caso, los campos pueden prefjarse completamente, por lo que puedes añadir prefijos válidos de valor predefinido de tiempo y de nivel de objeto.

Actualmente permitimos un máximo de 6 campos que no sean constantes en una fórmula. Puedes tener tantas constantes como quieras.

today_spent / adset.today_spent

0.8 * cpc + 0.2 * cpm

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

Ejemplos de fórmulas

Ejemplos correctos

today_spent / adset.daily_budget: gasto porcentual diario.

clicks / adset.clicks: relación entre los clics y los clics del conjunto de anuncios.

today_impressions / yesterday_impressions: relación entre el número de impresiones de hoy y el número de impresiones de ayer.

today_impressions / aggregate(today_impressions): relación entre el número de impresiones de hoy y un número agregado de impresiones.

(adset.spent - spent): se aceptan los paréntesis; al recibir fórmulas en las respuestas de la API, se incluirán entre paréntesis.

Ejemplos incorrectos

(clicks + cpc + cpm + ctr + cpa + cpp) / cost_per: no se pueden usar más de 6 campos.

today_impressions/yesterday_impressions: las condiciones se deben separar con espacios.

Campos de metadatos numéricos válidos

CampoVálido en tipos de objetos

bid_amount

Anuncio, conjunto de anuncios

daily_budget

Conjunto de anuncios

lifetime_budget

Conjunto de anuncios

spend_cap

Campaña