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.

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