Reglas de audiencia

Las reglas de audiencia determinan si una persona se añade a tu audiencia personalizada. Las reglas se aplican en la URL de referencia o en eventos y datos específicos.

Proporciona las reglas como cadenas con codificación JSON con la siguiente estructura:

Utiliza las reglas de audiencia para distintos tipos de audiencias personalizadas, incluidas las audiencias personalizadas de sitios web, las audiencias personalizadas de aplicaciones para móviles y las audiencias personalizadas fuera de internet. En el caso de las reglas de audiencia de interacción, consulta Audiencias personalizadas de interacción.

Limitaciones

  • Cada audiencia puede especificar hasta diez reglas en la regla de audiencia. Esto incluye el número de rules de inclusions o exclusions.
  • Cada regla puede especificar hasta 100 filtros, que se conocen como nodos de hoja.

Sintaxis de las reglas de audiencia

Para definir una regla de audiencia, se debe seguir la estructura siguiente:

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

Campos disponibles

Nombre Descripción

inclusions

Tipo: cadena

Obligatorio.

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

exclusions

Tipo: cadena

Obligatorio.

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 u or.

rules

Tipo: cadena

Obligatorio.

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

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

Para cada regla de inclusión y 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. No obstante, la edición de aggregation y retention_seconds no eliminará la audiencia. Las personas que solo coincidan con el agregado o la regla anterior seguirán estando en la audiencia hasta que caduquen.

Campos disponibles

Nombre Descripción

event_sources

Tipo: cadena

Obligatorio.

Objeto JSON que contiene los valores de id y type.


Se pueden añadir más orígenes de eventos a type mediante una lista delimitada por comas "store_visits,pixel,app".

retention_seconds

Tipo: entero

Obligatorio.

Entero (en segundos) para el intervalo de retención de la audiencia; debe ser menor que retention_days. Mínimo = 1. Máximo = 365 días.

filter

Tipo: cadena

Obligatorio.

Cadena JSON de las reglas de filtros. Consulta Filtros.

aggregation

Tipo: entero

Opcional.

Cadena JSON de las funciones de agregado. Consulta Funciones de agregado.

Filtros

La filtración sigue este formato general:

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

Campos disponibles

Nombre Descripción

operator

Tipo: cadena

Obligatorio.

and u or.

filters

Tipo: cadena

Obligatorio.

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

Sintaxis del conjunto de filtros

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

Campos disponibles

Nombre Descripción

field

Tipo: cadena

Obligatorio.


  • En el caso de las audiencias personalizadas de sitios web, usa 'event' si el filtro es para especificar un evento. Parámetros que hacen coincidir eventos enviados por el píxel (por ejemplo, 'ViewContent', 'Purchase').
  • En el caso de las audiencias personalizadas de aplicaciones para móviles, usa 'event' si el filtro es para especificar un evento. Parámetros que hacen coincidir 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 se establece en event, se debe usar =.

value

Tipo: cadena

Obligatorio.

Si el atributo field se establece en "event", value se debe establecer en un nombre de evento. Utiliza la API de eventos de la aplicación para ver los eventos de la aplicación y los parámetros de los que informa la aplicación.

Funciones de agregado

Crea audiencias personalizadas basadas en la frecuencia y la intensidad del comportamiento mediante aggregation en el campo de la regla de la audiencia. De esta forma, defines una función de agregado; por ejemplo:

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

Campos disponibles

Nombre Descripción

type

Tipo: cadena

Obligatorio.

Tipo de función de agregado.

  • En el caso de las audiencias personalizadas de sitios web, están disponibles las siguientes funciones: 'count', 'sum', 'avg', 'min', 'max', 'time_spent' y 'last_event_time_field'.
  • En el caso de las audiencias personalizadas de aplicaciones para móviles, están disponibles las siguientes funciones: "count", "sum", "avg", "min" y "max".

config

Obligatorio para ciertos tipos de funciones de agregado.

method

Tipo: cadena

Opcional.

"absolute", que añade personas que han registrado eventos en el rango especificado, o "percentile", que añade personas de un rango de percentil especificado. Si seleccionas percentile, el operador solo debe ser in_range y not_in_range.

field

Tipo: cadena

Obligatorio a menos que el tipo sea count.

Parámetro al que se aplica la función de agregado.

operator

Tipo: cadena

Obligatorio.

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

value

Tipo: cadena

Obligatorio.

Valor previsto del parámetro.

Por ejemplo:

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

Operadores de comparación

Operador Descripción

> o gt

Verdadero si el valor del parámetro del evento es mayor que el valor especificado.

>= o gte

Verdadero si el valor del parámetro del evento es mayor o igual que el valor especificado.

< o lt

Verdadero si el valor del parámetro del evento es menor que el valor especificado.

<= o lte

Verdadero si el valor del parámetro del evento es menor o igual que el valor especificado.

= o eq

Verdadero si el valor del parámetro del evento es igual que el valor especificado. Nota: Equivale a no especificar ningún operador; es decir, “'x' : { 'eq' : 'y' }” es lo mismo que “'x' : 'y' }”.

!= o neq

Verdadero si el valor del parámetro del evento no es igual que el valor especificado.

contains

Verdadero si el valor del parámetro del evento, como cadena, contiene la cadena especificada. El valor “shoe12345” cumple con “contains” si se ha especificado el valor “shoe”.

not_contains

Verdadero si el valor del parámetro del evento, como cadena, no contiene la cadena especificada. El valor “shoe12345” cumple con “not_contains” si el valor especificado es “purse”.

i_contains

Contiene (no distingue entre mayúsculas y minúsculas).

i_not_contains

No contiene (no distingue entre mayúsculas y minúsculas).

is_any

Verdadero si el valor del parámetro del evento coincide con cualquier cadena de la matriz proporcionada.

is_not_any

Verdadero si el valor del parámetro del evento no coincide con ninguna cadena de la matriz proporcionada.

i_is_any

“is_any” (no distingue entre mayúsculas y minúsculas).

i_is_not_any

“is_not_any” (no distingue entre mayúsculas y minúsculas).

starts_with

Verdadero si el valor del parámetro del evento empieza por la cadena proporcionada.

i_starts_with

“starts_with” (no distingue entre mayúsculas y minúsculas).

regex_match

Hace coincidir una expresión habitual, como \"example\.com.*purchase$\". Se admite toda la gramática de PCRE.

Ejemplos

Audiencias personalizadas de sitios web

Hace coincidir todas las URL de referencia que contienen la cadena “shoes” de 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 ViewContent en los que el precio del artículo es mayor o igual que 100 USD de los últimos 30 días. Considera la posibilidad de usar esta regla para el evento siguiente:

_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"
                                }
                            ]
                        }
                    ]
                }
            }
        ]
    }
}

Audiencias personalizadas de aplicaciones para móviles

Consulta Audiencias personalizadas de aplicaciones para móviles, Ejemplo de reglas de audiencias personalizadas.

Operadores y datos o eventos

Las reglas presentan los operadores y datos o eventos siguientes:

Operadores Tipo de filtro

i_contains

Contiene la subcadena (no distingue entre mayúsculas y minúsculas).

i_not_contains

No contiene la subcadena (no distingue entre mayúsculas y minúsculas).

contains

Contiene la subcadena (distingue entre mayúsculas y minúsculas).

not_contains

No contiene la subcadena (distingue entre mayúsculas y minúsculas).

eq

Igual a (distingue entre mayúsculas y minúsculas).

neq

No es igual a (distingue entre mayúsculas y 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

Hace coincidir una expresión habitual, como \"example\\.com.*purchase$\". Se admite toda la gramática de 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 objeto event del píxel, como 'ViewContent'.

device_type

Dispositivo que ha accedido al sitio:

desktop

mobile_android_phone

mobile_android_tablet

mobile_ipad

mobile_ipod

mobile_iphone

mobile_tablet

mobile_windows_phone

Cualquier campo de customData

Cualquier campo añadido 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.