**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à.
# Interroga i dati di analisi di Amazon Pinpoint
Oltre a utilizzare le pagine di analisi sulla console Amazon Pinpoint, puoi utilizzare Amazon Pinpoint APIs Analytics per interrogare i dati di analisi per un sottoinsieme di metriche standard che forniscono informazioni sulle tendenze relative al coinvolgimento degli utenti, alla sensibilizzazione delle campagne e altro ancora. Queste metriche, note anche come *indicatori chiave di performance (KPIs)*, sono valori misurabili che possono aiutarti a monitorare e valutare le prestazioni dei tuoi progetti, campagne e percorsi.
Se lo utilizzi APIs per interrogare i dati di analisi, puoi analizzarli utilizzando lo strumento di reporting di tua scelta, senza dover accedere alla console Amazon Pinpoint o analizzare i dati grezzi degli eventi da fonti come Amazon Kinesis Streams. Ad esempio, puoi creare un dashboard personalizzato che visualizzi i risultati settimanali delle campagne o che fornisca analisi approfondite sulle percentuali di consegna per le tue campagne.
Puoi interrogare i dati utilizzando l'API REST di Amazon Pinpoint, AWS Command Line Interface (AWS CLI) o un AWS SDK. Per eseguire una query sui dati, invia una richiesta all'API Amazon Pinpoint e utilizza i parametri supportati per specificare i dati desiderati e i filtri da applicare. Dopo aver inviato la query, Amazon Pinpoint restituisce i risultati della query in una risposta JSON. È quindi possibile trasferire i risultati a un altro servizio o a un'altra applicazione per un'analisi più approfondita, lo storage o la generazione di report.
Amazon Pinpoint raccoglie e aggrega automaticamente i dati per tutti i tipi di metriche supportati e per tutti i progetti, le campagne e i percorsi. Inoltre, i dati vengono aggiornati in modo continuo, generando un intervallo di tempo di latenza dei dati che è limitato a circa due ore. Si noti, tuttavia, che potrebbe esserci una latenza dei dati aggiuntiva per determinati parametri. Questo perché i dati per alcuni parametri si basano sulle informazioni che riceviamo dai provider di posta elettronica dei destinatari. Alcuni fornitori ci inviano immediatamente queste informazioni, mentre altri le inviano meno frequentemente.
Amazon Pinpoint archivia i dati per 90 giorni. Per archiviare i dati per più di 90 giorni o per accedere ai dati di analisi non elaborati in tempo reale, puoi configurare un progetto Amazon Pinpoint per lo streaming dei dati degli eventi su Amazon Kinesis Data Streams o Amazon Data Firehose. Per informazioni sulla configurazione dei flussi di eventi, consulta [Trasmetti in streaming i dati degli eventi delle app tramite Kinesis e Firehose utilizzando Amazon Pinpoint](event-streams.md).
## Componenti e parametri di query per le metriche in Amazon Pinpoint
Per eseguire una query sui dati per un parametro, inviare una richiesta `get` alla risorsa dei parametri appropriata dell'API di Amazon Pinpoint. Nella richiesta, è possibile definire la query utilizzando parametri supportati per i seguenti componenti di query:
+ **Progetto**: specifica un progetto fornendo il relativo ID come valore per il parametro `application-id`. Questo parametro è obbligatorio per tutti i parametri.
+ **Campagna**: specifica una campagna fornendo il relativo ID come valore per il parametro `campaign-id`. Questo parametro è obbligatorio solo per i parametri della campagna.
+ **Percorso**: specificare un percorso fornendo il relativo ID come valore per il parametro `journey-id`. Questo parametro è obbligatorio solo per i parametri di coinvolgimento e di esecuzione del viaggio e per i parametri di esecuzione dell'attività di viaggio.
+ **Attività del percorso**: specifica un'attività del percorso fornendo il relativo ID come valore per il parametro `journey-activity-id`. Questo parametro è obbligatorio solo per i parametri di esecuzione dell'attività di viaggio.
+ **Intervallo di date**: per filtrare facoltativamente i dati per intervallo di date, specifica la prima e l'ultima data e l'ora dell'intervallo utilizzando i parametri di ora di inizio e fine supportati. I valori devono essere in formato ISO 8601 esteso e utilizzare il fuso orario UTC (Coordinated Universal Time), ad esempio `2019-07-19T20:00:00Z` per le 20:00 UTC del 19 luglio 2019.
Gli intervalli di date includono gli estremi e devono essere limitati a 31 o a un numero minore di giorni di calendario. Inoltre, la prima data e la prima ora non devono precedere il giorno corrente di più di 90 giorni. Se non si specifica un intervallo di date, Amazon Pinpoint restituisce i dati dei 31 giorni di calendario precedenti. I parametri dell'intervallo di date sono supportati da tutti i parametri, ad eccezione dei parametri di esecuzione del viaggio e dei parametri di esecuzione dell'attività di viaggio.
+ **Parametro**: specifica una metrica fornendo il relativo nome come valore per il parametro `kpi-name`. Questo valore descrive il parametro associato ed è formato da due o più termini, che sono composti da caratteri alfanumerici minuscoli, separati da un trattino. Alcuni esempi sono `email-open-rate` e `successful-delivery-rate`. Questo parametro è obbligatorio per tutti i parametri, ad eccezione dei parametri di esecuzione del viaggio e dei parametri di esecuzione dell'attività di viaggio. Per un elenco completo dei parametri supportati e il valore `kpi-name` da utilizzare per ciascuno di essi, consulta [Metriche standard per progetti, campagne e viaggi](analytics-standard-metrics.md).
Dopo aver inviato la query, Amazon Pinpoint restituisce i risultati della query in una risposta JSON. Nella risposta, la struttura dei risultati varia a seconda del parametro richiesto.
Alcune metriche forniscono un solo valore, ad esempio il numero di messaggi recapitati da una campagna. Altre metriche forniscono più valori e in genere raggruppano tali valori in base a un campo pertinente, ad esempio il numero di messaggi recapitati da ciascuna campagna, raggruppati per esecuzione della campagna. Se un parametro fornisce e raggruppa più valori, la risposta JSON include un campo che indica quale campo è stato utilizzato per raggruppare i dati. Per ulteriori informazioni sulla struttura dei risultati delle query, consulta [Usa i risultati delle query JSON](analytics-query-results.md).
# Policy IAM per l'esecuzione di query sui dati di analisi di Amazon Pinpoint
Utilizzando l'API Amazon Pinpoint, puoi interrogare i dati di analisi per un sottoinsieme di metriche standard, note anche come *indicatori chiave di prestazione (KPIs)*, che si applicano a progetti, campagne e percorsi di Amazon Pinpoint. Questi parametri consentono di monitorare e valutare le prestazioni dei progetti, delle campagne e dei viaggi.
Per gestire l'accesso a questi dati, puoi creare policy AWS Identity and Access Management (IAM) che definiscono le autorizzazioni per i ruoli o gli utenti IAM autorizzati ad accedere ai dati. Per supportare il controllo granulare dell'accesso a questi dati, Amazon Pinpoint fornisce diverse azioni distinte che è possibile specificare nelle policy IAM. Per visualizzare i dati di analisi sulla console Amazon Pinpoint (`mobiletargeting:GetReports`), è disponibile un'azione distinta, mentre per accedere ai dati di analisi a livello di programmazione tramite l'API Amazon Pinpoint sono disponibili altre azioni.
Per creare policy IAM che gestiscano l'accesso ai dati di analisi, puoi utilizzare l'API Console di gestione AWS AWS CLI, the o IAM. Tieni presente che la scheda **Editor visivo** sulla Console di gestione AWS al momento non include azioni per la visualizzazione o l'esecuzione di query sui dati di analisi di Amazon Pinpoint. Tuttavia, puoi aggiungere manualmente le operazioni necessarie alle policy IAM utilizzando la scheda **JSON** sulla console.
Ad esempio, la seguente policy consente l'accesso programmatico a tutti i dati di analisi per tutti i tuoi progetti, campagne e viaggi in tutte le AWS regioni:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryAllAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetApplicationDateRangeKpi",
"mobiletargeting:GetCampaignDateRangeKpi",
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:*:111122223333:apps/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/campaigns/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/execution-metrics",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/activities/*/execution-metrics"
]
}
]
}
```
------
*accountId*Dov'è l'ID del tuo AWS account.
Tuttavia, è consigliabile definire policy in grado di seguire il principio del *privilegio minimo*. In altre parole, è necessario creare policy che includano solo le autorizzazioni necessarie per eseguire un'attività specifica. Per supportare questa pratica e implementare un controllo più granulare, puoi limitare l'accesso programmatico ai dati di analisi solo per un particolare progetto in una AWS regione specifica, ad esempio:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryProjectAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetApplicationDateRangeKpi",
"mobiletargeting:GetCampaignDateRangeKpi",
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/campaigns/*/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/execution-metrics",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/activities/*/execution-metrics"
]
}
]
}
```
------
Dove:
+ *region*è il nome della AWS regione che ospita il progetto.
+ *accountId*è l'ID AWS del tuo account.
+ *projectId*è l'identificatore del progetto a cui desideri fornire l'accesso.
Analogamente, la seguente policy di esempio consente l'accesso programmatico ai dati di analisi solo per una particolare campagna:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryCampaignAnalytics",
"Effect": "Allow",
"Action": "mobiletargeting:GetCampaignDateRangeKpi",
"Resource": "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/campaigns/campaignId/kpis/*"
}
]
}
```
------
Dove:
+ *region*è il nome della AWS regione che ospita il progetto.
+ *accountId*è il tuo Account AWS ID.
+ *projectId*è l'identificatore del progetto associato alla campagna.
+ *campaignId*è l'identificatore della campagna a cui desideri fornire l'accesso.
E la seguente policy di esempio consente l'accesso programmatico a tutti i dati di analisi, sia di coinvolgimento sia di esecuzione, per un particolare percorso e le attività che lo compongono:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryJourneyAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/execution-metrics",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/activities/*/execution-metrics"
]
}
]
}
```
------
Dove:
+ *region*è il nome della AWS regione che ospita il progetto.
+ *accountId*è l'ID AWS del tuo account.
+ *projectId*è l'identificatore del progetto associato al viaggio.
+ *journeyId*è l'identificatore del viaggio a cui desideri fornire l'accesso.
Per l'elenco completo delle azioni API Amazon Pinpoint che è possibile utilizzare nelle policy IAM, consulta [Azioni di Amazon Pinpoint per le policy IAM](permissions-actions.md). Per ulteriori informazioni sulla creazione e sulla gestione delle policy IAM, consulta la [Guida per l'utente di IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/).
# Metriche standard che si applicano a progetti, campagne e percorsi Amazon Pinpoint
Puoi utilizzare Amazon Pinpoint Analytics APIs per interrogare i dati di analisi per un sottoinsieme di metriche standard che si applicano a progetti, campagne e percorsi Amazon Pinpoint. Queste metriche, note anche come *indicatori chiave di performance (KPIs)*, sono valori misurabili che possono aiutarti a monitorare e valutare le prestazioni di progetti, campagne e percorsi.
Amazon Pinpoint fornisce l'accesso programmatico ai dati di analisi per diversi tipi di metriche standard:
+ **Metriche delle applicazioni**: queste metriche forniscono informazioni dettagliate sulle tendenze per tutte le campagne associate a un progetto, che viene indicato anche come *applicazione*. Ad esempio, è possibile utilizzare un parametro di applicazione per ottenere i dettagli del numero di messaggi aperti dai destinatari per ogni campagna associata a un progetto.
+ **Metriche della campagna**: queste metriche forniscono informazioni dettagliate sulle prestazioni delle campagne individuali. Ad esempio, è possibile utilizzare un parametro di campagna per stabilire il numero di endpoint ai quali è stato inviato un messaggio della campagna o quanti di questi messaggi sono stati distribuiti agli endpoint.
+ **Metriche di coinvolgimento del percorso**: queste metriche forniscono informazioni dettagliate sulle prestazioni dei singoli percorsi. Ad esempio, è possibile utilizzare un parametro di coinvolgimento del viaggio per ottenere una ripartizione del numero di messaggi aperti dai partecipanti a ciascuna attività di un viaggio.
+ **Metriche di esecuzione del percorso**: queste metriche forniscono informazioni dettagliate sulle tendenze di partecipazione dei singoli percorsi. Ad esempio, è possibile utilizzare un parametro di esecuzione del viaggio per determinare quanti partecipanti hanno iniziato un viaggio.
+ **Metriche di esecuzione delle attività del percorso**: queste metriche forniscono informazioni dettagliate sulle tendenze di partecipazione delle singole attività in un percorso. Ad esempio, è possibile utilizzare un parametro di esecuzione dell'attività di viaggio per determinare quanti partecipanti hanno iniziato un'attività e quanti partecipanti hanno completato ciascun percorso in un’attività.
Gli argomenti in questa sezione elencano e descrivono i singoli parametri su cui è possibile eseguire query per ogni tipo di parametro.
**Topics**
+ [Metriche delle applicazioni Amazon Pinpoint per le campagne](application-metrics-campaigns.md)
+ [Parametri delle applicazioni Amazon Pinpoint per i messaggi e-mail transazionali](application-metrics-txn-email.md)
+ [Parametri delle applicazioni Amazon Pinpoint per i messaggi SMS transazionali](application-metrics-txn-sms.md)
+ [Metriche delle campagne Amazon Pinpoint](campaign-metrics.md)
+ [Metriche di coinvolgimento del percorso Amazon Pinpoint](journey-metrics-engagement-email.md)
+ [Metriche di esecuzione del percorso Amazon Pinpoint](journey-metrics-execution.md)
+ [Metriche di esecuzione delle attività del percorso Amazon Pinpoint](journey-metrics-activity-execution.md)
+ [Metriche del percorso e dell'esecuzione delle campagne di Amazon Pinpoint](journey-run-metrics-activity-execution.md)
# Metriche delle applicazioni Amazon Pinpoint per le campagne
La tabella seguente elenca e descrive le metriche standard delle applicazioni su cui è possibile eseguire query per valutare le prestazioni di tutte le campagne associate a un progetto Amazon Pinpoint. Per eseguire query sui dati per queste metriche, utilizza la risorsa [Metriche delle applicazioni](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) dell'API Amazon Pinpoint. Nella tabella, la colonna **kpi-name** indica il valore da utilizzare per il parametro `kpi-name` in una query.
| Metrica | Kpi-name | Description |
| --- | --- | --- |
| Percentuale di recapiti | `successful-delivery-rate` | Per tutte le campagne associate a un progetto, la percentuale di messaggi inviati ai destinatari. Questo parametro viene calcolato come il numero di messaggi inviati da tutte le campagne per un progetto e recapitati ai destinatari, diviso il numero di messaggi che sono stati inviati da tutte le campagne. |
| Percentuale di recapiti, raggruppati per data | `successful-delivery-rate-grouped-by-date` | Per tutte le campagne associate a un progetto, la percentuale di messaggi recapitati ai destinatari per ogni giorno nell'intervallo di date specificato. Questo parametro viene calcolato come il numero di messaggi inviati da tutte le campagne per un progetto e recapitati ai destinatari, diviso il numero di messaggi che sono stati inviati da tutte le campagne, per ogni giorno nell'intervallo di date specificato. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Percentuale di e-mail aperte | `email-open-rate` | Per tutte le campagne associate a un progetto, la percentuale di messaggi e-mail aperti dai destinatari. Questo parametro viene calcolato come il numero di messaggi e-mail inviati da tutte le campagne per un progetto e aperti dai destinatari, diviso il numero di messaggi e-mail inviati da tutte le campagne e recapitati ai destinatari. |
| Percentuale di e-mail aperte, raggruppate per campagna | `email-open-rate-grouped-by-campaign` | Per ogni campagna associata a un progetto, la percentuale di messaggi e-mail aperti dai destinatari. Questo parametro viene calcolato come il numero di messaggi e-mail inviati da una campagna e aperti dai destinatari, diviso il numero di messaggi e-mail inviati dalla campagna e recapitati ai destinatari. I risultati della query per questo parametro sono raggruppati in base all'ID campagna (`CampaignId`), che è una stringa che identifica in modo univoco una campagna. |
| Consegne endpoint | `unique-deliveries` | Per tutte le campagne associate a un progetto, il numero di endpoint univoci ai quali sono stati consegnati i messaggi. |
| Consegne endpoint, raggruppate per campagna | `unique-deliveries-grouped-by-campaign` | Per ogni campagna associata a un progetto, il numero di endpoint univoci ai quali sono stati consegnati i messaggi. I risultati della query per questo parametro sono raggruppati in base all'ID campagna (`CampaignId`), che è una stringa che identifica in modo univoco una campagna. |
| Consegne endpoint, raggruppate per data | `unique-deliveries-grouped-by-date` | Per tutte le campagne associate a un progetto, il numero di endpoint univoci ai quali sono stati consegnati i messaggi, per ogni giorno nell'intervallo di date specificato. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Messaggi recapitati, raggruppati per campagna | `successful-deliveries-grouped-by-campaign` | Per ogni campagna associata a un progetto, il numero di messaggi che sono stati recapitati ai destinatari. Questo parametro viene calcolato come il numero di messaggi inviati da una campagna, meno il numero di messaggi che sono stati inviati dalla campagna e non sono stati recapitati ai destinatari a causa di un hard bounce. I risultati della query per questo parametro sono raggruppati in base all'ID campagna (`CampaignId`), che è una stringa che identifica in modo univoco una campagna. |
| Percentuale di notifiche push aperte | `push-open-rate` | Per tutte le campagne associate a un progetto, la percentuale di notifiche push aperte dai destinatari. Questo parametro viene calcolato in base al numero di notifiche push che sono state inviate da tutte le campagne per un progetto e aperte dai destinatari, diviso il numero di notifiche push che sono state inviate da tutte quelle campagne e consegnate ai destinatari. |
| Percentuale di notifiche push aperte, raggruppate per campagna | `push-open-rate-grouped-by-campaign` | Per ogni campagna associata a un progetto, la percentuale di notifiche push aperte dai destinatari. Questo parametro viene calcolato in base al numero di notifiche push che sono state inviate tramite una campagna e aperte dai destinatari, diviso il numero di notifiche push inviate dalla campagna e consegnate ai destinatari. I risultati della query per questo parametro sono raggruppati in base all'ID campagna (`CampaignId`), che è una stringa che identifica in modo univoco una campagna. |
# Parametri delle applicazioni Amazon Pinpoint per i messaggi e-mail transazionali
La tabella seguente elenca e descrive le metriche standard delle applicazioni su cui è possibile eseguire query per monitorare le tendenze relative a tutti i messaggi e-mail transazionali associati a un progetto Amazon Pinpoint. Per eseguire query sui dati per queste metriche, utilizza la risorsa [Metriche delle applicazioni](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) dell'API Amazon Pinpoint. Nella tabella, la colonna **kpi-name** indica il valore da utilizzare per il parametro `kpi-name` in una query.
Tieni presente che questi parametri non forniscono dati sui messaggi e-mail inviati dalle campagne. Forniscono dati solo sui messaggi e-mail transazionali. Per eseguire query sui dati per i messaggi inviati da una o più campagne, utilizza un [parametro della campagna](campaign-metrics.md) o un [parametro di applicazione per le campagne](application-metrics-campaigns.md).
| Metrica | Kpi-name | Description |
| --- | --- | --- |
| Clic | `txn-emails-clicked` | Il numero di volte che i destinatari hanno fatto clic sui collegamenti nei messaggi. Se un singolo destinatario ha fatto clic su più collegamenti in un messaggio o ha fatto clic sullo stesso collegamento più di una volta, ogni clic è incluso nel conteggio. |
| Clic, raggruppati per data | `txn-emails-clicked-grouped-by-date` | Il numero di volte in cui i destinatari hanno fatto clic sui collegamenti nei messaggi, per ogni giorno nell'intervallo di date specificato. Se un singolo destinatario ha fatto clic su più collegamenti in un messaggio o ha fatto clic sullo stesso collegamento più di una volta, ogni clic è incluso nel conteggio. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Complaint rate (Percentuale di reclami) | `txn-emails-complaint-rate` | La percentuale di messaggi segnalati dai destinatari come e-mail non richieste o indesiderate. Questo parametro viene calcolato come il numero di messaggi segnalati dai destinatari come e-mail non richieste o indesiderate, diviso per il numero di messaggi inviati. |
| Percentuale di reclami, raggruppati per data | `txn-emails-complaint-rate-grouped-by-date` | La percentuale di messaggi segnalati dai destinatari come e-mail non richieste o indesiderate, per ogni giorno nell'intervallo di date specificato. Questo parametro viene calcolato come il numero di messaggi segnalati dai destinatari come e-mail non richieste o indesiderate, diviso per il numero di messaggi inviati, per ogni giorno nell'intervallo di date specificato. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Reclami | `txn-emails-with-complaints` | Il numero di messaggi segnalati dai destinatari come e-mail non richieste o indesiderate. |
| Reclami, raggruppati per data | `txn-emails-with-complaints-grouped-by-date` | Il numero di messaggi segnalati dai destinatari come e-mail non richieste o indesiderate, per ogni giorno nell'intervallo di date specificato.I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Consegne | `txn-emails-delivered` | Il numero di messaggi consegnati ai destinatari. Questo parametro viene calcolato come il numero di messaggi inviati, meno il numero di messaggi che non è stato possibile consegnare a causa di un soft bounce o di un hard bounce o perché sono stati rifiutati. Un messaggio viene rifiutato se Amazon Pinpoint determina che il messaggio contiene malware. Amazon Pinpoint non tenta di inviare i messaggi rifiutati. |
| Consegne, raggruppate per data | `txn-emails-delivered-grouped-by-date` | Il numero di messaggi consegnati ai destinatari, per ogni giorno nell'intervallo di date specificato. Questo parametro viene calcolato come il numero di messaggi inviati, meno il numero di messaggi che non è stato possibile consegnare a causa di un soft bounce o di un hard bounce o perché sono stati rifiutati, per ogni giorno nell'intervallo di date specificato. Un messaggio viene rifiutato se Amazon Pinpoint determina che il messaggio contiene malware. Amazon Pinpoint non tenta di inviare i messaggi rifiutati. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Percentuale di recapiti | `txn-emails-delivery-rate` | La percentuale di messaggi consegnati ai destinatari. Questo parametro viene calcolato come il numero di messaggi inviati e consegnati ai destinatari, diviso il numero di messaggi inviati. |
| Percentuale di recapiti, raggruppati per data | `txn-emails-delivery-rate-grouped-by-date` | La percentuale di messaggi consegnati ai destinatari, per ogni giorno nell'intervallo di date specificato. Questo parametro viene calcolato come il numero di messaggi inviati e consegnati ai destinatari, diviso il numero di messaggi inviati per ogni giorno nell'intervallo di date specificato. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Mancati recapiti permanenti | `txn-emails-hard-bounced` | Il numero di messaggi che non è stato possibile consegnare ai destinatari a causa di un hard bounce. Un mancato recapito permanente si verifica se un problema persistente impedisce il recapito di un messaggio, ad esempio se l'indirizzo e-mail del destinatario non esiste. |
| Hard bounce, raggruppati per data | `txn-emails-hard-bounced-grouped-by-date` | Il numero di messaggi che non è stato possibile consegnare ai destinatari a causa di un hard bounce, per ogni giorno nell'intervallo di date specificato. Un mancato recapito permanente si verifica se un problema persistente impedisce il recapito di un messaggio, ad esempio se l'indirizzo e-mail del destinatario non esiste. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Aperture | `txn-emails-opened` | Mostra il numero di messaggi che sono stati aperti dai destinatari: |
| Aperture, raggruppate per data | `txn-emails-opened-grouped-by-date` | Il numero di messaggi che sono stati aperti dai destinatari, per ogni giorno nell'intervallo di date specificato. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Invii | `txn-emails-sent` | Il numero di messaggi che sono stati inviati. |
| Invii, raggruppati per data | `txn-emails-sent-grouped-by-date` | Il numero di messaggi inviati, per ogni giorno nell'intervallo di date specificato. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Soft bounce | `txn-emails-soft-bounced` | Il numero di messaggi che non è stato possibile consegnare ai destinatari a causa di un soft bounce. Si verifica un caso di e-mail non recapitata se un problema temporaneo impedisce il recapito di un messaggio, ad esempio se la posta in arrivo del destinatario è piena o il server di ricezione è temporaneamente non disponibile. |
| Soft bounce, raggruppati per data | `txn-emails-soft-bounced-grouped-by-date` | Il numero di messaggi che non è stato possibile consegnare ai destinatari a causa di un soft bounce, per ogni giorno nell'intervallo di date specificato. Si verifica un caso di e-mail non recapitata se un problema temporaneo impedisce il recapito di un messaggio, ad esempio se la posta in arrivo del destinatario è piena o il server di ricezione è temporaneamente non disponibile. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Eventi clic utente univoci | `txn-emails-unique-clicks` | Il numero di destinatari univoci (endpoint) che hanno fatto clic sui collegamenti nei messaggi. A differenza del parametro **Clicks (Clic)**, questo parametro indica il numero di destinatari univoci che hanno fatto clic sui collegamenti, non il numero di eventi di clic che si sono verificati. Ad esempio, se un singolo destinatario ha fatto clic su più collegamenti nello stesso messaggio o ha fatto clic sullo stesso link più di una volta, questo parametro segnala un solo evento clic per quel destinatario. |
| Eventi clic utente univoci, raggruppati per data | `txn-emails-unique-clicks-grouped-by-date` | Il numero di destinatari univoci (endpoint) che hanno fatto clic sui collegamenti nei messaggi, per ogni giorno nell'intervallo di date specificato. A differenza del parametro **Clicks, grouped by date (Clic, raggruppati per data)** questo parametro indica il numero di destinatari univoci che hanno fatto clic sui collegamenti, non il numero di eventi clic che si sono verificati. Ad esempio, se un singolo destinatario ha fatto clic su più collegamenti nello stesso messaggio o ha fatto clic sullo stesso link più di una volta, questo parametro segnala un solo evento clic per quel destinatario. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Eventi univoci di apertura degli utenti | `txn-emails-unique-opens` | Il numero di destinatari univoci (endpoint) che hanno aperto i messaggi. A differenza del parametro **Opens (Aperture)**, questo parametro indica il numero di destinatari univoci che hanno aperto i messaggi, non il numero di eventi di apertura che si sono verificati. Ad esempio, se un singolo destinatario apre lo stesso messaggio più volte, questo parametro segnala un solo evento di apertura per quel destinatario. |
| Eventi univoci di apertura degli utenti, raggruppati per data | `txn-emails-unique-opens-grouped-by-date` | Il numero di destinatari univoci (endpoint) che hanno aperto messaggi, per ogni giorno nell'intervallo di date specificato. A differenza del parametro **Opens, grouped by date (Aperture, raggruppate per data)** questo parametro indica il numero di destinatari univoci che hanno aperto i messaggi, non il numero di eventi di apertura che si sono verificati. Ad esempio, se un singolo destinatario apre lo stesso messaggio più volte, questo parametro segnala un solo evento di apertura per quel destinatario. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
# Parametri delle applicazioni Amazon Pinpoint per i messaggi SMS transazionali
La tabella seguente elenca e descrive le metriche standard delle applicazioni su cui è possibile eseguire query per ottenere informazioni sulle tendenze relative a tutti i messaggi SMS transazionali associati a un progetto Amazon Pinpoint. Per eseguire query sui dati per queste metriche, utilizza la risorsa [Metriche delle applicazioni](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) dell'API Amazon Pinpoint. Nella tabella, la colonna **kpi-name** indica il valore da utilizzare per il parametro `kpi-name` in una query.
Tieni presente che questi parametri non forniscono dati sui messaggi SMS inviati dalle campagne. Forniscono dati solo sui messaggi SMS transazionali. Per eseguire query sui dati per i messaggi inviati da una o più campagne, utilizza un [parametro della campagna](campaign-metrics.md) o un [parametro di applicazione per le campagne](application-metrics-campaigns.md).
| Metrica | Kpi-name | Description |
| --- | --- | --- |
| Prezzo medio per messaggio, raggruppato per paese | `txn-sms-average-price-grouped-by-country` | Costo totale dell'invio dei messaggi, per ogni paese o regione a cui sono stati inviati i messaggi. Il prezzo è indicato in millesimi di un centesimo degli Stati Uniti. Ad esempio, se il valore di questo attributo è 645, vengono addebitati 0,645 ¢ per l'invio del messaggio (645/1000=0,645¢=\$10,00645). Questo parametro viene calcolato come costo totale di tutti i messaggi inviati ai destinatari in ciascun paese o regione, diviso per il numero di messaggi inviati ai destinatari in ciascuno di tali paesi e regioni. I risultati delle query per questo parametro sono raggruppati per paese o regione, nel formato ISO 3166-1 alfa-2. |
| Prezzo medio per parte di messaggio, raggruppato per paese | `txn-sms-average-price-by-parts-grouped-by-country` | Costo totale dell'invio delle parti di messaggio, per ogni paese o regione a cui sono stati inviati i messaggi. Una parte di messaggio è una sezione di un messaggio SMS. Il prezzo è indicato in millesimi di un centesimo degli Stati Uniti. Ad esempio, se il valore di questo attributo è 645, vengono addebitati 0,645 ¢ per l'invio del messaggio (645/1000=0,645¢=\$10,00645). Questa metrica viene calcolata come costo totale di tutte le parti di messaggio inviate ai destinatari in ciascun paese o regione, diviso per il numero di parti di messaggio inviati ai destinatari in ciascuno di tali paesi e regioni. I risultati delle query per questo parametro sono raggruppati per paese o regione, nel formato ISO 3166-1 alfa-2. |
| Consegne | `txn-sms-delivered` | Il numero di messaggi consegnati ai destinatari. |
| Consegne, raggruppate per paese | `txn-sms-delivered-grouped-by-country` | Il numero di messaggi consegnati ai destinatari per ogni paese o regione a cui sono stati inviati i messaggi. I risultati delle query per questo parametro sono raggruppati per paese o regione, nel formato ISO 3166-1 alfa-2. |
| Consegne, raggruppate per data | `txn-sms-delivered-grouped-by-date` | Il numero di messaggi consegnati ai destinatari, per ogni giorno nell'intervallo di date specificato. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Errori di recapito | `txn-sms-error-distribution` | Il numero di volte in cui si è verificato un errore durante il tentativo di recapitare i messaggi, per ogni tipo di errore che si è verificato. I risultati della query per questo parametro sono raggruppati per codice di errore, per ogni tipo di errore che si è verificato. |
| Percentuale di recapiti | `txn-sms-delivery-rate` | La percentuale di messaggi consegnati ai destinatari. Questo parametro viene calcolato come il numero di messaggi inviati e consegnati ai destinatari, diviso il numero di messaggi inviati. |
| Percentuale di recapiti, raggruppati per data | `txn-sms-delivery-rate-grouped-by-date` | La percentuale di messaggi consegnati ai destinatari, per ogni giorno nell'intervallo di date specificato. Questo parametro viene calcolato come il numero di messaggi inviati e consegnati ai destinatari, diviso il numero di messaggi inviati per ogni giorno nell'intervallo di date specificato. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Parti del messaggio consegnate | `txn-sms-delivered-by-parts` | Numero di parti di messaggio recapitate ai partecipanti. Una *parte di messaggio* è una sezione di un messaggio SMS. Se un messaggio SMS contiene più caratteri di quelli consentiti dal protocollo SMS, Amazon Pinpoint divide il messaggio nel numero di parti necessarie per l'invio del messaggio a un destinatario. |
| Parti di messaggio recapitate, raggruppate per paese | `txn-sms-delivered-by-parts-grouped-by-country` | Numero di parti di messaggio recapitate ai destinatari per ogni paese o regione a cui sono stati inviati i messaggi. Una *parte di messaggio* è una sezione di un messaggio SMS. I risultati delle query per questo parametro sono raggruppati per paese o regione, nel formato ISO 3166-1 alfa-2. |
| Parti di messaggio inviate | `txn-sms-sent-by-parts` | Numero di parti di messaggio inviate. Una *parte di messaggio* è una sezione di un messaggio SMS. Se un messaggio SMS contiene più caratteri di quelli consentiti dal protocollo SMS, Amazon Pinpoint divide il messaggio nel numero di parti necessarie per l'invio del messaggio a un destinatario. |
| Parti di messaggio inviate, raggruppate per paese | `txn-sms-sent-by-parts-grouped-by-country` | Numero di parti messaggio inviate per ogni paese o regione a cui sono stati inviati i messaggi. Una *parte di messaggio* è una sezione di un messaggio SMS. I risultati delle query per questo parametro sono raggruppati per paese o regione, nel formato ISO 3166-1 alfa-2. |
| Messages sent (Messaggi inviati) | `txn-sms-sent` | Il numero di messaggi che sono stati inviati. |
| Messaggi inviati, raggruppati per paese | `txn-sms-sent-grouped-by-country` | Il numero di messaggi inviati per ogni paese o regione a cui sono stati inviati i messaggi. I risultati delle query per questo parametro sono raggruppati per paese o regione, nel formato ISO 3166-1 alfa-2. |
| Messaggi inviati, raggruppati per data | `txn-sms-sent-grouped-by-date` | Il numero di messaggi inviati, per ogni giorno nell'intervallo di date specificato. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Prezzo totale, raggruppato per paese | `txn-sms-total-price-grouped-by-country` | Costo totale dell'invio dei messaggi, per ogni paese o regione a cui sono stati inviati i messaggi. Il prezzo è indicato in millesimi di un centesimo degli Stati Uniti. Ad esempio, se il valore di questo attributo è 645, vengono addebitati 0,645 ¢ per l'invio del messaggio (645/1000=0,645¢=\$10,00645). I risultati delle query per questo parametro sono raggruppati per paese o regione, nel formato ISO 3166-1 alfa-2. |
# Metriche delle campagne Amazon Pinpoint
La tabella seguente elenca e descrive i parametri standard delle campagne su cui è possibile eseguire query per valutare le performance di una singola campagna. Per eseguire query sui dati per queste metriche, utilizza la risorsa [Parametri della campagna](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) dell'API Amazon Pinpoint. Nella tabella, la colonna **kpi-name** indica il valore da utilizzare per il parametro `kpi-name` nella query.
| Metrica | Kpi-name | Description |
| --- | --- | --- |
| Bounce rate (Percentuale di mancati recapiti (bounce)) | `hard-bounce-rate` | Per ogni esecuzione della campagna, la percentuale di messaggi e-mail che non è stato possibile recapitare ai destinatari. Questa metrica misura solo le occorrenze di mancato recapito permanente, ovvero i messaggi in cui l'indirizzo e-mail del destinatario presenta un problema permanente che impedisce il recapito del messaggio. Questo parametro viene calcolato come il numero di messaggi e-mail non recapitati inviati da tutte le esecuzioni della campagna, diviso il numero di messaggi e-mail inviati da tutte quelle esecuzioni della campagna. |
| Percentuale di mancati recapiti, raggruppati per esecuzione della campagna | `hard-bounce-rate-grouped-by-campaign-activity` | Per ogni esecuzione della campagna, la percentuale di messaggi e-mail che non è stato possibile recapitare ai destinatari. Questa metrica misura solo le occorrenze di mancato recapito permanente, ovvero i messaggi in cui l'indirizzo e-mail del destinatario presenta un problema permanente che impedisce il recapito del messaggio. Questo parametro viene calcolato come il numero di messaggi e-mail non recapitati inviati da un'esecuzione della campagna, diviso il numero di messaggi e-mail inviati dall'esecuzione della campagna. I risultati della query per questo parametro sono raggruppati per ID attività della campagna (`CampaignActivityId`), che è una stringa che identifica in modo univoco una esecuzione della campagna. |
| Percentuale di recapiti | `successful-delivery-rate` | Per ogni esecuzione della campagna, la percentuale di messaggi recapitati ai destinatari. Questo parametro viene calcolato come il numero di messaggi che sono stati inviati da tutte le esecuzioni della campagna e recapitati ai destinatari, diviso il numero di messaggi inviati da tutte quelle esecuzioni della campagna. |
| La percentuale di recapiti, raggruppati per l'esecuzione della campagna | `successful-delivery-rate-grouped-by-campaign-activity` | Per ogni esecuzione della campagna, la percentuale di messaggi recapitati ai destinatari. Questo parametro viene calcolato come il numero di messaggi inviati da un'esecuzione della campagna e recapitati ai destinatari, diviso il numero di messaggi inviati tramite l'esecuzione della campagna. I risultati della query per questo parametro sono raggruppati per ID attività della campagna (`CampaignActivityId`), che è una stringa che identifica in modo univoco una esecuzione della campagna. |
| Percentuale di recapiti, raggruppati per data | `successful-delivery-rate-grouped-by-date` | Per tutte le esecuzioni della campagna, la percentuale di messaggi recapitati ai destinatari durante ogni giorno nell'intervallo di date specificato. Questo parametro viene calcolato come il numero di messaggi che sono stati inviati da tutte le esecuzioni della campagna e recapitati ai destinatari, diviso il numero di messaggi inviati da tutte quelle esecuzioni della campagna, per ogni giorno nell'intervallo di date specificato. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Percentuale di e-mail aperte | `email-open-rate` | Per tutte le esecuzioni della campagna, la percentuale di messaggi e-mail aperti dai destinatari.Questo parametro viene calcolato come il numero di messaggi e-mail inviati da tutte le esecuzioni della campagna e aperti dai destinatari, diviso il numero di messaggi e-mail inviati da tutte quelle esecuzioni della campagna e recapitati ai destinatari. |
| Percentuale di e-mail aperte, raggruppate per l'esecuzione della campagna | `email-open-rate-grouped-by-campaign-activity` | Per ogni esecuzione della campagna, la percentuale di messaggi e-mail aperti dai destinatari. Questo parametro viene calcolato come il numero di messaggi e-mail inviati da un'esecuzione della campagna e aperti dai destinatari, diviso il numero di messaggi e-mail inviati dall'esecuzione della campagna e recapitati ai destinatari. I risultati della query per questo parametro sono raggruppati per ID attività della campagna (`CampaignActivityId`), che è una stringa che identifica in modo univoco una esecuzione della campagna. |
| E-mail aperte, raggruppate per l'esecuzione della campagna | `direct-email-opens-grouped-by-campaign-activity` | Per ogni esecuzione della campagna, il numero di messaggi e-mail aperti dai destinatari. I risultati della query per questo parametro sono raggruppati per ID attività della campagna (`CampaignActivityId`), che è una stringa che identifica in modo univoco una esecuzione della campagna. |
| Consegne endpoint | `unique-deliveries` | Per tutte le esecuzioni della campagna, il numero di endpoint univoci ai quali sono stati consegnati i messaggi. |
| Consegne endpoint, raggruppate per l'esecuzione della campagna | `unique-deliveries-grouped-by-campaign-activity` | Per ogni esecuzione della campagna, il numero di endpoint univoci ai quali sono stati consegnati i messaggi. I risultati della query per questo parametro sono raggruppati per ID attività della campagna (`CampaignActivityId`), che è una stringa che identifica in modo univoco una esecuzione della campagna. |
| Consegne endpoint, raggruppate per data | `unique-deliveries-grouped-by-date` | Per tutte le esecuzioni della campagna, il numero di endpoint univoci ai quali sono stati consegnati i messaggi, per ogni giorno nell'intervallo di date specificato. I risultati della query per questo parametro sono raggruppati per giorno di calendario, nel formato esteso ISO 8601. |
| Collegamenti selezionati, raggruppati per l'esecuzione della campagna | `clicks-grouped-by-campaign-activity` | Per ogni esecuzione della campagna, il numero di volte che i destinatari hanno fatto clic su collegamenti nel messaggio e-mail. Se un singolo destinatario ha fatto clic su più collegamenti nel messaggio o ha fatto clic sullo stesso collegamento più di una volta, ogni clic è incluso nel conteggio. I risultati della query per questo parametro sono raggruppati per ID attività della campagna (`CampaignActivityId`), che è una stringa che identifica in modo univoco una esecuzione della campagna. |
| Messaggi recapitati, raggruppati per l'esecuzione della campagna | `successful-deliveries-grouped-by-campaign-activity` | Per ogni esecuzione della campagna, il numero di messaggi recapitati ai destinatari. Questo parametro viene calcolato come il numero di messaggi inviati da una esecuzione della campagna, meno il numero di messaggi non recapitati ai destinatari dell'esecuzione a causa di un hard bounce. I risultati della query per questo parametro sono raggruppati per ID attività della campagna (`CampaignActivityId`), che è una stringa che identifica in modo univoco una esecuzione della campagna. |
| I messaggi inviati, raggruppati per l'esecuzione della campagna | `attempted-deliveries-grouped-by-campaign-activity` | Per ogni esecuzione della campagna, il numero di messaggi che sono stati inviati. I risultati della query per questo parametro sono raggruppati per ID attività della campagna (`CampaignActivityId`), che è una stringa che identifica in modo univoco una esecuzione della campagna. |
| Percentuale di notifiche push aperte | `push-open-rate` | Per ogni esecuzione della campagna, la percentuale di notifiche push aperte dai destinatari. Questo parametro viene calcolato in base al numero di notifiche push che sono state inviate da tutte le esecuzioni della campagna e aperte dai destinatari, diviso il numero di notifiche push che sono state inviate da tutte quelle esecuzioni della campagna e consegnate ai destinatari. |
| Percentuale di notifiche push aperte, raggruppate per l'esecuzione della campagna | `push-open-rate-grouped-by-campaign-activity` | Per ogni esecuzione della campagna, la percentuale di notifiche push aperte dai destinatari. Questo parametro viene calcolato in base al numero di notifiche push che sono state inviate da un'esecuzione della campagna e aperte dai destinatari, diviso il numero di notifiche push che sono state inviate dall'esecuzione della campagna e consegnate ai destinatari. I risultati della query per questo parametro sono raggruppati per ID attività della campagna (`CampaignActivityId`), che è una stringa che identifica in modo univoco una esecuzione della campagna. |
| Totale notifiche push aperte, raggruppate per l'esecuzione della campagna | `direct-push-opens-grouped-by-campaign-activity` | Per ogni esecuzione della campagna, il numero di notifiche push aperte dai destinatari. I risultati della query per questo parametro sono raggruppati per ID attività della campagna (`CampaignActivityId`), che è una stringa che identifica in modo univoco una esecuzione della campagna. |
| Spesa totale SMS | sms-spend | Per tutte le campagne, l'importo totale, in millesimi di centesimo, speso per l'invio di SMS. |
# Metriche di coinvolgimento del percorso Amazon Pinpoint
La tabella seguente elenca e descrive le metriche di coinvolgimento del percorso standard per cui è possibile eseguire query per monitorare le tendenze di tutti i messaggi e-mail inviati da un percorso Amazon Pinpoint. Per eseguire query sui dati relativi a queste metriche, utilizza la risorsa [Metriche di coinvolgimento del percorso](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-kpis-daterange-kpi-name.html) dell'API Amazon Pinpoint. Nella tabella, la colonna **kpi-name** indica il valore da utilizzare per il parametro `kpi-name` in una query.
| Metrica | Kpi-name | Description |
| --- | --- | --- |
| Clic | `journey-emails-clicked` | Il numero di volte che i partecipanti hanno fatto clic sui collegamenti nei messaggi. Se un singolo partecipante ha fatto clic su più collegamenti in un messaggio o ha fatto clic sullo stesso collegamento più di una volta, ogni clic è incluso nel conteggio. |
| Clic, raggruppati per attività | `emails-clicked-grouped-by-journey-activity` | Per ogni attività del viaggio, il numero di volte in cui i partecipanti hanno fatto clic sui link nei messaggi. Se un singolo partecipante ha fatto clic su più collegamenti in un messaggio o ha fatto clic sullo stesso collegamento più di una volta, ogni clic è incluso nel conteggio. I risultati della query per questo parametro sono raggruppati per ID attività (`JourneyActivityId`), che è una stringa che identifica in modo univoco un’attività. |
| Reclami | `journey-emails-complained` | Il numero di messaggi segnalati dai partecipanti come e-mail non richieste o indesiderate. |
| Reclami, raggruppati per attività | `emails-complained-grouped-by-journey-activity` | Per ogni attività del viaggio, il numero di messaggi segnalati dai partecipanti come e-mail non richieste o indesiderate.I risultati della query per questo parametro sono raggruppati per ID attività (`JourneyActivityId`), che è una stringa che identifica in modo univoco un’attività. |
| Consegne | `journey-emails-delivered` | Il numero di messaggi consegnati ai partecipanti. Questo parametro viene calcolato come il numero di messaggi inviati, meno il numero di messaggi che non è stato possibile consegnare a causa di un soft bounce o di un hard bounce o perché sono stati rifiutati. |
| Consegne raggruppate per attività | `emails-delivered-grouped-by-journey-activity` | Per ogni attività del viaggio, il numero di messaggi che sono stati recapitati ai partecipanti. Questo parametro viene calcolato come il numero di messaggi inviati, meno il numero di messaggi che non è stato possibile consegnare a causa di un soft bounce o di un hard bounce o perché sono stati rifiutati, per ogni attività nel viaggio. I risultati della query per questo parametro sono raggruppati per ID attività (`JourneyActivityId`), che è una stringa che identifica in modo univoco un’attività. |
| Mancati recapiti permanenti | `journey-emails-hardbounced` | Il numero di messaggi che non è stato possibile consegnare ai partecipanti a causa di un hard bounce. Un mancato recapito permanente si verifica se un problema persistente impedisce il recapito di un messaggio, ad esempio se l'indirizzo e-mail del partecipante non esiste. |
| Hard bounce, raggruppati per attività | `emails-hardbounced-grouped-by-journey-activity` | Per ogni attività del viaggio, il numero di messaggi che non possono essere recapitati ai partecipanti a causa di un hard bounce. Un mancato recapito permanente si verifica se un problema persistente impedisce il recapito di un messaggio, ad esempio se l'indirizzo e-mail del partecipante non esiste. I risultati della query per questo parametro sono raggruppati per ID attività (`JourneyActivityId`), che è una stringa che identifica in modo univoco un’attività. |
| Aperture | `journey-emails-opened` | Mostra il numero di messaggi che sono stati aperti dai partecipanti: |
| Aperture, raggruppate per attività | `emails-opened-grouped-by-journey-activity` | Per ogni attività del viaggio, il numero di messaggi che sono stati aperti dai partecipanti. I risultati della query per questo parametro sono raggruppati per ID attività (`JourneyActivityId`), che è una stringa che identifica in modo univoco un’attività. |
| Rifiuti | `journey-emails-rejected` | Il numero di messaggi non inviati ai partecipanti perché rifiutati. Un messaggio viene rifiutato se Amazon Pinpoint determina che il messaggio contiene malware. Amazon Pinpoint non tenta di inviare i messaggi rifiutati. |
| Rifiuti, raggruppati per attività | `emails-rejected-grouped-by-journey-activity` | Per ogni attività del viaggio, il numero di messaggi che non sono stati inviati ai partecipanti perché sono stati rifiutati. Un messaggio viene rifiutato se Amazon Pinpoint determina che il messaggio contiene malware. Amazon Pinpoint non tenta di inviare i messaggi rifiutati. I risultati della query per questo parametro sono raggruppati per ID attività (`JourneyActivityId`), che è una stringa che identifica in modo univoco un’attività. |
| Invii | `journey-emails-sent` | Il numero di messaggi che sono stati inviati. |
| Invia, raggruppati per attività | `emails-sent-grouped-by-journey-activity` | Per ogni attività del viaggio, il numero di messaggi inviati. I risultati della query per questo parametro sono raggruppati per ID attività (`JourneyActivityId`), che è una stringa che identifica in modo univoco un’attività. |
| Soft bounce | `journey-emails-softbounced` | Il numero di messaggi che non è stato possibile consegnare ai partecipanti a causa di un soft bounce. Si verifica un caso di e-mail non recapitata se un problema temporaneo impedisce il recapito di un messaggio, ad esempio se la posta in arrivo del partecipante è piena o il server di ricezione è temporaneamente non disponibile. |
| Soft bounce, raggruppati per attività | `emails-softbounced-grouped-by-journey-activity` | Per ogni attività del viaggio, il numero di messaggi che non è stato possibile recapitare ai partecipanti a causa di un soft bounce. Si verifica un caso di e-mail non recapitata se un problema temporaneo impedisce il recapito di un messaggio, ad esempio se la posta in arrivo del partecipante è piena o il server di ricezione è temporaneamente non disponibile. I risultati della query per questo parametro sono raggruppati per ID attività (`JourneyActivityId`), che è una stringa che identifica in modo univoco un’attività. |
| Annullamenti di sottoscrizioni | `journey-emails-unsubscribed` | Il numero di volte in cui i partecipanti hanno fatto clic sui link di annullamento della sottoscrizione nei messaggi. Se un singolo partecipante ha fatto clic sullo stesso link di annullamento della sottoscrizione più di una volta, ogni clic è incluso nel conteggio. |
| Annullamenti delle sottoscrizioni, raggruppati per attività | `emails-unsubscribed-grouped-by-journey-activity` | Per ogni attività del viaggio, il numero di volte in cui i partecipanti hanno fatto clic sui link di annullamento della sottoscrizione nei messaggi. Se un singolo partecipante ha fatto clic sullo stesso link di annullamento della sottoscrizione più di una volta, ogni clic è incluso nel conteggio. I risultati della query per questo parametro sono raggruppati per ID attività (`JourneyActivityId`), che è una stringa che identifica in modo univoco un’attività. |
# Metriche di esecuzione del percorso Amazon Pinpoint
La tabella seguente elenca e descrive le metriche di esecuzione standard su cui è possibile eseguire query per valutare lo stato dei partecipanti in un percorso Amazon Pinpoint. Per eseguire query sui dati per questi metriche, utilizza la risorsa [Metriche di esecuzione percorso](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-execution-metrics.html) dell'API Amazon Pinpoint. Nella colonna **Field (Campo)** nella tabella viene identificato il nome del campo visualizzato nei risultati della query per ogni parametro.
| Metrica | Campo | Description |
| --- | --- | --- |
| Partecipanti attivi | `ENDPOINT_ACTIVE` | Il numero di partecipanti che stanno procedendo attivamente nelle attività del viaggio. Questo parametro è calcolato come il numero di partecipanti che hanno iniziato il viaggio, meno il numero di partecipanti che hanno lasciato il viaggio e il numero di partecipanti che sono stati rimossi dal viaggio. |
| Annullamenti dei partecipanti | `CANCELLED` | Il numero di partecipanti che non hanno completato il viaggio perché il viaggio è stato annullato. |
| Partenze partecipanti | `ENDPOINT_LEFT` | Il numero di partecipanti che hanno abbandonato il viaggio. |
| Ingressi partecipanti | `ENDPOINT_ENTERED` | Il numero di partecipanti che hanno iniziato il viaggio. |
| Eccezioni dei partecipanti, limiti di rientro | `REENTRY_CAP_EXCEEDED` | Il numero di partecipanti che non hanno completato il viaggio perché avrebbero superato il numero massimo di volte in cui un singolo partecipante può rientrare nel viaggio. |
| Eccezioni dei partecipanti, rifiuti | `ACTIVE_ENDPOINT_REJECTED` | Il numero di partecipanti che non possono iniziare il viaggio perché sono già partecipanti attivi al viaggio. Un partecipante viene rifiutato se inizia un viaggio e in seguito la sua definizione di endpoint viene aggiornata in modo tale da compromettere la sua inclusione in un segmento (in base ai criteri del segmento) o nel viaggio (in base alle condizioni di attività). |
# Metriche di esecuzione delle attività del percorso Amazon Pinpoint
La tabella seguente elenca e descrive le metriche di esecuzione standard su cui è possibile eseguire query per valutare lo stato dei partecipanti in ogni tipo di attività individuale in un percorso Amazon Pinpoint. Per eseguire query sui dati per queste metriche, utilizza la risorsa [Metriche di esecuzione delle attività del percorso](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-activities-journey-activity-id-execution-metrics.html) dell'API Amazon Pinpoint. Nella colonna **Metrics (Parametri)** della tabella sono elencati i campi visualizzati nei risultati della query per ogni tipo di attività. Fornisce anche una breve descrizione di ciascun campo.
| Tipo di attività | Metriche |
| --- | --- |
| Divisione/Nessuna divisione (`CONDITIONAL_SPLIT`) | I parametri sono: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) I parametri aggiuntivi sono disponibili per l'attività in ogni percorso. Per informazioni su tali parametri, vedere la riga in questa tabella per quel tipo di attività. |
| Controllo (`HOLDOUT`) | I parametri sono: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| E-mail (`MESSAGE`) | I parametri sono: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| Divisione multivariata (`MULTI_CONDITIONAL_SPLIT`) | Per ogni percorso dell'attività, il numero dei partecipanti che hanno proceduto all'attività sul percorso. I risultati delle query per questa metrica sono raggruppati per percorso, `Branch_#` dove si *\$1* trova l'identificatore numerico di un percorso, `Branch_1` ad esempio per il primo percorso dell'attività. I parametri aggiuntivi sono disponibili per l'attività in ogni percorso. Per informazioni su tali parametri, vedere la riga in questa tabella per quel tipo di attività. |
| Divisione casuale (`RANDOM_SPLIT`) | Per ogni percorso dell'attività, il numero dei partecipanti che hanno proceduto all'attività sul percorso. I risultati della query per questa metrica sono raggruppati per percorso, `Branch_#` *\$1* dov'è l'identificatore numerico di un percorso, ad esempio per il primo percorso dell'attività. `Branch_1` I parametri aggiuntivi sono disponibili per l'attività in ogni percorso. Per informazioni su tali parametri, vedere la riga in questa tabella per quel tipo di attività. |
| Attesa (`WAIT`) | I parametri sono: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| Contact Center (`CONTACT_CENTER`) | I parametri sono: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
# Metriche del percorso e dell'esecuzione delle campagne di Amazon Pinpoint
Puoi eseguire query sulle metriche di esecuzione standard per valutare lo stato dei partecipanti a ogni tipo di attività individuale per un percorso o una campagna Amazon Pinpoint. Per eseguire query sui dati relativi a queste metriche, utilizza la risorsa [Parametri di esecuzione attività percorso](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-runs-run-id-activities-journey-activity-id-execution-metrics.html) o [Parametri della campagna](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) dell'API Amazon Pinpoint. Nella seguente tabella sono elencati i campi visualizzati nei risultati della query per ogni tipo di attività.
****
| Nome parametro | Si applica a percorsi, campagne o entrambi | Description |
| --- | --- | --- |
| ENDPOINT\$1PRODUCED | Entrambi | Numero di endpoint inizialmente prodotti dal segmento o dall'evento prima dell'applicazione di qualsiasi filtro. |
| ENDPOINTS\$1FROM\$1USER | Entrambi | Se il cliente ha un segmento dedicato solo agli ID utente, verranno aggiunti tutti gli endpoint di tali utenti. Questa metrica misura il numero di endpoint aggiunti in questo modo. |
| ENDPOINT\$1OPT\$1OUT | Entrambi | L'endpoint è stato escluso mediante opt-out e non è stato inserito nella campagna o nel percorso. |
| ENDPOINT\$1INACTIVE | Entrambi | L'endpoint è inattivo e non rientra nella campagna o nel percorso. |
| FILTERED\$1OUT\$1BY\$1SEGMENT | Entrambi | L'endpoint non corrisponde ai filtri dei segmenti e non rientra nella campagna o nel percorso. |
| ENDPOINT\$1MISSING\$1ADDRESS | Entrambi | All'endpoint manca un indirizzo e non rientra nella campagna o nel percorso. |
| ENDPOINT\$1MISSING\$1CHANNEL | Entrambi | All'endpoint manca un canale e non rientra nella campagna o nel percorso. |
| ENDPOINT\$1MISSING\$1TIMEZONE | Entrambi | All'endpoint manca un valore per il fuso orario ed è stato escluso. Ciò accade solo quando è richiesto un valore del fuso orario. |
| ENDPOINT\$1TIMEZONE\$1MISMATCH | Entrambi | L'endpoint si trova in un fuso orario attualmente non incluso nell'esecuzione. |
| ENDPOINT\$1CHANNEL\$1MISMATCH | Campagne | La campagna non ha un messaggio configurato per il tipo di canale dell'endpoint specifico. |
| DUPLICATE\$1ENDPOINT | Entrambi | Sono stati rilevati e deduplicati gli endpoint duplicati. |
| DUPLICATE\$1USER | Entrambi | Sono stati rilevati e deduplicati gli utenti duplicati da un segmento di soli ID utente. Se hanno lo stesso ID utente, verrà restituita una metrica pari a 1. |
| PAUSED | Percorsi | Metrica rimossa dall'esecuzione perché il percorso è stato sospeso. |
| ENDED | Percorsi | Metrica rimossa dall'esecuzione perché il percorso è terminato. |
| TREATMENT\$1HOLDOUT | Campagne | Questi dati vengono emessi nelle A/B campagne, per endpoint le cui coorti non corrispondono al trattamento attuale. Ad esempio, in una A/B divisione 50/50, il 50% degli endpoint emetterà questa metrica per ogni trattamento |
| ENDPOINT\$1ESTIMATED\$1TIMEZONE | Percorsi | La stima del fuso orario è stata in grado di stimare un fuso orario per l'endpoint. |
# Interroga i dati di analisi di Amazon Pinpoint per le campagne
Oltre a utilizzare le pagine di analisi sulla console Amazon Pinpoint, puoi utilizzare Amazon Pinpoint APIs Analytics per interrogare i dati di analisi per un sottoinsieme di metriche standard che forniscono informazioni sulle tendenze di distribuzione e coinvolgimento per le campagne.
Ognuno di questi parametri è un valore misurabile, noto anche come *indicatore di prestazioni chiave (KPI)*, che consente di monitorare e valutare le prestazioni di una o più campagne. Ad esempio, è possibile utilizzare un parametro di campagna per accedere ai dati relativi al numero di endpoint ai quali è stato inviato un messaggio della campagna o quanti di questi messaggi sono stati recapitati agli endpoint previsti.
Amazon Pinpoint raccoglie e aggrega automaticamente questi dati per tutte le campagne. Memorizza i dati per 90 giorni. Se hai integrato un'app mobile con Amazon Pinpoint utilizzando un SDK AWS per dispositivi mobili, Amazon Pinpoint estende questo supporto per includere parametri aggiuntivi, come la percentuale di notifiche push aperte dai destinatari. Per informazioni sull'integrazione di un'app per dispositivi mobili, consulta [Integra Amazon Pinpoint con la tua applicazione](integrate.md).
Se utilizzi Amazon Pinpoint Analytics APIs per interrogare i dati, puoi scegliere varie opzioni che definiscono l'ambito, i dati, il raggruppamento e i filtri per la tua query. A tale scopo, utilizzare i parametri che specificano il progetto, la campagna e il parametro su cui eseguire una query, oltre a eventuali filtri basati sulla data che si desidera applicare.
In questo argomento vengono illustrati e forniti esempi di come scegliere queste opzioni ed eseguire query di dati di una o più campagne.
## Prerequisiti
Prima di eseguire query sui dati di analisi di una o più campagne, consente di raccogliere le informazioni seguenti, che sono utilizzate per definire la query:
+ **ID progetto**: identificatore univoco per il progetto associato alla campagna o alle campagne. Nell'API Amazon Pinpoint, questo valore viene archiviato nella proprietà `application-id`. Nella console Amazon Pinpoint, questo valore viene visualizzato nel campo **ID progetto** nella pagina **Tutti i progetti**.
+ **ID campagna**: l'identificatore univoco per la campagna, se desideri eseguire query e i dati solo per una campagna. Nell'API Amazon Pinpoint, questo valore viene archiviato nella proprietà `campaign-id`. Questo valore non viene visualizzato sulla console.
+ **Intervallo di date**: facoltativamente, la prima e l'ultima data e l'ora dell'intervallo di date in cui eseguire query sui dati. Gli intervalli di date includono gli estremi e devono essere limitati a 31 o a un numero minore di giorni di calendario. Inoltre, devono iniziare da meno di 90 giorni rispetto al giorno corrente. Se non viene specificato un intervallo di date, Amazon Pinpoint esegue automaticamente le query sui dati dei 31 giorni di calendario precedenti.
+ **Tipo di metrica**: tipo di metrica a cui inviare le query. Esistono due tipi di parametri, *parametri delle applicazioni* e *parametri delle campagne*. Un *parametro dell'applicazione* fornisce i dati per tutte le campagne associate a un progetto, denominate anche *applicazione*. Un *parametro della campagna* fornisce dati per una sola campagna.
+ **Metrica**: nome della metrica a cui inviare le query, in particolare il valore `kpi-name` della metrica. Per un elenco completo dei parametri supportati e per il valore `kpi-name`di ognuno, consulta [Metriche standard per progetti, campagne e viaggi](analytics-standard-metrics.md).
Aiuta anche a stabilire se si desidera raggruppare i dati in base a un campo pertinente. In tal caso, è possibile semplificare l'analisi e la creazione di report scegliendo un parametro progettato per raggruppare automaticamente i dati. Ad esempio, in Amazon Pinpoint sono disponibili diverse metriche standard che riportano la percentuale di messaggi recapitati ai destinatari di una campagna. Uno di questi parametri raggruppa automaticamente i dati per data (`successful-delivery-rate-grouped-by-date`). Un altro parametro raggruppa automaticamente i dati per esecuzione di campagna (`successful-delivery-rate-grouped-by-campaign-activity`). Una terza metrica restituisce semplicemente un unico valore, ovvero la percentuale di messaggi recapitati ai destinatari da tutte le esecuzioni delle campagne (`successful-delivery-rate`).
Se non è possibile trovare un parametro standard che raggruppi i dati nel modo desiderato, è possibile sviluppare una serie di query in grado di restituire i dati desiderati e quindi suddividere manualmente o combinare i risultati della query in gruppi personalizzati progettati.
Infine, è importante verificare di essere autorizzati ad accedere ai dati su cui si desidera eseguire una query. Per ulteriori informazioni, consulta [Policy IAM per l'esecuzione di query sui dati di analisi di Amazon Pinpoint](analytics-permissions.md).
# Interroga i dati di Amazon Pinpoint per una campagna
Per eseguire una query sui dati di una campagna, è possibile utilizzare l'API [Parametri della campagna](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) e specificare i valori per i seguenti parametri richiesti:
+ **application-id**: ID del progetto, ovvero l'identificatore univoco del progetto associato alla campagna. In Amazon Pinpoint, i termini *progetto* e *applicazione* hanno lo stesso significato.
+ **campaign-id**: identificatore univoco della campagna.
+ **kpi-name**: nome della metrica a cui inviare la query. Questo valore descrive il parametro associato ed è formato da due o più termini, che sono composti da caratteri alfanumerici minuscoli, separati da un trattino. Per un elenco completo dei parametri supportati e per il valore `kpi-name`di ognuno, consulta [Metriche standard per progetti, campagne e viaggi](analytics-standard-metrics.md).
È inoltre possibile applicare un filtro che esegue le query sui dati di un intervallo di date specifico. Se non si specifica un intervallo di date, Amazon Pinpoint restituisce i dati dei 31 giorni di calendario precedenti. Per filtrare i dati in base a date diverse, utilizzare i parametri dell'intervallo di date supportati per specificare la prima e l'ultima data e l'ora dell'intervallo di date. I valori devono essere in formato ISO 8601 esteso e utilizzare il fuso orario UTC (Coordinated Universal Time), ad esempio `2019-07-19T20:00:00Z` per le 20:00 UTC del 19 luglio 2019. Gli intervalli di date includono gli estremi e devono essere limitati a 31 o a un numero minore di giorni di calendario. Inoltre, la prima data e la prima ora non devono precedere il giorno corrente di più di 90 giorni.
Gli esempi seguenti mostrano come interrogare i dati di analisi per una campagna utilizzando l'API REST di Amazon Pinpoint AWS CLI, il e il. AWS SDK per Java Puoi utilizzare qualsiasi AWS SDK supportato per interrogare i dati di analisi per una campagna. Gli AWS CLI esempi sono formattati per Microsoft Windows. Per Unix, Linux e macOS, sostituire il carattere di continuazione della riga caret (^) con una barra rovesciata ().
------
#### [ REST API ]
Per eseguire query sui dati di analisi per una campagna tramite la REST API Amazon Pinpoint, invia una richiesta HTTP(S) GET all'URI [Parametri della campagna](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html). Nell'URI, specificare i valori appropriati per i parametri del percorso richiesti:
```
https://endpoint/v1/apps/application-id/campaigns/campaign-id/kpis/daterange/kpi-name
```
Dove:
+ *endpoint*è l'endpoint Amazon Pinpoint per la AWS regione che ospita il progetto associato alla campagna.
+ *application-id* è l'identificatore univoco del progetto associato alla campagna.
+ *campaign-id* è l'identificatore univoco per la campagna.
+ *kpi-name*è il `kpi-name` valore della metrica da interrogare.
Tutti i parametri devono essere codificati URL.
Per applicare un filtro che interroga i dati per un intervallo di date specifico, aggiungere i parametri di query e i valori `start-time` e `end-time` all'URI. Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Utilizzare una e commerciale (&) per separare i parametri.
Ad esempio, la richiesta seguente recupera il numero di endpoint univoci a cui sono stati recapitati i messaggi, da tutte le esecuzioni di una campagna, dal 19 luglio 2019 al 26 luglio 2019:
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/campaigns/80b8efd84042ff8d9c96ce2f8example/kpis/daterange/unique-deliveries?start-time=2019-07-19T00:00:00Z&end-time=2019-07-26T23:59:59Z
```
Dove:
+ `pinpoint.us-east-1.amazonaws.com` è l'endpoint Amazon Pinpoint per la regione AWS che ospita il progetto.
+ `1234567890123456789012345example` è l'identificatore univoco del progetto associato alla campagna.
+ `80b8efd84042ff8d9c96ce2f8example` è l'identificatore univoco per la campagna.
+ `unique-deliveries` è il valore `kpi-name` del parametro della campagna *recapiti endpoint*, ovvero il parametro che segnala il numero di endpoint univoci a cui sono stati recapitati i messaggi, da tutti i cicli di una campagna.
+ `2019-07-19T00:00:00Z` rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.
+ `2019-07-26T23:59:59Z` rappresenta l'ultima data e l'ora in cui recuperare i dati, come parte di un intervallo di date inclusivo.
------
#### [ AWS CLI ]
Per interrogare i dati di analisi per una campagna utilizzando il AWS CLI, utilizza il **get-campaign-date-range-kpi** comando e specifica i valori appropriati per i parametri richiesti:
```
C:\> aws pinpoint get-campaign-date-range-kpi ^
--application-id application-id ^
--campaign-id campaign-id ^
--kpi-name kpi-name
```
Dove:
+ *application-id* è l'identificatore univoco del progetto associato alla campagna.
+ *campaign-id* è l'identificatore univoco per la campagna.
+ *kpi-name*è il `kpi-name` valore della metrica da interrogare.
Per applicare un filtro che interroga i dati per un intervallo di date specifico, aggiungere i parametri e i valori `end-time` e `start-time` alla query. Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Ad esempio, la richiesta seguente recupera il numero di endpoint univoci a cui sono stati recapitati i messaggi, da tutte le esecuzioni di una campagna, dal 19 luglio 2019 al 26 luglio 2019:
```
C:\> aws pinpoint get-campaign-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--campaign-id 80b8efd84042ff8d9c96ce2f8example ^
--kpi-name unique-deliveries ^
--start-time 2019-07-19T00:00:00Z ^
--end-time 2019-07-26T23:59:59Z
```
Dove:
+ `1234567890123456789012345example` è l'identificatore univoco del progetto associato alla campagna.
+ `80b8efd84042ff8d9c96ce2f8example` è l'identificatore univoco per la campagna.
+ `unique-deliveries` è il valore `kpi-name` del parametro della campagna *recapiti endpoint*, ovvero il parametro che segnala il numero di endpoint univoci a cui sono stati recapitati i messaggi, da tutti i cicli di una campagna.
+ `2019-07-19T00:00:00Z` rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.
+ `2019-07-26T23:59:59Z` rappresenta l'ultima data e l'ora in cui recuperare i dati, come parte di un intervallo di date inclusivo.
------
#### [ SDK for Java ]
Per interrogare i dati di analisi per una campagna utilizzando AWS SDK per Java, utilizza il **GetCampaignDateRangeKpiRequest** metodo dell'API [Campaign Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html). Specificare i valori appropriati per i parametri richiesti:
```
GetCampaignDateRangeKpiRequest request = new GetCampaignDateRangeKpiRequest()
.withApplicationId("applicationId")
.withCampaignId("campaignId")
.withKpiName("kpiName")
```
Dove:
+ *applicationId* è l'identificatore univoco del progetto associato alla campagna.
+ *campaignId* è l'identificatore univoco per la campagna.
+ *kpiName*è il `kpi-name` valore della metrica da interrogare.
Per applicare un filtro che interroga i dati per un intervallo di date specifico, includere i parametri e i valori `endTime` e `startTime` alla query. Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Ad esempio, la richiesta seguente recupera il numero di endpoint univoci a cui sono stati recapitati i messaggi, da tutte le esecuzioni di una campagna, dal 19 luglio 2019 al 26 luglio 2019:
```
GetCampaignDateRangeKpiRequest request = new GetCampaignDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withCampaignId("80b8efd84042ff8d9c96ce2f8example")
.withKpiName("unique-deliveries")
.withStartTime(Date.from(Instant.parse("2019-07-19T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-07-26T23:59:59Z")));
```
Dove:
+ `1234567890123456789012345example` è l'identificatore univoco del progetto associato alla campagna.
+ `80b8efd84042ff8d9c96ce2f8example` è l'identificatore univoco per la campagna.
+ `unique-deliveries` è il valore `kpi-name` del parametro della campagna *recapiti endpoint*, ovvero il parametro che segnala il numero di endpoint univoci a cui sono stati recapitati i messaggi, da tutti i cicli di una campagna.
+ `2019-07-19T00:00:00Z` rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.
+ `2019-07-26T23:59:59Z` rappresenta l'ultima data e l'ora in cui recuperare i dati, come parte di un intervallo di date inclusivo.
------
Dopo aver inviato la query, Amazon Pinpoint restituisce i risultati della query in una risposta JSON. La struttura dei risultati varia a seconda del parametro interrogato. Alcuni parametri restituiscono un solo valore. Ad esempio, la metrica della campagna *Recapiti agli endpoint* (`unique-deliveries`), utilizzata negli esempi precedenti, restituisce un valore, ovvero il numero di endpoint univoci a cui sono stati recapitati i messaggi, per tutte le esecuzioni di una campagna. In questo caso, la risposta JSON è la seguente:
```
{
"CampaignDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"CampaignId":"80b8efd84042ff8d9c96ce2f8example",
"EndTime":"2019-07-26T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
}
]
},
"StartTime":"2019-07-19T00:00:00Z"
}
}
```
Altri parametri restituiscono più valori e raggruppano tali valori in base a un campo pertinente. Se un parametro restituisce più valori, la risposta JSON include un campo che indica quale campo è stato utilizzato per raggruppare i dati.
Per ulteriori informazioni sulla struttura dei risultati delle query, consulta [Usa i risultati delle query JSON](analytics-query-results.md).
# Interroga i dati di Amazon Pinpoint per più campagne
È possibile eseguire query sui dati per più campagne in due modi. Il modo migliore dipende dal fatto che si desidera eseguire una query sui dati per le campagne che sono tutte associate allo stesso progetto. In tal caso, dipende anche dal fatto che si desidera eseguire una query sui dati per tutte o solo per un sottoinsieme di tali campagne.
Per eseguire una query sui dati delle campagne associate a progetti diversi o solo sui dati di un sottoinsieme delle campagne associate allo stesso progetto, l'approccio migliore consiste nel creare ed eseguire una serie di query individuali, una per ogni campagna sui cui dati si desidera eseguire una query. Nella sezione precedente viene illustrato come eseguire una query sui dati per una sola campagna.
Per eseguire una query sui dati di tutte le campagne associate allo stesso progetto, è possibile utilizzare l'API [Parametri applicazioni](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Specificare i valori per i parametri obbligatori seguenti.
+ **application-id**: ID del progetto, che è l'identificatore univoco del progetto. In Amazon Pinpoint, i termini *progetto* e *applicazione* hanno lo stesso significato.
+ **kpi-name**: nome della metrica a cui inviare la query. Questo valore descrive il parametro associato ed è formato da due o più termini, che sono composti da caratteri alfanumerici minuscoli, separati da un trattino. Per un elenco completo dei parametri supportati e per il valore `kpi-name`di ognuno, consulta [Metriche standard per progetti, campagne e viaggi](analytics-standard-metrics.md).
È inoltre possibile filtrare i dati in base all'intervallo di date. Se non si specifica un intervallo di date, Amazon Pinpoint restituisce i dati dei 31 giorni di calendario precedenti. Per filtrare i dati in base a date diverse, utilizzare i parametri dell'intervallo di date supportati per specificare la prima e l'ultima data e l'ora dell'intervallo di date. I valori devono essere in formato ISO 8601 esteso e utilizzare il fuso orario UTC (Coordinated Universal Time), ad esempio `2019-07-19T20:00:00Z` per le 20:00 UTC del 19 luglio 2019. Gli intervalli di date includono gli estremi e devono essere limitati a 31 o a un numero minore di giorni di calendario. Inoltre, la prima data e la prima ora non devono precedere il giorno corrente di più di 90 giorni.
Gli esempi seguenti mostrano come interrogare i dati di analisi per una campagna utilizzando l'API REST di Amazon Pinpoint AWS CLI, il e il. AWS SDK per Java Puoi utilizzare qualsiasi AWS SDK supportato per interrogare i dati di analisi per una campagna. Gli AWS CLI esempi sono formattati per Microsoft Windows. Per Unix, Linux e macOS, sostituire il carattere di continuazione della riga caret (^) con una barra rovesciata ().
------
#### [ REST API ]
Per eseguire query sui dati di analisi per più campagne utilizzando la REST API Amazon Pinpoint, invia una richiesta HTTP(S) GET all'URI [Metriche delle applicazioni](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Nell'URI, specificare i valori appropriati per i parametri del percorso richiesti:
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
Dove:
+ *endpoint*è l'endpoint Amazon Pinpoint per la AWS regione che ospita il progetto associato alle campagne.
+ *application-id* è l'identificatore univoco per il progetto associato alle campagne.
+ *kpi-name*è il `kpi-name` valore della metrica da interrogare.
Tutti i parametri devono essere codificati URL.
Per applicare un filtro che richiama i dati per un intervallo di date specifico, aggiungere i parametri di query e i valori `start-time` e `end-time` all'URI. Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Utilizzare una e commerciale (&) per separare i parametri.
Ad esempio, la richiesta seguente recupera il numero di endpoint univoci a cui sono stati recapitati i messaggi, da tutte le campagne di un progetto, dal 19 luglio 2019 al 26 luglio 2019:
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/unique-deliveries-grouped-by-campaign?start-time=2019-07-19T00:00:00Z&end-time=2019-07-26T23:59:59Z
```
Dove:
+ `pinpoint.us-east-1.amazonaws.com` è l'endpoint Amazon Pinpoint per la regione AWS che ospita il progetto.
+ `1234567890123456789012345example` è l'identificatore univoco per il progetto associato alle campagne.
+ `unique-deliveries-grouped-by-campaign` è il valore `kpi-name` per il parametro dell'applicazione *recapiti endpoint, raggruppati per campagna* ovvero il parametro che restituisce il numero di endpoint univoci a cui sono stati recapitati i messaggi per ciascuna campagna.
+ `2019-07-19T00:00:00Z` rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.
+ `2019-07-26T23:59:59Z` rappresenta l'ultima data e l'ora in cui recuperare i dati, come parte di un intervallo di date inclusivo.
------
#### [ AWS CLI ]
Per interrogare i dati di analisi per più campagne utilizzando il AWS CLI, utilizza il **get-application-date-range-kpi** comando e specifica i valori appropriati per i parametri richiesti:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
Dove:
+ *application-id* è l'identificatore univoco per il progetto associato alle campagne.
+ *kpi-name*è il `kpi-name` valore della metrica da interrogare.
Per applicare un filtro che richiama i dati per un intervallo di date specifico, includere i parametri e i valori `end-time` e `start-time` alla query. Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Ad esempio, la richiesta seguente recupera il numero di endpoint univoci a cui sono stati recapitati i messaggi, da tutte le campagne di un progetto, dal 19 luglio 2019 al 26 luglio 2019:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name unique-deliveries-grouped-by-campaign ^
--start-time 2019-07-19T00:00:00Z ^
--end-time 2019-07-26T23:59:59Z
```
Dove:
+ `1234567890123456789012345example` è l'identificatore univoco del progetto associato alla campagna.
+ `unique-deliveries-grouped-by-campaign` è il valore `kpi-name` per il parametro dell'applicazione *recapiti endpoint, raggruppati per campagna* ovvero il parametro che restituisce il numero di endpoint univoci a cui sono stati recapitati i messaggi per ciascuna campagna.
+ `2019-07-19T00:00:00Z` rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.
+ `2019-07-26T23:59:59Z` rappresenta l'ultima data e l'ora in cui recuperare i dati, come parte di un intervallo di date inclusivo.
------
#### [ SDK for Java ]
Per interrogare i dati di analisi per più campagne utilizzando il AWS SDK per Java, utilizza il **GetApplicationDateRangeKpiRequest** metodo dell'API [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Specificare i valori appropriati per i parametri richiesti:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
Dove:
+ *applicationId* è l'identificatore univoco per il progetto associato alle campagne.
+ *kpiName*è il `kpi-name` valore della metrica da interrogare.
Per applicare un filtro che richiama i dati per un intervallo di date specifico, includere i parametri e i valori `endTime` e `startTime` alla query. Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Ad esempio, la richiesta seguente recupera il numero di endpoint univoci a cui sono stati recapitati i messaggi, da tutte le campagne di un progetto, dal 19 luglio 2019 al 26 luglio 2019:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("unique-deliveries-grouped-by-campaign")
.withStartTime(Date.from(Instant.parse("2019-07-19T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-07-26T23:59:59Z")));
```
Dove:
+ `1234567890123456789012345example` è l'identificatore univoco per il progetto associato alle campagne.
+ `unique-deliveries-grouped-by-campaign` è il valore `kpi-name` per il parametro dell'applicazione *recapiti endpoint, raggruppati per campagna* ovvero il parametro che restituisce il numero di endpoint univoci a cui sono stati recapitati i messaggi per ciascuna campagna.
+ `2019-07-19T00:00:00Z` rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.
+ `2019-07-26T23:59:59Z` rappresenta l'ultima data e l'ora in cui recuperare i dati, come parte di un intervallo di date inclusivo.
------
Dopo aver inviato la query, Amazon Pinpoint restituisce i risultati della query in una risposta JSON. La struttura dei risultati varia a seconda del parametro interrogato. Alcuni parametri restituiscono un solo valore. Altri parametri restituiscono più valori e quei valori sono raggruppati in base a un campo pertinente. Se un parametro restituisce più valori, la risposta JSON include un campo che indica quale campo è stato utilizzato per raggruppare i dati.
Ad esempio, la metrica *Recapiti agli endpoint, raggruppati per campagna* (`unique-deliveries-grouped-by-campaign`), utilizzata negli esempi precedenti, restituisce più valori, ovvero il numero di endpoint univoci a cui sono stati recapitati i messaggi, per ogni campagna associata a un progetto. In questo caso, la risposta JSON è la seguente:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-07-26T23:59:59Z",
"KpiName":"unique-deliveries-grouped-by-campaign",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"80b8efd84042ff8d9c96ce2f8example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"810c7aab86d42fb2b56c8c966example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"456.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"42d8c7eb0990a57ba1d5476a3example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"789.0"
}
]
}
]
},
"StartTime":"2019-07-19T00:00:00Z"
}
}
```
In questo caso, il campo `GroupedBys` indica che i valori sono raggruppati per ID campagna (`CampaignId`).
Per ulteriori informazioni sulla struttura dei risultati delle query, consulta [Usa i risultati delle query JSON](analytics-query-results.md).
# Interroga i dati di analisi di Amazon Pinpoint per i messaggi transazionali
Oltre a utilizzare le pagine di analisi sulla console Amazon Pinpoint, puoi utilizzare Amazon Pinpoint APIs Analytics per interrogare i dati di analisi per un sottoinsieme di metriche standard che forniscono informazioni sulle tendenze di consegna e coinvolgimento per i messaggi transazionali inviati per un progetto.
Ognuno di questi parametri è un valore misurabile, noto anche come *indicatore di prestazioni chiave (KPI)*, che consente di monitorare e valutare le prestazioni di questi messaggi transazionali. Ad esempio, è possibile utilizzare una metrica per scoprire il numero di messaggi e-mail o SMS transazionali inviati o quanti di questi messaggi sono stati recapitati ai destinatari. Amazon Pinpoint raccoglie e aggrega automaticamente questi dati per tutti i messaggi e-mail e SMS transazionali inviati per un progetto. Memorizza i dati per 90 giorni.
Se utilizzi Amazon Pinpoint Analytics APIs per interrogare i dati, puoi scegliere varie opzioni che definiscono l'ambito, i dati, il raggruppamento e i filtri per la tua query. A tale scopo, utilizza i parametri che specificano il progetto e il parametro su cui eseguire una query, oltre a eventuali filtri basati sulla data che desideri applicare.
Questo argomento illustra e fornisce esempi di come scegliere queste opzioni ed esegue query sui dati di messaggistica transazionale per un progetto.
## Prerequisiti
Prima di eseguire query sui dati di analisi per i messaggi transazionali, consente di raccogliere le informazioni seguenti, che vengono utilizzate per definire la query:
+ **ID progetto**: identificatore univoco per il progetto da cui sono stati inviati i messaggi. Nell'API Amazon Pinpoint, questo valore viene archiviato nella proprietà `application-id`. Nella console Amazon Pinpoint, questo valore viene visualizzato nel campo **ID progetto** nella pagina **Tutti i progetti**.
+ **Intervallo di date**: facoltativamente, la prima e l'ultima data e l'ora dell'intervallo di date in cui eseguire query sui dati. Gli intervalli di date includono gli estremi e devono essere limitati a 31 o a un numero minore di giorni di calendario. Inoltre, devono iniziare da meno di 90 giorni rispetto al giorno corrente. Se non viene specificato un intervallo di date, Amazon Pinpoint esegue automaticamente le query sui dati dei 31 giorni di calendario precedenti.
+ **Metrica**: nome della metrica a cui inviare le query, in particolare il valore `kpi-name` della metrica. Per un elenco completo dei parametri supportati e per il valore `kpi-name`di ognuno, consulta [Metriche standard per progetti, campagne e viaggi](analytics-standard-metrics.md).
Aiuta anche a stabilire se si desidera raggruppare i dati in base a un campo pertinente. In tal caso, è possibile semplificare l'analisi e la creazione di report scegliendo un parametro progettato per raggruppare automaticamente i dati. Ad esempio, in Amazon Pinpoint sono disponibili diverse metriche standard che restituiscono il numero di messaggi SMS transazionali recapitati ai destinatari. Uno di questi parametri raggruppa automaticamente i dati per data (`txn-sms-delivered-grouped-by-date`). Un altro parametro raggruppa automaticamente i dati per paese o regione (`txn-sms-delivered-grouped-by-country`). Una terza metrica restituisce semplicemente un unico valore, ovvero il numero di messaggi recapitati ai destinatari (`txn-sms-delivered`). Se non è possibile trovare un parametro standard che raggruppi i dati nel modo desiderato, è possibile sviluppare una serie di query in grado di restituire i dati desiderati e quindi suddividere manualmente o combinare i risultati della query in gruppi personalizzati progettati.
Infine, è importante verificare di essere autorizzati ad accedere ai dati su cui si desidera eseguire una query. Per ulteriori informazioni, consulta [Policy IAM per l'esecuzione di query sui dati di analisi di Amazon Pinpoint](analytics-permissions.md).
# Interroga i dati di Amazon Pinpoint per i messaggi e-mail transazionali
Per eseguire una query sui dati relativi ai messaggi e-mail transazionali inviati per un progetto, è possibile utilizzare l'API [Parametri applicazioni](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) e specificare i valori per i seguenti parametri richiesti:
+ **application-id**: ID del progetto, che è l'identificatore univoco del progetto. In Amazon Pinpoint, i termini *progetto* e *applicazione* hanno lo stesso significato.
+ **kpi-name**: nome della metrica a cui inviare la query. Questo valore descrive il parametro associato ed è formato da due o più termini, che sono composti da caratteri alfanumerici minuscoli, separati da un trattino. Per un elenco completo dei parametri supportati e per il valore `kpi-name`di ognuno, consulta [Metriche standard per progetti, campagne e viaggi](analytics-standard-metrics.md).
È inoltre possibile applicare un filtro che esegue le query sui dati di un intervallo di date specifico. Se non si specifica un intervallo di date, Amazon Pinpoint restituisce i dati dei 31 giorni di calendario precedenti. Per filtrare i dati in base a date diverse, utilizzare i parametri dell'intervallo di date supportati per specificare la prima e l'ultima data e l'ora dell'intervallo di date. I valori devono essere in formato ISO 8601 esteso e utilizzare il fuso orario UTC (Coordinated Universal Time), ad esempio `2019-09-06T20:00:00Z` per le 20:00 UTC del 6 settembre 2019. Gli intervalli di date includono gli estremi e devono essere limitati a 31 o a un numero minore di giorni di calendario. Inoltre, la prima data e la prima ora non devono precedere il giorno corrente di più di 90 giorni.
Gli esempi seguenti mostrano come interrogare i dati di analisi per i messaggi e-mail transazionali utilizzando l'API REST di Amazon Pinpoint, il e AWS CLI il. AWS SDK per JavaÈ possibile utilizzare qualsiasi SDK AWS supportato per eseguire query sui dati di analisi dei messaggi transazionali. Gli AWS CLI esempi sono formattati per Microsoft Windows. Per Unix, Linux e macOS, sostituire il carattere di continuazione della riga caret (^) con una barra rovesciata ().
------
#### [ REST API ]
Per eseguire query sui dati di analisi per i messaggi e-mail transazionali tramite la REST API Amazon Pinpoint, invia una richiesta HTTP(S) GET all'URI [Metriche delle applicazioni](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Nell'URI, specificare i valori appropriati per i parametri del percorso richiesti:
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
Dove:
+ *endpoint*è l'endpoint Amazon Pinpoint per la AWS regione che ospita il progetto.
+ *application-id* è l'identificatore univoco per il progetto.
+ *kpi-name*è il `kpi-name` valore della metrica da interrogare.
Tutti i parametri devono essere codificati URL.
Per applicare un filtro che interroga i dati per un intervallo di date specifico, aggiungere i parametri di query e i valori `start-time` e `end-time` all'URI. Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Utilizzare una e commerciale (&) per separare i parametri.
Ad esempio, la seguente richiesta recupera il numero di messaggi e-mail transazionali inviati per un progetto dal 6 settembre 2019 al 13 settembre 2019:
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/txn-emails-sent?start-time=2019-09-06T00:00:00Z&end-time=2019-09-13T23:59:59Z
```
Dove:
+ `pinpoint.us-east-1.amazonaws.com` è l'endpoint Amazon Pinpoint per la regione AWS che ospita il progetto.
+ `1234567890123456789012345example` è l'identificatore univoco per il progetto.
+ `txn-emails-sent` è il valore `kpi-name` del parametro dell'applicazione *invii* ovvero il parametro segnala il numero di messaggi e-mail transazionali inviati per un progetto.
+ `2019-09-06T00:00:00Z` rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.
+ `2019-09-13T23:59:59Z` rappresenta l'ultima data e l'ora in cui recuperare i dati, come parte di un intervallo di date inclusivo.
------
#### [ AWS CLI ]
Per interrogare i dati di analisi per i messaggi e-mail transazionali utilizzando il AWS CLI, utilizzate il **get-application-date-range-kpi** comando e specificate i valori appropriati per i parametri richiesti:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
Dove:
+ *application-id* è l'identificatore univoco per il progetto.
+ *kpi-name*è il `kpi-name` valore della metrica da interrogare.
Per applicare un filtro che interroga i dati per un intervallo di date specifico, aggiungere i parametri e i valori `end-time` e `start-time` alla query. Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Ad esempio, la seguente richiesta recupera il numero di messaggi e-mail transazionali inviati per un progetto dal 6 settembre 2019 al 13 settembre 2019:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name txn-emails-sent ^
--start-time 2019-09-06T00:00:00Z ^
--end-time 2019-09-13T23:59:59Z
```
Dove:
+ `1234567890123456789012345example` è l'identificatore univoco per il progetto.
+ `txn-emails-sent` è il valore `kpi-name` del parametro dell'applicazione *invii* ovvero il parametro segnala il numero di messaggi e-mail transazionali inviati per un progetto.
+ `2019-09-06T00:00:00Z` rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.
+ `2019-09-13T23:59:59Z` rappresenta l'ultima data e l'ora in cui recuperare i dati, come parte di un intervallo di date inclusivo.
------
#### [ SDK for Java ]
Per interrogare i dati di analisi per i messaggi e-mail transazionali utilizzando il AWS SDK per Java, utilizza il **GetApplicationDateRangeKpiRequest** metodo dell'API [Application](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) Metrics. Specificare i valori appropriati per i parametri richiesti:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
Dove:
+ *applicationId* è l'identificatore univoco per il progetto.
+ *kpiName*è il `kpi-name` valore della metrica da interrogare.
Per applicare un filtro che interroga i dati per un intervallo di date specifico, includere i parametri e i valori `endTime` e `startTime` alla query. Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Ad esempio, la seguente richiesta recupera il numero di messaggi e-mail transazionali inviati per un progetto dal 6 settembre 2019 al 13 settembre 2019:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("txn-emails-sent")
.withStartTime(Date.from(Instant.parse("2019-09-06T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-09-13T23:59:59Z")));
```
Dove:
+ `1234567890123456789012345example` è l'identificatore univoco per il progetto.
+ `txn-emails-sent` è il valore `kpi-name` del parametro dell'applicazione *invii* ovvero il parametro segnala il numero di messaggi e-mail transazionali inviati per un progetto.
+ `2019-09-06T00:00:00Z` rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.
+ `2019-09-13T23:59:59Z` rappresenta l'ultima data e l'ora in cui recuperare i dati, come parte di un intervallo di date inclusivo.
------
Dopo aver inviato la query, Amazon Pinpoint restituisce i risultati della query in una risposta JSON. La struttura dei risultati varia a seconda del parametro interrogato. Alcuni parametri restituiscono un solo valore. Ad esempio, la metrica *Invii* (`txn-emails-sent`), utilizzata negli esempi precedenti, restituisce un valore, ovvero il numero di messaggi e-mail transazionali inviati da un progetto. In questo caso, la risposta JSON è la seguente:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-09-13T23:59:59Z",
"KpiName":"txn-emails-sent",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"TxnEmailsSent",
"Type":"Double",
"Value":"62.0"
}
]
}
]
},
"StartTime":"2019-09-06T00:00:00Z"
}
}
```
Altri parametri restituiscono più valori e raggruppano tali valori in base a un campo pertinente. Se un parametro restituisce più valori, la risposta JSON include un campo che indica quale campo è stato utilizzato per raggruppare i dati.
Per ulteriori informazioni sulla struttura dei risultati delle query, consulta [Usa i risultati delle query JSON](analytics-query-results.md).
# Interroga i dati di Amazon Pinpoint per i messaggi SMS transazionali
Per eseguire una query sui dati relativi ai messaggi SMS transazionali inviati per un progetto, è possibile utilizzare l'API [Parametri applicazioni](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) e specificare i valori per i seguenti parametri richiesti:
+ **application-id**: ID del progetto, che è l'identificatore univoco del progetto. In Amazon Pinpoint, i termini *progetto* e *applicazione* hanno lo stesso significato.
+ **kpi-name**: nome della metrica a cui inviare la query. Questo valore descrive il parametro associato ed è formato da due o più termini, che sono composti da caratteri alfanumerici minuscoli, separati da un trattino. Per un elenco completo dei parametri supportati e per il valore `kpi-name`di ognuno, consulta [Metriche standard per progetti, campagne e viaggi](analytics-standard-metrics.md).
È inoltre possibile applicare un filtro che esegue le query sui dati di un intervallo di date specifico. Se non si specifica un intervallo di date, Amazon Pinpoint restituisce i dati dei 31 giorni di calendario precedenti. Per filtrare i dati in base a date diverse, utilizzare i parametri dell'intervallo di date supportati per specificare la prima e l'ultima data e l'ora dell'intervallo di date. I valori devono essere in formato ISO 8601 esteso e utilizzare il fuso orario UTC (Coordinated Universal Time), ad esempio `2019-09-06T20:00:00Z` per le 20:00 UTC del 6 settembre 2019. Gli intervalli di date includono gli estremi e devono essere limitati a 31 o a un numero minore di giorni di calendario. Inoltre, la prima data e la prima ora non devono precedere il giorno corrente di più di 90 giorni.
Gli esempi seguenti mostrano come interrogare i dati di analisi per i messaggi SMS transazionali utilizzando l'API REST di Amazon Pinpoint, il e AWS CLI il. AWS SDK per Java Puoi utilizzare qualsiasi AWS SDK supportato per interrogare i dati di analisi per i messaggi transazionali. Gli AWS CLI esempi sono formattati per Microsoft Windows. Per Unix, Linux e macOS, sostituire il carattere di continuazione della riga caret (^) con una barra rovesciata ().
------
#### [ REST API ]
Per eseguire query sui dati di analisi per i messaggi SMS transazionali tramite la REST API Amazon Pinpoint, invia una richiesta HTTP(S) GET all'URI [Metriche delle applicazioni](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Nell'URI, specificare i valori appropriati per i parametri del percorso richiesti:
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
Dove:
+ *endpoint*è l'endpoint Amazon Pinpoint per la AWS regione che ospita il progetto.
+ *application-id* è l'identificatore univoco per il progetto.
+ *kpi-name*è il `kpi-name` valore della metrica da interrogare.
Tutti i parametri devono essere codificati URL.
Per applicare un filtro che richiama i dati per un intervallo di date specifico, aggiungere i parametri di query e i valori `start-time` e `end-time` all'URI. Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Utilizzare una e commerciale (&) per separare i parametri.
Ad esempio, la seguente richiesta recupera il numero di messaggi SMS transazionali inviati ogni giorno dal 6 settembre 2019 all'8 settembre 2019:
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/txn-sms-sent-grouped-by-date?start-time=2019-09-06T00:00:00Z&end-time=2019-09-08T23:59:59Z
```
Dove:
+ `pinpoint.us-east-1.amazonaws.com` è l'endpoint Amazon Pinpoint per la regione AWS che ospita il progetto.
+ `1234567890123456789012345example` è l'identificatore univoco per il progetto.
+ `txn-sms-sent-grouped-by-date` è il valore `kpi-name` del parametro dell'applicazione *invii, raggruppati per data* ovvero il parametro che restituisce il numero di messaggi SMS transazionali inviati ogni giorno nell'intervallo di date indicato.
+ `2019-09-06T00:00:00Z` rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.
+ `2019-09-08T23:59:59Z` rappresenta l'ultima data e l'ora in cui recuperare i dati, come parte di un intervallo di date inclusivo.
------
#### [ AWS CLI ]
Per interrogare i dati di analisi per i messaggi SMS transazionali utilizzando il AWS CLI, utilizzate il **get-application-date-range-kpi** comando e specificate i valori appropriati per i parametri richiesti:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
Dove:
+ *application-id* è l'identificatore univoco per il progetto.
+ *kpi-name*è il `kpi-name` valore della metrica da interrogare.
Per applicare un filtro che richiama i dati per un intervallo di date specifico, includere i parametri e i valori `end-time` e `start-time` alla query. Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Ad esempio, la seguente richiesta recupera il numero di messaggi SMS transazionali inviati ogni giorno dal 6 settembre 2019 all'8 settembre 2019:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name txn-sms-sent-grouped-by-date ^
--start-time 2019-09-06T00:00:00Z ^
--end-time 2019-09-08T23:59:59Z
```
Dove:
+ `1234567890123456789012345example` è l'identificatore univoco per il progetto.
+ `txn-sms-sent-grouped-by-date` è il valore `kpi-name` del parametro dell'applicazione *invii, raggruppati per data* ovvero il parametro che restituisce il numero di messaggi SMS transazionali inviati ogni giorno nell'intervallo di date indicato.
+ `2019-09-06T00:00:00Z` rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.
+ `2019-09-08T23:59:59Z` rappresenta l'ultima data e l'ora in cui recuperare i dati, come parte di un intervallo di date inclusivo.
------
#### [ SDK for Java ]
Per interrogare i dati di analisi per i messaggi SMS transazionali utilizzando il AWS SDK per Java, utilizza il **GetApplicationDateRangeKpiRequest** metodo dell'API [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) e specifica i valori appropriati per i parametri richiesti:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
Dove:
+ *applicationId* è l'identificatore univoco per il progetto.
+ *kpiName*è il `kpi-name` valore della metrica da interrogare.
Per applicare un filtro che richiama i dati per un intervallo di date specifico, includere i parametri e i valori `endTime` e `startTime` alla query. Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Ad esempio, la seguente richiesta recupera il numero di messaggi SMS transazionali inviati ogni giorno dal 6 settembre 2019 all'8 settembre 2019:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("txn-sms-sent-grouped-by-date")
.withStartTime(Date.from(Instant.parse("2019-09-06T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-09-08T23:59:59Z")));
```
Dove:
+ `1234567890123456789012345example` è l'identificatore univoco per il progetto.
+ `txn-sms-sent-grouped-by-date` è il valore `kpi-name` del parametro dell'applicazione *invii, raggruppati per data* ovvero il parametro che restituisce il numero di messaggi SMS transazionali inviati ogni giorno nell'intervallo di date indicato.
+ `2019-09-06T00:00:00Z` rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.
+ `2019-09-08T23:59:59Z` rappresenta l'ultima data e l'ora in cui recuperare i dati, come parte di un intervallo di date inclusivo.
------
Dopo aver inviato la query, Amazon Pinpoint restituisce i risultati della query in una risposta JSON. La struttura dei risultati varia a seconda del parametro interrogato. Alcuni parametri restituiscono un solo valore. Altri parametri restituiscono più valori e raggruppano tali valori in base a un campo pertinente. Se un parametro restituisce più valori, la risposta JSON include un campo che indica quale campo è stato utilizzato per raggruppare i dati.
Ad esempio, la metrica *Invii, raggruppati per data* (`txn-sms-sent-grouped-by-date`), utilizzata negli esempi precedenti, restituisce più valori, ovvero il numero di messaggi SMS transazionali inviati durante ogni giorno dell'intervallo di date specificato. In questo caso, la risposta JSON è la seguente:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-09-08T23:59:59Z",
"KpiName":"txn-sms-sent-grouped-by-date",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-06"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"29.0"
}
]
},
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-07"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"35.0"
}
]
},
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-08"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"10.0"
}
]
}
]
},
"StartTime":"2019-09-06T00:00:00Z"
}
}
```
In questo caso, il campo `GroupedBys` indica che i valori sono raggruppati per giorno di calendario (`Date`). Ciò significa che:
+ 29 messaggi sono stati inviati il 6 settembre 2019.
+ 35 messaggi sono stati inviati il 7 settembre 2019.
+ 10 messaggi sono stati inviati l'8 settembre 2019.
Per ulteriori informazioni sulla struttura dei risultati delle query, consulta [Usa i risultati delle query JSON](analytics-query-results.md).
# Usa i risultati delle query JSON di Amazon Pinpoint Analytics
Quando usi Amazon Pinpoint Analytics APIs per interrogare i dati di analisi, Amazon Pinpoint restituisce i risultati in una risposta JSON. Per le metriche delle applicazioni, le metriche delle campagne e le metriche di coinvolgimento del percorso, i dati nella risposta sono conformi a uno schema JSON standard per la creazione di report di dati di analisi di Amazon Pinpoint.
Ciò significa che è possibile utilizzare il linguaggio di programmazione o lo strumento di propria scelta per implementare una soluzione personalizzata che esegua query sui dati per uno o più di questi parametri, acquisisca i risultati di ogni query e quindi scriva i risultati in una tabella, un oggetto o un'altra posizione. È quindi possibile utilizzare i risultati delle query in tale posizione utilizzando un altro servizio o applicazione.
Ad esempio, puoi:
+ Creare un dashboard personalizzato che esegua regolarmente le query su un set di parametri e visualizzi i risultati utilizzando il framework di visualizzazione dei dati preferito.
+ Creare un report che tenga traccia dei tassi di coinvolgimento eseguendo una query sui parametri appropriati e visualizzando i risultati in un grafico o in un altro tipo di report che si progetta.
+ Analizzare e scrivere i dati di analisi in un particolare formato di storage e quindi eseguire il port dei risultati in una soluzione di storage a lungo termine.
Tieni presente che Amazon Pinpoint Analytics APIs non è progettato per creare o archiviare oggetti persistenti da leggere o utilizzare successivamente in un progetto Amazon Pinpoint o nel tuo account Amazon Pinpoint. APIs Sono invece progettati per aiutarti a recuperare dati di analisi e trasferirli ad altri servizi e applicazioni per ulteriori analisi, archiviazione o report. Lo fanno in parte utilizzando la stessa struttura di risposta JSON e lo stesso schema per tutti i dati di analisi su cui è possibile eseguire query in modo programmatico per i parametri dell’applicazione, i parametri della campagna e i parametri di coinvolgimento del viaggio.
In questo argomento vengono illustrati la struttura, gli oggetti e i campi in una risposta JSON a una query per un parametro dell'applicazione, un parametro della campagna o un parametro di coinvolgimento del viaggio. Per informazioni sui campi in una risposta JSON a una query relativa a un parametro di esecuzione del viaggio o a un parametro di esecuzione dell'attività di viaggio, consulta [Metriche standard che si applicano a progetti, campagne e percorsi Amazon Pinpoint](analytics-standard-metrics.md).
## Struttura JSON
Per aiutarti ad analizzare e utilizzare i risultati delle query, Amazon Pinpoint APIs Analytics utilizza la stessa struttura di risposta JSON per tutti i dati di analisi di Amazon Pinpoint che puoi interrogare a livello di codice per le metriche delle applicazioni, le metriche delle campagne e le metriche di coinvolgimento del viaggio. Ogni risposta JSON specifica i valori che hanno definito la query, ad esempio l'ID del progetto (`ApplicationId`). La risposta include anche un (e solo un) oggetto `KpiResult`. L'oggetto `KpiResult` contiene il set di risultati complessivo per una query.
Ogni oggetto `KpiResult` contiene un oggetto `Rows`. Si tratta di un array di oggetti che contengono risultati di query e metadati pertinenti sui valori in tali risultati. La struttura e il contenuto di un oggetto `Rows` presentano le seguenti caratteristiche generali:
+ Ogni riga di risultati di query è un oggetto JSON separato, denominato `Values`, nell'oggetto `Rows`. Ad esempio, se una query restituisce tre valori, l'oggetto `Rows` contiene tre oggetti `Values`. Ogni oggetto `Values` contiene un singolo risultato per la query.
+ Ogni colonna dei risultati della query è una proprietà dell'oggetto `Values` a cui si applica. Il nome della colonna viene archiviato nel campo `Key` dell'oggetto `Values`.
+ Per i risultati delle query raggruppate, ogni oggetto `Values` ha un oggetto `GroupedBys` associato. L'oggetto `GroupedBys` indica quale campo è stato utilizzato per raggruppare i risultati. Fornisce inoltre il valore di raggruppamento per l'oggetto `Values` associato.
+ Se i risultati della query per un parametro sono null, l'oggetto `Rows` è vuoto.
Al di là di queste caratteristiche generali, la struttura e il contenuto dell'oggetto `Rows` variano a seconda del parametro. Questo perché Amazon Pinpoint supporta due tipi di metriche, ovvero *metriche a valore singolo * e *metriche a valore multiplo*.
Un *parametro a valore singolo* fornisce un solo valore cumulativo. Un esempio è la percentuale di messaggi recapitati ai destinatari da tutte le esecuzioni di una campagna. Un *parametro a valore multiplo* fornisce più di un valore e raggruppa tali valori in base a un campo pertinente. Un esempio è la percentuale di messaggi recapitati ai destinatari per ogni esecuzione di una campagna, raggruppati per esecuzione di campagna.
È possibile stabilire rapidamente se un parametro è un parametro a valore singolo o un parametro a valore multiplo facendo riferimento al nome del parametro. Se il nome non contiene `grouped-by`, si tratta di un parametro a valore singolo. Se lo fa, è un parametro a valore multiplo. Per un elenco completo dei parametri su cui è possibile eseguire query a livello di programmazione, consulta [Metriche standard che si applicano a progetti, campagne e percorsi Amazon Pinpoint](analytics-standard-metrics.md).
### Parametri a valore singolo
Per un parametro a valore singolo, l'oggetto `Rows` contiene un oggetto `Values` che:
+ Specifica il nome descrittivo del parametro su cui è stata eseguita la query.
+ Fornisce il valore per il parametro su cui è stata eseguita la query.
+ Identifica il tipo di dati del valore restituito.
Ad esempio, la seguente risposta JSON contiene i risultati della query per un parametro a valore singolo. Questo parametro riporta il numero di endpoint univoci a cui sono stati recapitati i messaggi da tutte le campagne associate a un progetto, dal 1° agosto 2019 al 31 agosto 2019:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"1368.0"
}
]
}
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
In questo esempio, la risposta indica che tutte le campagne del progetto hanno recapitato messaggi a 1.368 endpoint univoci dal 1 agosto 2019 al 31 agosto 2019, dove:
+ `Key` è il nome descrittivo del parametro il cui valore è specificato nel campo `Value` (`UniqueDeliveries`).
+ `Type` è il tipo di dati del valore specificato nel campo `Value` (`Double`).
+ `Value` è il valore effettivo per il parametro su cui è stata eseguita la query, inclusi eventuali filtri applicati (`1368.0`).
Se il risultato della query per una metrica a valore singolo è nullo (non maggiore o uguale a zero), l'oggetto `Rows` è vuoto. Amazon Pinpoint restituisce un valore nullo per una metrica se non ci sono dati da restituire per la metrica. Esempio:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"2345678901234567890123456example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
### Parametri a più valori
La struttura e il contenuto dell'oggetto `Rows` per un parametro a più valori sono per lo più uguali a un parametro a valore singolo. L'oggetto `Rows` per un parametro a valore multiplo contiene anche un oggetto `Values`. L'oggetto `Values` specifica il nome descrittivo del parametro con query, fornisce il valore per tale parametro e identifica il tipo di dati di tale valore.
Tuttavia, l'oggetto `Rows` per un parametro a più valori contiene anche uno o più oggetti `GroupedBy`. Esiste un oggetto `GroupedBy` per ogni oggetto `Values` nei risultati della query. L'oggetto `GroupedBy` indica quale campo è stato utilizzato per raggruppare i dati nei risultati e il tipo di dati di quel campo. Indica anche il valore di raggruppamento per quel campo (per l'oggetto `Values` associato).
Ad esempio, la seguente risposta JSON contiene i risultati della query per un parametro a più valori che segnala il numero di endpoint univoci a cui sono stati recapitati i messaggi per ogni campagna associata a un progetto, dal 1 agosto 2019 al 31 agosto 2019:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries-grouped-by-campaign",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"80b8efd84042ff8d9c96ce2f8example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"810c7aab86d42fb2b56c8c966example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"456.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"42d8c7eb0990a57ba1d5476a3example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"789.0"
}
]
}
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
In questo esempio, la risposta indica che tre delle campagne del progetto hanno inviato messaggi a endpoint univoci dal 1 agosto 2019 al 31 agosto 2019. Per ciascuna di queste campagne, la ripartizione dei conteggi dei recapiti è:
+ La campagna `80b8efd84042ff8d9c96ce2f8example` ha recapitato messaggi a 123 endpoint univoci.
+ La campagna `810c7aab86d42fb2b56c8c966example` ha recapitato messaggi a 456 endpoint univoci.
+ La campagna `42d8c7eb0990a57ba1d5476a3example` ha recapitato messaggi a 789 endpoint univoci.
Dove la struttura generale degli oggetti e dei campi è:
+ `GroupedBys.Key`: nome della proprietà o del campo che archivia il valore di raggruppamento specificato nel campo `GroupedBys.Value` (`CampaignId`).
+ `GroupedBys.Type`: tipo di dati del valore specificato nel campo `GroupedBys.Value` (`String`).
+ `GroupedBys.Value`: valore effettivo del campo utilizzato per raggruppare i dati, come specificato nel campo `GroupedBys.Key` (ID campagna).
+ `Values.Key`: nome descrittivo della metrica il cui valore è specificato nel campo `Values.Value` (`UniqueDeliveries`).
+ `Values.Type`: tipo di dati del valore specificato nel campo `Values.Value` (`Double`).
+ `Values.Value`: valore effettivo della metrica su cui è stata eseguita la query, inclusi tutti i filtri applicati.
Se i risultati della query per una metrica a più valori sono null (non maggiori di o uguali a zero) per un progetto, una campagna o un'altra risorsa specifica, Amazon Pinpoint non restituisce alcun oggetto o campo per la risorsa. Se i risultati della query per una metrica a più valori sono null per tutte le risorse, Amazon Pinpoint restituisce un oggetto `Rows` vuoto.
## Oggetti e campi JSON
Oltre a specificare i valori che hanno definito una query, ad esempio l'ID del progetto (`ApplicationId`), ogni risposta JSON a una query per un parametro dell'applicazione, il parametro della campagna o il parametro del viaggio include un oggetto `KpiResult`. Questo oggetto contiene il set di risultati complessivo per una query, che è possibile analizzare per inviare dati di analisi analitici a un altro servizio o applicazione. Ogni oggetto `KpiResult` contiene alcuni o tutti i seguenti oggetti e campi standard, a seconda del parametro.
| Oggetto o campo | Description |
| --- | --- |
| Rows | Un array di oggetti che contiene il set di risultati per una query. |
| Rows.GroupedBys | Per un parametro a più valori, un parametro di campi che definisce il campo e i valori utilizzati per raggruppare i dati nei risultati delle query. |
| Rows.GroupedBys.Key | Per un parametro a più valori, il nome della proprietà o del campo che memorizza il valore specificato nel campo GroupedBys.Value. |
| Rows.GroupedBys.Type | Per un parametro a più valori, il tipo di dati del valore specificato nel campo GroupedBys.Value. |
| Rows.GroupedBys.Value | Per un parametro a più valori, il valore effettivo per il campo utilizzato per raggruppare i dati nei risultati delle query. Questo valore è correlato a un oggetto Values associato. |
| Rows.Values | Un array di campi che contiene i risultati delle query. |
| Rows.Values.Key | Il nome descrittivo del parametro su cui è stata eseguita la query. Il valore del parametro è specificato nel campo Values.Value. |
| Rows.Values.Type | Il tipo di dati del valore specificato nel campo Values.Value. |
| Rows.Values.Value | Il valore effettivo per il parametro su cui è stata eseguita la query, inclusi tutti i filtri applicati. |
Per informazioni sui campi in una risposta JSON a una query relativa a un parametro di esecuzione del viaggio o a un parametro di esecuzione dell'attività di viaggio, consulta [Metriche standard che si applicano a progetti, campagne e percorsi Amazon Pinpoint](analytics-standard-metrics.md).