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.
rules
en inclusions
o exclusions
.Para definir una regla de público, debe seguirse la siguiente estructura:
rule: { "inclusions": <RULE_SET>, "exclusions": <RULE_SET>, }
Nombre | Descripción |
---|---|
Tipo: cadena | Obligatorio. La cadena JSON del conjunto de reglas que define la inclusión. Consulta Sintaxis del conjunto de reglas. |
Tipo: cadena | Obligatorio. La cadena JSON del conjunto de reglas que define la exclusión. Consulta Sintaxis del conjunto de reglas. |
Para cada conjunto de reglas, sigue esta estructura:
{ "operator" : <BOOLEAN_OPERATOR>, "rules" : <JSON_RULE>, }
Nombre | Descripción |
---|---|
Tipo: cadena | Obligatorio.
|
Tipo: cadena | Obligatorio. Cadena JSON de reglas (matriz de reglas) Consulta Sintaxis de reglas de 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.
Nombre | Descripción |
---|---|
Tipo: cadena | Obligatorio. Objeto JSON que contiene
Pueden agregarse más orígenes de eventos a |
Tipo: entero | Obligatorio. Entero (en segundos) para el intervalo de retención del público, debe ser inferior a |
Tipo: cadena | Obligatorio. Cadena JSON de las reglas de filtro. Consulta Filtros. |
Tipo: entero | Opcional. Cadena JSON de las funciones de agregación. Consulta Funciones de agregación. |
El filtrado sigue este formato:
"filter" : { "operator": <BOOLEAN_OPERATOR>, "filters": <FILTER_SET>, }
Nombre | Descripción |
---|---|
Tipo: cadena | Obligatorio.
|
Tipo: cadena | Obligatorio. Matriz de objetos JSON de las reglas de filtro. Consulta Sintaxis de reglas de filtros. |
{ "field": <FIELD>, "operator": <COMPARISON_OPERATOR>, "value": <VALUE>, }
Nombre | Descripción |
---|---|
Tipo: cadena | Obligatorio.
|
Tipo: cadena | Obligatorio.
Si |
Tipo: cadena | Obligatorio. Si el atributo |
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 }
Nombre | Descripción |
---|---|
Tipo: cadena | Obligatorio. El tipo de función de agregación.
|
| Necesario para determinados tipos de funciones de agregación. |
Tipo: cadena | Opcional.
|
Tipo: cadena | Obligatorio, a menos que el tipo sea El parámetro al cual se aplica la función de agregación. |
Tipo: cadena | Obligatorio.
|
Tipo: cadena | Obligatorio. Valor esperado del parámetro. |
Por ejemplo:
"aggregation" : { "type":"count", "operator":">", "value":1 }
Operador | Descripción |
---|---|
| Es verdadero (true) si el valor del parámetro del evento es mayor que el valor especificado. |
| Es verdadero (true) si el valor del parámetro del evento es mayor o igual que el valor especificado. |
| Es verdadero (true) si el valor del parámetro del evento es menor que el valor especificado. |
| Es verdadero (true) si el valor del parámetro del evento es menor o igual que el valor especificado. |
| 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' }. |
| Es verdadero (true) si el valor del parámetro del evento no es igual que el valor especificado. |
| 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". |
| 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". |
| Contiene, no distingue mayúsculas de minúsculas |
| No contiene, no distingue mayúsculas de minúsculas |
| Es verdadero (true) si el valor del parámetro del evento coincide con alguna de las cadenas de una matriz específica. |
| Es verdadero (true) si el valor del parámetro del evento no coincide con ninguna de las cadenas de una matriz específica. |
| "is_any", no distingue mayúsculas de minúsculas |
| "is_not_any", no distingue mayúsculas de minúsculas |
| "Verdadero" si el valor del parámetro del evento que comienza con la cadena proporcionada |
| "starts_with", no distingue mayúsculas de minúsculas |
| Coincide con una expresión regular, como \"example\.com.*purchase$\". Admite la gramática completa PCRE. |
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" } ] } ] } } ] } }
Consulta Públicos personalizados de apps para celulares, Ejemplos de reglas de públicos personalizados.
Las reglas tienen los siguientes operadores y datos o eventos:
Operadores | Tipo de filtro |
---|---|
| Contiene subcadena (no distingue mayúsculas de minúsculas) |
| No contiene subcadena (no distingue mayúsculas de minúsculas) |
| Contiene subcadena (distingue mayúsculas de minúsculas) |
| No contiene subcadena (distingue mayúsculas de minúsculas) |
| Igual a (distingue mayúsculas de minúsculas) |
| Distinto de (distingue mayúsculas de minúsculas) |
| Menor que (solo campos numéricos) |
| Menor o igual que (solo campos numéricos) |
| Mayor que (solo campos numéricos) |
| Mayor o igual que (solo campos numéricos) |
| Coincide con una expresión regular, como |
Datos | Datos que se filtran |
---|---|
| URL con escape completo del sitio visitado. |
| Dominio del sitio visitado. |
| Ruta del sitio visitado sin el dominio. |
| Nombre del |
| Dispositivo que accedió al sitio:
|
any | Cualquier campo agregado a |
Proporciona cada una de las reglas como una cadena con codificación JSON.