Zum Inhalt springen

Diese Seite wurde automatisch übersetzt und kann Ungenauigkeiten enthalten. Um einen Übersetzungsfehler zu melden, nutzen Sie das Feedback unten im Inhaltsverzeichnis rechts auf der Seite.

Liste der Segmente exportieren

get

/segments/list

Verwenden Sie diesen Endpunkt, um eine Liste von Segmenten zu exportieren, die jeweils den Namen, den Segment-API-Bezeichner und die Angabe enthalten, ob Analytics-Tracking aktiviert ist.

Die Segmente werden in Gruppen von 100 zurückgegeben, sortiert nach dem Zeitpunkt der Erstellung (standardmäßig vom ältesten zum neuesten). Archivierte Segmente sind nicht enthalten.

Wann Sie diesen Endpunkt verwenden sollten

Sie senden Events und Käufe mit dem /users/track-Endpunkt an Braze. Um diese Daten für ein Segment im Zeitverlauf einzusehen, muss für das Segment Analytics-Tracking aktiviert sein. Das Feld analytics_tracking_enabled in der Antwort dieses Endpunkts zeigt an, für welche Segmente es aktiviert ist.

Der Endpunkt „Segmentdetails exportieren“ gibt diese Einstellung nicht zurück. Über diesen Endpunkt können Sie sie daher per API prüfen.

Verwenden Sie diesen Endpunkt für Folgendes:

Bestätigen, dass Tracking aktiviert ist, bevor Sie neue Daten senden. Braze füllt Umsatz- und Kaufdaten aus der Zeit vor der Aktivierung des Trackings nicht rückwirkend auf. Prüfen Sie zuerst, ob analytics_tracking_enabled für die Segmente, die Sie vergleichen möchten, auf true gesetzt ist.
Leere Segmentberichte untersuchen. Wenn die Berichte zu Sitzungen, angepassten Events oder Umsatz eines Segments leer sind, prüfen Sie, ob analytics_tracking_enabled auf false steht, bevor Sie Ihre Integration debuggen.
Ihre getrackten Segmente zählen. In einem Workspace kann Tracking für bis zu 25 Segmente aktiviert sein. Verwenden Sie den Parameter page, um jede Seite abzurufen, und zählen Sie dann die Segmente, bei denen analytics_tracking_enabled den Wert true hat, um zu sehen, wie viele noch verfügbar sind.

Um einige wenige Segmente einmalig zu prüfen, wählen Sie auf der Seite Segments den Filter Advanced Tracking Segments Only aus. Verwenden Sie diesen Endpunkt, wenn Sie die Antwort in einem Skript oder einem geplanten Job benötigen.

Dieser Endpunkt liest die Tracking-Einstellung nur aus und ändert sie nicht. Um Tracking zu aktivieren, öffnen Sie den Abschnitt Segment Details eines Segments und aktivieren Sie Analytics Tracking.

Diesen Endpunkt mit anderen Endpunkten kombinieren

Diese Endpunkte decken den Rest des Workflows für das Nutzer:innen-Tracking ab. Verwenden Sie für die Segment-Endpunkte eine id aus der Antwort dieses Endpunkts als segment_id.

Endpunkt	Wie er Ihren Workflow für das Nutzer:innen-Tracking unterstützt
`/users/track`-Endpunkt	Zeichnet die angepassten Events, Käufe und Attribut-Updates auf, über die Ihre getrackten Segmente berichten.
Endpunkt „Segmentdetails exportieren“	Ruft die Filterbeschreibung und Tags eines Segments für eine bestimmte `segment_id` ab.
Endpunkt „Segment-Analytics exportieren“	Ruft die geschätzte Größe eines Segments im Zeitverlauf ab.
`/users/export/segment`-Endpunkt	Exportiert die Nutzerprofile in einem Segment, damit Sie überprüfen können, ob die gesendeten Attribute, angepassten Events und Käufe in den Profilen angekommen sind.

Tipp

Hilfe zu CSV- und API-Exporten finden Sie unter Fehlerbehebung beim Export.

Sie können das OpenAPI-Dokument herunterladen und damit Schemas validieren. Wie das funktioniert, erfahren Sie unter OpenAPI-Schemas zur Validierung von Anfragen verwenden.

New Stuff!