Endpunkte exportieren
Mit den Export-Endpunkten können Sie auf verschiedene Details zu Ihren KPIs, App-Sitzungen, Nutzer:innen, Segmenten, Campaigns und Canvases zugreifen und diese exportieren. Stellen Sie sicher, dass Sie Ihre Braze-Instanz, Ihren API-Schlüssel und Ihren API-Bezeichner kennen, wenn Sie Ihre Parameter und Anfragen erstellen.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:
| Anforderung | Beschreibung |
|---|---|
| Braze-REST-API-Schlüssel | Ein REST-API-Schlüssel mit den entsprechenden Export-Berechtigungen für die Endpunkte, die Sie aufrufen möchten. API-Schlüssel sind auf bestimmte Endpunkte beschränkt, und Berechtigungen können nach der Erstellung nicht mehr geändert werden. Weitere Informationen finden Sie unter REST-API-Schlüssel. |
| Relevante Bezeichner | Die Bezeichner für die Daten, die Sie exportieren möchten, z. B. eine Campaign-ID, Segment-ID oder Canvas-ID. Diese finden Sie im Braze-Dashboard. Eine vollständige Liste finden Sie unter API-Bezeichnertypen. |
| Cloud-Storage-Zugangsdaten (optional) | Wenn Sie große Datensätze exportieren, verbinden Sie einen Amazon S3-, Microsoft Azure Blob Storage- oder Google Cloud Storage-Bucket, damit Exportdateien direkt in Ihren Speicher geschrieben werden. |
Wenn Sie Marketer oder Teammitglied ohne API-Zugang sind, stimmen Sie sich mit einem Entwickler oder Administrator in Ihrer Organisation ab, um API-Schlüssel und Integrationen einzurichten.
Was Sie exportieren können
Die folgende Tabelle fasst die Datenkategorien zusammen, die über die Export-APIs verfügbar sind.
| Kategorie | Enthaltene Daten | API-Referenz |
|---|---|---|
| Campaigns | Performance-Analytics, Campaign-Details, Campaign-Listen und Versand-Analytics | Campaign-Endpunkte |
| Canvases | Datenreihen-Analytics, Analytics-Zusammenfassungen, Canvas-Details und Canvas-Listen | Canvas-Endpunkte |
| Segmente | Segment-Listen, Segment-Analytics und Segment-Details | Segment-Endpunkte |
| Nutzerdaten | Vollständige Nutzerprofile nach Bezeichner oder nach Segment sowie Nutzer:innen nach globaler Kontrollgruppe | Nutzerdaten-Endpunkte |
| KPIs | Täglich aktive Nutzer:innen, monatlich aktive Nutzer:innen, täglich neue Nutzer:innen und Deinstallationen nach Datum | KPI-Endpunkte |
| Sitzungen | Zeitreihendaten zu App-Sitzungen | Sitzungen-Endpunkt |
| Angepasste Events | Event-Namen, Event-Listen und Event-Analytics im Zeitverlauf | Endpunkte für angepasste Events |
| Angepasste Attribute | Attributnamen | Endpunkt für angepasste Attribute |
| Käufe | Umsatzdaten nach Zeit, Produkt-ID-Listen und Kaufanzahlen | Kauf-Endpunkte |
Wie Exportdaten bereitgestellt werden
API-Exporte geben Daten im JSON-Format zurück, im Gegensatz zu den CSV-Dateien, die Sie vom Dashboard herunterladen. Die Bereitstellungsmethode hängt davon ab, ob Sie Cloud-Storage verbunden haben:
- Ohne Cloud-Storage: Braze schreibt die Exportdateien in seinen eigenen S3-Bucket und fügt der API-Antwort eine temporäre Download-URL hinzu. Diese URL läuft nach vier Stunden ab, und der Export wird als komprimiertes Archiv (ZIP oder GZIP, abhängig vom Parameter
output_format) bereitgestellt, das JSON-Dateien enthält. Jede Zeile in den JSON-Dateien repräsentiert ein Datenobjekt. - Mit verbundenem Cloud-Storage: Braze schreibt die Exportdateien direkt in Ihren konfigurierten Bucket. Die API-Antwort enthält keine Download-URL. Die Dateien unterliegen Ihren eigenen Aufbewahrungsrichtlinien und sind in der Regel zuverlässiger für große Exporte.
„Cloud-Storage“ bezeichnet Ihren eigenen Speicher-Bucket (z. B. Amazon S3, Microsoft Azure Blob Storage oder Google Cloud Storage). Sie können Ihren Bucket unter Partnerintegrationen > Technologie-Partner verbinden, damit Braze Exportdateien direkt dorthin schreiben kann.
Weitere Details zur Exportbereitstellung und Fehlerbehebung finden Sie unter Export-Fehlerbehebung.
Export-Endpunkte
Die folgende Tabelle listet alle verfügbaren Export-APIs auf.
Verwandte Artikel
Für einmalige Exporte aus dem Dashboard lesen Sie diese Artikel: