Zum Inhalt springen

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, ob Analytics-Tracking aktiviert ist, enthalten.

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 über einen bestimmten Zeitraum hinweg 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. Dieser Endpunkt ist daher die Möglichkeit, sie über die API zu 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 nicht rückwirkend auf, die vor der Aktivierung des Trackings liegen. Prüfen Sie, dass 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. Ein Workspace kann Tracking für bis zu 25 Segmente aktiviert haben. 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 den Filter Advanced Tracking Segments Only auf der Seite Segments aus. Verwenden Sie diesen Endpunkt, wenn Sie die Antwort in einem Skript oder einem geplanten Job benötigen.

Dieser Endpunkt liest die Tracking-Einstellung 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 Nutzer:innen-Tracking-Workflows ab. Verwenden Sie für die Segment-Endpunkte eine id aus der Antwort dieses Endpunkts als segment_id.

Endpunkt Wie er Ihren Nutzer:innen-Tracking-Workflow 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 gegebene segment_id ab.
Endpunkt „Segment-Analytics exportieren“ Ruft die geschätzte Größe eines Segments über einen bestimmten Zeitraum ab.
/users/export/segment-Endpunkt Exportiert die Nutzer:innenprofile in einem Segment, damit Sie überprüfen können, ob die gesendeten Attribute, angepassten Events und Käufe in den Profilen angekommen sind.

Endpoint reference

This reference is generated from the OpenAPI specification for this endpoint. To run the endpoint, copy the generated cURL example and send it from your terminal or Postman. You can also download the raw OpenAPI spec for this page at /docs/de/assets/api/openapi/export_segments_get_segment.yaml. Use this spec to validate that your requests include the correct parameters, fields, and structure before you send them. To learn how, see Use OpenAPI schemas for request validation.

New Stuff!