Fragen Sie Amazon Pinpoint Pinpoint-Daten für mehrere Kampagnen ab

Es gibt zwei Möglichkeiten, die Daten für mehrere Kampagnen abzufragen. Der beste Weg hängt davon ab, ob Sie die Daten für Kampagnen abfragen möchten, die alle demselben Projekt zugeordnet sind. Wenn ja, hängt er außerdem davon ab, ob Sie die Daten für alle Kampagnen oder nur oder nur für eine Teilmenge dieser Kampagnen abfragen möchten.

Um die Daten für Kampagnen abzufragen, die verschiedenen Projekten zugeordnet sind, oder nur für eine Teilmenge der Kampagnen, die demselben Projekt zugeordnet sind, ist es am besten, eine Reihe von einzelnen Abfragen zu erstellen und auszuführen, eine für jede Kampagne, für die Sie die Daten abfragen möchten. Im vorangegangenen Abschnitt wird erläutert, wie die Daten nur für eine Kampagne abgefragt werden.

Um die Daten für alle Kampagnen abzufragen, die demselben Projekt zugeordnet sind, können Sie die Application Metrics-API verwenden. Geben Sie Werte für die folgenden erforderlichen Parameter an:

• application-id: Die Projekt-ID, bei der es sich um den eindeutigen Bezeichner für das Projekt handelt. In Amazon Pinpoint haben die Begriffe Projekt und Anwendung dieselbe Bedeutung.

• kpi-name: Der Name der abzufragenden Metrik. Dieser Wert beschreibt die zugeordnete Metrik und besteht aus zwei oder mehr Begriffen, die aus alphanumerischen Kleinbuchstaben bestehen, die durch einen Bindestrich getrennt sind. Eine vollständige Liste der unterstützten Metriken und den kpi-name-Wert für die einzelnen Metriken finden Sie unter Standardkennzahlen für Projekte, Kampagnen und Journeys.

Sie können die Daten auch nach Datumsbereich filtern. Wenn Sie keinen Datumsbereich angeben, werden die Daten für die letzten 31 Kalendertage von Amazon Pinpoint zurückgegeben. Um die Daten nach verschiedenen Datumsangaben zu filtern, verwenden Sie die unterstützten Datumsbereichsparameter, um das erste und letzte Datum und die Uhrzeit des Datumsbereichs anzugeben. Die Werte sollten im erweiterten ISO 8601-Format vorliegen und die koordinierte Weltzeit (UTC) verwenden, z. B. 2019-07-19T20:00:00Z für 20.00 Uhr UTC am 19. Juli 2019. Datumsbereiche werden inklusiv angegeben und dürfen maximal 31 Kalendertage umfassen. Darüber hinaus müssen das erste Datum und die erste Uhrzeit früher als 90 Tage ab dem aktuellen Tag liegen.

Die folgenden Beispiele zeigen, wie Analysedaten für eine Kampagne mithilfe der Amazon Pinpoint REST-API AWS CLI, der und der AWS SDK für Java abgefragt werden. Sie können jedes unterstützte AWS SDK verwenden, um Analysedaten für eine Kampagne abzufragen. Die AWS CLI Beispiele sind für Microsoft Windows formatiert. Ersetzen Sie für Unix, Linux und macOS das Zeilenfortsetzungszeichen (^) durch einen umgekehrten Schrägstrich (\).

REST API

Um Analysedaten für mehrere Kampagnen mithilfe der Amazon-Pinpoint-REST-API abzufragen, senden Sie eine HTTP(S)-GET-Anforderung an den Anwendungsmetriken-URI. Geben Sie im URI die entsprechenden Werte für die erforderlichen Pfadparameter an:

https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name

Wobei gilt:

• endpointist der Amazon Pinpoint-Endpunkt für die AWS Region, in der das mit den Kampagnen verknüpfte Projekt gehostet wird.

• application-id ist der eindeutige Bezeichner für das Projekt, das den Kampagnen zugeordnet ist.

• kpi-nameist der kpi-name Wert für die abzufragende Metrik.

Alle Parameter sollten URL-codiert sein.

Wenn Sie einen Filter anwenden möchten, der die Daten für einen bestimmten Datumsbereich abruft, hängen Sie die start-time- und end-time-Parameter und -Werte an den URI an. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Verwenden Sie ein kaufmännisches Und-Zeichen (&), um die Parameter zu trennen.

Die folgende Anforderung ruft beispielsweise die Anzahl der eindeutigen Endpunkte ab, an die Nachrichten von jeder Kampagne eines Projekts vom 19. Juli 2019 bis zum 26. Juli 2019 übermittelt wurden:

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

Wobei gilt:

• pinpoint.us-east-1.amazonaws.com ist der Amazon-Pinpoint-Endpunkt für die AWS -Region, die das Projekt hostet.

• 1234567890123456789012345example ist der eindeutige Bezeichner für das Projekt, das den Kampagnen zugeordnet ist.

• unique-deliveries-grouped-by-campaign ist der kpi-name-Wert für die Endpunktzustellungen, gruppiert nach Kampagne-Anwendungsmetrik. Dies ist die Metrik, die die Anzahl der eindeutigen Endpunkte zurückgibt, an die Nachrichten von jeder Kampagne übermittelt wurden.

• 2019-07-19T00:00:00Z ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.

• 2019-07-26T23:59:59Z ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.

AWS CLI

Um Analysedaten für mehrere Kampagnen mithilfe von abzufragen AWS CLI, verwenden Sie den get-application-date-range-kpi Befehl und geben Sie die entsprechenden Werte für die erforderlichen Parameter an:

C:\> aws pinpoint get-application-date-range-kpi ^
    --application-id application-id ^
    --kpi-name kpi-name

Wobei gilt:

• application-id ist der eindeutige Bezeichner für das Projekt, das den Kampagnen zugeordnet ist.

• kpi-nameist der kpi-name Wert für die abzufragende Metrik.

Um einen Filter anzuwenden, der die Daten für einen bestimmten Zeitraum abruft, schließen Sie die start-time- und end-time-Parameter und -Werte in die Abfrage ein. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Die folgende Anforderung ruft beispielsweise die Anzahl der eindeutigen Endpunkte ab, an die Nachrichten von jeder Kampagne eines Projekts vom 19. Juli 2019 bis zum 26. Juli 2019 übermittelt wurden:

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

Wobei gilt:

• 1234567890123456789012345example ist der eindeutige Bezeichner für das Projekt, das der Kampagne zugeordnet ist.

• unique-deliveries-grouped-by-campaign ist der kpi-name-Wert für die Endpunktzustellungen, gruppiert nach Kampagne-Anwendungsmetrik. Dies ist die Metrik, die die Anzahl der eindeutigen Endpunkte zurückgibt, an die Nachrichten von jeder Kampagne übermittelt wurden.

• 2019-07-19T00:00:00Z ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.

• 2019-07-26T23:59:59Z ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.

SDK for Java

Verwenden Sie die GetApplicationDateRangeKpiRequest Methode der Application Metrics API AWS SDK für Java, um Analysedaten für mehrere Kampagnen mithilfe von abzufragen. Geben Sie die entsprechenden Werte für die erforderlichen Parameter an:

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

Wobei gilt:

• applicationId ist der eindeutige Bezeichner für das Projekt, das den Kampagnen zugeordnet ist.

• kpiNameist der kpi-name Wert für die abzufragende Metrik.

Um einen Filter anzuwenden, der die Daten für einen bestimmten Zeitraum abruft, schließen Sie die startTime- und endTime-Parameter und -Werte in die Abfrage ein. Mithilfe dieser Parameter können Sie das erste und letzte Datum und die Uhrzeit im erweiterten ISO 8601-Format eines Inklusivdatumsbereichs angeben, für den die Daten abgerufen werden sollen. Die folgende Anforderung ruft beispielsweise die Anzahl der eindeutigen Endpunkte ab, an die Nachrichten von jeder Kampagne eines Projekts vom 19. Juli 2019 bis zum 26. Juli 2019 übermittelt wurden:

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")));

Wobei gilt:

• 1234567890123456789012345example ist der eindeutige Bezeichner für das Projekt, das den Kampagnen zugeordnet ist.

• unique-deliveries-grouped-by-campaign ist der kpi-name-Wert für die Endpunktzustellungen, gruppiert nach Kampagne-Anwendungsmetrik. Dies ist die Metrik, die die Anzahl der eindeutigen Endpunkte zurückgibt, an die Nachrichten von jeder Kampagne übermittelt wurden.

• 2019-07-19T00:00:00Z ist das erste Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.

• 2019-07-26T23:59:59Z ist das letzte Datum und die Uhrzeit, für die Daten abgerufen werden sollen, als Teil eines einschließenden Datumsbereichs.

Nachdem Sie Ihre Abfrage gesendet haben, gibt Amazon Pinpoint die Abfrageergebnisse in einer JSON-Antwort zurück. Die Struktur der Ergebnisse hängt von der Metrik ab, die Sie abgefragt haben. Einige Metriken geben nur einen Wert zurück. Andere Metriken geben mehrere Werte zurück, und diese Werte werden nach einem relevanten Feld gruppiert. Wenn eine Metrik mehrere Werte zurückgibt, enthält die JSON-Antwort ein Feld, das angibt, welches Feld zum Gruppieren der Daten verwendet wurde.

Beispielsweise gibt die Anwendungsmetrik Endpunkt-Zustellungen, nach Kampagnen gruppiert (unique-deliveries-grouped-by-campaign), die in den vorherigen Beispielen verwendet wurde, mehrere Werte zurück – die Anzahl der eindeutigen Endpunkte, an die Nachrichten gesendet wurden, für jede einem Projekt zugeordnete Kampagne. In diesem Fall lautet die JSON-Antwort wie folgt:

{
    "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 diesem Fall gibt das GroupedBys-Feld an, dass die Werte nach Kampagnen-ID (CampaignId) gruppiert sind.

Weitere Informationen zur Struktur von Abfrageergebnissen finden Sie unter Verwenden Sie JSON-Abfrageergebnisse.