Häufig gestellte Fragen

Dieser Artikel enthält Antworten auf einige häufig gestellte Fragen zu Canvas.

Erstellen und Bearbeiten von Canvas

Wie viele Schritte kann ich in einem Canvas hinzufügen?

Sie können bis zu 200 Schritte in einem Canvas hinzufügen.

Gibt es Größenbeschränkungen für Canvas-Entry-Eigenschaften?

Ja. Das Canvas-Kontextobjekt (Canvas-Entry-Eigenschaften) hat eine maximale Größe von 50 KB. Halten Sie Payloads so klein wie praktisch möglich innerhalb dieses Limits. Informationen zur Funktionsweise von Entry- und Event-Eigenschaften in Canvas finden Sie unter Kontext- und Event-Eigenschaften.

Warum wird der Fehler „Too many Canvas branches“ angezeigt?

Dieser Fehler wird angezeigt, wenn die Kombination aus Schritt-Verzweigungen und Zielgruppengröße am Einstieg zu Cluster-Performance-Problemen führen kann, die den Versand von Nachrichten verhindern. Hinweise zur Behebung – einschließlich der Verwendung von Zielgruppenpfaden, der Reduzierung von Verzweigungen oder Zielgruppengröße sowie des Neuaufbaus in Canvas Flow – finden Sie unter Fehler „Too many Canvas branches“.

Kann ich „Optimize with BrazeAI^TM“ mit erneuter Berechtigung in einem Canvas verwenden?

Ja. Canvases können Optimize with BrazeAI^TM verwenden, wenn die erneute Berechtigung aktiviert ist. Braze kann nicht garantieren, dass bei erneutem Eintritt dieselbe Variante zugewiesen wird, da sich die Zuordnung im Laufe der Zeit verschiebt. Campaigns erfordern ein Fenster für die erneute Berechtigung von mindestens 24 Stunden, wenn Optimize with BrazeAI^TM aktiviert ist.

Was ist der Unterschied zwischen einer Komponente und einem Schritt?

Eine Komponente ist ein einzelner Bestandteil Ihres Canvas, mit dem Sie die Effektivität Ihres Canvas bestimmen können. Komponenten können Aktionen wie das Aufteilen der User Journey, das Hinzufügen einer Verzögerung und sogar das Testen mehrerer Canvas-Pfade umfassen. Ein Schritt in Canvas bezieht sich auf die personalisierte User Journey in Ihren Canvas-Branches. Im Wesentlichen besteht Ihr Canvas aus einzelnen Komponenten, die Schritte für Ihre User Journey bilden.

Kann ich ein Canvas mit nicht verbundenen Schritten starten?

Ja. Sie können Canvases auch nach dem Start mit nicht verbundenen Schritten speichern.

Wohin gelangen Nutzer:innen, wenn sie einen nicht verbundenen Schritt erreicht haben?

Wenn sich ein:e Nutzer:in in einem nicht verbundenen Schritt Ihres Canvas-Workflows befindet, rückt er/sie zum nächsten Schritt vor, sofern vorhanden, und die Einstellung des Schritts bestimmt, wie der/die Nutzer:in fortschreiten soll. Dies ermöglicht es, Änderungen an Schritten vorzunehmen, ohne sie direkt mit dem Rest des Canvas verbinden zu müssen. Außerdem haben Sie so Raum zum Testen, bevor Sie sofort live gehen – es funktioniert praktisch wie das Speichern eines Entwurfs.

Wir empfehlen, die Analytics-Ansicht auf Nutzer:innen zu prüfen, die in einem Canvas-Schritt ausstehen, bevor Sie einen Schritt trennen.

Was passiert, wenn die Zielgruppe und die Sendezeit für ein Canvas mit einer Variante, aber mehreren Branches identisch sind?

Es wird ein Job für jeden Schritt in die Warteschlange eingereiht – sie werden etwa zur gleichen Zeit ausgeführt, und einer von ihnen „gewinnt“. In der Praxis kann die Verteilung einigermaßen gleichmäßig sein, aber es gibt wahrscheinlich eine leichte Tendenz zum Schritt, der zuerst erstellt wurde.

Darüber hinaus können wir keine Garantie dafür geben, wie diese Verteilung genau aussehen wird. Wenn Sie eine gleichmäßige Aufteilung wünschen, fügen Sie einen Filter für zufällige Bucket-Nummern hinzu.

Wie werden Canvas-Zielgruppen ausgewertet?

Standardmäßig werden Filter und Segmente für vollständige Schritte im Canvas zum Sendezeitpunkt geprüft. Der Decision-Split-Schritt führt eine Auswertung direkt nach Erhalt eines vorherigen Schritts durch (oder vor einer Verzögerung).

Wann wird ein Ausnahme-Event ausgelöst?

Ausnahme-Events werden nur ausgelöst, während der/die Nutzer:in auf den Empfang der zugehörigen Canvas-Komponente wartet. Wenn ein:e Nutzer:in eine Aktion vorzeitig ausführt, wird das Ausnahme-Event nicht ausgelöst. Wenn Sie Nutzer:innen ausschließen möchten, die ein bestimmtes Event bereits ausgeführt haben, verwenden Sie stattdessen Filter.

Wie wirkt sich die Bearbeitung eines Canvas auf Nutzer:innen aus, die sich bereits im Canvas befinden?

Wenn Sie einige Schritte eines mehrstufigen Canvas bearbeiten, erhalten Nutzer:innen, die bereits in der Zielgruppe waren, aber die Schritte noch nicht erhalten haben, die aktualisierte Version der Nachricht. Beachten Sie, dass dies nur geschieht, wenn sie noch nicht für den Schritt ausgewertet wurden.

Weitere Informationen darüber, was Sie nach dem Start bearbeiten können, finden Sie unter Canvas nach dem Start ändern.

Was passiert, wenn Sie ein Canvas stoppen?

Wenn Sie ein Canvas stoppen, gilt Folgendes:

• Nutzer:innen werden daran gehindert, das Canvas zu betreten.
• Es werden keine weiteren Nachrichten versendet, unabhängig davon, wo sich ein:e Nutzer:in im Flow befindet.
• Ausnahme: Canvases mit E-Mails werden nicht sofort gestoppt. Nachdem die Sendeanfragen an SendGrid übermittelt wurden, kann die Zustellung an den/die Nutzer:in nicht mehr verhindert werden.

Sollte ich ein einziges Canvas oder separate Canvases pro Nutzer-Lifecycle erstellen?

Je nachdem, was Sie mit Ihrem Canvas erreichen möchten, benötigen Sie möglicherweise unterschiedliche Ansätze beim Aufbau Ihrer User Journey. Die Flexibilität von Canvas ermöglicht es Ihnen, User Journeys für jede Phase des Nutzer-Lifecycle abzubilden. Sehen Sie sich unsere Braze-Canvas-Templates an, um verschiedene Beispiele für optimierte Ansätze zur Erstellung effektiver User Journeys zu finden.

Nachrichten und Zustellung

Wann werden In-App-Nachrichten in Canvas gesendet?

In-App-Nachrichten werden beim nächsten Sitzungsstart gesendet. Das bedeutet: Wenn Nutzer:innen den Canvas-Schritt betreten, bevor der Canvas gestoppt wird, erhalten sie die In-App-Nachricht beim nächsten Sitzungsstart, sofern die In-App-Nachricht noch nicht abgelaufen ist.

Es ist möglich, dass Nutzer:innen eine Sitzung starten, bevor der Canvas gestoppt wird, die In-App-Nachricht aber nicht sofort angezeigt wird. Das kann vorkommen, wenn die In-App-Nachricht durch ein angepasstes Event getriggert oder verzögert wird. In diesem Fall kann es passieren, dass Nutzer:innen eine In-App-Nachrichten-Impression protokollieren und die In-App-Nachricht „empfangen“, nachdem der Canvas gestoppt wurde. Die Sitzung muss jedoch vor dem Stoppen des Canvas begonnen worden sein – aber nachdem der Canvas-Schritt empfangen wurde.

Warum kann ein Canvas null Sends anzeigen, obwohl Impressionen protokolliert werden?

Wenn Gesendete Nachrichten für einen Canvas mit einem In-App-Nachrichten-Schritt immer null sind, liegt das daran, dass die Zustellung von In-App-Nachrichten anders funktioniert als bei anderen Messaging-Kanälen.

In-App-Nachrichten werden vom SDK „abgerufen“ und nicht von Braze „gepusht“. In-App-Nachrichten für berechtigte Nutzer:innen werden automatisch beim Sitzungsstart zugestellt und „warten“ auf das Trigger-Event, bevor sie angezeigt werden. Da berechtigte Nutzer:innen die Nachricht beim Start einer Sitzung erhalten, meldet Braze dies nicht als Send-Event. Wenn Nutzer:innen das Trigger-Event ausführen, wird die Nachricht angezeigt und Braze protokolliert eine Impression und markiert den Canvas-Schritt (oder die Campaign) als empfangen im Nutzerprofil. Folglich ist die Gesamtzahl der Sends für In-App-Nachrichten null.

Warum haben Nutzer:innen meine In-App-Nachricht nach einer langen Verzögerung oder einem Branch nicht erhalten?

Nachdem vorgelagerte Verzögerungsschritte und Zielgruppenprüfungen abgeschlossen sind, werden Nutzer:innen erst für eine In-App-Nachricht berechtigt, wenn sie den Nachrichtenschritt erreichen. Wenn die Nachricht an einem Kalenderdatum oder nach einem kurzen Zeitfenster nach Verfügbarkeit des Schritts abläuft, können Nutzer:innen auf langsameren Branches nach Ablauf ankommen und die Nachricht nie sehen. Stimmen Sie den Ablauf auf Ihre längsten realistischen Pfadverzögerungen ab. Weitere Informationen und Beispiele finden Sie unter Ablauf von In-App-Nachrichten.

Warum sehe ich die Meldung „Canvas Entry Properties may not be used in In-App Messages.“?

Diese Meldung erscheint, wenn die Personalisierung auf Felder verweist, die In-App-Nachrichten in Canvas nicht auflösen können. Verwenden Sie das context-Objekt, wie unter Kontext- und Event-Eigenschaften und Nachrichtenschritt beschrieben. Der Legacy-Liquid-Namespace canvas_entry_properties unterliegt anderen Einschränkungen als context. Wenn Sie Werte über mehrere Schritte hinweg beibehalten müssen, besprechen Sie persistente Eigenschaften im ursprünglichen Canvas-Editor mit Ihrem Braze-Team. Gespeicherte Werte werden gelöscht, wenn Nutzer:innen den Canvas verlassen, bevor das Gerät die In-App-Payload heruntergeladen hat.

Wo finde ich Button-Klicks für Drag-and-Drop-In-App-Nachrichten in Canvas?

Button-Metriken für Drag-and-Drop-In-App-Nachrichten erscheinen auf der Analytics-Karte des Nachrichtenschritts in den Canvas-Details, nicht nur in der Canvas-Gesamtübersicht. Öffnen Sie den Canvas, wählen Sie den Nachrichtenschritt aus und prüfen Sie dort das In-App-Engagement. Informationen zu Reporting-Konzepten finden Sie unter Canvas Analytics.

Kann ich für jede Variante im selben Canvas-Nachrichtenschritt oder multivariaten Versand unterschiedliche Sendezeiten planen?

Nein. Varianten in derselben multivariaten Konfiguration oder im selben Nachrichtenschritt teilen sich einen Zustellungsplan. Sie können nicht eine Variante um 18 Uhr und eine andere um 19 Uhr für denselben geplanten Versand senden lassen.

Um Versendungen zu staffeln oder unterschiedliche Zeiten pro Pfad zu verwenden, probieren Sie die folgenden Methoden:

• Trennen Sie Nachrichtenschritte mit Verzögerungsschritten, damit jede Nachricht ihren eigenen Zeitplan hat.
• Verwenden Sie Branches oder einen Experimentpfade-Schritt, damit Nutzer:innen Pfade mit unterschiedlichem Timing durchlaufen.
• Nutzen Sie separate Campaigns, wenn der Anwendungsfall nicht innerhalb eines Canvas bleiben muss.

Informationen zu multivariaten und A/B-Konzepten in Campaigns finden Sie unter Multivariate und A/B-Tests.

Was passiert, wenn Nutzer:innen an einem Canvas-Nachrichtenschritt durch globales Frequency-Capping begrenzt werden?

Sie erhalten den Versand für den begrenzten Kanal nicht, aber Nachrichtenschritte bringen Nutzer:innen trotzdem voran, wenn eine Nachricht aufgrund von globalem Frequency-Capping nicht gesendet wird. Informationen zu den einzelnen Fortschritt-Fällen finden Sie unter Wie Nutzer:innen voranschreiten. Globales Frequency-Capping allein bewirkt keinen Exit von Nutzer:innen aus einem Canvas; dieses Verhalten ist unabhängig von Zustellungsvalidierungen in einem Nachrichtenschritt. Weitere Details finden Sie unter Rate-Limiting und Frequency-Capping.

Warum sind die Sends niedriger als die geschätzte Zielgruppengröße?

Sends können aus vielen der gleichen Gründe niedriger als die geschätzte Zielgruppe sein wie bei Campaigns, darunter Frequency-Caps, strenge Geräte- oder Browser-Filter, Wiederzulassungsfenster, Rate-Limiting und Kanalausschlüsse (z. B. Push-Erreichbarkeit oder E-Mail-Abo- und Zustellbarkeitsprüfungen).

Canvas-spezifische Faktoren spielen ebenfalls eine Rolle:

• Aktionsbasierter oder API-getriggerter Entry: Nutzer:innen treten erst ein (und erhalten Schritte), nachdem sie das Entry-Verhalten ausführen. Daher liegen die tatsächlichen Sends hinter der Vorabschätzung zurück, bis diese Aktionen stattfinden.
• Zielgruppenpfade: Nutzer:innen werden dem Branch mit der höchsten Priorität zugeordnet, für den sie sich qualifizieren. Nachgelagerte Branches können daher weniger Nutzer:innen erhalten, als eine einfache Segment-Zählung vermuten lässt.
• Zielgruppen- und Sendezeitprüfungen: Vollständige Schritte bewerten Filter zum Sendezeitpunkt erneut, sofern Sie nichts anderes konfigurieren. Nutzer:innen, die sich beim Erstellen des Canvas qualifiziert haben, können vor dem Versand einer Nachricht herausfallen.
• Kontrollgruppen: Globale oder Canvas-Kontrollgruppen halten einen Anteil der Eintretenden vom Messaging zurück.
• Ruhezeiten und Verzögerungen: Nachrichten können zurückgehalten oder verschoben werden, wodurch sich Sends aus dem angezeigten Berichtszeitraum verschieben.
• Maximale Entry- oder Zielgruppen-Caps: Entry- oder Send-Caps stoppen weitere Nutzer:innen, auch wenn das zugrundeliegende Segment größer ist.
• Berichtszeitraum: Der Analytics-Zeitraum umfasst möglicherweise nicht jeden Versand, den Sie mit der Schätzung vergleichen.

Warum stimmen geschätzte Zielgruppe und Canvas-Nutzer:innen-Anzahl nicht überein?

Die geschätzte Zielgruppe spiegelt wider, wer zum Zeitpunkt der Schätzung Ihrem Segment und Ihren Entry-Filtern entspricht. Danach können verzögerte oder aktionsbasierte Entries, Wiederzulassung, API-Trigger oder Branch-Routing dazu führen, dass mehr Profile die Journey durchlaufen als im Snapshot erfasst. Nutzer:innen können auch herausfallen, wenn Sendezeitfilter fehlschlagen, was die tatsächlichen Entries oder Sends verringert. Vergleichen Sie Timing, Caps und Auswertungseinstellungen zusammen mit Warum sind die Sends niedriger als die geschätzte Zielgruppengröße?.

Warum ist Eindeutige Empfänger:innen höher als die Anzahl der Nutzer:innen, die ich angesprochen habe?

Eindeutige Empfänger:innen kann höher sein als die erwartete Zielgruppe, da Braze eindeutige tägliche Empfänger:innen für Canvas- und Campaign-Reporting erfasst. Dies unterstützt eine genaue Konversions-Attribution für jeden Zeitpunkt, zu dem Nutzer:innen eine Nachricht in der Journey erhalten.

Wenn Nutzer:innen beispielsweise am Montag und am Freitag einen Canvas-Schritt erhalten und nach jedem Versand konvertieren, kann Braze zwei Empfänger:innen-Zeilen und zwei relevante Konversionen zählen. Bei wiederkehrenden Entries oder Wiederzulassung kann dieselbe kleine Gruppe von Profilen über mehrere Tage hinweg mehrere Eindeutige Empfänger:innen erzeugen.

Warum hat mein Canvas niedrigere Sendraten?

Wenn Sie feststellen, dass Ihr täglich geplanter Canvas im Laufe der Zeit an weniger Nutzer:innen sendet, prüfen Sie Folgendes:

• Prüfen Sie, ob Wiederzulassung aktiviert ist: Ohne Wiederzulassung lässt Braze jede:n Nutzer:in nur einmal in den Canvas eintreten. Bei täglich geplanten Canvases sind nur Nutzer:innen berechtigt, die zur Zielgruppe passen und noch nicht in den Canvas eingetreten sind. Mit jedem Entry gibt es weniger berechtigte Nutzer:innen, sodass das Entry-Volumen abnimmt.
• Prüfen Sie, ob die Zielgruppe eine feste Mitgliedschaft hat: Zielgruppen, die auf einer festen Nutzerliste basieren (z. B. ein CSV-Import als Segment-Filter), gewinnen nicht automatisch neue Mitglieder. Ohne neue Eintritte kann das Entry-Volumen nicht wieder steigen, da Nutzer:innen den Canvas betreten.

Informationen zu Rate-Limits für die Zustellgeschwindigkeit und anderen Faktoren, die Sends für einen einzelnen Versand senken, finden Sie unter Warum sind die Sends niedriger als die geschätzte Zielgruppengröße?.

Warum zeigt ein kleines Kontrollgruppen-Segment Änderungen in der historischen Mitgliedschaft?

Historische Mitgliedschafts-Charts verwenden geschätzte Stichproben, sodass kleine Segmente – einschließlich globaler Kontrollgruppen-Segmente – tägliche Schwankungen zeigen können, auch wenn die zugrundeliegende Zielgruppe stabil ist. Informationen zur Funktionsweise von Schätzungen und warum Charts schwanken können, finden Sie unter Historische Segment-Mitgliedschaftsgröße anzeigen.

Analytics und Konversionen

Wie ordnet das Konversions-Dashboard Canvas-Konversionen zu?

Das Konversions-Dashboard ordnet Canvas-Konversionen basierend auf der von Ihnen gewählten Attributionsmethode zu (zum Beispiel Upon Receipt, Upon Send, Upon Open oder Upon Click). Damit Nutzer:innen im Bericht erscheinen, müssen sie den Canvas oder die Campaign betreten, die ausgewählte Attributionsmethode auslösen und das Konversions-Event innerhalb Ihrer Berichtseinstellungen ausführen.

Informationen zu Konversionsregeln auf Schritt- und Variantenebene in der Canvas-Analyse finden Sie unter Wie werden Nutzerkonversionen in einem Canvas erfasst?.

Wie werden Nutzerkonversionen in einem Canvas erfasst?

Nutzer:innen können pro Canvas-Eintritt nur einmal konvertieren. Konversionen werden der zuletzt empfangenen Nachricht für diesen Eintritt zugeordnet. Der Zusammenfassungsblock am Anfang eines Canvas spiegelt alle Konversionen wider, die Nutzer:innen innerhalb dieses Pfads durchgeführt haben – unabhängig davon, ob sie eine Nachricht erhalten haben. Jeder nachfolgende Schritt zeigt nur die Konversionen an, die stattfanden, als dieser Schritt der letzte war, den die Nutzer:innen erhalten haben.

Beispiele anzeigen

Beispiel 1

Es gibt einen Canvas-Pfad mit 10 Push-Benachrichtigungen und das Konversions-Event ist „Sitzungsstart“ („App öffnen“):

• Nutzer:in A öffnet die App nach dem Eintritt, aber bevor die erste Nachricht zugestellt wird.
• Nutzer:in B öffnet die App nach jeder Push-Benachrichtigung.

Ergebnis: Die Zusammenfassung zeigt zwei Konversionen an, während die einzelnen Schritte eine Konversion beim ersten Schritt und null bei allen nachfolgenden Schritten anzeigen.

Hinweis

Wenn Ruhezeiten aktiv sind, wenn das Konversions-Event stattfindet, gelten die gleichen Regeln.

Beispiel 2

Es gibt einen Canvas mit einem Schritt und aktivierten Ruhezeiten:

1. Nutzer:in betritt den Canvas.
2. Der erste Schritt hat keine Verzögerung, liegt aber innerhalb der festgelegten Ruhezeiten, sodass die Nachricht unterdrückt wird.
3. Nutzer:in führt das Konversions-Event aus.

Ergebnis: Die/der Nutzer:in wird als konvertiert in der gesamten Canvas-Variante gezählt, aber nicht im Schritt, da sie/er den Schritt nicht erhalten hat.

Was ist der Unterschied zwischen den verschiedenen Konversionsratentypen?

• Die Canvas-Gesamtkonversionen zeigen, wie viele eindeutige Nutzer:innen ein Konversions-Event abgeschlossen haben, nicht wie viele Konversionen sie jeweils durchgeführt haben.
• Die Variantenkonversionsrate oder der Zusammenfassungsblock am Anfang eines Canvas spiegelt alle Konversionen wider, die Nutzer:innen innerhalb dieses Pfads durchgeführt haben – unabhängig davon, ob sie eine Nachricht erhalten haben – als Gesamtsumme.
• Die Schrittkonversionsrate zeigt, wie viele Personen diesen Nachrichtenschritt erhalten und eines der definierten Konversions-Events abgeschlossen haben.

Warum entspricht die Konversionsrate meines Canvas-Schritts nicht der Gesamtkonversionsrate meiner Canvas-Variante?

Es ist üblich, dass die Konversionssumme einer Canvas-Variante größer ist als die Summe der einzelnen Schritte. Das liegt daran, dass Nutzer:innen ein Konversions-Event für eine Variante ausführen können, sobald sie die Variante betreten. Dieses gleiche Konversions-Event zählt jedoch nicht für einen Canvas-Schritt. Nutzer:innen, die den Canvas betreten und das Konversions-Event vor dem Empfang des ersten Canvas-Schritts ausführen, werden daher in der Variantenkonversionssumme gezählt, aber nicht in der Schrittsumme. Dasselbe gilt für Nutzer:innen, die den Canvas betreten, ihn aber verlassen, bevor sie einen Schritt erhalten.

Beachten Sie, dass es auch möglich ist, dass Nutzer:innen eine Variante betreten, von einem Schritt keine Nachricht erhalten und dann konvertieren. In diesem Fall wird keine Konversion auf Schrittebene protokolliert. Da die Nutzer:innen jedoch technisch gesehen konvertiert haben, wird eine Konversion auf Canvas-Ebene protokolliert.

Wie kann ich bestätigen, ob meine Nutzer:innen einen API-getriggerten Canvas erhalten haben?

Sie können ein Segment erstellen, das einen Canvas-Filter verwendet, um zu bestätigen, ob Nutzer:innen den Canvas betreten oder einen bestimmten Canvas-Schritt erhalten haben. Verwenden Sie beispielsweise einen Canvas-Eintrittsfilter, wenn Sie bestätigen möchten, dass Nutzer:innen den API-getriggerten Canvas betreten haben, oder einen Filter für empfangene Schritte, wenn Sie bestätigen möchten, dass sie eine Nachricht vom Canvas erhalten haben. Verwenden Sie dann den /users/export/segment-Endpunkt, um die Nutzer:innen in diesem Segment zu exportieren.

Kann ich einen Canvas löschen?

Nein, aber Sie können einen Canvas archivieren.

Wie setze ich einen archivierten Canvas oder eine archivierte Campaign fort?

Archivierte Nachrichten werden erst wieder gesendet, wenn Sie sie in einen bearbeitbaren Status zurückversetzen. Dearchivieren Sie die Campaign oder den Canvas, legen Sie den Eintrittszeitplan oder die Sendezeit auf ein zukünftiges Fenster fest (oder duplizieren Sie die Journey, wenn Sie eine saubere Kopie benötigen) und wählen Sie dann Fortsetzen oder starten Sie wie gewünscht. Weitere Informationen finden Sie unter Campaigns und Canvases archivieren.

Warum lässt sich mein Canvas nicht speichern, obwohl kein Fehler angezeigt wird?

Leere Angepasstes Attribut-Filter in Zielgruppen- oder Schrittfiltern können das Speichern ohne detaillierte Validierungsnachricht blockieren. Öffnen Sie jede Filterkarte, entfernen Sie unvollständige Regeln für angepasste Attribute oder geben Sie sowohl den Attributnamen als auch den Wert ein und wählen Sie dann erneut Speichern.

Warum ist ein Tag von meinem Canvas oder meiner Campaign verschwunden?

Wenn ein Tag aus Ihrem Workspace gelöscht wird, entfernt Braze es aus jeder Campaign und jedem Canvas, der darauf verwiesen hat. Diese Bereinigung erzeugt nicht immer einen eigenen Eintrag im Canvas-Änderungsprotokoll.

Wie kann ich die Analytics für jede meiner Canvas-Komponenten anzeigen?

Um die Analytics einer Canvas-Komponente anzuzeigen, navigieren Sie zu Ihrem Canvas und scrollen Sie auf der Seite Canvas-Details nach unten. Hier können Sie die Analytics jeder Komponente einsehen. Weitere Informationen finden Sie unter Canvas Analytics.

Wann ist das Engagement eines Canvas-Schritts in einem Nutzerprofil sichtbar?

Filter wie Received Message from Canvas Step werden aktualisiert, nachdem Braze das entsprechende Sende-, Empfangs- oder Engagement-Event für diesen Schritt protokolliert hat. In-App-Nachrichten können Impressionen getrennt von sendeartigen Metriken protokollieren. Siehe Warum kann ein Canvas null Sends anzeigen, obwohl Impressionen protokolliert werden?. Dieselben Events erscheinen in den Schrittmetriken unter Canvas-Details.

Was ist genauer, wenn es um die Anzahl eindeutiger Nutzer:innen geht: Canvas Analytics oder der Segmenter?

Der Segmenter liefert eine genauere Statistik für eindeutige Nutzerdaten als Canvas- oder Campaign-Statistiken. Das liegt daran, dass Canvas- und Campaign-Statistiken Zahlen sind, die Braze inkrementiert, wenn etwas passiert – es gibt daher Variablen, die dazu führen können, dass diese Zahl von der des Segmenters abweicht. Zum Beispiel können Nutzer:innen für einen Canvas oder eine Campaign mehr als einmal konvertieren.

Warum weicht die Anzahl der Nutzer:innen, die einen Canvas betreten, von der erwarteten Anzahl ab?

Die Anzahl der Nutzer:innen, die einen Canvas betreten, kann sich von der erwarteten Anzahl unterscheiden, da Zielgruppen und Trigger unterschiedlich ausgewertet werden. In Braze wird die Zielgruppe vor dem Trigger ausgewertet (es sei denn, es wird ein Attributänderung-Trigger verwendet). Dadurch fallen Nutzer:innen aus dem Canvas, wenn sie nicht Teil der ausgewählten Zielgruppe sind, bevor Trigger-Aktionen ausgewertet werden.

Was passiert mit anonymen Nutzer:innen während ihrer Canvas-Journey?

Anonyme Nutzer:innen können zwar Canvases betreten und verlassen, aber ihre Aktionen werden keinem bestimmten Nutzerprofil zugeordnet, bis sie identifiziert werden. Daher werden ihre Interaktionen möglicherweise nicht vollständig in Ihren Analytics erfasst. Sie können den Query Builder verwenden, um einen Bericht zu diesen Metriken zu erstellen.

Kann ich Nutzer:innen, die sich derzeit in einer Canvas-Journey befinden, von einer Campaign oder einem Segment ausschließen?

Verwenden Sie Segmentierungsfilter wie Entered Canvas Variation, In Canvas Control Group oder Received Message from Canvas Step, um Nutzer:innen basierend auf Canvas-Eintritt, Variantenzuordnung oder Schritt-Engagement anzusprechen. Diese Filter bewerten den Eintrittsverlauf und Interaktionen – sie zeigen nicht an, ob Nutzer:innen derzeit noch eine aktive Journey durchlaufen.

Um Nutzer:innen basierend auf aktiver Canvas-Teilnahme ein- oder auszuschließen, fügen Sie Nutzer-Update-Schritte beim Canvas-Eintritt und -Austritt hinzu, um angepasste Attribute zu setzen und zu entfernen, und filtern Sie dann in Campaigns oder Segments nach diesen Attributen.

Segmentierung

Was ist der Unterschied zwischen „Hat keine Canvas-Variante betreten“ und „Ist nicht in der Canvas-Kontrollgruppe“?

Die vollständigen Filterdefinitionen finden Sie unter Segmentierungsfilter.

Hat keine Canvas-Variante betreten

Die/der Nutzer:in hat nie einen Varianten-Pfad eines bestimmten Canvas betreten. Alle Nutzer:innen, die sich nicht in der Kontrollgruppe befinden, sind eingeschlossen – unabhängig davon, ob sie den Canvas betreten haben. Dies umfasst Nutzer:innen, die eine andere Variante betreten haben, und Nutzer:innen, die keine Variante betreten haben.

Ist nicht in der Canvas-Kontrollgruppe

Die/der Nutzer:in hat den Canvas betreten, befindet sich aber nicht in der Kontrollgruppe und hat folglich eine Variante erhalten. Dies umfasst nur Nutzer:innen, die den Canvas betreten haben.

Beachten Sie, dass die Variantenzuordnung beim Canvas-Eintritt erfolgt. Wenn ein:e Nutzer:in einen Canvas nicht betreten hat, wird ihr/ihm keine Variante zugewiesen. Mit anderen Worten: Sie befinden sich weder in der Kontrollgruppe noch in einer Variante.

Originaler Canvas-Editor

Erweitern für FAQ zum originalen Canvas-Editor

Wie konvertiere ich ein bestehendes Canvas vom originalen Editor zum aktuellen Editor?

Sie können Ihr Canvas klonen. Dadurch wird eine Kopie Ihres originalen Canvas im aktuellsten Canvas-Workflow erstellt.

Was sind die Hauptunterschiede zwischen dem aktuellen und dem originalen Canvas-Editor?

Canvas-Komponenten-Symbolleiste

Zuvor wurde im originalen Canvas-Editor standardmäßig ein vollständiger Schritt hinzugefügt, wenn Sie einen Schritt in Ihrer User-Journey erstellt haben. Diese vollständigen Schritte werden durch verschiedene Canvas-Komponenten ersetzt, was Ihnen den Vorteil einer besseren Übersichtlichkeit und Anpassbarkeit bei der Bearbeitung bietet. Sie können alle Ihre Canvas-Komponenten direkt über die Canvas-Schritt-Symbolleiste sehen.

Schrittverhalten

Zuvor enthielt jeder vollständige Schritt Informationen wie Verzögerungs- und Zeitplaneinstellungen, Ausnahme-Events, Zielgruppenfilter, Nachrichtenkonfiguration und Nachrichtenfortschrittsoptionen in einer einzigen Komponente. Diese sind im aktuellen Editor separate Einstellungen, um Ihre Canvas-Erstellung anpassbarer zu gestalten, und führen zu einigen Unterschieden in der Funktionalität.

Fortschritt bei Nachrichtenkomponenten

Nachrichtenkomponenten bringen alle Nutzer:innen weiter, die den Schritt betreten. Es ist nicht erforderlich, das Nachrichtenfortschrittsverhalten festzulegen, was die Konfiguration des gesamten Schritts vereinfacht. Wenn Sie die Option Bei gesendeter Nachricht fortfahren implementieren möchten, fügen Sie einen separaten Zielgruppenpfad hinzu, um Nutzer:innen herauszufiltern, die den vorherigen Schritt nicht erhalten haben.

Verzögerungsverhalten „in“

Verzögerungskomponenten warten die gesamte Verzögerungsdauer ab, bevor sie zum nächsten Schritt übergehen.

Nehmen wir an, am 12. April haben wir eine Verzögerungskomponente, bei der die Verzögerung so eingestellt ist, dass die/der Nutzer:in am nächsten Tag um 14 Uhr zum nächsten Schritt weitergeleitet wird. Ein:e Nutzer:in betritt die Komponente am 13. April um 14:01 Uhr.

• Im originalen Workflow würde die/der Nutzer:in am 14. April um 14 Uhr zum nächsten Schritt übergehen, was weniger als ein Tag nach dem Eintrittszeitpunkt ist.
• Im aktuellen Editor würde die/der Nutzer:in am 15. April um 14 Uhr zum nächsten Schritt übergehen. Beachten Sie, dass dies die gleiche Uhrzeit ist, aber mehr als ein Tag nach dem Eintrittszeitpunkt.

Verhalten bei intelligentem Timing

Da intelligentes Timing in der Nachrichtenkomponente gespeichert ist, werden Verzögerungen vor den Berechnungen des intelligenten Timings angewendet. Das bedeutet, dass Nutzer:innen die Nachricht je nach Eintrittszeitpunkt in die Komponente möglicherweise später erhalten als in einem Canvas, das mit dem originalen Canvas-Workflow erstellt wurde.

Nehmen wir an, Ihre Verzögerung ist auf 2 Tage eingestellt, intelligentes Timing ist aktiviert und hat ermittelt, dass die beste Sendezeit für Ihre Nachricht 14 Uhr ist. Ein:e Nutzer:in betritt den Verzögerungsschritt um 14:01 Uhr.

• Aktueller Workflow: Es dauert 48 Stunden, bis die Verzögerung abgelaufen ist, sodass die/der Nutzer:in die Nachricht am dritten Tag um 14 Uhr erhält.
• Originaler Workflow: Die/der Nutzer:in erhält die Nachricht am zweiten Tag um 14 Uhr.

Beachten Sie, dass bei aktiviertem intelligentem Timing die Nachricht innerhalb von 24 Stunden nach dem Eintritt der/des Nutzer:in in die Nachrichtenkomponente zur ermittelten intelligenten Zeit gesendet wird (auch wenn keine Verzögerungskomponente beteiligt ist).

Ausnahme-Events

Ruhezeiten

Ausnahme-Events werden über Aktionspfade angewendet, die von Nachrichtenschritten getrennt sind. Ruhezeiten werden in der Nachrichtenkomponente durchgesetzt. Das bedeutet: Wenn ein:e Nutzer:in den Aktionspfad-Schritt bereits passiert hat (und nicht durch das Ausnahme-Event ausgeschlossen wurde) und dann bei der Nachrichtenkomponente auf Ruhezeiten trifft, wobei das Canvas so konfiguriert ist, dass die Nachricht nach der Ruhezeitperiode erneut gesendet wird, wird das Ausnahme-Event nicht mehr angewendet. Beachten Sie, dass dieser Anwendungsfall nicht häufig vorkommt.

Für Segmente und Filter bietet der Nachrichtenschritt Zustellungsvalidierungen, mit denen Nutzer:innen zusätzliche Segmente und Filter konfigurieren können, die zum Sendezeitpunkt überprüft werden. Dies verhindert den oben genannten Ruhezeiten-Grenzfall.

Zeitplaneinstellung „in“ oder „zum nächsten“

Ausnahme-Events werden über Aktionspfade erstellt. Aktionspfade unterstützen nur „nach einem Zeitfenster von X“ und nicht „in X Zeit“ oder „zum nächsten X Zeitpunkt“.

Was sollte ich bei einem Support-Ticket für einen „Request Timed Out“-Fehler angeben?

Wenn beim Bearbeiten eines Canvas der Fehler „Request Timed Out“ auftritt und Sie den Braze-Support kontaktieren müssen, geben Sie die folgenden Informationen an, um eine schnellere Lösung zu ermöglichen:

• Bildschirmaufnahme: Eine Aufnahme der Schritte, die Sie vor dem Auftreten des Fehlers durchgeführt haben, einschließlich aller Seitenwechsel.
• Zeitstempel und Zeitzone: Der genaue Zeitpunkt, zu dem der Fehler aufgetreten ist, und Ihre Zeitzone.
• Browser und Version: Der Browser, den Sie verwenden (zum Beispiel Chrome 120, Safari 17), und ob Sie versucht haben, den Fehler in einem anderen Browser zu reproduzieren.
• Schritte zur Reproduktion: Eine klare Beschreibung der Aktionen, die den Fehler triggern, einschließlich aller spezifischen Canvas-Schritte oder Konfigurationen, die beteiligt sind.
• Netzwerkprotokolle (optional): Öffnen Sie die Entwicklertools Ihres Browsers (Tab Network), reproduzieren Sie den Fehler und exportieren Sie das Netzwerkprotokoll als HTTP-Archive-Datei (HAR). Dies hilft dem Support-Team festzustellen, welcher API-Aufruf ein Timeout verursacht.

Canvas-Zustellung und Fehlerbehebung

Sind verwaiste Nutzer:innen berechtigt, Canvas-Nachrichten zu empfangen?

Nein. Verwaiste Nutzer:innen sind nicht berechtigt, Nachrichten zu empfangen. Wenn ein Profil verwaist wird, während sich ein:e Nutzer:in in einer Canvas-Journey befindet, verlässt er/sie den Flow still. Analytics zeigen möglicherweise nicht immer ein Exited-Event für diesen Exit an, und die Workflow-Zusammenfassung kann ein partial_update_token ohne exited_date oder exit_reason enthalten.

Weitere Informationen zu Zusammenführungen und verwaisten Profilen finden Sie unter Doppelte Nutzer:innen zusammenführen.

Wenn ich ein aktives Canvas oder eine aktive Campaign stoppe, werden bereits an den ESP gesendete Nachrichten trotzdem zugestellt?

Ja. Nachdem Braze eine Anfrage an Ihren E-Mail-Anbieter (ESP) gesendet hat, kann Braze diesen Versand nicht zurückrufen. Das Stoppen eines Canvas oder einer Campaign verhindert neue Versandanfragen, aber bereits an den ESP übergebene Nachrichten können weiterhin zugestellt werden und die Versandzähler erhöhen, während der ESP sie verarbeitet.

Dies entspricht dem Verhalten, das unter Stoppen eines Canvas beschrieben wird: E-Mail-Versendungen, die sich bereits in Zustellung befinden, werden nicht sofort angehalten.

Wie kann ich bestätigen, dass ein Canvas-Webhook-Schritt ohne sichtbaren Nutzerinhalt ausgelöst wurde?

Braze erfasst Webhook-Versendungen und zugehörige Zustellungsergebnisse für Webhook-Schritte in Campaigns und Canvases. Verwenden Sie die Schritt-Analytics, Webhook-Reporting oder Currents-Webhook-Events, um zu bestätigen, dass der Schritt ausgeführt wurde. Die Anfrage-Logs Ihres Endpunkts bieten eine zusätzliche Bestätigung, wenn Sie einen serverseitigen Empfangsnachweis benötigen.

Braze enthält kein eingebautes unsichtbares Tracking-Pixel für Webhook-Schritte. Verlassen Sie sich auf Braze-Webhook-Metriken und Ihr Endpunkt-Logging anstelle von benutzerdefinierten Ein-Pixel-Bildanfragen.

Warum hat mein Webhook-Schritt kein Body-Feld?

Webhook-Schritte verwenden einen Request-Body für POST, PUT, PATCH und DELETE. Wenn Sie die Methode auf GET umstellen, entfernt Braze das Body-Feld, da GET-Anfragen keinen Request-Body unterstützen. Wechseln Sie zurück zu einer Methode mit Body-Unterstützung, wenn Sie JSON- oder Formulardaten senden müssen. Details zu den Methoden finden Sie unter Einen Webhook erstellen.

Wie verwende ich spacer.gif in einem Webhook-Schritt?

Braze hostet ein spacer.gif-Platzhalterbild auf cdn.braze.com und braze-images.com. Einige Teams verwenden eine Webhook-URL, die auf dieses Bild zeigt, wenn ein Schritt ausgelöst werden muss, ohne einen externen Endpunkt aufzurufen. Standard-Webhook-Schritte sollten einen echten Endpunkt aufrufen. Verwenden Sie Webhook-Reporting und Ihre Endpunkt-Logs, um die Zustellung zu bestätigen, wie unter Wie kann ich bestätigen, dass ein Canvas-Webhook-Schritt ohne sichtbaren Nutzerinhalt ausgelöst wurde? beschrieben.

Warum lädt mein Canvas nicht und zeigt einen „invalid next-step-id“-Fehler an?

Dieser Konsolenfehler bedeutet, dass mindestens ein Schritt auf einen fehlenden oder ungültigen nächsten Schritt verweist – zum Beispiel nach einem teilweisen Löschen, Klonen oder Import. Öffnen Sie das Canvas im Editor, verbinden Sie verwaiste Schritte erneut oder entfernen Sie Schritte, die keinen gültigen nachgelagerten Pfad mehr haben. Wenn das Canvas immer noch nicht lädt, wenden Sie sich an den Braze-Support mit der Canvas-ID und einem Screenshot des Konsolenfehlers.

Warum unterscheidet sich ein Canvas-Konversions-Zeitstempel in Currents von meinen Canvas-Analytics?

Currents protokolliert Canvas-Konversionen als users.canvas.Conversion-Events. Die Event-time ist der Zeitpunkt, zu dem das Konversions-Event aufgetreten ist. Das Feld conversion_behavior dieses Events beschreibt die Konversionsdefinition (Typ und Zeitfenster). Canvas-Analytics können Konversionen auch relativ zum Canvas-Entry innerhalb des Konversionsfensters zusammenfassen. Vergleichen Sie beim Abgleich von Exporten die Currents-time mit dem Zeitstempel des Konversions-Events und Ihren Canvas-Konversionsfenster-Einstellungen.

Warum ist canvas_step_name in Currents null?

Campaign- und Canvas-Namensfelder wie canvas_step_name können null sein, wenn ein Currents-Event gesendet wird, bevor Braze die Schritt-Metadaten vollständig übermittelt hat – zum Beispiel nachdem Sie einen Schritt erstellt oder umbenannt haben. Details finden Sie unter Warum ist der Campaign-Name oder Canvas-Schrittname NULL in meinen Currents-Daten?.

Warum wird mein Array in einem User-Update-Schritt nicht aktualisiert?

Überprüfen Sie das JSON in Ihrem User-Update-Schritt. Array- und verschachtelte Attribut-Updates benötigen gültige Pfade und Werte für das Attribut, das Sie ändern. Fügen Sie keine Felder ein, die der Schritt automatisch bereitstellt, wie z. B. die externe Nutzer-ID. Verwenden Sie den Tab Vorschau und Test des Schritts, um den Payload vor dem Start zu bestätigen.

Kann ich Canvas-Nachrichten an Nutzer:innen ohne external_id senden?

Ja, sofern bereits ein Braze-Nutzerprofil existiert. Nutzer:innen ohne external_id sind anonyme Nutzer:innen und können über eine braze_id oder einen Nutzer-Alias referenziert werden. Erstellen oder aktualisieren Sie das Profil mit dem /users/track-Endpunkt oder Ihrem SDK vor dem Canvas-Entry, und verwenden Sie dann aktionsbasierte oder API-getriggerte Entry. Standard-Canvas-Targeting erfordert weiterhin ein Braze-Nutzerprofil – Sie können keine Canvas-Nachrichten an eine E-Mail-Adresse allein ohne Profil senden.

Warum ist ein:e Nutzer:in seltener in ein Canvas eingetreten als er/sie das Trigger-Event ausgeführt hat?

Bei aktionsbasierten und API-getriggerten Canvases dedupliziert Braze Trigger-Events, sodass ein:e Nutzer:in für dasselbe Canvas höchstens etwa einmal pro Sekunde eintreten kann. Wenn ein:e Nutzer:in dasselbe Trigger-Event mehrmals innerhalb einer Sekunde ausführt, wird nur ein Entry verarbeitet.

Um mehrere Entries in derselben Sekunde zu ermöglichen, planen Sie Trigger-Events mit mindestens 1,1 Sekunden Abstand (zum Beispiel wenn Sie das Event-Timing von Ihrem Server aus steuern). Für Campaign-ähnliches Verhalten, das mehrere gleichzeitige Trigger erlaubt, vergleichen Sie Ihren Anwendungsfall mit Campaigns mit entsprechenden Zeitplan- und Wiederberechtigung-Einstellungen.

Wann werden Nutzer:innen in API-getriggerten Canvases dedupliziert?

Wenn ein:e Nutzer:in erneut in ein API-getriggertes Canvas eintritt und einen Verzögerungsschritt erreicht, in dem er/sie bereits aus einem vorherigen Entry für eine identische Nachricht eingereiht ist, dedupliziert Braze den/die Nutzer:in, um doppelte Versendungen zu vermeiden. Die zweite Canvas-Instanz wird beendet, sodass die Anzahl der Entries die Anzahl der Versendungen übersteigen kann.

Warum wird ein Test-Push an die falsche App zugestellt, aber Live-Versendungen sehen korrekt aus?

Test-Push auf einem Nutzerprofil wird an jedes Push-fähige Gerät für dieses Profil zugestellt. Wenn mehrere Apps auf einem Gerät installiert sind, stellt das Betriebssystem die Testbenachrichtigung in der Regel an die erste verfügbare App zu, die möglicherweise nicht die App ist, die Sie validieren möchten.

Um App-spezifisches Targeting zu bestätigen, senden Sie eine Live- oder Testnachricht über eine Campaign oder ein Canvas mit einer eng eingegrenzten Zielgruppe (zum Beispiel nach external_id filtern), anstatt sich allein auf das Profil-Feature Test-Push zu verlassen.

Aktivieren Sie für Canvas-Nachrichtenschritte mit mehreren Apps die Option Zielgruppe beim Nachrichtenversand validieren im Nachrichtenschritt, damit Segment- und Filterprüfungen zum Zeitpunkt des Versands ausgeführt werden. Weitere Informationen finden Sie unter Nachrichtenschritt.

Zum allgemeinen Test-Push-Verhalten siehe Testnachrichten senden und Push-FAQ.

Wie debugge ich Push Stories auf iOS und Android?

Beginnen Sie mit Push Stories für Einrichtung und kreative Anforderungen. Für Implementierung und Rich-Benachrichtigungs-Handling siehe Rich-Benachrichtigungen und Push Stories im Entwicklerhandbuch.

Wer erhält die E-Mail „Canvas Messages Delayed 24+ Hours“?

Braze sendet diese Benachrichtigung, wenn Canvas-Nachrichten durch Rate-Limiting um 24 Stunden oder länger verzögert werden. Die E-Mail geht an Dashboard-Nutzer:innen, die zuvor Änderungen am betroffenen Canvas vorgenommen haben (basierend auf den Canvas-Änderungsprotokollen). Wenn Braze diese Empfänger:innen nicht ermitteln kann, geht die E-Mail an die Unternehmensadministrator:innen des Workspace.

Wann hört ein:e Nutzer:in auf, Nachrichten nach einem Ausnahme-Event zu erhalten?

Braze erfasst den Exit, sobald das Ausnahme-Event eintritt, aber Nutzer:innen können innerhalb eines Schritts verbleiben, bis Timer abgelaufen sind – am sichtbarsten bei Verzögerungsschritten. Das Verhalten unterscheidet sich auch zwischen geplanten Schritten und Event-getriggerten Schritten. Zeitlinien, Beispiele und Analytics-Nuancen finden Sie unter Exit-Kriterien.

Warum zeigt mein Aktionspfade-Schritt einen Fehler an, wenn ich eine Link-Alias-Interaktion auswähle?

Aktionsgruppen, die E-Mail-Interaktivitäts-Trigger verwenden (zum Beispiel Alias in E-Mail geklickt oder Alias in einer beliebigen Campaign oder einem Canvas-Schritt geklickt), benötigen einen Nachrichtenschritt, der die Nachricht mit diesem Link bereits gesendet hat. Fügen Sie Schritte hinzu oder ordnen Sie sie neu an, damit die E-Mail vor der Auswertung des Aktionspfade-Schritts gesendet wird, oder wählen Sie eine Interaktion, die zu einer Nachricht passt, die der/die Nutzer:in bereits in diesem Canvas erhalten hat. Die vollständige Liste der Interaktions-Trigger finden Sie unter Aktionsbasierte Zustellung.

Wie beeinflussen historische Zeitstempel von angepassten Events aktionsbasierte Canvases und Campaigns?

Braze wertet aktionsbasierte Journeys aus, wenn qualifizierende Events aufgenommen werden und der/die Nutzer:in Ihre Zielgruppenregeln erfüllt. Rückdatierte angepasste Events können einen Canvas-Entry auslösen, wenn der Event-Zeitstempel in das Canvas-Entry-Fenster fällt. Entry oder nachgelagerte Versendungen erfolgen möglicherweise nicht wie erwartet, wenn der Zeitstempel außerhalb dieses Fensters liegt, das Canvas oder die Campaign nicht aktiv war oder der/die Nutzer:in Ihre Zielgruppe noch nicht erfüllt hatte.

Vergleichen Sie Event-Zeitstempel mit den Go-Live-Zeiten, Entry-Fenster-Einstellungen und der Segment-Zugehörigkeit mithilfe des Aktivitätsprotokolls im Nutzerprofil und den Fehlerbehebungsschritten unter Fehlerbehebung bei angepassten Events. Wenn das Verhalten weiterhin nicht den Erwartungen entspricht, wenden Sie sich an den Braze-Support.