Ir al contenido

Esta página fue traducida automáticamente y puede contener errores. Para informar de un error de traducción, usa el componente de comentarios situado bajo el sumario, a la derecha de la página.

Exportar lista de segmentos

get

/segments/list

Utiliza este endpoint para exportar una lista de segmentos, cada uno de los cuales incluye su nombre, identificador de API de Segment y si tiene habilitado el seguimiento de análisis.

Los segmentos se devuelven en grupos de 100 ordenados por hora de creación (de más antiguo a más reciente de forma predeterminada). No se incluyen los segmentos archivados.

See me in Postman

Cuándo usar este endpoint

Envías eventos y compras a Braze con el endpoint /users/track. Para ver esos datos a lo largo del tiempo para un segmento, el segmento necesita tener activado el seguimiento de análisis. El campo analytics_tracking_enabled en la respuesta de este endpoint muestra qué segmentos lo tienen activado.

El endpoint Exportar detalles de segmento no devuelve esta configuración, por lo que este endpoint es la forma de verificarlo a través de la API.

Usa este endpoint para lo siguiente:

Confirmar que el seguimiento está activado antes de enviar datos nuevos. Braze no rellena retroactivamente los datos de ingresos y compras anteriores a la activación del seguimiento. Verifica que analytics_tracking_enabled sea true para los segmentos que planeas comparar primero.
Solucionar problemas de informes de segmento vacíos. Si los informes de sesiones, eventos personalizados o ingresos de un segmento están vacíos, comprueba si analytics_tracking_enabled es false antes de depurar tu integración.
Contar tus segmentos con seguimiento. Un espacio de trabajo puede tener el seguimiento activado para un máximo de 25 segmentos. Usa el parámetro page para recuperar cada página y luego cuenta los segmentos donde analytics_tracking_enabled sea true para ver cuántos quedan.

Para verificar unos pocos segmentos una sola vez, selecciona el filtro Solo segmentos con seguimiento avanzado en la página Segments. Usa este endpoint cuando necesites la respuesta en un script o trabajo programado.

Este endpoint lee la configuración de seguimiento y no la modifica. Para activar el seguimiento, ve a la sección Detalles del segmento de un segmento y activa Seguimiento de análisis.

Combinar este endpoint con otros endpoints

Estos endpoints cubren el resto del flujo de trabajo de seguimiento de usuarios. Para los endpoints de segmentos, usa un id de la respuesta de este endpoint como segment_id.

Endpoint	Cómo apoya tu flujo de trabajo de seguimiento de usuarios
Endpoint `/users/track`	Registra los eventos personalizados, compras y actualizaciones de atributos sobre los que informan tus segmentos con seguimiento.
Endpoint Exportar detalles de segmento	Recupera la descripción de filtros y etiquetas de un segmento para un `segment_id` dado.
Endpoint Exportar análisis de segmento	Recupera el tamaño estimado de un segmento a lo largo del tiempo.
Endpoint `/users/export/segment`	Exporta los perfiles de usuario en un segmento, para que puedas verificar que los atributos, eventos personalizados y compras que enviaste se registraron en los perfiles.

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/es/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!