Interroga i dati di Amazon Pinpoint per più campagne

È possibile eseguire query sui dati per più campagne in due modi. Il modo migliore dipende dal fatto che si desidera eseguire una query sui dati per le campagne che sono tutte associate allo stesso progetto. In tal caso, dipende anche dal fatto che si desidera eseguire una query sui dati per tutte o solo per un sottoinsieme di tali campagne.

Per eseguire una query sui dati delle campagne associate a progetti diversi o solo sui dati di un sottoinsieme delle campagne associate allo stesso progetto, l'approccio migliore consiste nel creare ed eseguire una serie di query individuali, una per ogni campagna sui cui dati si desidera eseguire una query. Nella sezione precedente viene illustrato come eseguire una query sui dati per una sola campagna.

Per eseguire una query sui dati di tutte le campagne associate allo stesso progetto, è possibile utilizzare l'API Parametri applicazioni. Specificare i valori per i parametri obbligatori seguenti.

• 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 filtrare i dati in base all'intervallo di date. 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 fuso orario UTC (Coordinated Universal Time), ad esempio 2019-07-19T20:00:00Z per 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.

Gli esempi seguenti mostrano come interrogare i dati di analisi per una campagna utilizzando l'API REST di Amazon Pinpoint AWS CLI, il e il. AWS SDK per Java Puoi utilizzare qualsiasi AWS SDK supportato per interrogare i dati di analisi per una campagna. 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 eseguire query sui dati di analisi per più campagne utilizzando la REST API Amazon Pinpoint, invia una richiesta HTTP(S) GET all'URI Metriche delle applicazioni. Nell'URI, specificare 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 associato alle campagne.

• application-id è l'identificatore univoco per il progetto associato alle campagne.

• kpi-nameè il kpi-name valore della metrica da interrogare.

Tutti i parametri devono essere codificati URL.

Per applicare un filtro che richiama i dati per un intervallo di date specifico, aggiungere i parametri di query e i valori start-time e end-time all'URI. Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Utilizzare una e commerciale (&) per separare i parametri.

Ad esempio, la richiesta seguente recupera il numero di endpoint univoci a cui sono stati recapitati i messaggi, da tutte le campagne di un progetto, dal 19 luglio 2019 al 26 luglio 2019:

https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/unique-deliveries-grouped-by-campaign?start-time=2019-07-19T00:00:00Z&end-time=2019-07-26T23: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 associato alle campagne.

• unique-deliveries-grouped-by-campaign è il valore kpi-name per il parametro dell'applicazione recapiti endpoint, raggruppati per campagna ovvero il parametro che restituisce il numero di endpoint univoci a cui sono stati recapitati i messaggi per ciascuna campagna.

• 2019-07-19T00:00:00Z rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.

• 2019-07-26T23: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 più campagne utilizzando il AWS CLI, utilizza il get-application-date-range-kpi comando e specifica 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 per il progetto associato alle campagne.

• kpi-nameè il kpi-name valore della metrica da interrogare.

Per applicare un filtro che richiama i dati per un intervallo di date specifico, includere i parametri e i valori end-time e start-time alla query. Utilizzando questi parametri, è possibile specificare la prima e l'ultima data e l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Ad esempio, la richiesta seguente recupera il numero di endpoint univoci a cui sono stati recapitati i messaggi, da tutte le campagne di un progetto, dal 19 luglio 2019 al 26 luglio 2019:

C:\> aws pinpoint get-application-date-range-kpi ^
    --application-id 1234567890123456789012345example ^
    --kpi-name unique-deliveries-grouped-by-campaign ^
    --start-time 2019-07-19T00:00:00Z ^
    --end-time 2019-07-26T23:59:59Z

Dove:

• 1234567890123456789012345example è l'identificatore univoco del progetto associato alla campagna.

• unique-deliveries-grouped-by-campaign è il valore kpi-name per il parametro dell'applicazione recapiti endpoint, raggruppati per campagna ovvero il parametro che restituisce il numero di endpoint univoci a cui sono stati recapitati i messaggi per ciascuna campagna.

• 2019-07-19T00:00:00Z rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.

• 2019-07-26T23: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 più campagne utilizzando il AWS SDK per Java, utilizza il GetApplicationDateRangeKpiRequest metodo dell'API Application Metrics. Specificare i valori appropriati per i parametri richiesti:

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

Dove:

• applicationId è l'identificatore univoco per il progetto associato alle campagne.

• kpiNameè il kpi-name valore della metrica da interrogare.

Per applicare un filtro che richiama 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 l'ora, in formato ISO 8601 esteso, di un intervallo di date inclusivo per il recupero dei dati. Ad esempio, la richiesta seguente recupera il numero di endpoint univoci a cui sono stati recapitati i messaggi, da tutte le campagne di un progetto, dal 19 luglio 2019 al 26 luglio 2019:

GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
        .withApplicationId("1234567890123456789012345example")
        .withKpiName("unique-deliveries-grouped-by-campaign")
        .withStartTime(Date.from(Instant.parse("2019-07-19T00:00:00Z")))
        .withEndTime(Date.from(Instant.parse("2019-07-26T23:59:59Z")));

Dove:

• 1234567890123456789012345example è l'identificatore univoco per il progetto associato alle campagne.

• unique-deliveries-grouped-by-campaign è il valore kpi-name per il parametro dell'applicazione recapiti endpoint, raggruppati per campagna ovvero il parametro che restituisce il numero di endpoint univoci a cui sono stati recapitati i messaggi per ciascuna campagna.

• 2019-07-19T00:00:00Z rappresenta la prima data e ora per il recupero dei dati, come parte di un intervallo di date inclusivo.

• 2019-07-26T23: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 query, Amazon Pinpoint restituisce i risultati della query in una risposta JSON. La struttura dei risultati varia a seconda del parametro interrogato. Alcuni parametri restituiscono un solo valore. Altri parametri restituiscono più valori e quei valori sono raggruppati in base a un campo pertinente. Se un parametro restituisce più valori, la risposta JSON include un campo che indica quale campo è stato utilizzato per raggruppare i dati.

Ad esempio, la metrica Recapiti agli endpoint, raggruppati per campagna (unique-deliveries-grouped-by-campaign), utilizzata negli esempi precedenti, restituisce più valori, ovvero il numero di endpoint univoci a cui sono stati recapitati i messaggi, per ogni campagna associata a un progetto. In questo caso, la risposta JSON è la seguente:

{
    "ApplicationDateRangeKpiResponse":{
        "ApplicationId":"1234567890123456789012345example",
        "EndTime":"2019-07-26T23:59:59Z",
        "KpiName":"unique-deliveries-grouped-by-campaign",
        "KpiResult":{
            "Rows":[
                {
                    "GroupedBys":[
                        {
                            "Key":"CampaignId",
                            "Type":"String",
                            "Value":"80b8efd84042ff8d9c96ce2f8example"
                        }
                    ],
                    "Values":[
                        {
                            "Key":"UniqueDeliveries",
                            "Type":"Double",
                            "Value":"123.0"
                        }
                    ]
                },
                {
                    "GroupedBys":[
                        {
                            "Key":"CampaignId",
                            "Type":"String",
                            "Value":"810c7aab86d42fb2b56c8c966example"
                        }
                    ],
                    "Values":[
                        {
                            "Key":"UniqueDeliveries",
                            "Type":"Double",
                            "Value":"456.0"
                        }
                    ]
                },
                {
                    "GroupedBys":[
                        {
                            "Key":"CampaignId",
                            "Type":"String",
                            "Value":"42d8c7eb0990a57ba1d5476a3example"
                        }
                    ],
                    "Values":[
                        {
                            "Key":"UniqueDeliveries",
                            "Type":"Double",
                            "Value":"789.0"
                        }
                    ]
                }
            ]
        },
        "StartTime":"2019-07-19T00:00:00Z"
    }
}

In questo caso, il campo GroupedBys indica che i valori sono raggruppati per ID campagna (CampaignId).

Per ulteriori informazioni sulla struttura dei risultati delle query, consulta Usa i risultati delle query JSON.