Fehlerbehebung für Segmente

Ordnen Sie Ihr Symptom unten 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 eine Segmentanzahl falsch aussieht.

1. Start blockiert: Wenn Sie einen Fehler wegen Zielgruppenkomplexität oder 10.000-Byte-Filter bei einer Campaign oder einem Canvas 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. Speichern Sie Ihr Segment vor der Berechnung. Wenn bereits eine Berechnung läuft, warten Sie, bis sie abgeschlossen ist; veraltete Zahlen können angezeigt werden, 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 + OR-Logik.
5. Komplexität prüfen: Wenn der Start blockiert ist, siehe Zielgruppe ist zu komplex zum Starten.
6. Support kontaktieren: Für weitere Unterstützung bei der Filteroptimierung kontaktieren Sie den Support.

Segment zeigt null Nutzer:innen an

Die Segmentgröße im Dashboard ist oft eine Schätzung basierend auf einer Stichprobe von Nutzer:innen. Sehr kleine Segmente können einen geschätzten Bereich anzeigen, der 0 einschließt, selbst wenn Nutzer:innen Ihren Filtern entsprechen.

• Wählen Sie Exakte Statistiken berechnen im Panel Erreichbare Nutzer:innen für eine genaue Zählung. Speichern Sie das Segment zuerst. Weitere Informationen finden Sie unter Hinweise zu geschätzten Zählungen.
• Wenn die Nutzervorschau für ein kleines Segment null Nutzer:innen zurückgibt, bedeutet das nicht unbedingt, dass das Segment leer ist. Führen Sie Exakte Statistiken berechnen aus, um dies zu bestätigen. Weitere Informationen finden Sie unter Nutzervorschau.

Rückwirkende Segmentzugehörigkeit

Braze speichert keine historische Segmentzugehörigkeit pro Nutzer:in. Sie können nicht nachschlagen, ob ein:e bestimmte:r Nutzer:in zum Zeitpunkt eines vergangenen Versands in einem Segment war.

Um die Zugehörigkeit zu einem bestimmten Zeitpunkt zu erfassen, 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 (Segmentzugehörigkeitsfilter) und Segmentdaten 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 einer 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 Zielgruppe hinzugefügt wurden.

Wenn Sie Segmentfilter 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 ein:e Dashboard-Nutzer:in sieht). 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 summieren wir die Zeichenanzahl über alle referenzierten Segmente hinweg, einschließlich aller zusätzlichen Filter. Für ein bestimmtes Segment summieren wir die Zeichenanzahl über alle Filter und Filterwerte hinweg.

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 keine veralteten Daten in Segmentfiltern referenzieren. Beispielsweise könnte ein veralteter Filter 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 in einen 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 es nicht starten, bis die Zielgruppe aktualisiert wurde, um unter dem Grenzwert zu liegen.

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 Segmentfilter auf maximal 10.000 Bytes, was 10.000 englischen Zeichen oder 3.333 japanischen Zeichen entspricht. Eine Warnung erscheint, 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 Segmentzugehörigkeit bestimmen, aufgrund eigener Aktivitäten oder anderer Campaigns und Canvases geändert, mit denen sie zuvor interagiert haben. Wenn die erneute Berechtigung aktiviert ist, zeigt das Nutzerprofil die neuesten 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 werden für Nutzer:innen anderer Apps angezeigt, wenn ich nach einer bestimmten App filtere

Nutzer:innen können mehrere Apps haben, sodass die Auswahl einer bestimmten App im Abschnitt Apps Used der Segmentierungsseite Ergebnisse für Nutzer:innen liefert, 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 Ihr angepasstes Attribut 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. Detaillierte Beschreibungen der verschiedenen Datentypen und ihrer Filteroptionen finden Sie unter Datentypen für angepasste Attribute.

Beachten Sie, dass das Ändern des Datentyps eines angepassten Attributs im Dashboard Daten ablehnt, die in einem anderen Format an Braze gesendet werden. Sie können den Datentyp eines angepassten Attributs nicht ändern, solange dieses Attribut in aktiven Campaigns, Canvases oder Segmenten 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 zu bestätigen, ob ein bestimmter Attributwert zur Fehlerbehebung existiert. Weitere Informationen finden Sie unter Tab „Werte“.

Segment ist viel größer als erwartet

Wenn Ihr Segment trotz restriktiv wirkender Filter viel größer aussieht als erwartet, prü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 statt OR verwenden sollten, finden Sie unter Wann Sie den OR-Operator vermeiden sollten in „Segment erstellen“.

Analytics und Berichterstattung

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

Wenn die Anzahl für Gesendete Nachrichten oder Eindeutige 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 Gründe haben.

1. Nutzer:innen wurden möglicherweise seit dem Campaign-Start archiviert, verwaist oder gelöscht
   
   Nehmen wir beispielsweise 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 (z. B. ü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. Die Campaign hat eine erneute Berechtigung eingestellt, sodass Nutzer:innen die Campaign mehrfach betreten können
   
   Nehmen wir beispielsweise an, eine E-Mail-Campaign hat die erneute Berechtigung auf null Minuten eingestellt (Nutzer:innen können die Campaign erneut betreten, solange sie die Anforderungen des Zielgruppensegments 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 Nachrichten enthält, die an doppelte Nutzer:innen gesendet wurden.
   
   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:r Empfänger:in gezählt werden, da das Eindeutigkeitsfenster nur einen Tag dauert. 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 wirklich eindeutig.
   
   

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

Nutzer:in ist 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. Ein:e Nutzer:in muss eine Sitzung in einer bestimmten App gehabt haben, um dieser App zugewiesen zu werden. Es gibt jedoch zwei Szenarien, in denen ein:e Nutzer:in einer bestimmten App zugewiesen werden kann, ohne Sitzungen in der App protokolliert zu haben.

Das erste Szenario ist, wenn das Feld app_id bei Verwendung des Endpunkts /users/track ausgefü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 zum Migrieren von Push-Tokens ausgefü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}"}
      ]
  }
]
}