

**Avviso di fine del supporto:** il 30 ottobre 2026, AWS terminerà il supporto per Amazon Pinpoint. Dopo il 30 ottobre 2026, non potrai più accedere alla console Amazon Pinpoint o alle risorse Amazon Pinpoint (endpoint, segmenti, campagne, percorsi e analisi). Per ulteriori informazioni, consulta [Fine del supporto di Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Nota: per quanto** APIs riguarda gli SMS, i comandi vocali, i messaggi push su dispositivi mobili, l'OTP e la convalida del numero di telefono non sono interessati da questa modifica e sono supportati da End User Messaging. AWS 

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à.

# Segmenti di Amazon Pinpoint
<a name="segments"></a>

Quando crei una campagna, devi scegliere un *segmento* a cui inviarla. Un segmento è un gruppo di clienti che condividono determinati attributi. Ad esempio, un segmento potrebbe contenere tutti i clienti che utilizzano la versione 2.0 della tua app su un dispositivo Android o tutti i clienti che vivono nella città di Los Angeles. Puoi inviare più campagne a un singolo segmento, oltre che aggiungere una singola campagna a più segmenti.

**Nota**  
Ti consigliamo di utilizzare i dati di tutti i segmenti importati ed eliminare i dati dei segmenti da un progetto che non ti serve più. Ad esempio, puoi [eliminare gli endpoint a livello di codice per rimuovere i dati dei segmenti](https://docs.aws.amazon.com/pinpoint/latest/developerguide/audience-define-remove.html) non utilizzati. L'accumulo di dati sui segmenti all'interno di un progetto può causare ritardi nei successivi processi di importazione.

Esistono due tipi di segmenti che puoi creare in Amazon Pinpoint:
+ **Segmenti dinamici**: segmenti basati su attributi definiti da te. I segmenti dinamici possono cambiare nel tempo. Ad esempio, se aggiungi nuovi endpoint ad Amazon Pinpoint o se modifichi o elimini gli endpoint esistenti, è possibile che il numero di endpoint in un segmento aumenti o diminuisca. Per ulteriori informazioni sui segmenti dinamici, consultare [Creazione di segmenti](segments-building.md).
+ **Segmenti importati**: segmenti creati al di fuori di Amazon Pinpoint e salvati in formato CSV o JSON. Quando crei un segmento importato, carichi i file su Amazon Simple Storage Service (Amazon S3). Amazon Pinpoint recupera i file da Amazon S3 e crea nuovi endpoint in base al contenuto di tali file. I segmenti importati sono statici, ovvero non cambiano mai. Per apportare modifiche, è necessario reimportare il segmento con tali modifiche. Quando crei un nuovo segmento, puoi utilizzarne uno importato come base, quindi raffinarlo aggiungendo dei filtri. Per ulteriori informazioni sull'importazione di segmenti, consultare [Importazione di segmenti](segments-importing.md).

# Creazione di segmenti
<a name="segments-building"></a>

Dopo aver integrato le applicazioni con Amazon Pinpoint, è possibile creare segmenti dinamici basati sui dati forniti dalle app ad Amazon Pinpoint. Quando crei un segmento dinamico, scegli il tipo di segmento che desideri creare, crea un gruppo di segmenti e quindi perfeziona il gruppo di segmenti scegliendo i segmenti e i criteri che li definiscono. Ad esempio, puoi creare un gruppo di segmenti dinamici e quindi scegliere un segmento di pubblico e i criteri di tutti i clienti che hanno utilizzato la versione 2.0 della tua app su un dispositivo Android negli ultimi 30 giorni. Amazon Pinpoint continua ad aggiornare il valore dei segmenti man mano che l'app registra nuove interazioni con i clienti. Di conseguenza, le dimensioni e l'appartenenza di ciascun segmento cambia nel tempo. Per informazioni sull'integrazione delle app con Amazon Pinpoint, consulta [Integrazione di Amazon Pinpoint con le applicazioni](https://docs.aws.amazon.com/pinpoint/latest/developerguide/integrate.html) nella *Guida per gli sviluppatori di Amazon Pinpoint*.

## Gruppi di segmenti
<a name="segments-building-groups"></a>

Quando crei un segmento dinamico, devi creare uno o più *gruppi di segmenti*. Un gruppo di segmenti include i seguenti componenti:
+ **Segmenti di base**: segmenti che definiscono la popolazione iniziale di utenti. Puoi specificare un singolo segmento di base, svariati segmenti di base oppure tutti i segmenti nel progetto Amazon Pinpoint.
+ **Criteri**: categorie di informazioni sul pubblico che applichi in aggiunta ai segmenti di base. È possibile aggiungere più gruppi di criteri e quindi creare relazioni tra criteri. 
+ **Filtri**: i filtri riducono il numero di destinatari appartenenti al segmento. Puoi aggiungere la quantità di filtri che desideri per adattare il segmento per le tue esigenze. 

È necessario creare almeno un gruppo di segmenti, ma facoltativamente è possibile creare un secondo gruppo di segmenti e quindi creare una relazione tra i due gruppi. 

## Creazione di un segmento dinamico
<a name="segments-building-procedure"></a>

I passaggi seguenti descrivono la creazione e la configurazione di un segmento:
+ [Passaggio 1: creare un nuovo segmento o importare un segmento esistente](#segment-building-new)
+ [Passaggio 2: configurare il gruppo di segmenti 1](#segmentconfigure)
+ [Passaggio 3: selezionare i segmenti da includere nel gruppo](#choosesegments)
+ [Passaggio 4: selezionare e configurare i criteri dei segmenti](#choosecriteria)
+ [Passaggio 5: aggiungere un secondo gruppo di criteri](#addsecondcriteria)
+ [Passaggio 6: aggiungere il gruppo di segmenti 2](#addsegmentgroup)

### Passaggio 1: creare un nuovo segmento o importare un segmento esistente
<a name="segment-building-new"></a>

**Per creare un segmento**

1. Accedi a Console di gestione AWS e apri la console Amazon Pinpoint all'indirizzo. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Nella pagina **All projects (Tutti i progetti)**, scegliere il progetto a cui aggiungere il segmento.

1. Nel riquadro di navigazione, selezionare **Segments (Segmenti)**. Viene aperta la pagina **Segments (Segmenti)** e visualizzati i segmenti definiti in precedenza.

1. Scegliere **Create a segment (Crea segmento)**.

1. In **Create a segment (Crea segmento)**, scegliere **Build a segment (Compila segmento)**.  
![\[La pagina Create a segment (Crea segmento) con l'opzione Build a segment (Compila segmento) selezionata.\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/segments_build.png)

1. In **Segment name (Nome segmento)**, immettere un nome per il segmento.

### Passaggio 2: configurare il gruppo di segmenti 1
<a name="segmentconfigure"></a>

Per prima cosa sceglierai come definire i segmenti di pubblico per il gruppo di segmenti.

**Per configurare il gruppo di segmenti 1**
+ In **Gruppo di segmenti 1**, in **Segmenti di base** scegli una delle seguenti opzioni:
  + **Includi qualsiasi tipo di pubblico**: se utilizzi più di un segmento come segmento di base, il nuovo segmento contiene endpoint che si trovano in almeno uno dei segmenti scelti. Ad esempio, potresti avere due segmenti dinamici e. *Older than 18* *Lives in New York City* Quando scegli questa opzione, il pubblico di destinazione è qualsiasi pubblico di età superiore ai 18 anni *o* che vive a New York City. 
  + **Includi tutti i tipi di pubblico**: se utilizzi più di un segmento come segmento di base, il nuovo segmento contiene solo gli endpoint comuni a tutti i segmenti selezionati. Ad esempio, potresti avere due segmenti dinamici e. *Older than 18* *Lives in New York City* *Quando scegli questa opzione, il tuo pubblico di destinazione è costituito da tutti i segmenti di pubblico di età superiore ai 18 anni che vivono a New York City.*   
![\[Sezione Gruppo di segmenti 1 con l'opzione Includi tutti i tipi di pubblico.\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/segments_any_all.png)

### Passaggio 3: selezionare i segmenti da includere nel gruppo
<a name="choosesegments"></a>

Il passaggio successivo consiste nello scegliere quali segmenti includere nel gruppo. Questi segmenti sono composti dal pubblico a cui desideri rivolgerti nel gruppo di segmenti.

1. Nell'elenco a discesa, seleziona uno o più segmenti da includere nel gruppo di segmenti. Ogni segmento aggiunto viene visualizzato nella sezione. 
**Nota**  
L'elenco a discesa dei segmenti non si chiude quando scegli un segmento. Rimane aperto, con un segno di spunta accanto a ogni segmento che includi nel gruppo. Puoi deselezionare la casella di controllo accanto a qualsiasi segmento che desideri rimuovere. Quando hai finito di scegliere i segmenti, scegli un'area al di fuori dell'elenco a discesa per chiuderla.  
![\[Elenco a discesa del gruppo di segmenti 1 con i segmenti disponibili.\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/segments_any_drop_down_selected.png)

1. Man mano che aggiungi o rimuovi segmenti, la sezione Stima del segmento si aggiorna per visualizzare gli endpoint idonei e totali impostati per ricevere la campagna. Gli endpoint idonei sono gli endpoint determinati dalla any/and relazione per il gruppo di segmenti, mentre il totale è la somma di tutti gli endpoint indipendentemente dal connettore di relazione.  
![\[Stima del segmento che mostra gli endpoint disponibili e gli endpoint idonei.\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/segments_estimate.png)

### Passaggio 4: selezionare e configurare i criteri dei segmenti
<a name="choosecriteria"></a>

Dopo aver scelto i segmenti, è possibile rifinire ulteriormente il pubblico di destinazione applicando attributi, operatori e valori a tali segmenti. 

**Per scegliere e configurare i criteri del segmento**

1. Per **Attributo**, puoi scegliere tra i seguenti tipi: 
   +  **Attributi standard**: filtra il pubblico in base a uno dei suoi attributi predefiniti. 
   + **Tipi di canale**: filtra il pubblico in base al tipo di endpoint del destinatario, ovvero E-MAIL, SMS, PUSH o PERSONALIZZATO. 
   + **Attività**: filtra il pubblico in base allo stato attivo o inattivo. 
   + **Attributi endpoint personalizzati**: filtra il pubblico in base a un attributo specifico dell'endpoint. Ad esempio, può trattarsi di un elenco di clienti che hanno effettuato l'opt-out da una lista di distribuzione o di un elenco di clienti che si sono iscritti a una lista di distribuzione. 
   + **Attributi utente del cliente**: filtra il pubblico in base a un attributo specifico dell'utente. Ad esempio, potrebbe essere *LastName* o *FirstName*. 
   + **Parametri**: filtra il pubblico in base a una valutazione quantitativa. Ad esempio, potresti avere una metrica che puoi scegliere se desideri rivolgerti a un pubblico che ha visitato una località specifica un *x* numero di volte. *Visits*

1. In **Operatore** scegli l'operatore desiderato e immetti il relativo valore in **Valore**. Gli operatori determinano la relazione tra l'attributo e un valore immesso. I valori non possono contenere più di 100 caratteri e non possono essere presenti più di 100 valori totali tra tutti i gruppi, i criteri e i filtri. Di seguito vengono descritti gli operatori disponibili. Ogni attributo ha il proprio set di operatori supportati. 
**Nota**  
Gli attributi Channel Types non utilizzano operatori o valori.
   + **Dopo**: filtra il pubblico dopo una data specifica. 
   + **Prima di**: filtra il pubblico prima di una data specifica. 
   + **Tra**: filtra il pubblico in base a un intervallo di date.
   + **Contiene**: utilizza questo operatore per filtrare il pubblico in base a una sottostringa all'interno di una stringa. Ad esempio, se hai una metrica relativa alla città, puoi passare *ew* a Return *New York City* o Newcastle. Il valore passato fa distinzione tra maiuscole e minuscole, quindi *ew* restituisce risultati diversi da. *EW* 
   + **Durante**: utilizzato solo per l'attributo Attività. Filtra il pubblico in base a uno dei seguenti intervalli di tempo: **ultimo giorno**, **ultimi 7 giorni**, **ultimi 14 giorni** o **ultimi 30 giorni**. 
   + **Uguale**: utilizzato solo per gli attributi Metrics, questo operatore filtra i risultati in base a un valore numerico. Ad esempio, potresti avere una metrica che puoi utilizzare per filtrare i risultati solo in base ai clienti che hanno visitato gli orari di una località. *Visits* *3* 
   + **Maggiore di**: utilizzato solo per gli attributi Metrics, questo operatore filtra i risultati superiori al numero passato. Ad esempio, potresti avere una metrica che puoi utilizzare per filtrare i risultati solo in base ai clienti che hanno visitato una località più volte*3*. *Visits* 
   + **Maggiore o uguale**: utilizzato solo per gli attributi Metrics, questo operatore filtra i risultati maggiori o uguali al numero passato. Ad esempio, se disponi di una metrica*Visits*, puoi utilizzare questo operatore per filtrare i risultati solo in base ai clienti che hanno visitato una località *3* o più volte.
   + **È**: utilizza questa opzione per filtrare in base agli attributi specifici dell'endpoint. Quando si seleziona questa opzione, è necessario specificare l'ultima volta che l'endpoint era attivo o da quanto è attivo. Quindi, è possibile specificare ulteriori attributi associati a tale endpoint. 
   + **Non è**: utilizza questa opzione per filtrare i risultati che corrispondono al valore specificato. Ad esempio, potresti avere un endpoint utente *city* cliente che puoi utilizzare per filtrare i risultati che includono una città specifica. Usa questo operatore e *New York City* for the value per ignorare tutti i risultati che includono questa città. 
   + **Meno di**: utilizzato solo per gli attributi Metrics, questo operatore filtra i risultati inferiori al numero passato. Ad esempio, potresti avere una metrica che puoi utilizzare per filtrare i risultati solo in base ai clienti che hanno visitato una sede meno di volte*3*. *Visits* 
   + **Minore o uguale**: utilizzato solo per gli attributi Metrics, questo operatore filtra i risultati inferiori o uguali al numero passato. Ad esempio, potresti avere una metrica che puoi utilizzare per filtrare i risultati solo in base ai clienti che hanno visitato una località o *3* meno. *Visits* 
   + **Il**: utilizza questa metrica per filtrare i risultati. Ad esempio, potresti avere una metrica che puoi utilizzare per filtrare i risultati solo in base ai clienti che hanno scelto di non partecipare a una lista di distribuzione. *OptOut* *2020/11/09*
**Nota**  
La console Amazon Pinpoint utilizza l'ora predefinita 00:00:00 UTC per tutti i filtri basati sull'ora. Puoi filtrare in base alle date, ma le ore vengono registrate con lo stesso valore. Se inserisci una data di*2020-12-31*, la console passerà l'ora come*2020-12-31T12:00:00Z*. Pertanto, se hai più segmenti che superano la data 2020-20-12 con orari diversi, la console Amazon Pinpoint registra la data e l'ora di ognuno di questi segmenti come. *2020-12-31T12:00:00Z*

1. (Facoltativo) Per applicare attributi aggiuntivi a questi criteri, scegli **Aggiungi filtro**. Per creare criteri per un altro gruppo di segmenti, scegli **Aggiungi criteri**. Per creare un secondo gruppo di segmenti, scegli **Aggiungi un altro gruppo di segmenti**. Per ulteriori informazioni sull'aggiunta di un secondo gruppo di segmenti, consulta [Passaggio 6: aggiungere il gruppo di segmenti 2](#addsegmentgroup).

1. Dopo aver completato la configurazione di questo segmento, scegli **Crea segmento**.

### Passaggio 5: aggiungere un secondo gruppo di criteri
<a name="addsecondcriteria"></a>

Se lo desideri, aggiungi gruppi di criteri per affinare ulteriormente i risultati. Creerai una relazione tra questo gruppo di criteri e il gruppo precedente. 

**Per aggiungere un secondo gruppo di criteri**

1. Scegli **Aggiungi criteri**. 

1. Crea la relazione tra questo gruppo e il gruppo precedente scegliendo uno dei seguenti connettori:
   + **E**: il segmento contiene solo i segmenti di pubblico che soddisfano i criteri per entrambi i gruppi di criteri.
   + **OPPURE**: il segmento contiene i segmenti di pubblico che soddisfano i criteri di uno dei gruppi di criteri.
   + **NOR**: il segmento esclude i segmenti di pubblico che soddisfano i criteri dai risultati.   
![\[Connettore di relazione utilizzato per impostare la relazione tra due gruppi di criteri.\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/segments_and_or_nor.png)

1. (Facoltativo) Per aggiungere un altro gruppo di criteri, scegli **Aggiungi criteri** oppure, per aggiungere un secondo gruppo di segmenti, scegli **Aggiungi un altro gruppo di segmenti**. Per ulteriori informazioni, consulta [Passaggio 6: aggiungere il gruppo di segmenti 2](#addsegmentgroup).

1. Dopo aver completato la configurazione del gruppo di segmenti, scegli **Crea segmento**.

### Passaggio 6: aggiungere il gruppo di segmenti 2
<a name="addsegmentgroup"></a>

Facoltativamente, puoi creare un secondo gruppo di segmenti e creare una relazione con il gruppo di segmenti 1. Quando si crea un segmento utilizzando la console Amazon Pinpoint, è possibile aggiungere un massimo di due gruppi di segmenti per segmento. Se aggiungi un secondo gruppo al segmento, puoi scegliere tra due modalità di collegamento tra i due gruppi di segmenti.
+ **Mediante la logica AND**: se utilizzi la logica AND per collegare due gruppi di segmenti, il segmento conterrà tutti gli endpoint che soddisfano tutti i criteri di entrambi i gruppi di segmenti.
+ **Mediante la logica OR**: se utilizzi la logica OR per collegare due gruppi di segmenti, il segmento conterrà tutti gli endpoint che soddisfano tutti i criteri di uno dei gruppi di segmenti.

**Nota**  
Se come base per il primo gruppo di segmenti si utilizza un segmento importato, non è possibile creare un secondo gruppo di segmenti.

**Per configurare il secondo gruppo di segmenti**

1. Scegli **Aggiungi un altro gruppo di segmenti**.

1.  Crea la relazione con il primo gruppo di segmenti. Se scegli **AND**, il segmento contiene solo i clienti che soddisfano i criteri di entrambi i gruppi di segmenti. Se scegli **OR**, il segmento contiene solo i clienti che soddisfano i criteri di uno dei gruppi di segmenti. All'interno del gruppo di segmenti 2, è disponibile una terza opzione per **escludere i segmenti di pubblico**. I segmenti esclusi non verranno inclusi nei risultati. Puoi escludere i tipi di pubblico solo nel gruppo di segmenti 2.  
![\[Gruppo di segmenti 2 che mostra il connettore di relazione per escludere i tipi di pubblico.\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/segments_groups_logic.png)

1. Scegli i segmenti che desideri includere nel gruppo di segmenti 2. Per informazioni, consulta [Passaggio 3: selezionare i segmenti da includere nel gruppo](#choosesegments).

1. (Facoltativo) Scegliete i criteri in base ai quali filtrare i segmenti. Per informazioni, consulta [Passaggio 4: selezionare e configurare i criteri dei segmenti](#choosecriteria).

1. (Facoltativo) Aggiungi altri gruppi di criteri. Per informazioni, consulta [Passaggio 5: aggiungere un secondo gruppo di criteri](#addsecondcriteria).

1. Una volta terminata la configurazione del segmento, scegliere **Create segment (Crea segmento)**.

# Gestione dei segmenti
<a name="segments-managing"></a>

È possibile utilizzare la console Amazon Pinpoint per creare, visualizzare, copiare ed eseguire altre attività di gestione per i segmenti di un progetto. Se apri un segmento per visualizzarne le impostazioni, puoi anche creare rapidamente una campagna che utilizza il segmento. Per ulteriori informazioni sulla gestione dei segmenti, consulta [Creazione di segmenti](https://docs.aws.amazon.com/pinpoint/latest/developerguide/segments.html) nella Amazon Pinpoint Developer Guide.

**Per gestire un segmento**

1. Accedi a Console di gestione AWS e apri la console Amazon Pinpoint all'indirizzo. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Nella pagina **All projects (Tutti i progetti)**, scegliere il progetto contenente i segmenti che si desidera gestire.

1. Nel riquadro di navigazione, selezionare **Segments (Segmenti)**.

1. Nell'elenco di segmenti, selezionare il segmento da gestire.

1.  Nel menu **Actions (Operazioni)** scegliere una delle opzioni indicate di seguito:
   + **Visualizza i dettagli**: scegli questa opzione per visualizzare le informazioni relative al segmento, tra cui la data e l'ora di creazione o dell'ultimo aggiornamento del segmento.

     Quando si visualizzano i dettagli di un segmento dinamico, è anche possibile visualizzare il numero approssimativo di endpoint che soddisfano i criteri del segmento, nonché i gruppi del segmento e i filtri che definiscono il segmento. Quando si visualizzano i dettagli di un segmento importato, viene visualizzato anche il numero di record importati per il segmento. Se il segmento è stato importato da una posizione Amazon S3, vengono visualizzati anche i dettagli relativi a tale posizione e il nome del ruolo IAM utilizzato per importare il segmento da tale posizione.
   + **Modifica**: scegli questa opzione per modificare le impostazioni di un segmento dinamico.
**Nota**  
Non è possibile modificare le proprietà di un segmento importato.
   + **Copia su nuovo**: scegli questa opzione per creare un nuovo segmento da una copia del segmento selezionato. È quindi possibile modificare qualsiasi impostazione nel nuovo segmento, senza modificare il segmento originale.
   + **Esporta**: scegli questa opzione per esportare il segmento in un file su computer. Per ulteriori informazioni, consulta [Esportazione di segmenti](segments-exporting.md).
   + **Elimina**: scegli questa opzione per eliminare definitivamente il segmento. Non è possibile tuttavia recuperare un budget eliminato.
**Importante**  
Se si elimina un segmento, qualsiasi campagna attiva che utilizza il segmento avrà esito negativo e si interromperà. Analogamente, eventuali viaggi attivi che utilizzano il segmento potrebbero non riuscire e smettere di funzionare. Se un viaggio continua a funzionare, è possibile che tutti i partecipanti che facevano parte del segmento vengano rimossi prematuramente dal viaggio. Prima di eliminare un segmento, è consigliabile verificare innanzitutto che non sia utilizzato da campagne o viaggi attivi. 

# Importazione di segmenti
<a name="segments-importing"></a>

Con Amazon Pinpoint, puoi definire un segmento di utenti importando un file contenente le informazioni sugli utenti che appartengono al segmento. L'importazione di segmenti è utile se definisci i segmenti di utenti al di fuori di Amazon Pinpoint, ma desideri coinvolgere i tuoi utenti nelle campagne di Amazon Pinpoint.

**A differenza dei segmenti dinamici creati con il generatore di segmenti nella console, un segmento importato è un insieme immutabile di endpoint o utenti: IDs** 

**Endpoint**  
Una destinazione alla quale puoi inviare dei messaggi, ad esempio un indirizzo e-mail, l'identificatore di un dispositivo o un numero di telefono cellulare. La definizione di un endpoint può includere attributi che descrivono l'utente o il dispositivo al quale invii i messaggi, nonché un ID utente.   
Puoi definire un segmento importando un elenco di definizioni di endpoint. Amazon Pinpoint crea il segmento e aggiorna tutti gli endpoint precedentemente aggiunti ad Amazon Pinpoint con le nuove informazioni.

**ID utente**  
Un ID che rappresenta un singolo utente nel tuo pubblico. Tale ID deve essere assegnato a uno o più endpoint. Ad esempio, se una persona usa l'app su più dispositivi, l'app può assegnare l'ID utente di quella persona all'endpoint per ogni dispositivo.  
Puoi definire un segmento importando l'utente IDs solo se hai aggiunto gli endpoint associati all'utente IDs ad Amazon Pinpoint.

Un segmento importato è composto da endpoint IDs, utenti o una combinazione di entrambi. Quando utilizzi Amazon Pinpoint per inviare un messaggio al segmento, le potenziali destinazioni includono:
+ Ogni endpoint elencato nel file importato.
+ Ogni endpoint associato a ciascun utente ID elencato nel file importato.

Per la creazione di un nuovo segmento, come base puoi utilizzare un segmento importato. Quindi puoi applicare dei filtri al segmento base per raffinarlo in base alle tue esigenze.

## Considerazioni sui segmenti importati
<a name="segments-importing-considerations"></a>

Quando crei segmenti importati, tieni in considerazione i seguenti fattori:
+ Quando crei una campagna, devi scegliere un segmento. Se scegli un segmento dinamico, Amazon Pinpoint fornisce una stima delle dimensioni di tale segmento. Tuttavia, se scegli un segmento importato, Amazon Pinpoint non è in grado di fornire una stima.
+ Se crei una campagna che invia messaggi quando si verificano determinati eventi, non puoi utilizzare segmenti importati; per le campagne basate su eventi puoi utilizzare solo i segmenti dinamici. Per ulteriori informazioni sulla creazione di segmenti dinamici, consultare [Creazione di segmenti](segments-building.md).

## File di segmenti
<a name="segments-importing-examples-files"></a>

Definisci gli endpoint o gli utenti IDs che appartengono al tuo segmento in un file con valori separati da virgole (CSV) o JSON. Quindi, puoi importare il file in Amazon Pinpoint per creare il segmento.

Per l'importazione di un segmento, ricorda quanto segue:
+ Amazon Pinpoint non può importare file compressi.
+ I file da importare devono utilizzare la codifica dei caratteri UTF-8.
+ Se stai importando nuovi endpoint, sono richiesti gli attributi `Address` e `ChannelType`.
+ Se stai aggiornando endpoint esistenti, è richiesto l'attributo `Id` per ogni endpoint che vuoi aggiornare.
+ Le definizioni degli endpoint possono includere solo determinati attributi. Per un elenco, consulta [Attributi supportati](#segments-importing-available-attributes). Inoltre, il nome di un attributo deve contenere al massimo 50 caratteri. Il valore di un attributo deve contenere al massimo 100 caratteri.

### Esempi di file di segmento
<a name="segments-importing-examples"></a>

I file di esempio in questa sezione sono basati sui seguenti dati:


**Esempio di valori di attributi degli endpoint**  

| ChannelType | Indirizzo | Location.Country | Demographic.Platform | Demographic.Make | Utente. UserId | 
| --- | --- | --- | --- | --- | --- | 
| SMS | \$116045550182 | CA | Android | LG | example-user-id-1 | 
| APNS | 1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f | US | iOS | Apple | example-user-id-2 | 
| EMAIL | john.stiles@example.com | US | iOS | Apple | example-user-id-2 | 
| GCM | 4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c | CN | Android | Google | example-user-id-3 | 
| EMAIL | wang.xiulan@example.com | CN | Android | OnePlus | example-user-id-3 | 

Ogni riga della tabella rappresenta un singolo endpoint. Tieni presente che l'utente IDs `example-user-id-2` e `example-user-id-3` io siamo assegnati a due endpoint ciascuno.

**Example File con definizioni degli endpoint**  
È possibile importare gli endpoint definiti in un file CSV, come nell'esempio seguente:  

```
ChannelType,Address,Location.Country,Demographic.Platform,Demographic.Make,User.UserId
SMS,+16045550182,CA,Android,LG,example-user-id-1
APNS,1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f,US,iOS,Apple,example-user-id-2
EMAIL,john.stiles@example.com,US,iOS,Apple,example-user-id-2
GCM,4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c,CN,Android,Google,example-user-id-3
EMAIL,wang.xiulan@example.com,CN,Android,OnePlus,example-user-id-3
```
La prima riga è l'intestazione, che contiene gli attributi degli endpoint. Per un elenco completo dei possibili attributi, consulta [Attributi supportati](#segments-importing-available-attributes).  
Le righe successive definiscono gli endpoint fornendo valori per ciascun attributo nell'intestazione.  
Per includere una virgola o le virgolette in un valore, racchiudi il valore tra virgolette, come in `"aaa,bbb"`.   
Il file CSV non può contenere interruzioni di riga o tabulazioni. Se il file contiene dati con interruzioni di riga o tabulazioni, è possibile che i dati del file non vengano importati o che il processo di importazione abbia esito negativo.
Puoi importare gli endpoint definiti in un file JSON delimitato da nuove righe. In questo formato, ogni riga è un oggetto JSON completo che contiene una singola definizione di endpoint, come nell'esempio seguente:  

```
{"ChannelType":"SMS","Address":"+16045550182","Location":{"Country":"CA"},"Demographic":{"Platform":"Android","Make":"LG"},"User":{"UserId":"example-user-id-1"}}
{"ChannelType":"APNS","Address":"1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f","Location":{"Country":"US"},"Demographic":{"Platform":"iOS","Make":"Apple"},"User":{"UserId":"example-user-id-2"}}
{"ChannelType":"EMAIL","Address":"john.stiles@example.com","Location":{"Country":"US"},"Demographic":{"Platform":"iOS","Make":"Apple"},"User":{"UserId":"example-user-id-2"}}
{"ChannelType":"GCM","Address":"4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c","Location":{"Country":"CN"},"Demographic":{"Platform":"Android","Make":"Google"},"User":{"UserId":"example-user-id-3"}}
{"ChannelType":"EMAIL","Address":"wang.xiulan@example.com","Location":{"Country":"CN"},"Demographic":{"Platform":"Android","Make":"OnePlus"},"User":{"UserId":"example-user-id-3"}}
```
Per un elenco completo dei possibili attributi, consulta [Attributi supportati](#segments-importing-available-attributes).

## Importazione di un segmento
<a name="segments-importing-procedure"></a>

Esistono due modi per importare i segmenti in Amazon Pinpoint: puoi caricare i file direttamente dal tuo computer oppure puoi importare file archiviati in un bucket Amazon Simple Storage Service (Amazon S3).

Ti consigliamo di caricare file dal tuo computer, soprattutto se hai già i dati dei clienti sul tuo computer. Tuttavia, è possibile importare solo dieci file alla volta e caricare esclusivamente file di dimensioni inferiori a 1 gigabyte (GB).

Se devi importare più di 10 file contemporaneamente o se devi caricare file di dimensioni superiori a 1 GB, devi importare file da Amazon S3. L'opzione di importazione da Amazon S3 è utile anche se si dispone già di processi che inviano file di dati del cliente ad Amazon S3 per l'archiviazione.

Questa sezione include le procedure per l'importazione di segmenti tramite l'uso di entrambi i metodi.

### Importazione di un segmento caricando un file dal computer
<a name="segments-importing-procedure-direct-import"></a>

Puoi creare segmenti caricando fino a dieci file direttamente dal computer. I file da caricare possono essere in formato JSON o CSV. È possibile caricare file in qualsiasi combinazione di formati. Ad esempio, un file JSON e tre file CSV.

**Per importare un segmento**

1. Apri la console Amazon Pinpoint all'indirizzo. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Nella pagina **All projects (Tutti i progetti)**, scegliere il progetto a cui aggiungere il segmento.

1. Nel riquadro di navigazione, selezionare **Segments (Segmenti)**.

1. Scegliere **Create a segment (Crea segmento)**.

1. In **Create a segment (Crea segmento)**, scegliere **Import a segment (Importa segmento)**.

1. In **Import method (Importa metodo)**, scegliere**Upload files from your computer (Carica file dal computer)**.

1. In **Files to import (File da importare)**, selezionare **Choose files (Scegli file)**. Selezionare il file o i file che si desidera importare.
**Nota**  
È anche possibile trascinare i file da Esplora file del computer e rilasciarli direttamente sull'area **Drop files here (Rilascia i file qui**.

1. Quando si caricano i file in Amazon Pinpoint, è necessario fornire un nome di segmento per ogni file importato. In **Nomi dei segmenti**, inserisci un nome di segmento per ogni file che desideri importare.

   Per impostazione predefinita, Amazon Pinpoint fornisce un nome di segmento che corrisponde al nome del file importato, ma senza l'estensione. Tali valori predefiniti possono essere sostituiti con qualsiasi nome.  
![\[\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/segments-import-names.png)
**Nota**  
È possibile utilizzare lo stesso nome per più segmenti. In caso contrario, Amazon Pinpoint crea un segmento distinto e assegna un ID univoco a ogni file. Anche la data di creazione è leggermente diversa per ogni file importato. È possibile utilizzare questi fattori per distinguere segmenti con lo stesso nome.

1. Al termine, selezionare **Create segment (Crea segmento)**.

### Importazione di un segmento da un file archiviato in Amazon S3
<a name="segments-importing-procedure-s3-import"></a>

Prima di utilizzare questa procedura per importare un segmento, devi prima creare un bucket Amazon S3 e caricare il file in quel bucket. Puoi organizzare i file di segmenti diversi in cartelle separate. Quando Amazon Pinpoint importa gli endpoint o l'utente IDs per un segmento, include i file in tutte le cartelle e sottocartelle che appartengono alla posizione Amazon S3 specificata.

Per un'introduzione alla creazione di bucket e al caricamento di oggetti, consulta [What is Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)? nella Guida per l'utente di Amazon Simple Storage Service.

Amazon Pinpoint è in grado di importare solo un formato di file (CSV o JSON) per ogni segmento, in modo che il percorso Amazon S3 specificato contenga solo i file di un unico tipo.

**Per importare un segmento**

1. Apri la console Amazon Pinpoint all'indirizzo. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Nella pagina **All projects (Tutti i progetti)**, scegliere il progetto a cui aggiungere il segmento.

1. Nel riquadro di navigazione, selezionare **Segments (Segmenti)**.

1. Scegliere **Create a segment (Crea segmento)**.

1. In **Create a segment (Crea segmento)**, scegliere **Import a segment (Importa segmento)**.

1. Per **Nome del segmento**, inserisci un nome per il segmento.

1. in **URL Amazon S3**, immetti il percorso del bucket Amazon S3 contenente il file del segmento. L'indirizzo del bucket deve essere nel formato seguente:

   ```
   s3://bucket-name/folder-name
   ```

   Amazon Pinpoint importa i file dal percorso specificato e da qualsiasi sottocartella presente in tale percorso.

1. In **Ruolo IAM**, completare una delle seguenti fasi:
   + Se desideri che Amazon Pinpoint crei un ruolo che gli consenta di leggere da un bucket Amazon S3, scegli **Crea un ruolo automaticamente**. Quindi, per **IAM role (Ruolo IAM)**, immettere un nome per il ruolo che si sta creando.
   + Se è già stato creato un ruolo IAM che consente ad Amazon Pinpoint di leggere da un bucket Amazon S3, seleziona **Scegli un ruolo esistente**. Quindi, per **IAM role (Ruolo IAM)**, scegliere un ruolo che contiene le autorizzazioni appropriate.

   Se desideri creare personalmente il ruolo IAM, consulta [Ruolo IAM per l'importazione di endpoint o segmenti](https://docs.aws.amazon.com/pinpoint/latest/developerguide/permissions-import-segment.html) nella *Guida per gli sviluppatori di Amazon Pinpoint*. Dopo avere creato il ruolo, specificalo nella console Amazon Pinpoint.

1. In **Che tipo di file stai importando**, scegli **JavaScript Object Notation (JSON)** o **Comma-Separated Values (CSV)**, a seconda del formato del file che hai caricato su Amazon S3.

1. Scegli **Create segment** (Crea segmento).

## Attributi supportati
<a name="segments-importing-available-attributes"></a>

La tabella in questa sezione elenca e descrive gli attributi che è possibile specificare, nelle definizioni degli endpoint, da importare in Amazon Pinpoint. Se importi segmenti utilizzando file CSV, le intestazioni nel file devono corrispondere ai nomi mostrati nella colonna **Attribute (Attributo)**.

Per i file JSON, un punto nel nome dell'attributo indica che il nome dopo il punto è un oggetto nidificato in un oggetto padre con un nome uguale al valore che precede il punto. Ad esempio, un file JSON che contiene gli attributi `Demographic.Model` e `Demographic.Make` ha la seguente struttura:

```
{
...
"Demographic": {
  ...
  "Make":"Apple",
  "Model":"iPhone"
  ...
  }
...
}
```

La struttura JSON completa assomiglia molto a quella dell'[esempio di richiesta dell'endpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-endpoints-endpoint-id.html#apps-application-id-endpoints-endpoint-id-schemas) nella *documentazione di riferimento dell'API Amazon Pinpoint*. Tuttavia, non tutti gli attributi nello schema di richiesta dell'endpoint sono supportati quando importi i segmenti, inclusi `EndpointStatus` ed `EffectiveDate`.

Affinché un campo personalizzato abbia più valori in CSV, devi replicare l'intestazione e mantenere un valore per intestazione. Esempio:

```
...,User.UserId, User.UserAttributes.new_multi_field,User.UserAttributes.new_multi_field
...,example-user-id-2,test10,test20
```

È possibile sostituire i nomi di attributo mostrati come `custom_attribute` con qualsiasi valore. Ad esempio, per memorizzare il nome e il cognome degli utenti in attributi denominati `FirstName` e `LastName`, è possibile creare attributi personalizzati denominati `User.UserAttributes.FirstName` e `User.UserAttributes.LastName`, rispettivamente. Un nome di attributo può contenere fino a 50 caratteri. Un valore di attributo può contenere fino a 100 caratteri. I nomi degli attributi prevedono una distinzione tra lettere maiuscole e minuscole.

In JSON, l'attributo personalizzato deve essere formattato in. `"Attributes":{"Ride":["Bus"]}`


| Attributo | Description | 
| --- | --- | 
| Time zone (Fuso orario) | Fuso orario rimappato | 
| --- | --- | 
| Address | Indirizzo di destinazione univoco per i messaggi o per le notifiche push che invii all'endpoint, ad esempio un indirizzo e-mail, un numero di telefono o un token del dispositivo.  Se l'indirizzo dell'endpoint è un numero di telefono, è necessario specificarlo nel formato E.164. Per ulteriori informazioni sul formato E.164, consulta la voce [E.164](https://en.wikipedia.org/wiki/E.164) su Wikipedia.   | 
| Attributes.custom\$1attribute | Un attributo personalizzato che descrive l'endpoint. È possibile utilizzare questo tipo di attributo come criterio di selezione quando si crea un segmento. Puoi sostituire custom\$1attribute con un valore qualsiasi. | 
| ChannelType | Il canale da utilizzare per l'invio di messaggi o notifiche push all'endpoint. Esempio:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/segments-importing.html) | 
| Demographic.AppVersion | Il numero di versione dell'applicazione associata all'endpoint. | 
| Demographic.Locale | La lingua dell'endpoint nel seguente formato: il codice [ISO 639-1 alfa-2](https://en.wikipedia.org/wiki/ISO_639-1), seguito da un trattino basso (\$1), seguito da un valore [ISO 3166-1 alfa-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Ad esempio, en\$1US è l'impostazione locale della lingua inglese per gli Stati Uniti. | 
| Demographic.Make | Il produttore del dispositivo endpoint, ad esempio apple o samsung. | 
| Demographic.Model | Il nome del modello o il numero del dispositivo endpoint, ad esempio iPhone o SM-G900F. | 
| Demographic.ModelVersion | La versione del modello del dispositivo endpoint. | 
| Demographic.Platform | Il sistema operativo del dispositivo endpoint, ad esempio ios o android. | 
| Demographic.PlatformVersion | La versione del sistema operativo del dispositivo endpoint. | 
| Demographic.Timezone | Il fuso orario dell'endpoint, espresso come valore del [database tz](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). Ad esempio, America/Los\$1Angeles per l'ora del Pacifico (Nord America).I seguenti fusi orari non sono più supportati e vengono automaticamente rimappati ai fusi orari supportati. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/segments-importing.html) | 
| EffectiveDate | La data e l'ora dell'ultimo aggiornamento dell'endpoint, nel formato [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Ad esempio, 2019-08-23T10:54:35.220Z per 10:54 AM UTC 23 agosto 2019. | 
| Id | L'identificatore univoco per l'endpoint. | 
| Location.City | La città in cui si trova l'endpoint. | 
| Location.Country | Il codice di due caratteri, nel [formato ISO 3166-1 alfa-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), del paese o della regione in cui si trova l'endpoint. Ad esempio, US per gli Stati Uniti. | 
| Location.Latitude | La latitudine della posizione dell'endpoint, arrotondata a una posizione decimale. | 
| Location.Longitude | La longitudine della posizione dell'endpoint, arrotondata a una posizione decimale. | 
| Location.PostalCode | Il codice postale o CAP dell'area in cui si trova l'endpoint. | 
| Location.Region | Nome della regione, ad esempio uno stato o una provincia, in cui si trova l'endpoint. | 
| Metrics.custom\$1attribute | Metrica numerica personalizzata che l'applicazione restituisce ad Amazon Pinpoint per l'endpoint, ad esempio il numero di sessioni o il numero di articoli rimasti nel carrello, da utilizzare per scopi di segmentazione. Puoi sostituire custom\$1attribute con un valore qualsiasi.Questi valori personalizzati possono essere solo numerici. Poiché sono numerici, Amazon Pinpoint è in grado di eseguire solo operazioni aritmetiche, ad esempio la media o la somma, su di essi. | 
| OptOut | Indica se un utente ha scelto di non ricevere messaggi e notifiche push dall'utente. I valori accettabili sono:ALL, l'utente ha effettuato l'opt-out e non desidera ricevere messaggi o notifiche push oppureNONE, l'utente non ha effettuato l'opt-out e desidera ricevere tutti i messaggi e le notifiche push. | 
| RequestId | L'Identificatore univoco della richiesta più recente per aggiornare l'endpoint. | 
| User.UserAttributes.custom\$1attribute | Un attributo personalizzato che descrive l'utente. Puoi sostituire custom\$1attribute con qualsiasi valore, come FirstName o Age. | 
| User.UserId | Un identificatore univoco per l'utente. | 
| Canada/East-Saskatchewan  | America/Managua | 
| US/Pacific-New  | America/Los\$1Angeles | 

È possibile creare fino a 250 attributi personalizzati per endpoint e utenti in ogni progetto. Per ulteriori informazioni, consultare [Quote di Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/developerguide/quotas.html) nella *Guida per gli sviluppatori di Amazon Pinpoint*.

# Esportazione di segmenti nella console Amazon Pinpoint
<a name="segments-exporting"></a>

Nella pagina **Segmenti** nella console Amazon Pinpoint, è possibile esportare un segmento esistente in un file sul tuo computer. Quando esegui questa operazione, Amazon Pinpoint esporta tutte le informazioni associate agli endpoint presenti nel segmento in un file.

Questa funzionalità è utile se desideri condividere un elenco di membri del segmento con altri utenti nella tua organizzazione che non utilizzano Amazon Pinpoint. È inoltre utile nei casi in cui desideri modificare il segmento utilizzando un'altra applicazione.

1. Apri la console Amazon Pinpoint all'indirizzo. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)

1. Nella pagina **All projects (Tutti i progetti)**, scegliere il progetto contenente i segmenti che si desidera esportare.

1. Nel riquadro di navigazione, selezionare **Segments (Segmenti)**.

1. Nell'elenco di segmenti, scegliere il segmento da esportare.

1. Nella parte superiore della pagina, scegliere **Export (Esporta)**, come mostrato nella seguente immagine.  
![\[\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/segments_export_button.png)

1. Amazon Pinpoint crea un nuovo processo di esportazione. Nella pagina **Segmenti** viene visualizzata la scheda **Esportazioni recenti**.

   Prendere nota del valore nella colonna **Export status (Stato di esportazione)** per il segmento esportato. Quando si crea il processo di esportazione, lo stato è **In progress (In corso)**.

   Attendere qualche minuto e quindi scegliere il pulsante **refresh (aggiorna)** (![\[\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/refresh-button.png)). Se lo stato è ancora **In progress (In corso)**, attendere un altro minuto, quindi ripetere questa fase. Altrimenti, se lo stato è **Complete (Completato)**, procedere alla fase successiva.
**Nota**  
Se il completamento di un segmento richiede oltre 10 minuti, il processo di esportazione scadrà. Se devi esportare segmenti molto grandi, devi utilizzare l'[CreateExportJob](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-jobs-export.html#CreateExportJob)operazione nell'API Amazon Pinpoint.

1. Scegliere **Download (Scarica)** per salvare il segmento sul computer, come mostrato nella seguente immagine.  
![\[\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/segments_export_download_button.png)

# Risoluzione dei problemi relativi ai segmenti
<a name="segments-troubleshooting"></a>

Per semplificare l'identificazione della causa dell'errore, verifica che la registrazione dei log sia attivata. Per ulteriori informazioni, consulta [Monitoraggio e registrazione dei log](troubleshooting.md#troubleshooting-logging). 

## Importazione del segmento non riuscita
<a name="troubleshooting-segment-import"></a>

Se l'importazione di un segmento non riesce, potresti visualizzare il seguente messaggio di errore o un messaggio simile: 

**Processo di** importazione: importazione non riuscita per il file SampleTemplate .csv con nome del segmento. SampleTemplate Richiesta errata: i dati che abbiamo ricevuto non corrispondevano al formato previsto per l' createImportJob operazione. Verificare che le informazioni nella richiesta siano formattate correttamente, quindi inviare di nuovo la richiesta.

****Problema e risoluzione****
+ Questo errore si verifica quando il modello importato non è formattato correttamente.
+ Verifica che il modello sia in un formato JSON o CSV valido. Per un esempio del formato corretto, consulta [File di segmenti](segments-importing.md#segments-importing-examples-files). Un modello di esempio può essere scaricato anche dalla console. All'interno del progetto, seleziona **Segmenti**, **Crea un segmento**, **Importa un segmento** e seleziona **Scarica un file CSV di esempio**.
+ Verifica che tutti gli attributi specificati siano validi. **ChannelType**e **indirizzo** sono campi obbligatori per l'importazione dei segmenti. I nomi degli attributi prevedono la distinzione tra lettere maiuscole e minuscole. Per un elenco completo dei possibili attributi che possono essere aggiunti a un modello, consulta [Attributi supportati](segments-importing.md#segments-importing-available-attributes).

## Esportazione del segmento non riuscita
<a name="troubleshooting-segment-export"></a>

****Problema e risoluzione****
+ I processi di esportazione di grandi dimensioni potrebbero non riuscire quando si esegue questa azione dalla console.
+ Come soluzione alternativa a questa limitazione, il segmento può essere esportato in un bucket Amazon S3 utilizzando [CreateExportJob](https://docs.aws.amazon.com//pinpoint/latest/apireference/apps-application-id-jobs-export.html#apps-application-id-jobs-exportpost)l'API tramite il riferimento alla riga di comando (CLI) o l'SDK.

## Conteggio degli endpoint per un segmento dinamico
<a name="troubleshooting-dynamic-segment"></a>

****Problemi e risoluzione****
+ Quando si utilizza un segmento dinamico per creare una campagna, il numero di endpoint conteggiati è approssimativo e potrebbe non essere accurato. Questo perché i dati degli endpoint nei segmenti dinamici sono soggetti a modifiche nel tempo in base ai criteri definiti. Per verificare il numero esatto di endpoint in un determinato momento, è possibile esportare il segmento.

## BadRequestException: Numero massimo di endpoint per utente superato: 15
<a name="troubleshooting-badrequestexception"></a>

Questo errore si verifica quando si tenta di aggiungere più di 15 endpoint associati allo stesso `UserId`.

**Nota**  
Se il tipo di canale del nuovo endpoint è ADM, GCM, APNS, APNS\$1VOICE, APNS\$1VOIP\$1SANDBOX o BAIDU, la richiesta avrà esito positivo se esiste già un endpoint con uno di questi tipi di canale. Per ulteriori informazioni, consulta [Gestione del numero massimo di endpoint per i membri di un pubblico](https://docs.aws.amazon.com/pinpoint/latest/developerguide/audience-define-auto-inactive.html) nella *Guida per gli sviluppatori di Amazon Pinpoint*.

****Problema e risoluzione****
+ Questo errore può essere visualizzato durante la creazione di nuovi endpoint o la modifica di quelli esistenti mediante l'API [update-endpoint](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/update-endpoint.html) e l'endpoint specifico supera il numero massimo di 15 indirizzi di endpoint.
+ Questo limite è attualmente un limite rigido del servizio in quanto questo valore non può aumentato. Per ulteriori informazioni, consulta [Quote per gli endpoint](https://docs.aws.amazon.com//pinpoint/latest/developerguide/quotas.html#quotas-endpoint).

## BadRequestException quando si chiama l' UpdateEndpoints operazione UpdateEndpointsBatch or: troppi attributi personalizzati
<a name="troubleshooting-attributes"></a>

Questo errore viene visualizzato quando si tenta di aggiungere più di 250 attributi. Gli attributi personalizzati possono avere una dimensione massima di 15 KB per endpoint.

****Problema e risoluzione****
+ Esporta il segmento e controllalo per confermare il numero di attributi personalizzati.
+ Per aiutare a risolvere l'eccezione, vedi [Come posso risolvere un errore «troppi attributi» in Amazon Pinpoint](https://repost.aws/knowledge-center/pinpoint-additional-attributes)?