Regole del pubblico

Le regole del pubblico determinano se una persona viene aggiunta al tuo pubblico personalizzato. Le regole sono applicate all'URL di reindirizzamento o a eventi e dati specifici.

Fornisci le tue regole come stringhe codificate JSON strutturate in questo modo:

Usa le regole del pubblico per diversi tipi di pubblico personalizzato, tra cui Pubblico personalizzato dal sito web, Pubblico personalizzato dall'app mobile e Pubblico personalizzato offline. Per le regole del pubblico in base alle interazioni, consulta Pubblico personalizzato in base alle interazioni.

Limitazioni

  • Ogni pubblico può specificare fino a 10 regole nella regola del pubblico. Questo include il numero di rules in inclusions o exclusions.
  • Ogni regola può specificare fino a 100 filtri, noti come nodi terminali.

Sintassi delle regole del pubblico

Per definire una regola del pubblico, devi seguire la struttura seguente:

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

Campi disponibili

Nome Descrizione

inclusions

tipo: stringa

Obbligatorio.

Stringa JSON dell'insieme di regole che definisce l'inclusione. Consulta Sintassi dell'insieme di regole.

exclusions

tipo: stringa

Obbligatorio.

Stringa JSON dell'insieme di regole che definisce l'esclusione. Consulta Sintassi dell'insieme di regole.

Sintassi dell'insieme di regole

Per ogni insieme di regole, segui questa struttura:

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

Campi disponibili

Nome Descrizione

operator

tipo: stringa

Obbligatorio.

and o or.

rules

tipo: stringa

Obbligatorio.

Stringa JSON di regole (array di regole). Consulta Sintassi delle regole di inclusione ed esclusione.

Sintassi delle regole di inclusione ed esclusione

Per ogni regola di inclusione o esclusione, seguire questa struttura:

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

I campi aggregation e retention_seconds sono modificabili. Tuttavia, la modifica di aggregation e retention_seconds non elimina il pubblico. Gli utenti che soddisfano solo la vecchia regola/aggregazione continueranno a essere nel pubblico fino alla scadenza.

Campi disponibili

Nome Descrizione

event_sources

tipo: stringa

Obbligatorio.

Oggetto JSON contenente id e type.


Altre origini degli eventi possono essere aggiunte a type usando una lista delimitata da virgole "store_visits,pixel,app".

retention_seconds

tipo: intero

Obbligatorio.

Intero (in secondi) per la finestra di mantenimento del pubblico, deve essere inferiore a retention_days. Min=1; Max=365 giorni

filter

tipo: stringa

Obbligatorio.

Stringa JSON delle regole del filtro. Consulta Filtro.

aggregation

tipo: intero

Facoltativo.

Stringa JSON delle funzioni di aggregazione. Consulta Funzioni di aggregazione.

Filtri

L'applicazione dei filtri segue questo formato generale:

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

Campi disponibili

Nome Descrizione

operator

tipo: stringa

Obbligatorio.

and o or

filters

tipo: stringa

Obbligatorio.

Array di oggetti JSON di regole di filtri. Consulta Sintassi delle regole di filtri.

Sintassi dell'insieme di filtri

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

Campi disponibili

Nome Descrizione

field

tipo: stringa

Obbligatorio.


  • Per il Pubblico personalizzato dal sito web, usa 'event' se il filtro deve specificare un evento. I parametri che corrispondono agli eventi inviati dal pixel (ad esempio, 'ViewContent', 'Purchase').
  • Per il Pubblico personalizzato dall'app mobile, usa 'event' se il filtro deve specificare un evento. Parametri che corrispondono agli eventi nell'app inviati dall'app; ad esempio, "_appVersion", "_value" e così via.

operator

tipo: stringa

Obbligatorio.

  • =
  • !=
  • >=
  • >
  • <=
  • <
  • 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]

Se field è impostato su event, bisogna utilizzare =.

value

tipo: stringa

Obbligatorio.

Se l'attributo field è impostato su "event", il value deve essere impostato sul nome di un evento. Utilizza l'API App Event per visualizzare le azioni e i parametri riportati dall'app.

Funzioni di aggregazione

Puoi creare un pubblico personalizzato sulla base della frequenza e dell'intensità del comportamento usando l'aggregation nel campo delle regole del pubblico. Con questo, definisci una funzione di aggregazione, ad esempio:

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

Campi disponibili

Nome Descrizione

type

tipo: stringa

Obbligatorio.

Il tipo di funzione di aggregazione.

  • Per il pubblico personalizzato dal sito web, sono disponibili le seguenti funzioni: 'count', 'sum', 'avg', 'min', 'max', 'time_spent' e 'last_event_time_field'.
  • Per il pubblico personalizzato dall'app mobile, sono disponibili le seguenti funzioni: "count","sum", "avg", "min" e "max".

config

Obbligatoria per alcuni tipi di funzione di aggregazione.

method

tipo: stringa

Facoltativo.

"absolute", il che significa aggiungere persone che hanno registrato eventi nell'intervallo specificato, o "percentile", il che significa aggiungere persone da un intervallo percentile specificato. Se selezioni percentile, l'operatore dovrebbe essere solo in_range e not_in_range.

field

tipo: stringa

Obbligatorio. A meno che il tipo non sia count.

Il parametro su cui viene applicata la funzione di aggregazione.

operator

tipo: stringa

Obbligatorio.

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

value

tipo: stringa

Obbligatorio.

Valore atteso del parametro.

Ad esempio:

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

Operatori di confronto

Operatore Descrizione

> o gt

True se il valore del parametro dell'azione è maggiore rispetto al valore specificato.

>= o gte

True se il valore del parametro dell'azione è maggiore o uguale rispetto al valore specificato.

< o lt

True se il valore del parametro dell'azione è inferiore rispetto al valore specificato.

<= o lte

True se il valore del parametro dell'azione è inferiore o uguale rispetto al valore specificato.

= o eq

True se il valore del parametro dell'azione è uguale al valore specificato. Nota: questo equivale a non specificare alcun operatore; ovvero, "'x': { 'eq' : 'y' }" è uguale a "'x': 'y' }.

!= o neq

True se il valore del parametro dell'azione non è uguale al valore specificato.

contains

True se il valore del parametro dell'azione, come stringa, contiene la stringa specificata. Il valore di "shoe12345" soddisfa "contains" se è specificato il valore "shoe".

not_contains

True se il valore del parametro dell'azione, come stringa, non contiene la stringa specificata. Il valore di "shoe12345" soddisfa "not_contains" se è specificato il valore "purse".

i_contains

Contiene, senza distinzione tra maiuscole e minuscole

i_not_contains

Non contiene, senza distinzione tra maiuscole e minuscole

is_any

True se il valore del parametro dell'azione corrisponde a una qualsiasi stringa in un dato array.

is_not_any

True se il valore del parametro dell'azione non corrisponde ad alcuna stringa in un array specifico.

i_is_any

"is_any", senza distinzione tra maiuscole e minuscole.

i_is_not_any

"is_not_any", senza distinzione tra maiuscole e minuscole.

starts_with

True è il valore del parametro dell'azione che inizia con la stringa specificata.

i_starts_with

"starts_with", senza distinzione tra maiuscole e minuscole.

regex_match

Individua un'espressione regolare come \"example\.com.*purchase$\". Tutta la grammatica PCRE è supportata.

Esempi

Pubblico personalizzato dal sito web

Individua tutti gli URL di riferimento contenenti la stringa shoes negli ultimi 30 giorni:

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

Individua gli eventi ViewContent in cui il prezzo dell'articolo è superiore o uguale a 100 USD negli ultimi 30 giorni. Considera di usare questa regola per il seguente 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"
                                }
                            ]
                        }
                    ]
                }
            }
        ]
    }
}

Pubblico personalizzato dall'app mobile

Consulta Pubblico personalizzato dell'app mobile, esempio di regole del pubblico personalizzato.

Operatori e dati o eventi

Le regole hanno i seguenti operatori e dati o eventi:

Operatori Il tipo di filtro

i_contains

Contiene sottostringhe (non distingue tra lettere minuscole e maiuscole)

i_not_contains

Non contiene sottostringhe (non distingue tra lettere minuscole e maiuscole)

contains

Contiene sottostringhe (distingue tra lettere minuscole e maiuscole)

not_contains

Non contiene sottostringhe (distingue tra lettere minuscole e maiuscole)

eq

Uguale a (distingue tra lettere minuscole e maiuscole)

neq

Non uguale a (distingue tra lettere minuscole e maiuscole)

lt

Minore di (solo campi numerici)

lte

Minore o uguale a (solo campi numerici)

gt

Maggiore di (solo campi numerici)

gte

Maggiore o uguale a (solo campi numerici)

regex_match

Individua un’espressione regolare come \"example\\.com.*purchase$\". Tutta la grammatica PCRE è supportata.

Dati Dati filtrati

url

URL del sito visitato preceduto da un carattere di escape

domain

Dominio del sito visitato

path

Percorso del sito visitato, senza il dominio

event

Nome del pixel event, come 'ViewContent'

device_type

Dispositivo che ha effettuato l'accesso al sito:

desktop

mobile_android_phone

mobile_android_tablet

mobile_ipad

mobile_ipod

mobile_iphone

mobile_tablet

mobile_windows_phone

qualsiasi customData campo

Qualsiasi campo aggiunto a customData per le attivazioni del pixel, come productId, category, price

Fornisci ogni regola come stringa con codifica JSON.