Filtros de especificaciones de evaluación

En las reglas basadas en programación, es posible usar tipos de campos de filtro más avanzados.

Campos de estadísticas predefinidos

Puedes configurar tipos específicos de prefijos vinculados a los filtros de estadísticas. Esta acción resulta similar a lo que sucede cuando se configuran los prefijos de los filtros de Meta con el fin de realizar un filtrado multinivel.

Puedes configurar un prefijo de nivel de objeto en un filtro para aprovechar el filtro de estadísticas multinivel. Por ejemplo, una regla de anuncios puede filtrarse por el rendimiento de los conjuntos de anuncios o la campaña publicitaria. También puedes especificar prefijos predefinidos de intervalo de atribución y tiempo en un filtro. Se usan para anular el valor predefinido de tiempo y el intervalo de atribución de la regla relacionados con este filtro en particular.

Uso

Los prefijos son opcionales. Un campo puede tener los siguientes elementos:

  • un prefijo de nivel de objeto
  • un prefijo de intervalo de atribución
  • un prefijo predefinido de tiempo

Puedes tener todas las opciones arriba indicadas, ninguna, o cualquier combinación, siempre y cuando las mantengas en ese orden. El campo debería tener el siguiente formato:

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

A continuación, verás ejemplos de campos predefinidos de estadísticas correctos e incorrectos. También proporcionamos ejemplos de campos de metadatos predefinidos correctos e incorrectos, para mostrar qué filtros de metadatos admitimos.

Ejemplos del campo de estadísticas spent
Ejemplos correctos

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

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

yesterday_spent: importe total gastado ayer

campaign.28d_view_1d_click:lifetime_results: resultados totales en el nivel del conjunto de anuncios durante su vida útil, 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 la campaña publicitaria durante su vida útil

Ejemplos incorrectos

lifetime_campaign.spent: los prefijos de tiempo predefinidos no pueden colocarse delante de los prefijos del nivel de objeto

lifetime_today_spent: no pueden coexistir dos prefijos de tiempo predefinidos

ad.adset.spent: no pueden coexistir dos prefijos en el nivel de objeto

yesterday.adset_spent: delimitador correcto


Ejemplos del campo de metadatos daily_budget
Ejemplos correctos

adset.daily_budget: presupuesto del conjunto de anuncios diario

daily_budget: presupuesto diario

Ejemplos incorrectos

yesterday_daily_budget: no es posible usar prefijos de tiempo predefinidos 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 relación con los tipos de objetos

ad.

Anuncio

Anuncio

adset.

Conjunto de anuncios

Anuncio, conjunto de anuncios

campaign.

Campaña

Anuncio, conjunto de anuncios, campaña

Prefijos del intervalo de atribución

Prefijo del intervalo de atribución Descripción

account_default:

Usar la configuración del intervalo de atribución en el nivel de la cuenta

default:

El intervalo de atribución predeterminado de Facebook es de 1 día para las visualizaciones y 28 días para los clics

inline:

Solo atribución en línea (0 días para las visualizaciones y para los clics)

1d_view:

1 día para las visualizaciones y 0 días para los clics

7d_view:

7 días para las visualizaciones y 0 días para los clics

28d_view:

28 días para las visualizaciones y 0 días para los clics

1d_click:

0 días para las visualizaciones y 1 día para los clics

7d_click:

0 días para las visualizaciones y 7 días para los clics

28d_click:

0 días para las visualizaciones y 28 días para los clics

1d_view_1d_click:

1 día para las visualizaciones y 1 día para los clics

7d_view_1d_click:

7 día para las visualizaciones y 1 día para los clics

28d_view_1d_click:

28 días para las visualizaciones y 1 día para los clics

1d_view_7d_click:

1 día para las visualizaciones y 7 días para los clics

7d_view_7d_click:

7 días para las visualizaciones y 7 días para los clics

28d_view_7d_click:

28 días para las visualizaciones y 7 días para los clics

7d_view_28d_click:

7 días para las visualizaciones y 28 días para los clics

28d_view_28d_click:

28 días para las visualizaciones y 28 días para los clics

Prefijos de tiempo predefinidos

Esta lista es la misma que la de valores predefinidos de tiempo válidos, pero hecha en minúscula y adjunta con un delimitador.

Prefijo Descripción

lifetime_

Vida útil del objeto

today_

El día actual comienza a la medianoche de la zona horaria de la cuenta publicitaria

last_2_days_

YESTERDAY y TODAY

last_3_days_

Últimos 2 días completos y TODAY

last_7_days_

Últimos 6 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, incluido TODAY

this_week_mon_today_

Esta semana, donde el lunes es el primer día de la semana, incluido TODAY

this_week_sun_today

Esta semana, donde el sábado es el primer día de la semana, incluido TODAY

yesterday_

El día anterior completo, con excepción de TODAY

last_2d_

Últimos 2 días completos, con excepción de TODAY

last_3d_

Últimos 3 días completos, con excepción de TODAY

last_7d_

Últimos 7 días completos, con excepción de TODAY

last_14d_

Últimos 14 días completos, con excepción de TODAY

last_28d_

Últimos 28 días completos, con excepción de TODAY

last_30d_

Últimos 30 días completos, con excepción de TODAY

last_nd_14_8_

De los últimos 14 días a los últimos 7 días, con fines de ROAS

last_nd_30_8_

De los últimos 30 días a los últimos 7 días, con fines de ROAS

last_nd_60_8_

De los últimos 60 días a los últimos 7 días, con fines de ROAS

last_nd_120_8_

De los últimos 120 días a los últimos 7 días, con fines de ROAS

last_nd_180_8_

De los últimos 180 días a los últimos 7 días, con fines de ROAS

last_nd_lifetime_8_

Vida útil a los últimos 7 días, con fines de ROAS

last_nd_60_29_

De los últimos 60 días a los últimos 28 días, con fines de ROAS

last_nd_120_20_

De los últimos 120 días a los últimos 28 días, con fines de ROAS

last_nd_180_29_

De los últimos 180 días a los últimos 28 días, con fines de ROAS

last_nd_lifetime_29_

Vida útil a los últimos 28 días, con fines de ROAS

Agregación

Puedes agregar algunos campos de estadísticas sobre varios objetos publicitarios. De esta manera, puedes crear filtros de métricas en relación con un subconjunto específico de objetos publicitarios. Por ejemplo, el alcance total respecto de varios anuncios o el número total de clics de diferentes conjuntos de anuncios.

Mientras que algunas métricas, como clicks, se calculan con una simple suma, otras métricas, como reach, se calculan de manera diferente. Dado que reach se basa en impresiones únicas, los usuarios duplicados se eliminan en la agregación respecto de múltiples objetos publicitarios.

Uso

Un campo agregado tiene la forma de aggregate({ field }). El field puede contener un intervalo de atribución y prefijos de tiempo predefinidos. El conjunto de objetos publicitarios que se agregará se determina en función de otro campo de filtro obligatorio aggregation_id.

Ejemplo de campos agregados

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 qué objetos publicitarios se agregarán. 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 ser del 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 configurar expresiones aritméticas simples como campo. Por ejemplo, puede usarse esta posibilidad para encontrar la proporción entre dos campos numéricos.

Esto funciona en los campos de estadísticas y en un subconjunto de campos numéricos de metadatos. A continuación, encontrarás una lista con todos los elementos admitidos.

Uso

Un campo de fórmula consiste en campos o constantes y operadores sintácticamente correctos separados por espacios. Admite los operadores +-* y /. Puedes agregar constantes; por ejemplo, para considerar campos específicos o para actuar como compensaciones.

Los campos de este caso pueden tener un prefijo completo, de modo que puedes agregar prefijos válidos predefinidos de tiempo y en el nivel de objeto.

Por el momento, permitimos un máximo de 6 campos sin constantes en una fórmula. Puedes agregar tantas constantes como quieras.

today_spent / adset.today_spent

0.8 * cpc + 0.2 * cpm

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

Ejemplo de fórmulas

Ejemplos correctos

today_spent / adset.daily_budget: porcentaje diario de gasto

clicks / adset.clicks: proporción de clics en comparación con los clics del conjunto de anuncios

today_impressions / yesterday_impressions: proporción del número de impresiones de hoy en comparación con el número de impresiones de ayer

today_impressions / aggregate(today_impressions): proporción del número de impresiones de hoy en comparación con el número agregado de impresiones

(adset.spent - spent): se aceptan paréntesis; si se reciben fórmulas en las respuestas de la API, se les colocará 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: los términos deben estar separados por espacios

Campos de metadatos numéricos válidos

CampoVálido en relación con los tipos de objetos

bid_amount

Anuncio, conjunto de anuncios

daily_budget

Conjunto de anuncios

lifetime_budget

Conjunto de anuncios

spend_cap

Campaña