Häufig gestellte Fragen
Auf dieser Seite finden Sie Antworten auf einige häufig gestellte Fragen zu Currents.
Kann ich Campaign- oder Canvas-Daten für ein bestimmtes Zeitfenster exportieren?
Um Campaign- oder Canvas-Metriken für einen definierten Datumsbereich abzurufen, verwenden Sie einen der folgenden Ansätze:
- Wenn Sie an date-aligned campaign or Canvas exports for dashboard-style reporting outside standard API windows interessiert sind, reichen Sie Produktfeedback ein.
- Rufen Sie die Endpunkte für Campaign-Analytics oder Canvas-Analytics mit den Parametern
ending_atundlengthauf (oder verwenden Sie/campaigns/data_seriesund/canvas/data_series) für Zeitreihendaten. - Streamen Sie Events mit Currents in Ihr Data Warehouse, wenn Sie fortlaufend abfragbare Nachrichten-Engagement-Daten in Amazon S3, Azure Blob Storage oder einem anderen unterstützten Ziel benötigen.
Wie bearbeite ich eine aktive Currents-Integration?
Um einen aktiven Currents-Konnektor zu ändern, öffnen Sie die Integration und wählen Sie Bearbeiten aus. Ohne Bearbeiten bleibt die Integrations-Oberfläche schreibgeschützt, und Sie können die Konnektor-Einstellungen nicht allein über die Symbole ändern.
Wie behandelt Braze Avro-Dateien in Azure Blob Storage nach dem Upload?
Braze ändert Avro-Dateien in Microsoft Azure Blob Storage nach Abschluss des Uploads nicht. Azure kann das Löschen eines Blobs blockieren, solange ein Upload noch läuft.
Wie erhalte ich historische Daten?
Currents ist ein Echtzeit-Datenstrom, was bedeutet, dass Events nicht erneut abgespielt werden können. Sie können Currents-Daten jedoch in einem Data Warehouse wie Amazon S3 oder Microsoft Azure Blob Storage speichern, um vergangene Events nach Bedarf zu nutzen. Die Daten werden 30 Tage lang aufbewahrt. Für weiter zurückliegende Daten können Sie Snowflake abfragen.
Warum gibt Currents Daten im Avro-Format aus und nicht in JSON?
Avro unterstützt im Gegensatz zu schemalosem JSON nativ die Schema-Evolution. Darüber hinaus profitieren Sie davon, dass Avro-Dateien mit weniger Bandbreite gesendet werden können und Speicherplatz gespart wird, da Avro hochgradig komprimierbar ist.
Wie handhabt Braze den Datei-Overhead?
Wir bauen einen ETL-Prozess (Extract, Transform, Load) auf, mit dem Sie große Datenmengen aus einer Datenbank abrufen und in einer anderen ablegen und speichern können.
Wo sollte ich diese Daten für Abfragen speichern?
Braze arbeitet mit mehreren Data Warehouses zusammen, in denen Sie Ihre Daten für Abfragen speichern können. Wir empfehlen die Nutzung von:
Wie zuverlässig sind Currents-Daten?
Currents garantiert eine „At-least-once“-Zustellung, das heißt, doppelte Events können gelegentlich in Ihren Storage-Bucket geschrieben werden. Wenn Ihr Anwendungsfall eine Exactly-once-Zustellung erfordert, können Sie Events mithilfe des eindeutigen Bezeichnerfelds (id) deduplizieren, das mit jedem Event gesendet wird. Weitere Informationen finden Sie unter Event-Zustellungssemantik.
Wie oft werden Daten mit Currents synchronisiert?
Daten werden kontinuierlich gestreamt. Braze sendet einen Batch von Events, sobald ein vollständiger Batch vorliegt oder alle 5 Minuten – je nachdem, was zuerst eintritt. Bei Konnektoren mit hohem Volumen treffen Daten nahezu in Realtime ein. Bei Konnektoren mit geringem Volumen ist mit einer Verzögerung von 5 bis 30 Minuten zu rechnen. Weitere Informationen finden Sie unter Avro-Schreibschwellenwert.
Wenn ein Gerät nicht mit dem Internet verbunden ist, kann es zu einer Verzögerung bei der Erstellung des Events kommen. Dies tritt am häufigsten bei In-App-Nachrichten-Events auf, da In-App-Nachrichten auch offline ausgelöst werden können.
Wie finde ich heraus, welche Events für Currents verfügbar sind?
Eine vollständige Liste der Events, die Currents protokolliert, finden Sie in den Glossaren für Kundenverhalten-Events und Nachrichten-Engagement-Events. Sie können diese Glossare nach Event-Typ filtern (z. B. Sendungen, Zustellungen oder Öffnungen).
Warum stimmen meine Currents-Event-Zahlen nicht mit meinen Dashboard- oder Engagement-Bericht-Metriken überein?
Currents und das Braze-Dashboard berechnen bestimmte Metriken unterschiedlich, daher sind exakte Übereinstimmungen zwischen Currents-Events und Dashboard-Metriken nicht zu erwarten.
Eindeutige Klicks: Bei E-Mails erfasst das Dashboard eindeutige Klicks über einen Zeitraum von sieben Tagen und misst sie anhand der dispatch_id. Currents zeichnet jedes einzelne Klick-Event auf. Um die auf Currents basierenden eindeutigen Klickzahlen mit den Dashboard-Metriken abzugleichen, filtern Sie nach Events, bei denen is_unique den Wert true hat.
Abmeldungen: Die Dashboard-Metrik Unsub spiegelt Klicks auf den standardmäßigen Abmeldelink von Braze wider. Angepasste Abmeldeseiten erhöhen diese Metrik nicht, es sei denn, Sie aktualisieren die Nutzer:innen über die API. Das Currents-Event users.messages.email.Unsubscribe ist ein spezialisiertes Klick-Event, das ausgelöst wird, wenn Nutzer:innen auf einen Abmeldelink im E-Mail-Text oder in der Fußzeile klicken oder den List-Unsubscribe-Header verwenden. Es repräsentiert nicht jede Änderung des E-Mail-Abonnementstatus.
Zeitstempel und Zeitzonen: Alle Currents-Zeitstempel sind in UTC. Dashboard-Metriken folgen der Zeitzone Ihres Unternehmens. Wenn Sie Currents-Daten nach Kalendertag aggregieren, ohne sie in die Zeitzone Ihres Unternehmens umzurechnen, können Zählungen in andere Datums-Buckets fallen als im Dashboard angezeigt.
Doppelte Events: Currents bietet eine At-least-once-Zustellung, was bedeutet, dass gelegentlich doppelte Events geschrieben werden können. Deduplizieren Sie anhand des eindeutigen Felds id jedes Events, bevor Sie Gesamtzahlen mit Dashboard-Metriken vergleichen.
Warum unterscheidet sich die external_user_id (Braze-Schema: external_id) in meinem Currents-E-Mail-Öffnungs- oder -Klick-Event vom Nutzerprofil im Braze-Dashboard?
- Im Braze-Dashboard: Wenn eine:r mit einer E-Mail-Adresse verknüpfte:r Nutzer:in eine E-Mail öffnet oder darauf klickt, werden alle Nutzerprofile, die dieselbe E-Mail-Adresse verwenden, als „geöffnet“ oder „geklickt“ markiert. Weitere Informationen finden Sie unter Was passiert, wenn eine E-Mail gesendet wird und mehrere Profile dieselbe E-Mail-Adresse haben?.
- In Currents: Dasselbe Öffnungs- oder Klick-Event wird nur einem Profil zugeordnet. Braze ordnet es dem Profil zu, das ursprünglich für den Versand ausgewählt wurde, sofern dieses Profil die E-Mail-Adresse noch verwendet. Andernfalls ordnet Braze es einem zufällig ausgewählten Profil unter denjenigen zu, die dieselbe E-Mail-Adresse verwenden.
Aus diesem Grund stimmt der Wert von external_user_id (in der Braze-Schemazuordnungstabelle als external_id bezeichnet) bei einem Currents-E-Mail-Öffnungs- oder -Klick-Event möglicherweise nicht mit dem Nutzerprofil überein, das Sie erwarten, wenn Sie Currents mit dem Braze-Dashboard vergleichen.
Werden alle Sende-Events in Currents protokolliert?
Alle Events werden in Currents protokolliert. Es gibt keine Szenarien, in denen ein Event absichtlich aus dem Currents-Stream unterdrückt wird.
Können Daten in Currents beschädigt werden?
Unter normalen Umständen werden Currents-Daten nicht beschädigt. Obwohl es immer die Möglichkeit eines seltenen Problems gibt, sind keine Bedingungen bekannt, unter denen Daten systematisch beschädigt würden.
Warum sehe ich angepasste Event-Daten mit einem Datum vor der Einrichtung meiner Currents-Integration?
Braze füllt keine Events nachträglich in Currents auf. Angepasste Events können jedoch mit einem vergangenen Zeitstempel protokolliert werden (zum Beispiel, wenn ein Gerät zum Zeitpunkt des Events offline war und die Daten erst später synchronisiert wurden). In diesen Fällen gibt der Event-Zeitstempel an, wann das Event ursprünglich aufgetreten ist, was vor der Konfiguration der Currents-Integration liegen kann.
Welche Nutzer:innen-Bezeichner sind in Currents-Events enthalten?
Message-Engagement-Events (Versendungen, Öffnungen, Klicks und so weiter) enthalten die Braze-Nutzer:innen-ID (user_id) und, wenn im Profil vorhanden, den externen Bezeichner (external_user_id in Event-Payloads, als external_id in der Braze-Schemazuordnungstabelle bezeichnet). Einige E-Mail-Message-Engagement-Events enthalten außerdem email_address. Angepasste Attribute sind nicht enthalten.
Wenn Sie Currents-Daten an ein Data Warehouse oder CRM weiterleiten und mit Profildaten verknüpfen müssen, führen Sie diesen Join in Ihrem nachgelagerten System mithilfe von user_id oder external_user_id durch.
Kann ich angepasste Attribute in Currents-Sende-Events einbeziehen?
Nein. Currents enthält keine angepassten Attribute in Sende-Events. Currents protokolliert angepasste Events und Nachrichten-Engagement-Events. Eine vollständige Liste der verfügbaren Felder finden Sie in den Event-Glossaren.
Enthält Currents Campaign- oder Canvas-Tags oder Schlüssel-Wert-Paare?
Nein. Currents enthält keine Campaign- oder Canvas-Tags und keine Schlüssel-Wert-Paare auf Nachrichtenebene. Um Tag-Daten abzurufen, verwenden Sie die Export-REST-API. Als weitere Lösung können Sie einen Webhook-Kanal in einer Campaign verwenden, um Tag- oder Schlüssel-Wert-Paar-Daten an Ihren eigenen Endpunkt zu senden, indem Sie Liquid zum Templating der Werte nutzen.
Wie informiert Braze Kund:innen über Änderungen an Currents?
In dem seltenen Fall, dass es zu Breaking Changes kommt, sendet Braze vorab eine E-Mail an den Kontakt jeder aktiven Integration sowie an alle Admins mit aktiven Currents-Integrationen, die das Dashboard innerhalb der letzten 30 Tage genutzt haben. Bei Non-Breaking Changes, wie neuen Events oder neuen Feldern zu einem bestehenden Event, sendet Braze keine Benachrichtigung. Die neuesten Änderungen finden Sie im Currents-Changelog.
Wie viel Speicherplatz benötige ich für Currents-Daten?
Die Speicheranforderungen hängen von Ihrem Event-Volumen und den Arten der Events ab, die Sie exportieren. Braze stellt Beispiel-Events im Avro-Format bereit, mit denen Sie die Dateigrößen für Ihren Anwendungsfall abschätzen können.
Warum ist der Campaign-Name oder Canvas-Schritt-Name in meinen Currents-Daten NULL?
Wenn Sie eine neue Campaign oder ein neues Canvas erstellen, kann es einige Zeit dauern, bis der Name in allen Braze-Systemen verfügbar ist. Events, die während dieses Zeitfensters über Currents gesendet werden, können NULL in den Namensfeldern enthalten (z. B. campaign_name oder canvas_step_name). Dies ist auch zu erwarten, wenn der Name kurz vor der Protokollierung der Events geändert wurde. Um dies zu vermeiden, warten Sie nach dem Erstellen oder Umbenennen einer Campaign oder eines Canvas-Schritts einige Zeit, bevor Sie den Versand starten.
Warum sind Sitzungsende-Events in Currents verzögert oder fehlen?
Sitzungsende-Events folgen dem normalen Upload-Zeitplan des SDK. Das Braze SDK speichert Sitzungsdaten lokal zwischen und überträgt sie in regelmäßigen Abständen je nach Netzwerkqualität – beispielsweise etwa alle 10 Sekunden bei einer stabilen Verbindung. Solange das SDK das Event nicht hochgeladen hat, erscheint es nicht in Currents.
Wenn Nutzer:innen die App erzwungen beenden oder offline gehen, bevor die nächste Übertragung stattfindet, kann das Sitzungsende-Event verspätet oder gar nicht ankommen. Unter iOS werden Sitzungsende-Events häufig erst übertragen, wenn die App erneut geöffnet wird, da das SDK keine Daten senden kann, während die App im Hintergrund läuft.
Wenn Sie zeitnähere Sitzungsgrenzen in Currents benötigen, rufen Sie requestImmediateDataFlush() an Lifecycle-Punkten auf, z. B. wenn die App in den Hintergrund wechselt oder in den Vordergrund zurückkehrt. Weitere Informationen finden Sie unter Daten-Upload und -Download und Sitzungsende und Sitzungsstart haben ähnliche Zeitstempel (iOS).
Was passiert, wenn mein Speicher-Bucket nicht verfügbar ist, wenn Currents versucht, Daten zu schreiben?
Wenn Ihr Speicher-Bucket zum Zeitpunkt der Datenübertragung nicht verfügbar ist, gehen diese Daten verloren. Braze kann Events, die nicht erfolgreich zugestellt wurden, nicht nachträglich auffüllen. Um Datenverlust zu vermeiden, stellen Sie sicher, dass Ihr Speicher-Bucket jederzeit verfügbar und korrekt konfiguriert ist.
Warum sehe ich Meldungen zu Berechtigungslimits, wenn ich eine Currents-Integration erstelle oder bearbeite?
Currents verwendet separate Berechtigungspools für verschiedene Konnektor-Funktionen:
- Engagement Events: Erforderlich, um einen Standard-Currents-Konnektor zu erstellen oder zu aktualisieren.
- Customer Behavior Events: Erforderlich, um Track Customer Behavior and User Events zu aktivieren.
- User Profiles and Attributes: Erforderlich, um Track user profiles and attributes zu aktivieren.
Wenn ein Pool erschöpft ist, zeigt Braze eine Berechtigungswarnung an und blockiert die entsprechende Aktion. Wenden Sie sich an Ihre:n Braze Account Manager:in, um zusätzliche Berechtigungen anzufordern oder Ihre Konfiguration anpassen zu lassen.
Wie oft ändert sich die Currents-Version im Speicherpfad?
Das Segment version=<currents_version> im Speicherpfad wird mit jedem Currents-Release in einem monatlichen Rhythmus aktualisiert (zum Beispiel von version=6 auf version=7). Wir empfehlen, Dateien rekursiv vom Stammpfad aus zu lesen, anstatt ein bestimmtes Versionssegment fest zu codieren, damit Ihre Pipeline nach einer Versionsänderung automatisch die Daten erfasst. Weitere Informationen zum Pfadformat finden Sie unter Event-Zustellungssemantik. Eine Übersicht der Änderungen nach Version finden Sie im Currents-Changelog.
Warum fehlen campaign_id oder canvas_id bei einem Message-Engagement-Event?
Je nach Event-Typ und Kontext ist ein Message-Engagement-Event möglicherweise nicht an eine bestimmte Campaign oder einen bestimmten Canvas-Schritt gebunden. In solchen Fällen können campaign_id, canvas_id und zugehörige Namensfelder in der Event-Payload fehlen. Wenn Sie diese Felder bei einem bestimmten Event nicht sehen, prüfen Sie, ob der jeweilige Event-Typ und Kontext normalerweise Campaign- oder Canvas-Bezeichner enthält.
Warum sind Zeitstempel in Currents auf Sekundengenauigkeit begrenzt?
Das Feld time in Currents-Events wird als 32-Bit-Ganzzahl gespeichert und ist daher auf Sekundengenauigkeit begrenzt. Einige Events enthalten zusätzlich ein separates 64-Bit-Zeitstempelfeld mit Millisekundengenauigkeit. Im Event-Glossar finden Sie die verfügbaren Felder für jeden Event-Typ.
Warum hat das users.canvas.Conversion-Event aus Currents eine andere Zeit als das Canvas?
Die Eventzeit von users.canvas.Conversion in Currents spiegelt das gesamte Konversionsfenster wider – die Canvas-Dauer plus die Konversionsfrist –, gemessen ab dem Canvas-Eintritt.
Was passiert, wenn Engagement-Berichte an S3 gesendet werden?
Wenn S3-Zugangsdaten für den Datenexport konfiguriert sind, aber nicht für Currents, lädt Braze die Engagement-Berichte in den angegebenen S3-Bucket hoch. Die im Feld Send Report To aufgeführte Person erhält eine E-Mail mit einem Link zum Bericht in S3.
Können anonyme Nutzerdaten über Braze-Currents an Amplitude gesendet werden?
Anonyme Nutzerdaten, die durch device_id identifiziert werden, können über Currents an Amplitude gesendet werden. Dafür ist eine Feature-Aktivierung durch Ihr Braze-Account-Team erforderlich.
Wie werden Nutzer:innen der Kontrollgruppe in Currents für Content Cards, In-App-Nachrichten und Banner protokolliert?
Wenn eine:r Nutzer:in einer Kontrollgruppe für eine Content-Card- oder In-App-Nachrichten-Campaign zugewiesen wird, gibt Currents ein users.campaigns.EnrollInControl-Event anstelle eines Impressions-Events aus.
Banner-Campaigns funktionieren anders. Kontrollnutzer:innen werden nicht in users.campaigns.EnrollInControl protokolliert. Stattdessen wird die Kontrollgruppen-Exposition als users.messages.banner.Impression-Event protokolliert, nachdem das SDK eine Impression erfasst hat – auch wenn Ihre Integration insertBanner für ein Kontrollgruppen-Banner aufruft und den Container ausblendet. Um Kontrollnutzer:innen in Currents oder Data Sharing zu identifizieren, filtern Sie nach der message_variation_id oder dem message_variation_name (Control Group) der Kontrollvariante.
Informationen zu Tabellenschemata finden Sie unter Banner-Impressions-Events und USERS_MESSAGES_BANNER_IMPRESSION_SHARED.
Was passiert, wenn Sie über die API eine:n nicht existierende:n Nutzer:in ansprechen?
Wenn Sie eine:n Nutzer:in ansprechen, die:der nicht existiert, gibt die API eine 200-Antwort zurück, der Versand wird jedoch mit dem Ergebnis „Unknown external ID“ abgebrochen. Für diesen Versand werden keine Currents-Events generiert. Beachten Sie, dass der Parameter send_to_existing_only standardmäßig auf true gesetzt ist, sodass Sendungen an unbekannte Nutzer:innen stillschweigend übersprungen werden, es sei denn, Sie setzen ihn explizit auf false.