Utilizzo dell'analisi dei dati di Amazon Pinpoint con i bacini d'utenza di Amazon Cognito.

I pool di utenti di Amazon Cognito sono integrati con Amazon Pinpoint per fornire analisi per i pool di utenti di Amazon Cognito e per migliorare i dati utente per le campagne di Amazon Pinpoint. Amazon Pinpoint fornisce analisi dei dati e campagne mirate per guidare il coinvolgimento degli utenti nelle app per dispositivi mobili tramite notifiche push. Con il supporto di analisi dei dati di Amazon Pinpoint nei bacini d'utenza di Amazon Cognito, puoi tracciare le registrazioni, gli accessi, le autenticazioni non riuscite, gli utenti attivi giornalmente (daily active users, DAU) e utenti attivi mensilmente (monthly active users, MAU) nella console di Amazon Pinpoint. Puoi esplorare i dati in base a intervalli di date o attributi differenti, come piattaforma di dispositivo, dispositivo locale, e versione dell'app.

Puoi inoltre impostare attributi personalizzati per la tua app. Questi possono essere utilizzati per segmentare gli utenti su Amazon Pinpoint e inviare loro notifiche push mirate. Se scegli Share user attribute data with Amazon Pinpoint (Condividi dati attributi utente con Amazon Pinpoint) nella scheda Analytics (Analisi) della console Amazon Cognito, Amazon Pinpoint crea degli endpoint aggiuntivi per gli indirizzi e-mail e i numeri di telefono degli utenti.

Quando attivi le analisi di Amazon Pinpoint nel pool di utenti con la console di Amazon Cognito, crei anche un ruolo collegato ai servizi che Amazon Cognito assume quando effettua una richiesta API ad Amazon Pinpoint per il pool di utenti. Il principale IAM che aggiunge la tua configurazione di analisi deve disporre CreateServiceLinkedRoledelle autorizzazioni. Il ruolo collegato al servizio è. AWSServiceRoleForAmazonCognitoIdp Per ulteriori informazioni, consulta Utilizzo di ruoli collegati ai servizi per Amazon Cognito.

Quando applichi un AnalyticsConfiguration al client dell'app nell'API di Amazon Cognito, puoi assegnare un ruolo IAM personalizzato per Amazon Pinpoint e un ID esterno per assumere il ruolo. Il ruolo deve convalidare il principale del servizio cognito-idp e, se la policy di attendibilità del ruolo richiede un ID esterno, deve corrispondere a AnalyticsConfiguration. Devi concedere le autorizzazioni cognito-idp:Describe* del ruolo e le autorizzazioni seguenti per il progetto Amazon Pinpoint.

• mobiletargeting:UpdateEndpoint

• mobiletargeting:PutEvents

Disponibilità nelle regioni Amazon Cognito e Amazon Pinpoint

La tabella seguente mostra le Regione AWS mappature tra Amazon Cognito e Amazon Pinpoint che soddisfano una delle seguenti condizioni.

• È possibile utilizzare un progetto Amazon Pinpoint solo nella regione Stati Uniti orientali (Virginia settentrionale) (us-east-1).

• È possibile utilizzare un progetto Amazon Pinpoint nella stessa regione o nella regione Stati Uniti orientali (Virginia settentrionale) (us-east-1)

Per impostazione predefinita, Amazon Cognito può inviare analisi solo a un progetto Amazon Pinpoint all'interno della stessa Regione AWS. Le eccezioni a questa regola sono le regioni riportate nella tabella seguente e le regioni in cui Amazon Pinpoint non è disponibile.

Amazon Pinpoint è disponibile nelle seguenti regioni. I pool di utenti di Amazon Cognito in queste regioni non supportano l'analisi.

• Europa (Milano)

• Medio Oriente (Bahrein)

• Asia Pacifico (Osaka-Locale)

• Israele (Tel Aviv)

• Africa (Città del Capo)

• Asia Pacifico (Giacarta)

La tabella mostra la relazione tra la regione in cui è stato creato il pool di utenti di Amazon Cognito e la regione corrispondente in Amazon Pinpoint. Il progetto Amazon Pinpoint deve essere configurato in una regione disponibile per integrarlo con Amazon Cognito.

Regione del pool di utenti di Amazon Cognito	Regioni per progetto Amazon Pinpoint
ap-northeast-1	us-east-1
ap-northeast-2	us-east-1
ap-south-1	us-east-1, ap-south-1
ap-southeast-1	us-east-1
ap-southeast-2	us-east-1, ap-southeast-2
ca-central-1	us-east-1
eu-central-1	us-east-1, eu-central-1
eu-west-1	us-east-1, eu-west-1
eu-west-2	us-east-1
us-east-1	us-east-1
us-east-2	us-east-1
us-west-2	us-east-1, us-west-2

Esempi di mappatura di regioni

• Se crei un pool di utenti in ap-northest-1, puoi creare il progetto Amazon Pinpoint in us-east-1.

• Se crei un pool di utenti in ap-south-1, puoi creare il progetto Amazon Pinpoint in us-east-1 o ap-south-1.

Nota

Per tutti Regioni AWS tranne quelli della tabella precedente, Amazon Cognito può utilizzare solo un progetto Amazon Pinpoint nella stessa regione del pool di utenti. Se Amazon Pinpoint non è disponibile nella regione in cui è stato creato il pool di utenti e non è elencato nella tabella, allora Amazon Cognito non supporta l'analisi Amazon Pinpoint in tale regione. Per informazioni sulla Regione AWS dettagliate, consulta Endpoint e quote di Amazon Pinpoint.

Specifica delle impostazioni di analisi dei dati di Amazon Pinpoint (AWS Management Console)

È possibile configurare il pool di utenti di Amazon Cognito per inviare dati di analisi ad Amazon Pinpoint. Amazon Cognito invia dati di analisi solo ad Amazon Pinpoint per utenti locali. Dopo che hai configurato il pool di utenti per l'associazione a un progetto Amazon Pinpoint, devi includere AnalyticsMetadata nelle richieste API. Per ulteriori informazioni, consulta Integrazione di app con Amazon Pinpoint.

Specificazione delle impostazioni di analisi

1. Passa alla console Amazon Cognito. Potrebbe comparire una richiesta di inserimento delle credenziali AWS .

2. Seleziona User Pools (Pool di utenti) e scegli un pool di utenti esistente dall'elenco.

3. Scegli la scheda App integration (Integrazione app).

4. In App clients and analytics (Client di app e analisi dei dati), scegli un App client name (Nome del client dell'app) esistente dall'elenco.

5. In Pinpoint analytics (Analisi dei dati di Amazon Pinpoint), scegli Enable (Abilita).

6. Scegli una Pinpoint Region (Regione Pinpoint).

7. Scegli un Amazon Pinpoint project (Progetto Amazon Pinpoint) o seleziona Create Amazon Pinpoint project (Crea progetto Amazon Pinpoint).

   Nota

   L'ID progetto di Amazon Pinpoint è una stringa di 32 caratteri univoca per il progetto. È elencato nella console Amazon Pinpoint.

   Puoi mappare più app di Amazon Cognito a un singolo progetto di Amazon Pinpoint. Tuttavia, ogni app di Amazon Cognito può essere mappata solo a un progetto di Amazon Pinpoint.

   In Amazon Pinpoint, ogni progetto deve essere una singola app. Ad esempio, se uno sviluppatore di videogiochi ha due videogiochi, ognuno di questi dovrebbe costituire un progetto di Amazon Pinpoint separato, nonostante entrambi usino lo stesso bacino d'utenza di Amazon Cognito. Per ulteriori informazioni sui progetti Amazon Pinpoint, consulta Creazione di un progetto in Amazon Pinpoint.

8. In User data sharing (Condivisione dei dati utente), scegli Share user data with Amazon Pinpoint (Condividi i dati utente con Amazon Pinpoint) se Amazon Cognito deve inviare indirizzi e-mail e numeri di telefono ad Amazon Pinpoint e creare endpoint aggiuntivi per gli utenti. Dopo che gli utenti verificano i rispetti indirizzi e-mail e numeri di telefono, Amazon Cognito li condividi solo con Amazon Pinpoint se sono disponibili per l'account utente.

   Nota

   Un endpoint identifica in modo univoco un dispositivo dell'utente al quale puoi inviare notifiche push con Amazon Pinpoint. Per ulteriori informazioni sugli endpoint, consulta la sezione Aggiunta di endpoint nella Guida per gli sviluppatori di Amazon Pinpoint.

9. Scegli Save changes (Salva modifiche).

Specificazione delle impostazioni di analisi AWS CLI ( AWS e dell'API) di Amazon Pinpoint

Utilizza i comandi seguenti per specificare le impostazioni di analisi dei dati di Amazon Pinpoint per il tuo bacino d'utenza.

Specificazione di impostazioni di analisi per l'app client esistente del tuo bacino d'utenza al momento della creazione dell'app.

• AWS CLI: aws cognito-idp create-user-pool-client

• AWS API: CreateUserPoolClient

Aggiornamento delle impostazioni di analisi per l'app client esistente del tuo bacino d'utenza

• AWS CLI: aws cognito-idp update-user-pool-client

• AWS API: UpdateUserPoolClient

Nota

Se utilizzi ApplicationArn, Amazon Cognito supporta le integrazioni all'interno della regione.

Integrazione di app con Amazon Pinpoint

Puoi pubblicare metadati di analisi su Amazon Pinpoint per gli utenti locali di Amazon Cognito nell'API dei pool di utenti.

Utenti locali

Sono gli utenti che hanno creato un account mediante la registrazione o sono stati creati nel pool di utenti anziché eseguire l'accesso tramite un gestore dell'identità digitale (IdP) di terze parti.

API dei pool di utenti

Le operazioni che puoi integrare con un AWS SDK, utilizzando un'app con un'interfaccia utente (UI) personalizzata. Non puoi passare metadati di analisi per utenti federati o locali che effettuano l'accesso tramite l'interfaccia utente ospitata. Per un elenco di operazioni dei pool di utenti, consultare la documentazione di riferimento delle API di Amazon Cognito.

Dopo aver configurato il pool di utenti per la pubblicazione in una campagna, Amazon Cognito passa i metadati ad Amazon Pinpoint per le seguenti operazioni API.

• AdminInitiateAuth

• AdminRespondToAuthChallenge

• ConfirmForgotPassword

• ConfirmSignUp

• ForgotPassword

• InitiateAuth

• ResendConfirmationCode

• RespondToAuthChallenge

• SignUp

Per passare i metadati relativi alla sessione dell'utente alla campagna Amazon Pinpoint, includi un valore AnalyticsEndpointId nel parametro AnalyticsMetadata della richiesta API. JavaScript Ad esempio, vedi Perché le analisi del mio pool di utenti di Amazon Cognito non vengono visualizzate nella mia dashboard di Amazon Pinpoint? nel Knowledge Center.AWS