Skip to content

App-Sitzungen nach Zeit exportieren

get

/sessions/data_series

Verwenden Sie diesen Endpunkt, um eine Reihe der Anzahl von Sitzungen für Ihre App über einen bestimmten Zeitraum abzurufen.

Voraussetzungen

Um diesen Endpunkt zu verwenden, benötigen Sie einen API-Schlüssel mit der Berechtigung sessions.data_series.

Rate-Limit

Wir wenden auf diesen Endpunkt das standardmäßige Braze-Rate-Limit von 250.000 Anfragen pro Stunde an, wie in API-Rate-Limits dokumentiert.

Anfrageparameter

Parameter Erforderlich Datentyp Beschreibung
length Erforderlich Integer Maximale Anzahl der Einheiten (Tage oder Stunden) vor ending_at, die in die zurückgegebene Reihe aufgenommen werden sollen. Muss zwischen 1 und 100 (einschließlich) liegen.
unit Optional String Zeiteinheit zwischen Datenpunkten. Kann day oder hour sein, Standard ist day.
ending_at Optional Datetime
(ISO-8601-String)
Datum, an dem die Datenreihe enden soll. Standardmäßig wird der Zeitpunkt der Anfrage verwendet.
app_id Optional String App-API-Bezeichner, der von der Seite API-Schlüssel abgerufen wird, um Analytics auf eine bestimmte App zu beschränken.
segment_id Optional String Siehe Segment-API-Bezeichner. Segment-ID, die das Analytics-aktivierte Segment angibt, für das Sitzungen zurückgegeben werden sollen.

Beispielanfrage

1
2
curl --location -g --request GET 'https://rest.iad-01.braze.com/sessions/data_series?length=14&unit=day&ending_at=2018-06-28T23:59:59-5:00&app_id={{app_identifier}}&segment_id={{segment_identifier}}' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

Antwort

1
2
3
4
5
6
7
8
9
10
{
    "message": (required, string) the status of the export, returns 'success' when completed without errors,
    "data" : [
        {
            "time" : (string) point in time - as ISO 8601 extended when unit is "hour" and as ISO 8601 date when unit is "day",
            "sessions" : (int)
        },
        ...
    ]
}
New Stuff!