Riferimento per la creazione di regole dei criteri di consenso

Utilizzare questo riferimento alla logica avanzata delle regole per impostare regole precise e giuridicamente valide nella clausola Then del generatore di criteri di consenso in Adobe Experience Platform.

Scopri come le regole dei criteri si applicano alla struttura e ai tipi di dati sul consenso per applicare in modo preciso le preferenze di consenso dei clienti.

Leggi questo documento per scoprire come filtrare i profili in base al consenso navigando nei campi contenitore nello schema XDM e selezionando un campo primitivo. Quindi utilizza l’operatore appropriato per definire il valore esatto che un profilo deve corrispondere.

Prerequisiti

Prima di utilizzare questo riferimento, assicurati che la configurazione dei criteri di consenso sia completa e che tu comprenda i concetti fondamentali dell’architettura dei dati e del framework di governance di Adobe Experience Platform.

Assicurati di soddisfare i seguenti prerequisiti:

Concetti di base: campi primitivi e contenitori

Leggi questa sezione per scoprire come le regole dei criteri di consenso utilizzano diversi tipi di campo negli schemi XDM. La distinzione tra campi contenitore e campi primitivi consente di selezionare il campo e l’operatore corretti durante la definizione delle condizioni dei criteri.

Tipi di campo supportati e logica della regola

I criteri di consenso supportano più tipi di campo, ciascuno con operatori specifici per la creazione di condizioni delle regole. I tipi di campo sono raggruppati in due categorie: tipi contenitore e tipi primitivi.

Tipi di contenitori (navigazione schema)

I tipi di contenitore organizzano i dati del consenso, ma non possono essere utilizzati direttamente nelle condizioni dei criteri. Fungono da percorsi di navigazione per raggiungere i campi primitivi che contengono i valori effettivi.

Tipi primitivi (condizioni regola)

I campi primitivi contengono i valori dei dati di consenso effettivi (ad esempio, true o "weekly") e sono gli unici tipi di campo che possono essere utilizzati per definire le condizioni dei criteri.

La tabella seguente descrive ogni tipo primitivo supportato e gli operatori disponibili.

Utilizzo di strutture di dati complesse

Leggi questa sezione per scoprire come navigare tra i contenitori nidificati nello schema di consenso per raggiungere i campi primitivi. Introduce pattern di schema comuni e spiega come le strutture più profonde consentano una logica di consenso più granulare.

Gestione di strutture di schema nidificate e complesse

Gli schemi di consenso complessi spesso includono strutture di contenitori nidificati che supportano la gestione flessibile e scalabile dei dati. Poiché le regole dei criteri possono fare riferimento solo a campi primitivi, è necessario spostarsi tra le gerarchie dei contenitori per raggiungere i campi che possono essere utilizzati nelle condizioni dei criteri di consenso. Una nidificazione più approfondita consente un targeting delle regole più granulare e specifico.

I pattern comuni dei contenitori nidificati includono:

Esempio di struttura del campo

La struttura seguente funge da riferimento visivo per gli esempi di regole in questa guida.

consent.marketing (Object)
├── email (Boolean)
├── sms (Boolean)
├── preferences (Map with dynamic keys)
│   ├── "email_preferences" (Object)
│   │   ├── frequency (String)
│   │   └── channels (Array of Strings)
│   ├── "sms_preferences" (Object)
│   │   ├── frequency (String)
│   │   └── opt_in_time (Date)
│   └── "push_preferences" (Object)
│       ├── frequency (String)
│       └── categories (Array of Strings)
└── lastUpdated (Date)

Creazione di regole avanzate per tipo di campo

Leggi questa sezione per una guida dettagliata sulla creazione di regole dei criteri di consenso basate sul tipo di campo. Scoprirai come configurare la logica delle regole per booleani, mappe, oggetti e array per acquisire condizioni di consenso precise.

Componenti e passaggi per la creazione di regole

Per creare regole di criteri di consenso efficaci è necessario comprendere come navigare nella struttura dello schema e applicare gli operatori corretti per ogni tipo di campo. Ogni regola segue lo stesso approccio di base: passa a un campo primitivo, seleziona l’operatore appropriato e definisci la condizione che deve essere soddisfatta.

Per creare una regola, segui la procedura riportata di seguito:

Utilizzo di campi booleani (logica di consenso implicito)

I campi booleani memorizzano i valori di consenso true o false e rappresentano gli attributi di consenso più comuni. L'operatore is not equal to consente di includere profili che non hanno esplicitamente rinunciato, supportando scenari di consenso implicito.

Operatori e risultati booleani

Esempio: consenso e-mail implicito

Field: consent.marketing.email (boolean)
Operator: is not equal to
Value: false
Result: Includes profiles who have not explicitly opted out of email marketing (includes both true and missing/null values).

Utilizzo dei campi mappa (preferenze dinamiche)

I campi mappa memorizzano coppie chiave-valore con chiavi dinamiche, a differenza di oggetti che hanno schemi fissi. Le mappe vengono spesso utilizzate nei centri delle preferenze, dove è possibile aggiungere nuove categorie senza dover aggiornare lo schema. Puoi eseguire il targeting di chiavi specifiche o utilizzare la corrispondenza dei caratteri jolly in tutte le chiavi.

Corrispondenza chiave specifica

Utilizzare questo approccio per eseguire il targeting di una categoria di preferenze specifica.

Field: consent.preferences["email_preferences"].frequency (string) - navigated to from the map container
Operator: is equal to
Value: "weekly"
Result: Includes profiles who set the email frequency to weekly (for the "email_preferences" key)

Qualsiasi chiave corrispondente

Utilizzare l'opzione della casella di controllo "find any matching item" per trovare una corrispondenza tra tutte le chiavi dinamiche in una mappa.

Field: consent.preferences.*.frequency (string)
Operator: is equal to
Value: "weekly"
Result: Includes profiles who set frequency to weekly in ANY preference category (for example, email_preferences, sms_preferences, or push_preferences)

Utilizzo dei campi oggetto (navigazione fissa)

I campi oggetto fungono da contenitori con schemi fissi. Vengono utilizzati solo per la navigazione e non è possibile farvi riferimento direttamente nelle condizioni dei criteri.

Esempio di navigazione

consent.marketing (object) → consent.marketing.email (boolean)

Caso d'uso di esempio:

Field: consent.marketing.email (Boolean) - navigated to from the object
Operator: is equal to
Value: true
Result: Include profiles who have explicitly consented to marketing emails

Utilizzo dei campi array (più valori)

I campi array contengono più valori dello stesso tipo e richiedono una gestione diversa a seconda che memorizzino primitive o oggetti. Le opzioni di navigazione e operatore variano in base al tipo di array.

Esempio di array di primitive

Utilizzare l'operatore contains per identificare i profili in base a valori specifici all'interno di un array.

Field: consent.communication_channels (array of strings)
Operator: contains
Value: "email"
Result: Include profiles who have consented to email communication

Esempio di array di oggetti

Accedi all’array per accedere ai campi primitivi all’interno degli oggetti nidificati.

Field: consent.preferences["email_preferences"].categories[].type - navigated to from the array
Operator: is equal to
Value: "promotional"
Result: Include profiles where any email category is "promotional"

Combinazione di regole con logica complessa

Questa sezione spiega come combinare più condizioni di regola utilizzando l’operatore logico AND o OR. Scoprirai come gli operatori logici lavorano insieme per definire criteri di consenso avanzati e a più condizioni.

Combinazione di più condizioni (AND o OR)

Puoi combinare più condizioni di regola utilizzando l’operatore logico AND o OR per creare criteri di consenso più sofisticati destinati a segmenti di profilo specifici.
AND logic richiede che tutte le condizioni siano vere, generando corrispondenze di pubblico più strette.
OR logic consente a qualsiasi condizione di essere true, espandendo la portata del pubblico.

Nell’interfaccia dei criteri di consenso, utilizza il selettore logico visualizzato tra le condizioni della regola per passare dalla logica AND a quella OR.

Esempio generale di regola complessa

L’esempio seguente combina lo stato del consenso di base con la frequenza delle preferenze per creare un segmento di destinazione.

Field: consent.marketing.email
Operator: is equal to true
AND
Field: consent.preferences.frequency
Operator: is not equal to "daily"
Result: Include profiles who consent to email marketing but not to a daily frequency

Logica avanzata per array di oggetti

Quando si combinano condizioni all'interno di array di oggetti, il comportamento dipende dall'utilizzo della logica AND o OR tra le condizioni.

Esempio: array di oggetti con condizioni AND

Usa la logica AND quando tutte le condizioni devono essere applicate all'elemento di array same.

Field: consent.preferences["email_preferences"].categories[].enabled (boolean)
Operator: is equal to
Value: true
AND
Field: consent.preferences["email_preferences"].categories[].type (string)
Operator: is equal to
Value: "promotional"
Result: Includes profiles where the same category entry has both enabled=true and type="promotional".
Note: AND conditions apply to the same array entry. Using OR logic would include profiles if any array entry matches any of the conditions.

Esempio: array di oggetti con condizioni OR

Utilizza la logica OR per creare corrispondenze di pubblico inclusive consentendo a qualsiasi condizione di essere vera tra le voci dell’array.

Field: consent.preferences["email_preferences"].categories[].enabled (boolean)
Operator: is equal to
Value: true
OR
Field: consent.preferences["email_preferences"].categories[].type (string)
Operator: is equal to
Value: "newsletter"
Result: Includes profiles where any category entry has enabled=true or any entry has type="newsletter".
Note: OR logic allows matching across different array entries. One entry can meet the first condition while another meets the second.

Passaggi successivi

Dopo aver generato e perfezionato le regole dei criteri di consenso, utilizza le risorse seguenti per finalizzare la configurazione, convalidare l’applicazione dei criteri e rivedere i modelli di dati sottostanti.