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 einen bestimmten Zeitraum exportieren?

Um Campaign- oder Canvas-Metriken für einen festgelegten Zeitraum abzurufen, haben Sie folgende Möglichkeiten:

• 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_at und length auf (oder verwenden Sie /campaigns/data_series und /canvas/data_series), um Zeitreihendaten zu erhalten.
• Streamen Sie Events mit Currents in Ihr Data Warehouse, wenn Sie fortlaufende, abfragbare Daten zum Nachrichten-Engagement 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-UI schreibgeschützt, und Sie können die Konnektor-Einstellungen nicht allein über die Symbole ändern.

Wie geht Braze nach dem Upload mit Avro-Dateien in Azure Blob Storage um?

Braze verändert Avro-Dateien in Microsoft Azure Blob Storage nicht mehr, nachdem der Upload abgeschlossen ist. Solange ein Upload noch läuft, kann Azure das Löschen eines Blobs blockieren.

Wie erhalte ich historische Daten?

Currents ist ein Live-Datenstream in Realtime. Events lassen sich daher nicht erneut abspielen. Sie können Currents-Daten jedoch in einem Data Warehouse wie Amazon S3 oder Microsoft Azure Blob Storage speichern. So können Sie vergangene Events nach Bedarf 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 und nicht im JSON-Format aus?

Im Gegensatz zu schemalosem JSON unterstützt Avro die Schema-Evolution nativ. Da sich Avro sehr stark komprimieren lässt, benötigen Avro-Dateien bei der Übertragung zudem weniger Kapazität und sparen Speicherplatz.

Wie geht Braze mit dem Datei-Overhead um?

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:

• Amazon S3
• Microsoft Azure Blob Storage
• Google Cloud Storage.

Wie zuverlässig sind die Daten von Currents?

Currents garantiert eine „At-least-once“-Zustellung. Das bedeutet, dass gelegentlich doppelte Events in Ihren Storage-Bucket geschrieben werden können. Wenn Ihr Anwendungsfall eine Exactly-once-Zustellung erfordert, können Sie Events anhand des eindeutigen Bezeichnerfelds (id) deduplizieren, das mit jedem Event gesendet wird. Weitere Informationen finden Sie unter Semantik der Event-Zustellung.

Wie oft werden Daten mit Currents synchronisiert?

Daten werden kontinuierlich gestreamt. Braze sendet einen Batch von Events, sobald ein vollständiger Batch bereitsteht, oder alle 5 Minuten, je nachdem, was zuerst eintritt. Bei Konnektoren mit hohem Volumen treffen die Daten nahezu in Realtime ein. Bei Konnektoren mit geringem Volumen sollten Sie damit rechnen, dass die Daten innerhalb von 5 bis 30 Minuten eintreffen. Weitere Informationen finden Sie unter Avro-Schreibschwellenwert.

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 Kundenverhalten-Events und Messaging-Engagement-Events. Sie können diese Glossare nach Event-Typ filtern, zum Beispiel nach Sendungen, Zustellungen oder Öffnungen.

Warum stimmen die Anzahlen meiner Currents-Events nicht mit den Metriken im Dashboard oder im Engagement-Bericht überein?

Currents und das Braze-Dashboard berechnen bestimmte Metriken unterschiedlich. Exakte Übereinstimmungen zwischen Currents-Events und Dashboard-Metriken sind daher 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 dagegen jedes einzelne Klick-Event als Rohdaten auf. Um die auf Currents basierenden Anzahlen eindeutiger Klicks an die Dashboard-Metriken anzugleichen, filtern Sie nach Events, bei denen is_unique den Wert true hat.

Abmeldungen: Die Dashboard-Metrik Unsub gibt Klicks auf den Standard-Abmeldelink von Braze wieder. 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 spezielles Klick-Event, das ausgelöst wird, wenn Nutzer:innen auf einen Abmeldelink im E-Mail-Text oder in der Fußzeile klicken oder sich über den List-Unsubscribe-Header abmelden. Es bildet nicht jede Änderung des E-Mail-Abostatus ab.

Zeitstempel und Zeitzonen: Alle Zeitstempel in Currents sind in UTC angegeben. Dashboard-Metriken richten sich nach der Zeitzone Ihres Unternehmens. Wenn Sie Currents-Daten nach Kalendertag aggregieren, ohne sie in die Zeitzone Ihres Unternehmens umzurechnen, können Anzahlen in andere Datums-Buckets fallen als im Dashboard.

Doppelte Events: Currents garantiert eine At-least-once-Zustellung, sodass gelegentlich doppelte Events geschrieben werden können. Deduplizieren Sie anhand des eindeutigen Felds id jedes Events, bevor Sie Gesamtwerte mit Dashboard-Metriken vergleichen.

Warum weicht die external_user_id (Braze-Schema: external_id) in meinem Currents-Event für E-Mail-Öffnungen oder -Klicks vom Nutzerprofil im Braze-Dashboard ab?

• Im Braze-Dashboard: Wenn ein:e Nutzer:in, die oder der mit einer E-Mail-Adresse verknüpft ist, eine E-Mail öffnet oder anklickt, werden alle Nutzerprofile mit dieser E-Mail-Adresse so markiert, als hätten sie diese E-Mail geöffnet oder angeklickt. Weitere Informationen finden Sie unter Was passiert, wenn eine E-Mail versendet wird und mehrere Profile dieselbe E-Mail-Adresse haben?.
• In Currents: Dieselbe Öffnung oder derselbe Klick wird in genau einem Profil gespeichert. Braze ordnet das Event dem Profil zu, auf das der Versand ursprünglich ausgerichtet war, sofern dieses Profil die E-Mail-Adresse noch teilt. Andernfalls ordnet Braze es einem zufällig ausgewählten Profil unter den Profilen mit dieser E-Mail-Adresse zu.

Daher stimmt der Wert external_user_id (in der Zuordnungstabelle des Braze-Schemas als external_id bezeichnet) in einem Currents-Event für E-Mail-Öffnungen oder -Klicks 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?

Braze protokolliert Events aus aktiven Campaigns und Canvases in Currents. Abgesehen von Testsendungen unterdrückt Braze keine Events aus dem Currents-Stream.

Testsendungen erzeugen keine Currents-Events zum Nachrichten-Engagement. Das gilt für Testnachrichten, die aus einer Campaign oder einem Canvas-Schritt gesendet werden, und für Nachrichten, die Sie beim Testen eines Canvas mit Send All Test Messages senden. Damit Events zum Nachrichten-Engagement in Currents erscheinen, senden Sie aus einer aktiven Campaign oder einem aktiven Canvas.

Können Daten in Currents beschädigt werden?

Unter normalen Umständen werden Currents-Daten nicht beschädigt. Auch wenn seltene Probleme nie ganz auszuschließen sind, gibt es keine bekannten Bedingungen, unter denen Daten systematisch beschädigt würden.

Warum sehe ich angepasste Event-Daten, die vor der Einrichtung meiner Currents-Integration datiert sind?

Braze überträgt Events nicht rückwirkend an Currents. Angepasste Events können jedoch mit einem Zeitstempel aus der Vergangenheit geloggt werden, zum Beispiel wenn ein Gerät beim Auftreten des Events offline war und erst später synchronisiert wurde. In diesen Fällen gibt der Zeitstempel des Events an, wann das Event ursprünglich aufgetreten ist. Dieser Zeitpunkt kann vor der Konfiguration der Currents-Integration liegen.

Welche Nutzer-IDs sind in Currents-Events enthalten?

Message-Engagement-Events (Sendungen, Öffnungen, Klicks usw.) enthalten die Braze-Nutzer-ID (user_id) und, sofern im Profil vorhanden, den externen Bezeichner (external_user_id in Event-Payloads, in der Braze-Schema-Mapping-Tabelle als external_id bezeichnet). Einige E-Mail-Message-Engagement-Events enthalten zusätzlich email_address. Angepasste Attribute sind nicht enthalten.

Wenn Sie Currents-Daten an ein Data Warehouse oder CRM weiterleiten und sie mit Profildaten verknüpfen müssen, führen Sie diesen Join in Ihrem nachgelagerten System über user_id oder external_user_id durch.

Was ist das Feld app_group_id in Currents-Events?

Das Feld app_group_id enthält den API-Bezeichner des Workspace, zu dem das Event gehört. Dieser Wert ist eine UUID. Er entspricht dem Wert der Spalte app_group_api_id in den SQL-Tabellen für den Query Builder, SQL-Segmenterweiterungen und Snowflake Data Sharing. Daher können Sie damit Currents-Daten mit diesen Tabellen verknüpfen.

Currents verwendet in seinen ID-Feldern API-Bezeichner statt interner Braze-IDs, daher folgen auch andere Felder diesem Muster. So enthält canvas_id in Currents zum Beispiel den API-Bezeichner des Canvas.

Der Wert von app_group_id ist kein Zugangsnachweis. Sie können ihn also nicht zur Authentifizierung von REST-API-Anfragen verwenden. Um REST-API-Anfragen für einen Workspace zu stellen, verwenden Sie einen REST-API-Schlüssel.

Kann ich angepasste Attribute in Currents-Sendeevents aufnehmen?

Nein. Currents nimmt keine angepassten Attribute in Sendeevents auf. Currents protokolliert angepasste Events und Message-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 weder Campaign- oder Canvas-Tags noch Schlüssel-Wert-Paare auf Nachrichtenebene. Um Tag-Daten abzurufen, verwenden Sie die Export-REST-API. Alternativ können Sie in einer Campaign den Webhook-Kanal nutzen, um Tag- oder Schlüssel-Wert-Paar-Daten an Ihren eigenen Endpunkt zu senden. Die Werte legen Sie dabei mit Liquid als Template fest.

Wie benachrichtigt Braze Kund:innen über Änderungen an Currents?

In dem seltenen Fall, dass Breaking Changes auftreten, sendet Braze vorab eine E-Mail an die Kontaktperson jeder aktiven Integration sowie an alle Admins mit aktiven Currents-Integrationen, die das Dashboard in den letzten 30 Tagen genutzt haben. Bei Änderungen, die keine Breaking Changes sind, etwa neuen Events oder neuen Feldern in einem bestehenden Event, sendet Braze keine Benachrichtigung. Die neuesten Änderungen finden Sie im Currents-Changelog.

Welchen Zeitraum deckt eine Currents-Wiederherstellungsbenachrichtigung ab?

Wenn sich eine Currents-Integration von einem Fehler erholt, etwa nach ungültigen Zugangsdaten oder 500-Fehlern vom Endpunkt des Ziels, sendet Braze eine E-Mail an die Kontakt-E-Mail-Adresse der Integration. Darin steht, dass sich die Integration „is now recovering“. Sobald die Integration den Rückstand aufgeholt hat, meldet Braze, dass sie „has fully recovered“ und alle zurückgestauten Daten gesendet wurden. Diese Wiederherstellungsbenachrichtigungen geben nicht an, welchen Zeitraum die zurückgestauten Daten abdecken.

So ermitteln Sie den wiederhergestellten Zeitraum:

1. Suchen Sie die erste Fehlerbenachrichtigung, die Braze für dieselbe Integration gesendet hat. Sie gibt ungefähr an, wann die Fehler der Integration begonnen haben.
2. Notieren Sie, wann Sie die Benachrichtigung „has fully recovered“ erhalten haben.

Die von Braze gesendeten zurückgestauten Daten umfassen die Events vom Beginn der Fehler bis zur Wiederherstellung der Integration.

Wenn die Integration länger als fünf Tage fehlerhaft war, wurden möglicherweise einige Events verworfen. Verworfene Events lassen sich nicht wiederherstellen. Weitere Informationen finden Sie unter Anforderungen.

Wie viel Speicherplatz benötige ich für Currents-Daten?

Der Speicherbedarf hängt von Ihrem Event-Volumen und den Arten von 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 der Name des Canvas-Schritts 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 übernommen ist. Events, die in diesem Zeitraum über Currents gesendet werden, können in den Namensfeldern (zum Beispiel campaign_name oder canvas_step_name) den Wert NULL enthalten. Das ist auch zu erwarten, wenn der Name kurz vor dem Protokollieren der Events geändert wurde. Um dies zu vermeiden, warten Sie nach dem Erstellen oder Umbenennen einer Campaign oder eines Canvas-Schritts etwas ab, bevor Sie Nachrichten versenden.

Warum werden Session-End-Events in Currents verzögert übermittelt oder fehlen ganz?

Session-End-Events folgen dem regulären Upload-Zeitplan des SDK. Das Braze SDK speichert Sitzungsdaten lokal zwischen und überträgt sie regelmäßig, abhängig von der Netzwerkqualität. Bei einer guten Verbindung geschieht das zum Beispiel etwa alle 10 Sekunden. Erst nachdem das SDK das Event hochgeladen hat, erscheint es in Currents.

Beendet ein:e Nutzer:in die App zwangsweise oder geht offline, bevor die nächste Übertragung erfolgt, kommt das Session-End-Event möglicherweise verspätet oder gar nicht an. Unter iOS werden Session-End-Events häufig erst übertragen, wenn die App wieder geöffnet wird, da das SDK keine Daten senden kann, solange sich die App im Hintergrund befindet.

Wenn Sie in Currents zeitnähere Sitzungsgrenzen benötigen, rufen Sie requestImmediateDataFlush() an bestimmten Punkten im Lebenszyklus der App auf, etwa wenn die App in den Hintergrund wechselt oder wieder in den Vordergrund zurückkehrt. Weitere Informationen finden Sie unter Hoch- und Herunterladen von Daten und Sitzungsende und Sitzungsbeginn haben ähnliche Zeitstempel (iOS).

Was passiert, wenn mein Storage-Bucket nicht verfügbar ist, während Currents versucht, Daten zu schreiben?

Wenn Braze nicht in Ihren Storage-Bucket schreiben kann, stellt Braze die nicht schreibbaren Events in eine Warteschlange und versucht es weiter. Das gilt unabhängig davon, welchen Fehler Ihr Bucket zurückgibt. Sobald der Bucket wieder Schreibvorgänge akzeptiert, liefert Braze zuerst die Events aus der Warteschlange und danach neue Events aus.

Solange Braze nicht in Ihren Bucket schreiben kann, erhalten Sie möglicherweise eine Benachrichtigung über einen Integrationsfehler an die Kontakt-E-Mail-Adresse Ihrer Integration. Je nach dem Fehler, den Ihr Bucket zurückgibt, kann die Benachrichtigung besagen, dass Ihre Zugangsdaten ungültig sind, auch wenn sie sich nicht geändert haben.

Besteht das Problem länger als fünf Tage, beginnt Braze, Events zu verwerfen. Verworfene Events lassen sich nicht wiederherstellen. Weitere Informationen finden Sie unter Anforderungen.

So stellen Sie sicher, dass Ihr Bucket verfügbar ist

Ihr Bucket ist verfügbar, wenn er unter dem in Ihrer Currents-Integration gespeicherten Namen existiert und Schreibvorgänge von Braze akzeptiert. Gehen Sie zur Überprüfung wie folgt vor:

1. Gehen Sie in Braze zu Partnerintegrationen > Currents und öffnen Sie Ihre Integration. Notieren Sie sich den Bucket-Namen (bzw. den Container-Namen bei Azure Blob Storage) sowie den Ordnerpfad oder das Präfix.
2. Prüfen Sie in der Konsole Ihres Cloud-Anbieters, ob ein Bucket mit genau diesem Namen existiert:
   • Prüfen Sie bei Amazon S3 das AWS-Konto, dem der Bucket gehört.
   • Prüfen Sie bei Google Cloud Storage das Projekt, das in Ihrer JSON-Schlüsseldatei als project_id angegeben ist. Wenn Sie Workload Identity Federation verwenden, prüfen Sie das Projekt, dem der Bucket gehört.
   • Prüfen Sie bei Azure Blob Storage das Speicherkonto in Ihrem Konto-Endpunkt oder Ihrer Verbindungszeichenfolge.
3. Wenn der Bucket nicht existiert, erstellen Sie einen neuen Bucket und aktualisieren Sie Ihre Integration mit dessen Namen.
4. Wenn Sie den Netzwerkzugriff auf Ihren Bucket einschränken, etwa durch Firewall-Regeln oder private Endpunkte, stellen Sie sicher, dass Ihre Regeln Schreibvorgänge von Braze zulassen. Die IP-Adressen, von denen Braze Currents-Daten sendet, finden Sie unter IP-Allowlisting. Für Azure Blob Storage lesen Sie Kann Braze IP-Adressen für das Allowlisting bei Azure Blob Storage bereitstellen?.
5. Sobald Ihr Bucket Schreibvorgänge akzeptiert, prüfen Sie den Ordnerpfad oder das Präfix auf neue Dateien. Braze liefert zuerst die Events aus der Warteschlange und danach neue Events aus.

So stellen Sie sicher, dass Ihr Bucket richtig konfiguriert ist

Braze benötigt den exakten Bucket-Namen, gültige Zugangsdaten und die Berechtigung, in Ihren Bucket zu schreiben. Gehen Sie zur Überprüfung Ihrer Konfiguration wie folgt vor:

1. Stellen Sie in Ihrer Currents-Integration sicher, dass der Bucket-Name exakt mit Ihrem Bucket übereinstimmt. Geben Sie im Bucket-Feld nur den Bucket-Namen ein, ohne Schrägstriche oder Pfad. Einen Pfad geben Sie im Feld für den Ordnerpfad bzw. das Präfix ein.
2. Stellen Sie sicher, dass die Zugangsdaten in Ihrer Integration über die erforderlichen Berechtigungen verfügen:
   • Amazon S3: Ihre IAM-Richtlinie erlaubt s3:ListBucket und s3:GetBucketLocation für den Bucket sowie s3:PutObject und s3:GetObject für die Objekte im Bucket. Außerdem darf Ihr Bucket weder SSE-KMS-Verschlüsselung noch Object Lock verwenden. Weitere Informationen finden Sie unter Amazon-S3-Integration und Fehlerbehebung.
   • Google Cloud Storage: Die Rolle Ihres Dienstkontos umfasst storage.objects.create, storage.objects.delete, storage.objects.list, storage.objects.get und storage.buckets.get. Wenn Ihr Bucket einen hierarchischen Namespace verwendet, benötigt die Rolle zusätzlich storage.folders.create. Weitere Informationen finden Sie unter Schritt 1: Rolle erstellen. Wenn Sie Workload Identity Federation verwenden, stellen Sie sicher, dass die von Braze verwendete Identität (der Braze-Principal oder das Dienstkonto, als das er auftritt) diese Rolle für Ihren Bucket besitzt. Prüfen Sie außerdem, ob die Aussteller-URL und die zulässige Zielgruppe Ihres Workload-Identity-Pool-Anbieters mit den Werten übereinstimmen, die Braze anzeigt. Weitere Informationen finden Sie unter Schritt 3: Workload-Identity-Pool und Anbieter erstellen und Schritt 4: Zugriff auf Ihren Bucket gewähren.
   • Azure Blob Storage: Wenn Sie die Authentifizierung per Zertifikat-Dienstprinzipal oder Workload Identity Federation verwenden, besitzt Ihre App-Registrierung die Rolle Storage Blob Data Contributor für Ihren Container. Es kann bis zu 30 Minuten dauern, bis Rollenzuweisungen wirksam werden. Prüfen Sie bei Workload Identity Federation außerdem, ob Aussteller, Subjekt-Bezeichner und Zielgruppe der Verbundanmeldeinformation mit den Werten übereinstimmen, die Braze anzeigt. Weitere Informationen finden Sie unter Schritt 4: Zugriff auf Ihr Speicherkonto gewähren für den Zertifikat-Dienstprinzipal bzw. unter Schritt 2: Verbundanmeldeinformation hinzufügen und Schritt 3: Zugriff auf Ihr Speicherkonto gewähren für Workload Identity Federation.
3. Stellen Sie sicher, dass Ihre Zugangsdaten aktuell sind. Wenn Sie einen Schlüssel, eine Rolle oder ein Zertifikat rotiert haben, aktualisieren Sie Ihre Integration. Weitere Informationen finden Sie unter Amazon-S3-Zugangsdaten für Currents aktualisieren, Azure-Zugangsdaten für Currents aktualisieren, GCS-Zugangsdaten für Currents aktualisieren oder Currents aktualisieren.

Kann ich meinen Speicher-Bucket verlagern, ohne Currents-Daten zu verlieren?

Ja. Wenn Sie einen Speicher-Bucket verlagern, der mit einer aktiven Currents-Integration verbunden ist (zum Beispiel mit der Bucket-Verlagerung von Google Cloud Storage), und Bucket-Name, Zugangsdaten und Präfix unverändert bleiben, müssen Sie Ihre Currents-Integration nicht bearbeiten. Während der Verlagerung stellt Braze die Events, die nicht geschrieben werden können, in eine Warteschlange und liefert sie aus, sobald der Bucket wieder Schreibvorgänge akzeptiert.

Schließen Sie die Verlagerung innerhalb von fünf Tagen ab, damit keine Events verworfen werden.

Warum werden beim Erstellen oder Bearbeiten einer Currents-Integration Meldungen zu Berechtigungslimits angezeigt?

Currents verwendet für die verschiedenen Konnektor-Funktionen jeweils eigene Berechtigungskontingente:

• Engagement-Events: Erforderlich, um einen Standard-Currents-Konnektor zu erstellen oder zu upgraden.
• Kundenverhalten-Events: Erforderlich, um Track Customer Behavior and User Events zu aktivieren.
• Nutzerprofile und Attribute: Erforderlich, um Track user profiles and attributes zu aktivieren.

Ist eines dieser Kontingente ausgeschöpft, zeigt Braze eine Warnung zur Berechtigung an und blockiert die entsprechende Aktion. Wenden Sie sich an Ihren Braze Account Manager, um zusätzliche Berechtigungen anzufordern oder Unterstützung bei der Anpassung Ihrer Konfiguration zu erhalten.

Wie oft ändert sich die Currents-Version im Speicherpfad?

Der Pfadabschnitt version=<currents_version> im Speicherpfad erhöht sich mit jedem Currents-Release im monatlichen Rhythmus (zum Beispiel von version=6 auf version=7). Wir empfehlen, Dateien rekursiv ab dem Stammpfad zu lesen, statt einen bestimmten Versionsabschnitt fest zu codieren. So übernimmt Ihre Pipeline die Daten nach einem Versionswechsel automatisch. Weitere Informationen zum Pfadformat finden Sie unter Semantik der Event-Zustellung. Einen Verlauf der Änderungen nach Version finden Sie im Currents-Changelog.

Warum fehlen campaign_id oder canvas_id in einem Nachrichten-Engagement-Event?

Je nach Event-Typ und Kontext ist ein Nachrichten-Engagement-Event nicht immer einer bestimmten Campaign oder einem bestimmten Canvas-Schritt zugeordnet. In diesen Fällen können campaign_id, canvas_id und zugehörige Namensfelder in der Event-Payload fehlen. Wenn Sie diese Felder bei einem Event nicht sehen, prüfen Sie, ob dieser Event-Typ in diesem Kontext normalerweise Campaign- oder Canvas-Bezeichner enthält.

Warum sind Zeitstempel in Currents auf Sekundengenauigkeit beschränkt?

Das Feld time in Currents-Events wird als 32-Bit-Ganzzahl gespeichert und ist daher auf Sekundengenauigkeit beschränkt. Einige Events enthalten zusätzlich ein separates 64-Bit-Zeitstempelfeld mit Millisekundengenauigkeit. Welche Felder für die einzelnen Event-Typen verfügbar sind, erfahren Sie im Event-Glossar.

Warum hat das Event users.canvas.Conversion aus Currents einen anderen Zeitpunkt als das Canvas?

Der Event-Zeitpunkt von users.canvas.Conversion in Currents spiegelt das gesamte Conversion-Fenster wider. Dieses setzt sich aus der Dauer des Canvas und der Conversion-Frist zusammen und wird ab dem Eintritt in das Canvas gemessen.

Was passiert, wenn Engagement-Berichte an S3 gesendet werden?

Wenn S3-Zugangsdaten für den Datenexport, aber nicht für Currents konfiguriert sind, lädt Braze Engagement-Berichte in den angegebenen S3-Bucket hoch. Die im Feld Send Report To angegebene 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 über device_id identifiziert werden, können über Currents an Amplitude gesendet werden. Dafür muss Ihr Braze-Account-Team das Feature aktivieren.

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 nicht existierende Nutzer:in ansprechen?

Wenn Sie eine Nutzer:in ansprechen, die 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. Sendungen an unbekannte Nutzer:innen werden daher stillschweigend übersprungen, sofern Sie ihn nicht explizit auf false setzen.