Avviso di fine del supporto: il 30 ottobre 2026, AWS terminerà il supporto per Amazon Pinpoint. Dopo il 30 ottobre 2026, non potrai più accedere alla console Amazon Pinpoint o alle risorse Amazon Pinpoint (endpoint, segmenti, campagne, percorsi e analisi). Per ulteriori informazioni, consulta la pagina relativa alla fine del supporto di Amazon Pinpoint. Nota: per quanto APIs riguarda gli SMS, i comandi vocali, i messaggi push su dispositivi mobili, l'OTP e la convalida del numero di telefono non sono interessati da questa modifica e sono supportati da AWS End User Messaging.
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à.
Interroga i dati di analisi di Amazon Pinpoint
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 relative al coinvolgimento degli utenti, alla sensibilizzazione delle campagne e altro ancora. Queste metriche, note anche come indicatori chiave di performance (KPIs), sono valori misurabili che possono aiutarti a monitorare e valutare le prestazioni dei tuoi progetti, campagne e percorsi.
Se lo utilizzi APIs per interrogare i dati di analisi, puoi analizzarli utilizzando lo strumento di reporting di tua scelta, senza dover accedere alla console Amazon Pinpoint o analizzare i dati grezzi degli eventi da fonti come Amazon Kinesis Streams. Ad esempio, puoi creare un dashboard personalizzato che visualizzi i risultati settimanali delle campagne o che fornisca analisi approfondite sulle percentuali di consegna per le tue campagne.
Puoi interrogare i dati utilizzando l'API REST di Amazon Pinpoint, AWS Command Line Interface (AWS CLI) o un AWS SDK. Per eseguire una query sui dati, invia una richiesta all'API Amazon Pinpoint e utilizza i parametri supportati per specificare i dati desiderati e i filtri da applicare. Dopo aver inviato la query, Amazon Pinpoint restituisce i risultati della query in una risposta JSON. È quindi possibile trasferire i risultati a un altro servizio o a un'altra applicazione per un'analisi più approfondita, lo storage o la generazione di report.
Amazon Pinpoint raccoglie e aggrega automaticamente i dati per tutti i tipi di metriche supportati e per tutti i progetti, le campagne e i percorsi. Inoltre, i dati vengono aggiornati in modo continuo, generando un intervallo di tempo di latenza dei dati che è limitato a circa due ore. Si noti, tuttavia, che potrebbe esserci una latenza dei dati aggiuntiva per determinati parametri. Questo perché i dati per alcuni parametri si basano sulle informazioni che riceviamo dai provider di posta elettronica dei destinatari. Alcuni fornitori ci inviano immediatamente queste informazioni, mentre altri le inviano meno frequentemente.
Amazon Pinpoint archivia i dati per 90 giorni. Per archiviare i dati per più di 90 giorni o per accedere ai dati di analisi non elaborati in tempo reale, puoi configurare un progetto Amazon Pinpoint per lo streaming dei dati degli eventi su Amazon Kinesis Data Streams o Amazon Data Firehose. Per informazioni sulla configurazione dei flussi di eventi, consulta Trasmetti in streaming i dati degli eventi delle app tramite Kinesis e Firehose utilizzando Amazon Pinpoint.
Componenti e parametri di query per le metriche in Amazon Pinpoint
Per eseguire una query sui dati per un parametro, inviare una richiesta get alla risorsa dei parametri appropriata dell'API di Amazon Pinpoint. Nella richiesta, è possibile definire la query utilizzando parametri supportati per i seguenti componenti di query:
-
Progetto: specifica un progetto fornendo il relativo ID come valore per il parametro
application-id. Questo parametro è obbligatorio per tutti i parametri. -
Campagna: specifica una campagna fornendo il relativo ID come valore per il parametro
campaign-id. Questo parametro è obbligatorio solo per i parametri della campagna. -
Percorso: specificare un percorso fornendo il relativo ID come valore per il parametro
journey-id. Questo parametro è obbligatorio solo per i parametri di coinvolgimento e di esecuzione del viaggio e per i parametri di esecuzione dell'attività di viaggio. -
Attività del percorso: specifica un'attività del percorso fornendo il relativo ID come valore per il parametro
journey-activity-id. Questo parametro è obbligatorio solo per i parametri di esecuzione dell'attività di viaggio. -
Intervallo di date: per filtrare facoltativamente i dati per intervallo di date, specifica la prima e l'ultima data e l'ora dell'intervallo utilizzando i parametri di ora di inizio e fine supportati. I valori devono essere in formato ISO 8601 esteso e utilizzare il fuso orario UTC (Coordinated Universal Time), ad esempio
2019-07-19T20:00:00Zper le 20:00 UTC del 19 luglio 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. Se non si specifica un intervallo di date, Amazon Pinpoint restituisce i dati dei 31 giorni di calendario precedenti. I parametri dell'intervallo di date sono supportati da tutti i parametri, ad eccezione dei parametri di esecuzione del viaggio e dei parametri di esecuzione dell'attività di viaggio.
-
Parametro: specifica una metrica fornendo il relativo nome come valore per il parametro
kpi-name. Questo valore descrive il parametro associato ed è formato da due o più termini, che sono composti da caratteri alfanumerici minuscoli, separati da un trattino. Alcuni esempi sonoemail-open-rateesuccessful-delivery-rate. Questo parametro è obbligatorio per tutti i parametri, ad eccezione dei parametri di esecuzione del viaggio e dei parametri di esecuzione dell'attività di viaggio. Per un elenco completo dei parametri supportati e il valorekpi-nameda utilizzare per ciascuno di essi, consulta Metriche standard per progetti, campagne e viaggi.
Dopo aver inviato la query, Amazon Pinpoint restituisce i risultati della query in una risposta JSON. Nella risposta, la struttura dei risultati varia a seconda del parametro richiesto.
Alcune metriche forniscono un solo valore, ad esempio il numero di messaggi recapitati da una campagna. Altre metriche forniscono più valori e in genere raggruppano tali valori in base a un campo pertinente, ad esempio il numero di messaggi recapitati da ciascuna campagna, raggruppati per esecuzione della campagna. Se un parametro fornisce e raggruppa 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.
