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.
rules
de inclusions
o exclusions
.Para definir una regla de audiencia, se debe seguir la estructura siguiente:
rule: { "inclusions": <RULE_SET>, "exclusions": <RULE_SET>, }
Nombre | Descripción |
---|---|
Tipo: cadena | Obligatorio. Cadena JSON del conjunto de reglas que define la inclusión. Consulta Sintaxis del conjunto de reglas. |
Tipo: cadena | Obligatorio. 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 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.
Nombre | Descripción |
---|---|
Tipo: cadena | Obligatorio. Objeto JSON que contiene los valores de
Se pueden añadir más orígenes de eventos a |
Tipo: entero | Obligatorio. Entero (en segundos) para el intervalo de retención de la audiencia; debe ser menor que |
Tipo: cadena | Obligatorio. Cadena JSON de las reglas de filtros. Consulta Filtros. |
Tipo: entero | Opcional. Cadena JSON de las funciones de agregado. Consulta Funciones de agregado. |
La filtración sigue este formato general:
"filter" : { "operator": <BOOLEAN_OPERATOR>, "filters": <FILTER_SET>, }
Nombre | Descripción |
---|---|
Tipo: cadena | Obligatorio.
|
Tipo: cadena | Obligatorio. Matriz de objetos JSON de reglas de filtros. Consulta Sintaxis de las 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 |
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 }
Nombre | Descripción |
---|---|
Tipo: cadena | Obligatorio. Tipo de función de agregado.
|
| Obligatorio para ciertos tipos de funciones de agregado. |
Tipo: cadena | Opcional.
|
Tipo: cadena | Obligatorio a menos que el tipo sea Parámetro al que se aplica la función de agregado. |
Tipo: cadena | Obligatorio.
|
Tipo: cadena | Obligatorio. Valor previsto del parámetro. |
Por ejemplo:
"aggregation" : { "type":"count", "operator":">", "value":1 }
Operador | Descripción |
---|---|
| Verdadero si el valor del parámetro del evento es mayor que el valor especificado. |
| Verdadero si el valor del parámetro del evento es mayor o igual que el valor especificado. |
| Verdadero si el valor del parámetro del evento es menor que el valor especificado. |
| Verdadero si el valor del parámetro del evento es menor o igual que el valor especificado. |
| 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' }”. |
| Verdadero si el valor del parámetro del evento no es igual que el valor especificado. |
| 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”. |
| 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”. |
| Contiene (no distingue entre mayúsculas y minúsculas). |
| No contiene (no distingue entre mayúsculas y minúsculas). |
| Verdadero si el valor del parámetro del evento coincide con cualquier cadena de la matriz proporcionada. |
| Verdadero si el valor del parámetro del evento no coincide con ninguna cadena de la matriz proporcionada. |
| “is_any” (no distingue entre mayúsculas y minúsculas). |
| “is_not_any” (no distingue entre mayúsculas y minúsculas). |
| Verdadero si el valor del parámetro del evento empieza por la cadena proporcionada. |
| “starts_with” (no distingue entre mayúsculas y minúsculas). |
| Hace coincidir una expresión habitual, como \"example\.com.*purchase$\". Se admite toda la gramática de PCRE. |
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" } ] } ] } } ] } }
Las reglas presentan los operadores y datos o eventos siguientes:
Operadores | Tipo de filtro |
---|---|
| Contiene la subcadena (no distingue entre mayúsculas y minúsculas). |
| No contiene la subcadena (no distingue entre mayúsculas y minúsculas). |
| Contiene la subcadena (distingue entre mayúsculas y minúsculas). |
| No contiene la subcadena (distingue entre mayúsculas y minúsculas). |
| Igual a (distingue entre mayúsculas y minúsculas). |
| No es igual a (distingue entre mayúsculas y 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). |
| Hace coincidir una expresión habitual, 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 objeto |
| Dispositivo que ha accedido al sitio:
|
Cualquier campo de | Cualquier campo añadido a |
Proporciona cada una de las reglas como una cadena con codificación JSON.