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-namedi ognuno, consulta Metriche standard per progetti, campagne e viaggi.

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.