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 interrogare i dati relativi ai messaggi e-mail transazionali inviati per un progetto, utilizzate Application Metrics API e specificate i valori per i seguenti parametri obbligatori:
-
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 Coordinated Universal Time (UTC), ad esempio per le 20:00 del 2019-09-06T20:00:00Z
6 settembre 2019. UTC 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 Amazon REST API Pinpoint, il, e AWS CLI il. AWS SDK for Java Puoi utilizzare qualsiasi supporto per interrogare i dati di analisi AWS SDK 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 ().
Per interrogare i dati di analisi per i messaggi e-mail transazionali utilizzando Amazon REST API Pinpoint, invia HTTP una richiesta (SGET) a Application Metrics. URI NellaURI, specifica 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 del progetto. -
kpi-name
è ilkpi-name
valore della metrica da interrogare.
Tutti i parametri devono essere URL codificati.
Per applicare un filtro che richieda i dati per un intervallo di date specifico, aggiungi i parametri start-time
e i valori della end-time
query a. URI Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e ora, in formato ISO 8601 esteso, di un intervallo di date completo per il quale recuperare i 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 richiesta, Amazon Pinpoint restituisce i risultati della query in una JSON risposta. 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 JSON risposta è 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 una metrica restituisce più valori, la JSON risposta 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 JSON risultati delle query.