Regras de público

As regras de público determinam se uma pessoa é adicionada ao seu público personalizado. As regras são aplicadas na URL de referência ou em eventos e dados específicos.

Forneça suas regras como strings codificadas em JSON estruturadas desta forma:

• Uma regra de público contém dois conjuntos de regras.
• Cada conjunto de regras pode conter uma regra de inclusão ou exclusão.
• Cada regra de inclusão ou exclusão pode conter filtros e funções de agregação.
• Cada filtro contém um conjunto de filtros.

Use as regras de público para diferentes tipos de públicos personalizados, incluindo públicos personalizados do site, públicos personalizados de app para celular e públicos personalizados offline. Para regras de engajamento, consulte Públicos personalizados de engajamento.

Limitações

• Cada público pode especificar até 10 regras na regra de público. Isso inclui o número de rules em inclusions ou exclusions.
• Cada regra pode especificar até 100 filtros, conhecidos como nós folha.

Sintaxe das regras de público

Para definir uma regra de público, a seguinte estrutura deve ser seguida:

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

Campos disponíveis

Sintaxe do conjunto de regras

Para cada conjunto de regras, siga esta estrutura:

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

Campos disponíveis

Sintaxe da regra de inclusão e exclusão

Para cada regra de inclusão ou exclusão, siga esta estrutura:

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

Campos disponíveis

Filtros

A filtragem segue este formato geral:

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

Campos disponíveis

Sintaxe do conjunto de filtros

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

Campos disponíveis

Funções agregadas

Crie públicos personalizados com base na frequência e na intensidade do comportamento usando a aggregation no campo de regras de público. Dessa forma, você pode definir uma função agregada, por exemplo:

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

Campos disponíveis

Por exemplo:

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

Operadores de comparação

Exemplos

Públicos personalizados do site

Faça a correspondência de todas as URLs de referência que contêm a string "shoes" nos últimos 30 dias:

{
    "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"
                        }
                    ]
                },
            }
        ]
    }
}

Faça a correspondência dos eventos ViewContent em que o preço do artigo é maior que ou igual a US$ 100,00 nos últimos 30 dias. Considere usar essa regra no seguinte 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 app para celular

Consulte a seção que mostra um exemplo das regras de público personalizado de app para celular.

Operadores e dados ou eventos

As regras contêm os seguintes operadores e dados ou eventos:

Forneça cada regra como uma string codificada em JSON.