Seleziona le tue preferenze relative ai cookie

Utilizziamo cookie essenziali e strumenti simili necessari per fornire il nostro sito e i nostri servizi. Utilizziamo i cookie prestazionali per raccogliere statistiche anonime in modo da poter capire come i clienti utilizzano il nostro sito e apportare miglioramenti. I cookie essenziali non possono essere disattivati, ma puoi fare clic su \"Personalizza\" o \"Rifiuta\" per rifiutare i cookie prestazionali.

Se sei d'accordo, AWS e le terze parti approvate utilizzeranno i cookie anche per fornire utili funzionalità del sito, ricordare le tue preferenze e visualizzare contenuti pertinenti, inclusa la pubblicità pertinente. Per continuare senza accettare questi cookie, fai clic su \"Continua\" o \"Rifiuta\". Per effettuare scelte più dettagliate o saperne di più, fai clic su \"Personalizza\".

Interroga i dati di Amazon Pinpoint per i messaggi e-mail transazionali

Modalità Focus
Interroga i dati di Amazon Pinpoint per i messaggi e-mail transazionali - Amazon Pinpoint

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

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-namedi 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 ().

REST API

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 è il kpi-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 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 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 del 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 ora, in formato ISO 8601 esteso, di un intervallo di date completo per il quale recuperare i 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 for Java, utilizzate il GetApplicationDateRangeKpiRequest metodo Application Metrics. API Specificare i valori appropriati per i parametri richiesti:

GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest() .withApplicationId("applicationId") .withKpiName("kpiName")

Dove:

  • applicationId è l'identificatore univoco del 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 ora, in formato ISO 8601 esteso, di un intervallo di date completo per il quale recuperare i 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.

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 è il kpi-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 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 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.

PrivacyCondizioni del sitoPreferenze cookie
© 2025, Amazon Web Services, Inc. o società affiliate. Tutti i diritti riservati.