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à.
Per eseguire una query sui dati relativi ai messaggi e-mail transazionali inviati per un progetto, è possibile utilizzare l'API Parametri applicazioni 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.
È 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 for 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 ().
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. 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
è ilkpi-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 valorekpi-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.