Considerazioni sui segmenti importati File di segmenti Importazione di un segmento Attributi supportati

Importazione di segmenti

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

A differenza dei segmenti dinamici che crei con il generatore di segmenti nella console, un segmento importato è un set invariato di endpoint o ID utente:

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.

È possibile definire un segmento importando un elenco di definizioni degli 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 gli ID utente solo se hai aggiunto gli endpoint associati agli ID utente ad Amazon Pinpoint.

Un segmento importato è composto da endpoint, ID utente 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

Quando crei segmenti importati, tieni in considerazione i seguenti fattori:

Quando crei una campagna, devi scegliere un segmento. Quando scegli un segmento dinamico, Amazon Pinpoint fornisce una stima delle dimensioni di quel segmento. Tuttavia, quando scegli un segmento importato, Amazon Pinpoint non può 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.

File di segmenti

Puoi definire gli endpoint o gli ID utente che appartengono al tuo segmento in un file di valori separati da virgola (CSV) o JSON. Quindi, importi 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. Inoltre, un nome di attributo deve contenere al massimo 50 caratteri. Un valore di attributo deve contenere al massimo 100 caratteri.

Esempi di file di segmento

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	+16045550182	CA	Android	LG	example-user-id-1
APNS	1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f	USA	iOS	Apple	example-user-id-2
E-MAIL	john.stiles@example.com	USA	iOS	Apple	example-user-id-2
GCM	4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c	CN	Android	Google	example-user-id-3
E-MAIL	wang.xiulan@example.com	CN	Android	OnePlus	example-user-id-3

Ogni riga della tabella rappresenta un singolo endpoint. Tieni presente che agli ID utente example-user-id-2 ed example-user-id-3 vengono assegnati due endpoint ciascuno.

Esempio File con definizioni degli endpoint

CSV

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

Le righe successive definiscono gli endpoint fornendo valori per ciascun attributo nell'intestazione.

Per includere una virgola o una virgoletta doppia in un valore, racchiudi il valore tra virgolette doppie, 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, i dati nel file potrebbero non essere importati o il processo di importazione potrebbe non riuscire.

JSON

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.

Esempio di file con gli ID utente

Importazione di un segmento

Esistono due modi per importare segmenti in Amazon Pinpoint: puoi caricare file direttamente dal tuo computer oppure puoi importare file archiviati in un bucket Amazon S3.

Il caricamento dei file dal computer è generalmente il metodo più semplice per importare i segmenti, soprattutto se già disponi dei 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 Amazon S3 è utile anche se disponi già di processi che inviano file di dati dei clienti ad Amazon S3 per l'archiviazione.

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

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

Apri la console Amazon Pinpoint all'indirizzo https://console.aws.amazon.com/pinpoint/.
Nella pagina All projects (Tutti i progetti), scegliere il progetto a cui aggiungere il segmento.
Nel riquadro di navigazione, selezionare Segments (Segmenti).
Scegliere Create a segment (Crea segmento).
In Create a segment (Crea segmento), scegliere Import a segment (Importa segmento).
In Import method (Importa metodo), scegliereUpload files from your computer (Carica file dal computer).
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.
Quando carichi file su Amazon Pinpoint, devi fornire un nome di segmento per ogni file che importi. In Segment names (Nomi segmenti), immettere un nome di segmento per ogni file che si desidera importare, come illustrato nella seguente immagine.

Nota
Per impostazione predefinita, Amazon Pinpoint fornisce un nome di segmento uguale al nome del file importato, ma senza l'estensione del nome del file. Tali valori predefiniti possono essere sostituiti con qualsiasi nome.
È possibile utilizzare lo stesso nome per più segmenti. In tal caso, Amazon Pinpoint crea un segmento distinto per ogni file e assegna un ID univoco a ciascun file. Anche la data di creazione è leggermente diversa per ogni file importato. È possibile utilizzare questi fattori per distinguere segmenti con lo stesso nome.
Al termine, selezionare Create segment (Crea segmento).

Prima di utilizzare questa procedura per importare un segmento, devi prima creare un bucket Amazon S3 e caricare il tuo file in quel bucket. Puoi organizzare i file di segmenti diversi in cartelle separate. Quando Amazon Pinpoint importa gli endpoint o gli ID utente per un segmento, include i file all'interno di 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 la Guida per l'utente di Amazon Simple Storage Service.

Amazon Pinpoint può importare un solo formato di file (CSV o JSON) per segmento, quindi il percorso Amazon S3 specificato deve contenere solo file di un singolo tipo.

Per importare un segmento

Apri la console Amazon Pinpoint all'indirizzo https://console.aws.amazon.com/pinpoint/.
Nella pagina All projects (Tutti i progetti), scegliere il progetto a cui aggiungere il segmento.
Nel riquadro di navigazione, selezionare Segments (Segmenti).
Scegliere Create a segment (Crea segmento).
In Create a segment (Crea segmento), scegliere Import a segment (Importa segmento).
Per Segment name (Nome segmento), immettere un nome per il segmento che lo renda facilmente riconoscibile in un secondo momento.
Per l'URL Amazon S3, inserisci la posizione del bucket Amazon S3 che contiene il file per il tuo 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 in quel percorso.
Per il ruolo IAM, completa una delle seguenti fasi:
- Se desideri che Amazon Pinpoint crei un ruolo che gli consenta di leggere da un bucket Amazon S3, scegli Crea automaticamente un ruolo. Quindi, per IAM role (Ruolo IAM), immettere un nome per il ruolo che si sta creando.
- Se hai già creato un ruolo IAM che consente ad Amazon Pinpoint di leggere da un bucket Amazon S3, scegli Scegli un ruolo esistente. Quindi, per IAM role (Ruolo IAM), scegliere un ruolo che contiene le autorizzazioni appropriate.
Se desideri creare tu stesso il ruolo IAM, consulta il ruolo IAM per l'importazione di endpoint o segmenti nella Amazon Pinpoint Developer Guide. Dopo aver creato il ruolo, specificalo nella console Amazon Pinpoint.
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.
Scegli Create segment (Crea segmento).

Attributi supportati

La tabella in questa sezione elenca e descrive gli attributi che puoi specificare nelle definizioni degli endpoint importate 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 è molto simile alla richiesta di endpoint di esempio nell'Amazon Pinpoint API Reference. 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. Ad 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	Descrizione
`Address`	L'indirizzo di destinazione univoco per i messaggi o le notifiche push che invii all'endpoint, ad esempio un indirizzo email, un numero di telefono o un token del dispositivo. Nota 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 su Wikipedia.
`Attributes.custom_attribute`	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_attribute` con un valore qualsiasi.
`ChannelType`	Il canale da utilizzare per l'invio di messaggi o notifiche push all'endpoint. Ad esempio: `APNS`— Per un endpoint in grado di ricevere notifiche push inviate tramite il canale Apple Push Notification service (APNs) alle app in esecuzione su dispositivi iOS. `EMAIL`— Per un endpoint in grado di ricevere messaggi di posta elettronica. `GCM`— Per un endpoint in grado di ricevere notifiche push inviate tramite il canale Firebase Cloud Messaging (FCM) alle app in esecuzione su dispositivi Android. `SMS`— Per un endpoint in grado di ricevere messaggi di testo SMS.
`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, seguito da un trattino basso (_), seguito da un valore ISO 3166-1 alfa-2. Ad esempio, `en_US` è 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. Ad esempio, `America/Los_Angeles` per l'ora del Pacifico (Nord America).
`EffectiveDate`	La data e l'ora dell'ultimo aggiornamento dell'endpoint, nel formato 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, 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_attribute`	Una metrica numerica personalizzata che l'applicazione riporta ad Amazon Pinpoint per l'endpoint, ad esempio il numero di sessioni o il numero di elementi rimasti in un carrello, da utilizzare per scopi di segmentazione. Puoi sostituire `custom_attribute` con un valore qualsiasi. Questi valori personalizzati possono essere solo numerici. Poiché sono numerici, Amazon Pinpoint può eseguire operazioni aritmetiche, come 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 scelto di non ricevere messaggi o notifiche push; oppure `NONE`, l'utente non ha scelto di ricevere tutti i messaggi e le notifiche push.
`RequestId`	L'Identificatore univoco della richiesta più recente per aggiornare l'endpoint.
`User.UserAttributes.custom_attribute`	Un attributo personalizzato che descrive l'utente. Puoi sostituire `custom_attribute` con qualsiasi valore, come `FirstName` o `Age`.
`User.UserId`	Un identificatore univoco per l'utente.

Puoi creare fino a 250 attributi personalizzati per endpoint e utenti in ogni progetto. Per ulteriori informazioni, consultare Quote di Amazon Pinpoint nella Guida per gli sviluppatori di Amazon Pinpoint.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Gestione dei segmenti

Esportazione di segmenti