In questa pagina: scopri come utilizzare il generatore di regole per creare query mirate per le campagne orchestrate aggiungendo condizioni da attributi ed espressioni di database, combinandole con operatori logici e convalidando i risultati.
I passaggi principali per creare regole per le campagne orchestrate sono i seguenti:
- Aggiungi condizioni: crea condizioni personalizzate per filtrare la query creando la tua condizione personalizzata con gli attributi dal database e le espressioni avanzate.
- Combina condizioni: dispone le condizioni nell’area di lavoro utilizzando gruppi e operatori logici.
- Verifica e convalida la regola: prima di salvarla, controlla i dati risultanti dalla regola.
Aggiungere una condizione conditions
Per aggiungere condizioni nella query, segui questi passaggi:
-
Accedi al generatore di regole da un’attività Crea pubblico.
-
Fai clic sul pulsante Aggiungi condizione per creare una prima condizione per la query.
Puoi inoltre avviare la query utilizzando un filtro predefinito. A tale scopo, fare clic sul pulsante Seleziona o salva filtro e scegliere Seleziona filtro predefinito. Per ulteriori dettagli, vedere Utilizzare filtri predefiniti.
-
Identifica l’attributo dal database da utilizzare come criterio per la condizione. L’icona “i” accanto a un attributo fornisce informazioni sulla tabella in cui è memorizzato e sul relativo tipo di dati.
note NOTE Il pulsante Modifica espressione consente di sfruttare l’editor di espressioni per definire manualmente un’espressione utilizzando i campi dal database e le funzioni helper. Scopri come modificare le espressioni -
Fai clic sul pulsante
accordion Distribuzione dei valori La distribuzione dei valori consente di identificare il modo in cui i valori vengono utilizzati all’interno del database. È utile per comprendere i valori disponibili, i loro conteggi e le percentuali. Consente inoltre di evitare problemi come l’utilizzo incoerente delle maiuscole o ortografia errata durante la creazione di query o di espressioni.
Per gli attributi con un numero elevato di valori, lo strumento mostra solo i primi venti. In questi casi, viene visualizzata la notifica Caricamento parziale per indicare questa limitazione. Puoi applicare filtri avanzati per perfezionare i risultati visualizzati e concentrarti su valori o sottoinsiemi di dati specifici.
Per creare la condizione più velocemente, selezionare un valore e fare clic su Seleziona attributo e valore per popolare l’attributo e il valore nella condizione corrente.
Puoi anche copiare un valore negli Appunti utilizzando l’immagine
accordion Aggiungere ai preferiti L’aggiunta di attributi al menu dei preferiti consente di accedere rapidamente agli attributi utilizzati con maggiore frequenza. Puoi aggiungere fino a 20 attributi preferiti. Gli attributi preferiti e recenti sono associati a ogni utente all’interno di un’organizzazione, garantendo l’accessibilità tra computer diversi e fornendo un’esperienza fluida tra i dispositivi.
Per accedere agli attributi preferiti, utilizza il menu Preferiti e recenti. Per trovare più facilmente gli attributi necessari, sono elencati per primi gli attributi preferiti, seguiti da quelli utilizzati di recente. Per rimuovere un attributo dai preferiti, seleziona di nuovo l’icona a forma di stella.
-
Fai clic su Conferma per aggiungere l’attributo selezionato alla condizione.
-
Viene visualizzato un riquadro delle proprietà in cui è possibile configurare il valore desiderato per l’attributo.
-
Seleziona l’operatore da applicare dall’elenco a discesa. Sono disponibili diversi operatori da utilizzare. Gli operatori disponibili nell’elenco a discesa dipendono dal tipo di dati dell’attributo.
accordion Elenco degli operatori disponibili table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 Operatore Scopo Esempio Uguale a Restituisce un risultato identico ai dati immessi nella seconda colonna Valore. Cognome (@lastName) uguale a “Jones”, restituirà solo i destinatari il cui cognome è Jones. Non uguale a Restituisce tutti i valori non identici al valore inserito. Lingua (@language) non uguale a “Inglese” Maggiore di Restituisce un valore maggiore del valore immesso. Età (@age) maggiore di 50 anni, restituirà tutti i valori maggiori di “50”, ovvero “51”, “52”, ecc. Minore di Restituisce un valore minore del valore immesso. Data di creazione (@created) prima di “DaysAgo(100)”, restituirà tutti i destinatari creati meno di 100 giorni fa. Maggiore o uguale a Restituisce tutti i valori uguali o maggiori del valore immesso. Età (@age) maggiore o uguale a “30”, restituirà tutti i destinatari con un’età pari o superiore ai 30 anni. Minore o uguale a Restituisce tutti i valori uguali o inferiori al valore immesso. Età (@age) minore o uguale a “60”, restituirà tutti i destinatari di età uguale o inferiore ai 60 anni. Incluso in Restituisce i risultati inclusi nei valori indicati. Questi valori devono essere separati da una virgola. La data di nascita (@birthDate) inclusa in “10/12/1979,10/12/1984” restituirà i destinatari nati nell’intervallo tra queste date. Non in Funziona come l’operatore Incluso in. Qui, i destinatari vengono esclusi in base ai valori immessi. La data di nascita (@birthDate) non è inclusa in “10/12/1979,10/12/1984”. I destinatari nati in queste date non verranno restituiti. È vuoto Restituisce risultati che corrispondono a un valore vuoto nella seconda colonna Valore. Cellulare (@mobilePhone) è vuoto restituisce tutti i destinatari che non hanno un numero di cellulare. Non è vuoto Funziona in modo inverso rispetto all’operatore È vuoto. Non è necessario immettere dati nella seconda colonna Valore. Il campo E-mail (@email) non è vuoto. Inizia con Restituisce i risultati a partire dal valore immesso. Account # (@account) inizia con “32010”. Non inizia con Restituisce i risultati che non iniziano con il valore immesso Account # (@account) non inizia con “20”. Contiene Restituisce i risultati che contengono almeno il valore immesso. Il dominio e-mail (@domain) che contiene “mail”, restituirà tutti i nomi di dominio che contengono “mail”, come “gmail.com”. Non contiene Restituisce risultati che non contengono il valore immesso. Il dominio e-mail (@domain) non contiene “vo”. I nomi di dominio contenenti “vo”, ad esempio “voilà.fr”, non verranno visualizzati nei risultati. Simile a Simile all’operatore Contiene, consente di inserire un carattere jolly % nel valore. Cognome (@lastName) simile a “Jon%s”. Il carattere jolly funge da “jolly” per trovare nomi come “Jones”. Diverso da Simile all’operatore Contiene, consente di inserire un carattere jolly % nel valore. Cognome (@lastName) diverso da “Smi%h”. I destinatari con il cognome “Smith” non verranno restituiti. -
Nel campo Valore, definisci il valore previsto. Puoi anche sfruttare l’editor di espressioni per definire manualmente un’espressione utilizzando i campi dal database e le funzioni helper. A tale scopo, fai clic sull’
Per gli attributi di tipo data, i valori predefiniti sono disponibili utilizzando l’opzione Predefiniti.
accordion Vedi esempio 
Condizioni personalizzate per tabelle collegate (collegamenti 1-1 e 1-N) links
Le condizioni personalizzate consentono di eseguire query sulle tabelle collegate alla tabella attualmente utilizzata dalla regola. Questo include tabelle con un collegamento di cardinalità 1-1 o tabelle di raccolta (collegamento 1-N).
Collegamento 1-1
Per un collegamento 1-1, passa alla tabella collegata, seleziona l’attributo desiderato e definisci il valore previsto.
Puoi anche selezionare direttamente un collegamento alla tabella nel selettore Valore e confermare. In tal caso, i valori disponibili per la tabella selezionata devono essere selezionati utilizzando un selettore dedicato, come illustrato nell’esempio seguente.
Qui, la query esegue il targeting dei brand la cui etichetta è “in esecuzione”.
-
Naviga nella tabella Brand e seleziona l’attributo Etichetta.
-
Definisci il valore previsto per l’attributo.
Di seguito è riportato un esempio di query in cui è stato selezionato direttamente un collegamento di tabella. I valori disponibili per questa tabella devono essere selezionati da un selettore dedicato.
Collegamento 1-N
Per un collegamento 1-N, è possibile definire le condizioni in due modi:
-
Selezionare la raccolta stessa, ad esempio Acquisti. Viene creata una condizione exists, ad esempio, in cui è possibile aggiungere condizioni secondarie.
accordion Esempio di query In questo caso, la query ha come targeting destinatari che hanno effettuato acquisti relativi al prodotto BrewMaster, per un importo totale di almeno 100 $.
-
Seleziona la tabella Acquisti e conferma.
-
Fai clic su Aggiungi condizione per definire le condizioni secondarie da applicare alla tabella selezionata.
-
Aggiungi condizioni secondarie in base alle tue esigenze.
-
-
Selezionare un attributo dalla raccolta. Individuare la raccolta e selezionare un attributo, ad esempio Prezzo.
Journey Optimizer fornisce tre opzioni per definire la condizione.
-
Predefinito: opzione consigliata per la maggior parte dei casi d’uso. Crea automaticamente una condizione
exists such asper la raccolta. Equivale a selezionare la raccolta direttamente con il metodo descritto sopra e produce lo stesso risultato. Se ad esempio si seleziona l’attributo Prezzo da Acquisti, viene creata una condizione Acquisti esistenti, ad esempio. È quindi possibile impostare l’operatore e il valore, ad esempio uguale a0. -
Aggregato: applica una funzione di aggregazione all’attributo di raccolta selezionato. Selezionare ad esempio Conteggio per creare una condizione come Conteggio(Prezzo) uguale a 0. È possibile utilizzare la condizione aggiuntiva per perfezionare i record inclusi nell’aggregazione.
-
Avanzate: utilizza un join diretto all’elemento della raccolta. L’attributo selezionato viene valutato direttamente, ad esempio Prezzo (acquisti/@price). Utilizzare questa opzione per una singola condizione sull’elemento di raccolta.
L’opzione Default è selezionata per impostazione predefinita. Utilizza Aggregate quando devi contare o aggregare i record della raccolta oppure Advanced quando devi eseguire un join diretto a un attributo della raccolta.
-
Combinare le condizioni utilizzando gli operatori operators
Ogni volta che aggiungi una nuova condizione alla regola, questa viene collegata automaticamente alla condizione esistente da un operatore AND. Ciò significa che i risultati delle due condizioni sono combinati.
Per cambiare l’operatore tra le condizioni, fai clic su di esso e seleziona l’operatore desiderato.
Gli operatori disponibili sono:
- AND (intersezione): combina i risultati che corrispondono a tutti i componenti di filtraggio nelle transizioni in uscita.
- OR (Unione): include i risultati che corrispondono ad almeno uno dei componenti di filtraggio nelle transizioni in uscita.
- EXCEPT (Esclusione): esclude i risultati che corrispondono a tutti i componenti di filtro nella transizione in uscita.
Gestire le condizioni manipulate
La barra degli strumenti dell’area di lavoro del generatore di regole fornisce opzioni per gestire facilmente le condizioni all’interno della regola:
A seconda delle esigenze, potrebbe essere necessario creare gruppi intermedi di componenti raggruppando i componenti in uno stesso gruppo e collegandoli tra loro.
-
Per raggruppare due condizioni esistenti, seleziona una delle due condizioni e fai clic sul pulsante
-
Per raggruppare una condizione esistente con una nuova, selezionala, fai clic su
Nell’esempio seguente, è stato creato un gruppo intermedio per il targeting di clienti che hanno acquistato il prodotto BrewMaster o VanillaVelvet.
Controllare e convalidare la query
Dopo aver creato la query nell’area di lavoro, puoi verificarla utilizzando il riquadro Proprietà della regola. Le operazioni disponibili sono:
- Visualizza risultati: visualizza i dati risultanti dalla query.
- Vista codice: visualizza una versione della query basata su codice in SQL.
- Calcola: aggiorna e visualizza il numero di record interessati dalla regola.
- Selezionare o salvare il filtro: scegli un filtro preimpostato esistente da utilizzare nell’area di lavoro oppure salva la query come filtro preimpostato per riutilizzarla in futuro. Se il filtro include parametri, fornisci i valori prima di applicarlo. Per ulteriori dettagli, vedere Utilizzare filtri predefiniti.
Quando la regola è pronta, fai clic sul pulsante Conferma per salvarla.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to build rules for Orchestrated campaigns using the rule builder, by adding conditions from database attributes and expressions, combining them with logical operators, and checking and validating the results.
Intents:
- Add a custom condition to a query by selecting an attribute from the database and defining an operator and value.
- Start a query from a predefined filter instead of building a condition from scratch.
- Use the Distribution of values tool to review available attribute values before building a condition.
- Add attributes to a favorites menu for quicker access when building conditions.
- Build conditions on 1-1 linked tables by navigating to the linked table and selecting an attribute, or by selecting the table link directly.
- Build conditions on 1-N (collection) linked tables by selecting the collection itself to create an exists such as condition with sub-conditions, or by selecting an attribute from the collection and choosing the Default, Aggregate, or Advanced option.
- Combine conditions with AND, OR, or EXCEPT operators and group conditions using the canvas toolbar.
- Check the resulting data, view the SQL code, or calculate the number of targeted records before confirming the rule.
Glossary:
- Rule builder: the interface accessed from a Build audience activity used to create targeted queries for Orchestrated campaigns (product-specific)
- Custom condition: a filtering component that lets you filter a query by building a condition with attributes from the database and advanced expressions (product-specific)
- Distribution of values: a tool that shows how values are used within the database, including their counts and percentages, to help avoid issues such as inconsistent capitalization or spelling (product-specific)
- 1-1 link: a table link with one-to-one cardinality, where an attribute from the linked table can be selected directly (product-specific)
- 1-N link (collection table): a table link with one-to-many cardinality, where conditions can target the collection itself or an attribute within it (product-specific)
- Exists such as condition: a condition created when selecting a collection itself (or, with the Default option, an attribute from the collection), which allows sub-conditions to be added (product-specific)
- Default: the recommended option for a collection attribute condition; it automatically creates an exists such as condition for the collection and produces the same result as selecting the collection directly (product-specific)
- Aggregate: an option that applies an aggregate function, such as Count, to the selected collection attribute (product-specific)
- Advanced: an option that uses a direct join to the collection element, evaluating the selected attribute directly, for a single condition on the collection element (product-specific)
- AND (Intersection): an operator that combines results matching all the filtering components in the outbound transitions (product-specific)
- OR (Union): an operator that includes results matching at least one of the filtering components in the outbound transitions (product-specific)
- EXCEPT (Exclusion): an operator that excludes results matching all the filtering components in the outbound transition (product-specific)
- Rule properties pane: the pane used to check a built query, offering View results, Code view, Calculate, and Select or save filter operations (product-specific)
Guardrails:
- For attributes with a large number of values, the Distribution of values tool displays only the first twenty; a Partial load notification appears to indicate this limitation.
- Up to 20 attributes can be added to favorites.
- Each new condition added to a rule is automatically linked to the existing condition by an AND operator.
- Selecting a predefined filter from the Rule properties pane replaces the rule that has been built in the canvas with the selected filter.
Terminology:
- Canonical name: rule builder
FAQ:
- Q: What is a custom condition? — A filtering component that lets you filter a query by building your own condition with attributes from the database and advanced expressions.
- Q: How many attributes can I add to favorites? — Up to 20 attributes.
- Q: What operator links a newly added condition to an existing one? — An AND operator, by default.
- Q: What is the difference between selecting a collection itself and selecting an attribute from the collection with the Default option? — Both create an exists such as condition and produce the same result; the Default option is the recommended choice for most use cases.
- Q: What does the Aggregate option do? — It applies an aggregate function, such as Count, to the selected collection attribute.
- Q: What happens if I select a predefined filter from the Rule properties pane? — It replaces the rule built in the canvas with the selected filter.
Related pages:
- To start a query from a predefined filter, or to save a query as one: Work with predefined filters (orchestrated/predefined-filters.md)
- To manually define an expression using fields from the database and helper functions: Learn how to edit expressions (orchestrated/edit-expressions.md)
Personas:
- marketer: Can build rules for Orchestrated campaigns by adding conditions with database attributes, operators, and values in the rule builder. Can combine conditions using AND, OR, and EXCEPT operators, and check results before confirming. The page states that each new condition is automatically linked to the existing condition by an AND operator. Where: “Combine conditions using operators”.
Onboarding:
- Level: Intermediate
- First minimal step: Access the rule builder from a Build audience activity.
- Success check: You can view the resulting data, view the SQL code, and calculate the number of records targeted by your rule.
- Previous: Starting a query from a predefined filter instead of building a condition from scratch: Work with predefined filters (orchestrated/predefined-filters.md)
- Next: Manually defining an expression using fields from the database and helper functions: Edit expressions (orchestrated/edit-expressions.md)