

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Creazione di regole per il pubblico
<a name="appconfig-experimentation-about-specifying-audience-rule-section"></a>

La ** sezione ** Audience rule include una ** scheda ** Rule Builder e una ** scheda ** Editor per la creazione di regole destinate a un pubblico target per l'esperimento.

**Topics**
+ [Utilizzo del generatore di regole per il pubblico](#appconfig-experimentation-about-specifying-audience-rule-builder)
+ [Usare l'editor](#appconfig-experimentation-about-specifying-audience-editor)

## Utilizzo del generatore di regole per il pubblico
<a name="appconfig-experimentation-about-specifying-audience-rule-builder"></a>

Il generatore di regole fornisce un'interfaccia visiva per definire le regole di targeting del pubblico senza scrivere espressioni. È possibile creare condizioni utilizzando gli attributi e combinarli con operatori logici per controllare quali utenti sono inclusi nell'esperimento. Nel generatore di regole, si definiscono le regole combinando condizioni e gruppi:
+ Le condizioni valutano un singolo attributo (ad esempio,`$plan equals "enterprise"`).
+ I gruppi combinano più condizioni utilizzando operatori logici come `AND` o`OR`.

Ogni gruppo restituisce uno `true` o`false`. Gli utenti che soddisfano la regola generale vengono inclusi nel pubblico di destinazione.

Usa il generatore di regole quando vuoi:
+ Definisci o modifica rapidamente le regole del pubblico senza scrivere espressioni
+ Visualizza come le condizioni vengono raggruppate e valutate
+ Crea e convalida la logica di targeting in modo incrementale

Ecco alcuni esempi:

**Una regola per scegliere come target gli utenti del livello di account Premium. **

![Un'immagine della scheda Generatore di regole durante la AWS AppConfig sperimentazione con una regola di pubblico di esempio specificata.](https://docs.aws.amazon.com/it_it/appconfig/latest/userguide/images/experimentation-rule-builder-1.png)


**Una regola per indirizzare gli utenti in una specifica area geografica utilizzando un dominio di posta elettronica specifico. **

![Una seconda immagine della scheda Generatore di regole durante la AWS AppConfig sperimentazione con una regola di pubblico di esempio specificata.](https://docs.aws.amazon.com/it_it/appconfig/latest/userguide/images/experimentation-rule-builder-2.png)


**Una regola per indirizzare gli utenti di un determinato piano o per utilizzare un piano secondario dopo aver aderito a un programma beta. **

![Una terza immagine della scheda Generatore di regole durante la AWS AppConfig sperimentazione con una regola di pubblico di esempio specificata.](https://docs.aws.amazon.com/it_it/appconfig/latest/userguide/images/experimentation-rule-builder-3.png)


**Relazione con l'editor **

Il generatore di regole e l'editor definiscono la stessa logica di targeting in diversi formati:
+ Il generatore di regole fornisce un modo visivo per creare regole.
+ L'editor mostra l'espressione logica equivalente.

Le modifiche apportate in una vista si riflettono nell'altra.

**Best practice**
+ Mantieni le regole leggibili: utilizza i gruppi per organizzare le condizioni in modo logico ed evitare strutture profondamente annidate.
+ Convalida i valori degli attributi: assicurati che i nomi e i valori degli attributi corrispondano a quelli forniti dall'applicazione.
+ Esegui il test prima dell'esposizione: utilizza le sostituzioni dell'esposizione allo 0% e dell'assegnazione del trattamento per confermare che le regole si comportino come previsto.

## Usare l'editor
<a name="appconfig-experimentation-about-specifying-audience-editor"></a>

L'editor consente di definire regole di targeting che determinano quali utenti sono inclusi in un esperimento. Specificate queste regole come espressioni logiche che valutano gli attributi dell'utente o del dispositivo, come piattaforma, regione o versione dell'applicazione. Quando viene eseguito un esperimento, AWS AppConfig valuta l'espressione per ogni utente. Gli utenti che soddisfano i criteri vengono inclusi nel pubblico di destinazione e possono essere assegnati ai trattamenti.

**Formato di espressione **

Le espressioni utilizzano una sintassi di prefisso (in stile funzione):

```
(operator argument1 argument2 ...)
```

Ad esempio:

```
(and
    (eq $system "iPhone")
    (lt $osVersion 1.8)
)
```

Questa espressione include utenti che:
+ Usa un iPhone e
+ Hai una versione del sistema operativo precedente alla 1.8

L'editor supporta gli stessi scenari di targeting del generatore di regole. Per esempi visivi delle regole relative al pubblico, consulta[Utilizzo del generatore di regole per il pubblico](#appconfig-experimentation-about-specifying-audience-rule-builder).

**Definizione degli attributi **

Gli attributi rappresentano le proprietà dell'utente o dell'ambiente da valutare. Gli attributi sono referenziati con un `$` prefisso.

Esempi comuni comprendono:
+ `$system`— tipo di dispositivo o piattaforma
+ `$osVersion`— versione del sistema operativo
+ `$region`— regione geografica
+ `$appVersion`— versione dell'applicazione

Gli attributi disponibili dipendono dall'applicazione e dal modo in cui vengono trasmessi i dati AWS AppConfig.

**Scrittura di espressioni **

È possibile combinare più condizioni utilizzando operatori logici:
+ Si usa `and` per richiedere che tutte le condizioni siano vere
+ `or`Da utilizzare per soddisfare qualsiasi condizione
+ `not`Usare per escludere condizioni

Esempio:

```
(and
    (eq $region "us-east-1")
    (or
        (eq $system "iPhone")
        (eq $system "Android")
    )
)
```

Questa espressione è destinata agli utenti `us-east-1` che utilizzano dispositivi iPhone o Android.

**Best practice**
+ Inizia in modo semplice: inizia con una piccola serie di condizioni ed espandi secondo necessità.
+ Convalida gli attributi: assicurati che gli attributi utilizzati nelle espressioni siano popolati in modo coerente.
+ Evita espressioni eccessivamente complesse: una logica complessa può rendere il targeting più difficile da comprendere e gestire.
+ Esegui il test prima dell'esposizione: utilizza l'opzione 0% di esposizione e assegnazione del trattamento per confermare che le regole si comportino come previsto.

**Operatori di espressione **

I seguenti operatori sono supportati nelle espressioni di pubblico.

Operatori logici



| Operatore | Description | Esempio | 
| --- | --- | --- | 
| and | Restituisce vero se tutte le condizioni sono vere | `(and (eq $region "us") (eq $system "iPhone"))` | 
| or | Restituisce vero se una qualsiasi condizione è vera | `(or (eq $system "iPhone") (eq $system "Android"))` | 
| not | Restituisce vero se la condizione è falsa | `(not (eq $region "eu-west-1"))` | 

Operatori di confronto



| Operatore | Description | Esempio | 
| --- | --- | --- | 
| eq | Equals | `(eq $system "iPhone")` | 
| uno | Non uguale | `(ne $region "us-west-2")` | 
| lt | Less than | `(lt $osVersion 1.8)` | 
| lte | Minore di o uguale a | `(lte $osVersion 2.0)` | 
| gt | Greater than | `(gt $appVersion 5.0)` | 
| gte | Maggiore di o uguale a | `(gte $appVersion 5.0)` | 

Operatori di stringa e set



| Operatore | Description | Esempio | 
| --- | --- | --- | 
| in | Corrisponde a qualsiasi valore in un elenco | `(in $region ["us-east-1" "us-west-2"])` | 
| contiene | Verifica se un valore contiene una sottostringa | `(contains $deviceName "iPhone")` | 

**Nota**  
Gli operatori disponibili possono variare a seconda di come gli attributi vengono definiti e valutati nell'applicazione.