Fehlerbehebung für Segmente

Ordnen Sie Ihr Symptom in der folgenden Liste zu, um den richtigen Abschnitt zu finden. Diese Seite behandelt Startfehler, Nutzereignung, Filterprobleme und Analytics-Abweichungen. Filterdefinitionen finden Sie unter Segmentierungsfilter. Informationen zu Segmentgrößenschätzungen, exakten Zählungen und historischen Mitgliedschaftsdiagrammen finden Sie unter Segmentgröße messen.

Hier starten: Symptom zuordnen

Standardmäßiger Untersuchungspfad

Verwenden Sie diesen Workflow, wenn ein:e Nutzer:in in einem Segment sein sollte, es aber nicht ist, oder wenn die Segmentanzahl falsch aussieht.

1. Start blockiert: Wenn Sie bei einer Campaign oder einem Canvas einen Fehler wegen Zielgruppenkomplexität oder einem 10.000-Byte-Filter sehen, beginnen Sie mit Fehler (CSV-Workaround, Filtervereinfachung).
2. Nutzervorschau oder Nutzersuche: Testen Sie eine:n bestimmte:n Nutzer:in gegen Ihre Segmentfilter. Wenn ein:e Nutzer:in einen Teil oder alle Kriterien nicht erfüllt, werden die fehlenden Kriterien zur Fehlerbehebung aufgelistet. Die Schritte finden Sie unter Segmente testen in „Segment erstellen“.
3. Exakte Statistiken berechnen: Wenn die Segmentschätzung 0 Nutzer:innen anzeigt oder falsch erscheint, wählen Sie Exakte Statistiken berechnen im Panel Erreichbare Nutzer:innen aus. Speichern Sie Ihr Segment, bevor Sie die Berechnung starten. Wenn bereits eine Berechnung läuft, warten Sie, bis sie abgeschlossen ist; veraltete Zahlen werden möglicherweise angezeigt, bis die neue Berechnung abgeschlossen ist. Weitere Informationen finden Sie unter Exakte Statistiken berechnen.
4. Filterwerte überprüfen: Achten Sie auf Tippfehler, Datentyp-Abweichungen, veraltete Canvas-Schritt-Referenzen und negative Filter + ODER-Logik.
5. Komplexität prüfen: Wenn der Start blockiert ist, lesen Sie Zielgruppe ist zu komplex für den Start.
6. Support kontaktieren: Wenn Sie weiterhin blockiert sind, wenden Sie sich an den Braze-Support.

Segment zeigt null Nutzer:innen an

Die Segmentgröße im Dashboard basiert häufig auf einer Schätzung anhand einer Stichprobe von Nutzer:innen. Sehr kleine Segmente können einen geschätzten Bereich anzeigen, der 0 enthält, selbst wenn Nutzer:innen Ihren Filtern entsprechen.

• Wählen Sie Calculate exact stats im Panel Reachable users aus, um eine genaue Anzahl zu erhalten. Speichern Sie das Segment zuerst. Weitere Informationen finden Sie unter Überlegungen zu geschätzten Anzahlen.
• Wenn die User Preview für ein kleines Segment null Nutzer:innen zurückgibt, bedeutet das nicht unbedingt, dass das Segment leer ist. Führen Sie Calculate exact stats aus, um dies zu bestätigen. Weitere Informationen finden Sie unter Nutzervorschau.

Rückwirkende Segment-Zugehörigkeit

Braze speichert keine historische Segment-Zugehörigkeit pro Nutzer:in. Sie können nicht nachschlagen, ob ein:e bestimmte:r Nutzer:in zu einem vergangenen Sendezeitpunkt in einem Segment war.

Um die Zugehörigkeit zu einem bestimmten Zeitpunkt festzuhalten, exportieren Sie Nutzer:innen aus dem Segment im Dashboard oder rufen Sie den Endpunkt /users/export/segment auf, bevor Sie eine Campaign oder ein Canvas senden. Weitere Informationen finden Sie unter Segmentierungsfilter (Filter für Segment-Zugehörigkeit) und Segment-Daten als CSV exportieren.

Fehler

Zielgruppe ist zu komplex zum Starten

Dieser seltene Fehler tritt auf, wenn Ihre Zielgruppe zu viele Regex-Werte, übermäßig lange Regex-Werte, übermäßig detaillierte Filter (z. B. „ist eine von 30.000 Postleitzahlen“) oder zu viele Filter enthält. Dies umfasst alle Filter in einer Campaign- oder Canvas-Zielgruppe, unabhängig davon, ob sich die Filter in den referenzierten Segmenten befinden oder als Filter im Schritt Target Audience hinzugefügt wurden.

Wenn Sie Segment-Filter zu einer Campaign oder einem Canvas hinzufügen, werden diese Filter in Abfragen in Braze übersetzt (die Zeichenanzahl dieser Abfragen entspricht nicht 1:1 der Anzahl der Zeichen, die Nutzer:innen im Dashboard sehen). Wenn Braze eine Campaign oder ein Canvas sendet, wird eine Abfrage ausgeführt, die alle Filter in der Zielgruppe kombiniert. Wir wenden einen Schwellenwert an, der die Anzahl der Zeichen in der resultierenden Abfrage für eine Zielgruppe begrenzt. Für eine bestimmte Campaign oder ein bestimmtes Canvas wird die Zeichenanzahl über alle referenzierten Segmente hinweg summiert, einschließlich aller zusätzlichen Filter. Für ein bestimmtes Segment wird die Zeichenanzahl über alle Filter und Filterwerte hinweg summiert.

Ihr Dashboard zeigt einen Fehler an, wenn eine Campaign, ein Canvas oder ein Segment den Schwellenwert überschreitet und nicht gestartet werden kann. Wenn Sie diesen Fehler erhalten, vereinfachen Sie Ihre Zielgruppe vor dem erneuten Starten, einschließlich:

• Wenn Ihre Zielgruppe mehrere Segmente referenziert, stellen Sie sicher, dass die Segmente keine Redundanzen aufweisen, z. B. dieselben Filter in mehreren Segmenten.
• Stellen Sie sicher, dass Sie in Segment-Filtern keine veralteten Daten referenzieren. Ein veralteter Filter könnte beispielsweise nach Nutzer:innen suchen, die in der letzten Woche einen bestimmten Canvas-Schritt nicht erhalten haben, obwohl das Canvas seit Monaten gestoppt ist.
• Segmente, die nur Listen von Nutzer-IDs oder E-Mail-Adressen sind (die häufig einen Regex-Filter verwenden), können in einen CSV-Import konvertiert und zu einem einzelnen CSV-Filter vereinfacht werden.
• Wenn Sie CDI verwenden, können Sie möglicherweise ein CDI-Segment erstellen, das die Gruppe direkt aus Ihrem Data Warehouse abruft.

Sie können auch den Support kontaktieren, um weitere Unterstützung bei der Filteroptimierung zu erhalten.

Hinweis

Wir haben im April 2025 begonnen, die Zeichenanzahl zu begrenzen. Campaigns und Canvases, die vor April 2025 gestartet wurden, waren davon ausgenommen, d. h. sie können den Grenzwert weiterhin überschreiten, während neu erstellte Campaigns und Canvases den Grenzwert nicht überschreiten können. Wenn Sie eine ausgenommene Campaign oder ein ausgenommenes Canvas bearbeiten oder klonen, können Sie sie erst starten, wenn die Zielgruppe so aktualisiert wurde, dass sie unter dem Grenzwert liegt.

X aktive oder gestoppte Campaigns oder Canvases überschreiten den Schwellenwert für die Zielgruppenkomplexität

Dieses Banner wird oben in einer Campaign- oder Canvas-Liste angezeigt, wenn aktive oder gestoppte Campaigns oder Canvases Zielgruppen haben, die den Schwellenwert für die Zielgruppenkomplexität überschreiten. Wählen Sie das Banner aus, um die Liste auf die Campaigns oder Canvases zu filtern, die den Schwellenwert überschreiten, und folgen Sie dann den Schritten zur Fehlerbehebung unter Zielgruppe ist zu komplex zum Starten.

Filter überschreitet 10.000 Bytes oder ist zu lang zum Speichern

Braze begrenzt einzelne Segment-Filter auf maximal 10.000 Bytes, was 10.000 englischen Zeichen oder 3.333 japanischen Zeichen entspricht. Eine Warnung wird angezeigt, wenn ein einzelner Filter 10.000 Bytes überschreitet, unabhängig davon, ob sich der Filter in einem Segment befindet oder direkt zu einer Campaign oder einem Canvas hinzugefügt wurde.

Dieser Fehler tritt sehr selten auf, aber wenn er auftritt, betrifft er typischerweise Regex-Filter, die auf eine Liste von Nutzer-IDs oder E-Mail-Adressen abzielen. In diesem Fall können Sie die folgenden Schritte ausführen, um die Filter in eine CSV-Datei zu konvertieren:

1. Exportieren Sie die Nutzer:innen aus dem betroffenen Segment oder dem spezifischen Regex-Filter.
2. Bereinigen Sie die CSV-Datei nach Bedarf. Sie benötigen entweder die Braze-ID oder die Appboy-ID, aber Sie können alle anderen Spalten entfernen, wenn sie nicht benötigt werden. Wir empfehlen außerdem, Ihre Daten zu überprüfen, um sicherzustellen, dass sie aktuell sind (entfernen Sie beispielsweise Nutzer:innen, die Sie nicht mehr ansprechen möchten).
3. Importieren Sie die CSV-Datei erneut, wodurch die Nutzer:innen automatisch in einen einzelnen, hocheffizienten CSV-basierten Filter gruppiert werden.

Nutzerverhalten

Nutzer:in ist nicht mehr in einem Segment

Wenn ein:e Nutzer:in beim Erstellen eines Segments nicht verfügbar ist, haben sich möglicherweise die Nutzerdaten, die die Segment-Zugehörigkeit bestimmen, durch eigene Aktivitäten oder andere Campaigns und Canvases geändert, mit denen die Person zuvor interagiert hat. Wenn die erneute Berechtigung aktiviert ist, zeigt das Nutzerprofil die aktuellsten Daten der empfangenen Campaign an.

Um zu testen, ob ein:e bestimmte:r Nutzer:in heute Ihrem Segment entspricht, verwenden Sie die Nutzervorschau oder Nutzersuche.

Informationen zu Nutzer:innen anderer Apps werden angezeigt, wenn ich nach einer bestimmten App filtere

Nutzer:innen können mehrere Apps haben. Wenn Sie also eine bestimmte App im Abschnitt Verwendete Apps der Segmentierungsseite auswählen, erhalten Sie Ergebnisse für Nutzer:innen, die mindestens diese App haben. Der Filter liefert keine Ergebnisse für Nutzer:innen, die ausschließlich diese App haben.

Filtern

Filteroptionen haben sich geändert

Ihre Filteroptionen hängen mit dem Format (Datentyp) zusammen, das Sie für Ihre angepassten Attribute an Braze übergeben. Um den Datentyp zu überprüfen, den Braze für Ihre angepassten Attribute erkennt, navigieren Sie zu Dateneinstellungen > Angepasste Attribute.

Wenn sich Ihre Filteroptionen geändert haben, deutet dies darauf hin, dass Ihre Daten in einem anderen Format (Datentyp) als zuvor an Braze übergeben werden. Ausführliche Beschreibungen der verschiedenen Datentypen und ihrer Filteroptionen finden Sie unter Datentypen für angepasste Attribute.

Beachten Sie, dass eine Änderung des Datentyps eines angepassten Attributs im Dashboard dazu führt, dass Daten, die in einem anderen Format an Braze gesendet werden, abgelehnt werden. Sie können den Datentyp eines angepassten Attributs nicht ändern, solange dieses Attribut in aktiven Campaigns, Canvases oder Segments referenziert wird; das Dashboard zeigt einen Fehler an und blockiert die Änderung.

Der Tab Werte eines angepassten Attributs zeigt Ergebnisse aus einer Stichprobe von ungefähr 250.000 Nutzer:innen. Verwenden Sie den Tab Werte nicht, um zur Fehlerbehebung zu bestätigen, ob ein bestimmter Attributwert vorhanden ist. Weitere Informationen finden Sie unter Tab „Werte“.

Verschachteltes angepasstes Attribut ist nicht als Filteroption verfügbar

Wenn Ihr verschachteltes angepasstes Attribut beim Erstellen eines Segments nicht als Filteroption angezeigt wird, generieren Sie zuerst das Schema. Gehen Sie zu Dateneinstellungen > Angepasste Attribute, suchen Sie das Attribut und wählen Sie Schema generieren aus. Nach der Generierung wird das Attribut im Segment-Filter-Dropdown verfügbar. Weitere Informationen finden Sie unter Schema mit dem Explorer für verschachtelte Objekte generieren.

Segment ist viel größer als erwartet

Wenn Ihr Segment trotz restriktiv wirkender Filter viel größer aussieht als erwartet, überprüfen Sie, ob Sie negative Filter (ist nicht, ist nicht gleich, stimmt nicht mit Regex überein oder nicht enthalten) mit dem OR-Operator für dasselbe Attribut mehr als einmal verwenden. Diese Kombination kann Nutzer:innen mit allen Werten für das Attribut ansprechen.

Hinweise dazu, wann Sie AND anstelle von OR verwenden sollten, finden Sie unter Wann der OR-Operator vermieden werden sollte in „Segment erstellen“.

Analytics und Reporting

Gesendete Nachrichten oder Eindeutige Empfänger:innen in Campaign Analytics stimmen nicht mit der Segmentanzahl überein

Wenn die Anzahl der Gesendeten Nachrichten oder Eindeutigen Empfänger:innen in Ihren Campaign Analytics nicht mit der Anzahl der Nutzer:innen im Segmentfilter Has received message from campaign X übereinstimmt, kann dies drei mögliche Ursachen haben.

1. Nutzer:innen wurden seit dem Campaign-Start möglicherweise archiviert, verwaist oder gelöscht
   
   Nehmen wir zum Beispiel an, 1.000 Nutzer:innen erhalten eine Campaign und Sie erstellen am selben Tag einen CSV-Export. Sie sehen 1.000 gemeldete Nutzer:innen. Im Laufe des nächsten Monats werden 50 dieser 1.000 Nutzer:innen gelöscht (zum Beispiel über den Endpunkt users/delete). Wenn Sie einen weiteren CSV-Export erstellen, sehen Sie 950 gemeldete Nutzer:innen, während die Anzahl der Eindeutigen Empfänger:innen in Campaign Analytics weiterhin 1.000 beträgt.
   
   Mit anderen Worten: Die Metrik Eindeutige Empfänger:innen ist ein inkrementierter Zähler, während der Segmentierer und der CSV-Export eine Anzahl der aktuell vorhandenen Nutzer:innen liefern.
   
   

2. Für die Campaign ist eine erneute Berechtigung festgelegt, sodass Nutzer:innen die Campaign mehrfach durchlaufen können
   
   Nehmen wir zum Beispiel an, eine E-Mail-Campaign hat die erneute Berechtigung auf null Minuten eingestellt (Nutzer:innen können die Campaign erneut durchlaufen, solange sie die Anforderungen des Zielgruppen-Segments erfüllen), und die Campaign läuft seit über einem Monat. Die Anzahl der Gesendeten Nachrichten in Campaign Analytics würde nicht mit der Anzahl im Segment übereinstimmen, da dieses Feld auch Nachrichten an doppelte Nutzer:innen enthält.
   
   Das liegt daran, dass Braze eindeutige Nutzer:innen als Eindeutige tägliche Empfänger:innen zählt, also die Anzahl der Nutzer:innen, die eine bestimmte Nachricht an einem Tag erhalten haben. Das bedeutet, dass erneut berechtigte Nutzer:innen mehr als einmal als eindeutige Empfänger:innen gezählt werden, da das „Eindeutigkeits“-Fenster nur einen Tag umfasst. Dies kann dazu führen, dass die Anzahl der Eindeutigen täglichen Empfänger:innen höher ist als die Anzahl der Nutzerprofile im CSV-Export. Die Nutzerprofile in der CSV-Datei sind tatsächlich eindeutig.
   
   

3. Nutzer:innen, die einen Kanalbezeichner teilen, haben den Filter erfüllt
   
   Der Filter Has received message from campaign X (und andere „Empfangen“-Filter) kann Nutzer:innen erfassen, die einen Kanalbezeichner teilen, wie zum Beispiel dasselbe Push-Token oder dieselbe E-Mail-Adresse, mit einem anderen Nutzerprofil, das die Nachricht empfangen, geöffnet oder angeklickt hat.

Nutzer:in wird zwei Apps zugewiesen, obwohl nur in einer App eine Sitzung protokolliert wurde

Beim Erstellen eines Segments können Sie Nutzer:innen ansprechen, die bestimmte Apps verwendet haben. Nutzer:innen müssen eine Sitzung in einer bestimmten App gehabt haben, um dieser App zugewiesen zu werden. Es gibt jedoch zwei Szenarien, in denen Nutzer:innen trotzdem einer bestimmten App zugewiesen werden können, ohne Sitzungen in der App protokolliert zu haben.

Das erste Szenario ist, wenn das Feld app_id bei Verwendung des Endpunkts /users/track befüllt wird – insbesondere bei Verwendung eines Event-Objekts oder Kauf-Objekts, wie in diesem Beispiel:

1
2
3
4
5
6
7
8
9
10
{
    "events": [
    {
      "external_id": "john_doe123",
      "app_id": "my_web_app_id",
      "name": "Custom Event",
      "time": "2025-08-17T19:20:30+1:00"
    }
  ]
}

Das zweite Szenario ist, wenn das Feld app_id bei Verwendung des Endpunkts /users/track zur Migration von Push-Tokens befüllt wird, wie in diesem Beispiel:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"app_group_id": "{YOUR_APP_GROUP_ID}",
"attributes": [
{
      "push_token_import": false,
      "external_id": "external_id1",
      "country": "US",
      "language": "en",
      "{YOUR_CUSTOM_ATTRIBUTE}": "{YOUR_VALUE}",
      "push_tokens": [
        {"app_id": "{APP_ID_OF_OS}", "token": "{PUSH_TOKEN_STRING}"}
      ]
  }
]
}