Endpunkte exportieren
Mit dieser Sammlung von 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 Anfragetexte erstellen.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:
| Voraussetzung | Beschreibung |
|---|---|
| Braze-REST-API-Schlüssel | Ein REST-API-Schlüssel mit den entsprechenden Exportberechtigungen 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. Sie finden diese 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 einer Entwicklerin bzw. einem Entwickler oder einer Administratorin bzw. einem 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 |
| Segments | 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 Zeitraum, Produkt-ID-Listen und Kaufanzahlen | Kauf-Endpunkte |
Wie Exportdaten zugestellt werden
API-Exporte geben Daten im JSON-Format zurück, im Gegensatz zu den CSV-Dateien, die Sie vom Dashboard herunterladen. Die Zustellmethode hängt davon ab, ob Sie Cloud-Speicher verbunden haben:
- Ohne Cloud-Speicher: Braze schreibt die Exportdateien in den eigenen S3-Bucket und fügt eine temporäre Download-URL in die API-Antwort ein. Diese URL läuft nach vier Stunden ab, und der Export wird als komprimiertes Archiv (ZIP oder GZIP, je nach dem Parameter
output_format) gepackt, das JSON-Dateien enthält. Jede Zeile in den JSON-Dateien entspricht einem Datenobjekt. - Mit verbundenem Cloud-Speicher: Braze schreibt die Exportdateien direkt in Ihren konfigurierten Bucket. Die API-Antwort enthält keine Download-URL. Dateien folgen Ihren eigenen Aufbewahrungsrichtlinien und sind in der Regel zuverlässiger für große Exporte.
„Cloud-Speicher“ bedeutet Ihr eigener Speicher-Bucket (zum Beispiel 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 Exportzustellung und Fehlerbehebung finden Sie unter Fehlerbehebung beim Export.
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: