Reglas del público

Estas reglas determinan si se agrega una persona al público personalizado. Las reglas se aplican a la URL de referencia o a eventos y datos específicos.

Proporciona tus reglas como cadenas con codificación JSON estructuradas así:

Usa reglas de público para diferentes tipos de públicos personalizados, incluso los públicos personalizados de sitio web, los públicos personalizados de apps para celulares y los públicos personalizados offline. Para las normas de público de interacción, consulta Públicos personalizados de interacción.

Limitaciones

  • Cada público puede especificar hasta 10 reglas en la regla de público. Eso incluye la cantidad de rules en inclusions o exclusions.
  • Cada regla puede especificar hasta 100 filtros, conocidos como nodos de hojas.

Sintaxis de reglas del público

Para definir una regla de público, debe seguirse la siguiente estructura:

rule: {
   "inclusions": <RULE_SET>,
   "exclusions": <RULE_SET>,
}

Campos disponibles

Nombre Descripción

inclusions

Tipo: cadena

Obligatorio.

La cadena JSON del conjunto de reglas que define la inclusión. Consulta Sintaxis del conjunto de reglas.

exclusions

Tipo: cadena

Obligatorio.

La cadena JSON del conjunto de reglas que define la exclusión. Consulta Sintaxis del conjunto de reglas.

Sintaxis del conjunto de reglas

Para cada conjunto de reglas, sigue esta estructura:

{
  "operator" : <BOOLEAN_OPERATOR>,
  "rules" : <JSON_RULE>,
}

Campos disponibles

Nombre Descripción

operator

Tipo: cadena

Obligatorio.

and o or.

rules

Tipo: cadena

Obligatorio.

Cadena JSON de reglas (matriz de reglas) Consulta Sintaxis de reglas de exclusión.

Sintaxis de las reglas de inclusión y exclusión

Para cada regla de inclusión o exclusión, sigue esta estructura:

{
  "event_sources" : <EVENT_SOURCE_DEFINITION>, 
  "retention_seconds" : <SECONDS>,
  "filter" : <FILTER>,
  "aggregation" : <AGGREGATION>, 
}

Los campos aggregation y retention_seconds se pueden editar. Sin embargo, si se editan aggregation y retention_seconds, no se eliminará el público. Las personas que solo coincidan con la antigua regla/agregación seguirán estando en el público hasta su caducidad.

Campos disponibles

Nombre Descripción

event_sources

Tipo: cadena

Obligatorio.

Objeto JSON que contiene id y type.


Pueden agregarse más orígenes de eventos a type usando una lista delimitada por comas "store_visits,pixel,app".

retention_seconds

Tipo: entero

Obligatorio.

Entero (en segundos) para el intervalo de retención del público, debe ser inferior a retention_days. Mín.=1; Máx.=365 días

filter

Tipo: cadena

Obligatorio.

Cadena JSON de las reglas de filtro. Consulta Filtros.

aggregation

Tipo: entero

Opcional.

Cadena JSON de las funciones de agregación. Consulta Funciones de agregación.

Filtros

El filtrado sigue este formato:

"filter" : {
  "operator": <BOOLEAN_OPERATOR>,
  "filters": <FILTER_SET>,
  }

Campos disponibles

Nombre Descripción

operator

Tipo: cadena

Obligatorio.

and o or

filters

Tipo: cadena

Obligatorio.

Matriz de objetos JSON de las reglas de filtro. Consulta Sintaxis de reglas de filtros.

Sintaxis del conjunto de filtros

{
    "field": <FIELD>,
    "operator": <COMPARISON_OPERATOR>,
    "value": <VALUE>,
}

Campos disponibles

Nombre Descripción

field

Tipo: cadena

Obligatorio.


  • Para Públicos personalizados de sitio web, utiliza 'event' si el filtro debe especificar un evento. Parámetros que coinciden con eventos enviados por píxel (por ejemplo, 'ViewContent', 'Purchase').
  • Para Públicos personalizados de apps para celulares, utiliza 'event' si el filtro debe especificar un evento. Parámetros que coinciden con eventos de la aplicación enviados por la aplicación, por ejemplo, "_appVersion", "_value", etc.

operator

Tipo: cadena

Obligatorio.

  • =
  • !=
  • >=
  • >
  • <=
  • <
  • i_contains
  • i_not_contains
  • contains
  • not_contains
  • is_any
  • is_not_any
  • i_is_any
  • i_is_not_any
  • i_starts_with
  • starts_with
  • "regex_match"[INFO]

Si field es event, es necesario =.

value

Tipo: cadena

Obligatorio.

Si el atributo field se define como "event", value debe definirse con el nombre de un evento. Utiliza la API de eventos de la app para ver eventos y parámetros de la app reportados por la app.

Funciones de agregación

Puedes crear públicos personalizados según la frecuencia y la intensidad del comportamiento mediante la regla aggregation en el campo de reglas de público. De esta manera, defines una función de agregación. Por ejemplo:

"aggregation" : {
  "type":"count",
  "operator":">",
  "value":1
}

Campos disponibles

Nombre Descripción

type

Tipo: cadena

Obligatorio.

El tipo de función de agregación.

  • Para públicos personalizados de sitio web, se encuentran disponibles las siguientes funciones: 'count', 'sum', 'avg', 'min', 'max', 'time_spent' y 'last_event_time_field'.
  • Para públicos personalizados de apps para celulares, se encuentran disponibles las siguientes funciones: "count","sum", "avg", "min" y "max".

config

Necesario para determinados tipos de funciones de agregación.

method

Tipo: cadena

Opcional.

"absolute", es decir, agrega personas que registraron eventos en un rango especificado, o "percentile", es decir, agrega personas de un rango de percentil especificado. Si seleccionas la opción percentile, el operador solo puede ser in_range o not_in_range.

field

Tipo: cadena

Obligatorio, a menos que el tipo sea count.

El parámetro al cual se aplica la función de agregación.

operator

Tipo: cadena

Obligatorio.

=, !=, >=, >, <=, <, in_range, not_in_range

value

Tipo: cadena

Obligatorio.

Valor esperado del parámetro.

Por ejemplo:

"aggregation" : {
  "type":"count",
  "operator":">",
  "value":1
}

Operadores de comparación

Operador Descripción

> o gt

Es verdadero (true) si el valor del parámetro del evento es mayor que el valor especificado.

>= o gte

Es verdadero (true) si el valor del parámetro del evento es mayor o igual que el valor especificado.

< o lt

Es verdadero (true) si el valor del parámetro del evento es menor que el valor especificado.

<= o lte

Es verdadero (true) si el valor del parámetro del evento es menor o igual que el valor especificado.

= o eq

Es verdadero (true) si el valor del parámetro del evento es igual que el valor especificado. Nota: Esto equivale a no especificar ningún operador; es decir, que "'x' : { 'eq' : 'y' }" es lo mismo que "'x' : 'y' }.

!= o neq

Es verdadero (true) si el valor del parámetro del evento no es igual que el valor especificado.

contains

Es verdadero (true) si el valor del parámetro del evento, como cadena, contiene la cadena especificada. El valor de "shoe12345" cumple con "contains" si el valor especificado es "shoe".

not_contains

Es verdadero (true) si el valor del parámetro del evento, como cadena, no contiene la cadena especificada. El valor de "shoe12345" cumple con "not_contains" si el valor especificado es "purse".

i_contains

Contiene, no distingue mayúsculas de minúsculas

i_not_contains

No contiene, no distingue mayúsculas de minúsculas

is_any

Es verdadero (true) si el valor del parámetro del evento coincide con alguna de las cadenas de una matriz específica.

is_not_any

Es verdadero (true) si el valor del parámetro del evento no coincide con ninguna de las cadenas de una matriz específica.

i_is_any

"is_any", no distingue mayúsculas de minúsculas

i_is_not_any

"is_not_any", no distingue mayúsculas de minúsculas

starts_with

"Verdadero" si el valor del parámetro del evento que comienza con la cadena proporcionada

i_starts_with

"starts_with", no distingue mayúsculas de minúsculas

regex_match

Coincide con una expresión regular, como \"example\.com.*purchase$\". Admite la gramática completa PCRE.

Ejemplos

Públicos personalizados de sitio web

Hacer coincidir todas las URL de referencia que contengan la cadena "shoes" en los últimos 30 días:

{
    "inclusions": {
        "operator": "or",
        "rules": [
            {
                "event_sources": [
                    {
                        "type": "pixel",
                        "id": "<PIXEL_ID>",
                    }
                ],
                "retention_seconds": 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "url",
                            "operator": "i_contains",
                            "value": "shoes"
                        }
                    ]
                },
            }
        ]
    }
}

Hacer coincidir los eventos de ViewContent donde el precio del artículo sea mayor o igual que 100 USD en los últimos 30 días: Considera usar esta regla para el siguiente evento:

_fbq.push([ 'track', 'ViewContent', { productId: 1234, category: 'Men > Shoes', price: 199 } ]);
{
    "inclusions": {
        "operator": "or",
        "rules": [
            {
                "event_sources": [
                    {
                        "type": "pixel",
                        "id": "<PIXEL_ID>"
                    }
                ],
                "retention_seconds": 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "eq",
                            "value": "ViewContent"
                        },
                        {
                            "operator": "or",
                            "filters": [
                                {
                                    "field": "price",
                                    "operator": ">=",
                                    "value": "100"
                                }
                            ]
                        }
                    ]
                }
            }
        ]
    }
}

Públicos personalizados de apps para celulares

Consulta Públicos personalizados de apps para celulares, Ejemplos de reglas de públicos personalizados.

Operadores y datos o eventos

Las reglas tienen los siguientes operadores y datos o eventos:

Operadores Tipo de filtro

i_contains

Contiene subcadena (no distingue mayúsculas de minúsculas)

i_not_contains

No contiene subcadena (no distingue mayúsculas de minúsculas)

contains

Contiene subcadena (distingue mayúsculas de minúsculas)

not_contains

No contiene subcadena (distingue mayúsculas de minúsculas)

eq

Igual a (distingue mayúsculas de minúsculas)

neq

Distinto de (distingue mayúsculas de minúsculas)

lt

Menor que (solo campos numéricos)

lte

Menor o igual que (solo campos numéricos)

gt

Mayor que (solo campos numéricos)

gte

Mayor o igual que (solo campos numéricos)

regex_match

Coincide con una expresión regular, como \"example\\.com.*purchase$\". Admite la gramática completa PCRE.

Datos Datos que se filtran

url

URL con escape completo del sitio visitado.

domain

Dominio del sitio visitado.

path

Ruta del sitio visitado sin el dominio.

event

Nombre del event del píxel, como 'ViewContent'.

device_type

Dispositivo que accedió al sitio:

desktop

mobile_android_phone

mobile_android_tablet

mobile_ipad

mobile_ipod

mobile_iphone

mobile_tablet

mobile_windows_phone

any customData field

Cualquier campo agregado a customData para las activaciones del píxel, como productId, category y price.

Proporciona cada una de las reglas como una cadena con codificación JSON.