Preguntas frecuentes
Esta página ofrece respuestas a algunas preguntas frecuentes sobre Currents.
¿Puedo exportar datos de Campaign o Canvas para un periodo de fechas específico?
Para obtener métricas de Campaign o Canvas en un intervalo de fechas definido, usa uno de los siguientes enfoques:
- Si te interesa date-aligned campaign or Canvas exports for dashboard-style reporting outside standard API windows, envía comentarios sobre el producto.
- Llama a los endpoints de análisis de Campaign o análisis de Canvas con los parámetros
ending_atylength(o usa/campaigns/data_seriesy/canvas/data_series) para datos de series temporales. - Transmite eventos a tu almacén de datos con Currents cuando necesites datos de participación en mensajes continuos y consultables en Amazon S3, Azure Blob Storage u otro destino compatible.
¿Cómo edito una integración de Currents en vivo?
Para cambiar un conector de Currents en vivo, abre la integración y selecciona Editar. Sin Editar, la interfaz de la integración permanece en modo de solo lectura y no puedes modificar la configuración del conector únicamente desde los iconos.
¿Cómo gestiona Braze los archivos Avro de Azure Blob Storage después de la carga?
Braze no modifica los archivos Avro en Microsoft Azure Blob Storage una vez completada la carga. Azure puede bloquear la eliminación de un blob mientras una carga aún está en curso.
¿Cómo puedo obtener datos históricos?
Currents es una transmisión de datos en vivo y en tiempo real, lo que significa que los eventos no se pueden reproducir. Sin embargo, puedes almacenar los datos de Currents en un almacén de datos como Amazon S3 o Microsoft Azure Blob Storage, para que puedas actuar sobre eventos pasados como consideres conveniente. Los datos se conservan durante 30 días, pero para obtener datos más históricos, puedes realizar consultas en Snowflake.
¿Por qué Currents produce datos en formato Avro en lugar de JSON?
Avro, a diferencia de JSON (que carece de esquema), admite de forma nativa la evolución de esquemas. También te beneficiarás de la posibilidad de enviar archivos Avro con menos ancho de banda y ahorro de espacio de almacenamiento, ya que Avro es altamente comprimible.
¿Cómo gestiona Braze la sobrecarga de archivos?
Creamos un proceso de extraer, transformar, cargar (ETL), que te permite extraer grandes cantidades de datos de una base de datos para colocarlos y almacenarlos en otra.
¿Dónde debo almacenar estos datos para consultarlos?
Braze se ha asociado con varios almacenes de datos en los que puedes almacenar tus datos para consultarlos. Te recomendamos usar:
¿Qué tan fiable es la información de Currents?
Currents garantiza una entrega “al menos una vez”, lo que significa que ocasionalmente pueden escribirse eventos duplicados en tu contenedor de almacenamiento. Si tu caso de uso requiere una entrega exactamente una vez, puedes deduplicar eventos utilizando el campo de identificador único (id) que se envía con cada evento. Para más detalles, consulta Semántica de entrega de eventos.
¿Con qué frecuencia se sincronizan los datos con Currents?
Los datos se transmiten de forma continua. Braze envía un lote de eventos cada vez que hay un lote completo para enviar, o cada 5 minutos, lo que ocurra primero. Para conectores de alto volumen, los datos llegan casi en tiempo real. Para conectores de bajo volumen, los datos pueden tardar entre 5 y 30 minutos en llegar. Para más detalles, consulta Umbral de escritura Avro.
Si un dispositivo no está conectado a Internet, puede haber un retraso en la creación del evento. Esto es más frecuente con los eventos de mensajes dentro de la aplicación, ya que estos pueden activarse sin conexión.
¿Cómo encuentro qué eventos están disponibles para Currents?
Para obtener una lista completa de los eventos que Currents registra, consulta los glosarios de Eventos de comportamiento del cliente y Eventos de interacción con mensajes. Puedes filtrar estos glosarios por tipo de evento (como envíos, entregas o aperturas).
¿Por qué los recuentos de eventos de Currents no coinciden con las métricas de mi panel o de mi informe de participación?
Currents y el panel de Braze calculan ciertas métricas de forma diferente, por lo que no se esperan coincidencias exactas entre los eventos de Currents y las métricas del panel.
Clics únicos: En el caso del correo electrónico, el panel realiza un seguimiento de los clics únicos durante un período de siete días y los mide por dispatch_id. Currents registra cada evento de clic sin procesar. Para alinear los recuentos de clics únicos basados en Currents con las métricas del panel, filtra por los eventos en los que is_unique sea true.
Cancelaciones de suscripción: La métrica Unsub del panel refleja los clics en el enlace estándar de cancelación de suscripción de Braze. Las páginas personalizadas de cancelación de suscripción no incrementan esta métrica a menos que actualices al usuario a través de la API. El evento users.messages.email.Unsubscribe de Currents es un evento de clic especializado que se activa cuando un usuario hace clic en un enlace de cancelación de suscripción en el cuerpo o pie del correo electrónico, o a través del encabezado list-unsubscribe. No representa todos los cambios de estado de suscripción de correo electrónico.
Marcas de tiempo y zonas horarias: Todas las marcas de tiempo de Currents están en UTC. Las métricas del panel siguen la zona horaria de tu empresa. Si agregas datos de Currents por día natural sin convertirlos a la zona horaria de tu empresa, los recuentos pueden caer en intervalos de fechas diferentes a los que aparecen en el panel.
Eventos duplicados: Currents ofrece una entrega de al menos una vez, lo que significa que ocasionalmente pueden escribirse eventos duplicados. Deduplica por el campo único id de cada evento antes de comparar los totales con las métricas del panel.
¿Por qué el external_user_id (esquema de Braze: external_id) en mi evento de apertura o clic de correo electrónico de Currents difiere del perfil de usuario en el panel de Braze?
- En el panel de Braze: Cuando un usuario asociado a una dirección de correo electrónico abre o hace clic en un correo electrónico, todos los perfiles de usuario que comparten esa dirección de correo electrónico se marcan como que han abierto o hecho clic en ese correo electrónico. Para más información, consulta ¿Qué ocurre cuando se envía un correo electrónico y varios perfiles tienen la misma dirección de correo electrónico?.
- En Currents: Esa misma apertura o clic se almacena en un único perfil. Braze lo atribuye al perfil que fue originalmente el objetivo del envío, si ese perfil aún comparte la dirección de correo electrónico. De lo contrario, Braze lo atribuye a un perfil seleccionado aleatoriamente entre los que comparten la dirección de correo electrónico.
Debido a esto, el valor de external_user_id (llamado external_id en la tabla de mapeado del esquema de Braze) en un evento de apertura o clic de correo electrónico de Currents puede no coincidir con el perfil de usuario que esperas cuando comparas Currents con el panel de Braze.
¿Todos los eventos de envío se registran en Currents?
Todos los eventos se registran en Currents. No hay escenarios en los que un evento se suprima intencionalmente del flujo de Currents.
¿Pueden corromperse los datos en Currents?
En circunstancias normales, los datos de Currents no se corrompen. Aunque siempre existe la posibilidad de un problema poco frecuente, no se conocen condiciones en las que los datos se corrompan de forma sistemática.
¿Por qué veo datos de eventos personalizados con fechas anteriores a la configuración de mi integración de Currents?
Braze no rellena eventos de forma retroactiva en Currents. Sin embargo, los eventos personalizados pueden registrarse con una marca de tiempo pasada (por ejemplo, si un dispositivo estaba sin conexión cuando ocurrió el evento y se sincronizó después). En estos casos, la marca de tiempo del evento refleja cuándo ocurrió originalmente el evento, lo que puede ser anterior a la configuración de la integración de Currents.
¿Qué identificadores de usuario se incluyen en los eventos de Currents?
Los eventos de participación en mensajes (envíos, aperturas, clics, etc.) incluyen el ID de usuario de Braze (user_id) y, cuando está presente en el perfil, el identificador externo (external_user_id en las cargas útiles de los eventos, etiquetado como external_id en la tabla de mapeado del esquema de Braze). Algunos eventos de participación en mensajes de correo electrónico también incluyen email_address. Los atributos personalizados no se incluyen.
Si estás enrutando datos de Currents a un almacén de datos o CRM y necesitas hacer un join con datos de perfil, realiza esa unión en tu sistema posterior utilizando user_id o external_user_id.
¿Puedo incluir atributos personalizados en los eventos de envío de Currents?
No. Currents no incluye atributos personalizados en los eventos de envío. Currents registra eventos personalizados y eventos de participación en mensajes. Para obtener una lista completa de los campos disponibles, consulta los glosarios de eventos.
¿Currents incluye etiquetas de Campaign o Canvas o pares clave-valor?
No. Currents no incluye etiquetas de Campaign o Canvas ni pares clave-valor a nivel de mensaje. Para recuperar datos de etiquetas, utiliza la API REST de exportación. Como alternativa, puedes usar un canal de webhook en una Campaign para enviar datos de etiquetas o pares clave-valor a tu propio endpoint, utilizando Liquid para plantillar los valores.
¿Cómo notifica Braze a los clientes sobre los cambios en Currents?
En el caso poco frecuente en que ocurran cambios que interrumpan el servicio, Braze envía un correo electrónico con antelación al contacto de cualquier integración activa y a todos los administradores con integraciones de Currents activas que hayan utilizado el panel en los últimos 30 días. Para cambios que no interrumpan el servicio, como nuevos eventos o nuevos campos en un evento existente, Braze no envía ninguna notificación. Puedes consultar el registro de cambios de Currents para ver los cambios más recientes.
¿Cuánto almacenamiento necesito para los datos de Currents?
Los requisitos de almacenamiento dependen del volumen de eventos y de los tipos de eventos que estés exportando. Braze proporciona eventos de ejemplo en formato Avro que puedes usar para estimar el tamaño de los archivos en tu caso de uso.
¿Por qué el nombre de la Campaign o del paso en Canvas aparece como NULL en mis datos de Currents?
Cuando creas una nueva Campaign o Canvas, el nombre puede tardar un tiempo en propagarse a todos los sistemas de Braze. Los eventos enviados a través de Currents durante este intervalo pueden tener NULL en los campos de nombre (como campaign_name o canvas_step_name). Esto también es esperable si el nombre se modificó poco antes de que los eventos se registraran. Para evitarlo, espera un tiempo después de crear o cambiar el nombre de una Campaign o un paso en Canvas antes de realizar el envío.
¿Por qué los eventos de fin de sesión se retrasan o no aparecen en Currents?
Los eventos de fin de sesión siguen el calendario normal de carga del SDK. El SDK de Braze almacena en caché los datos de sesión de forma local y los envía periódicamente en función de la calidad de la red; por ejemplo, aproximadamente cada 10 segundos con una conexión fuerte. Hasta que el SDK carga el evento, este no aparece en Currents.
Si un usuario fuerza el cierre de la aplicación o pierde la conexión antes del siguiente envío, el evento de fin de sesión puede llegar con retraso o no llegar en absoluto. En iOS, los eventos de fin de sesión a menudo no se envían hasta que la aplicación se vuelve a abrir, ya que el SDK no puede enviar datos mientras la aplicación está en segundo plano.
Cuando necesites límites de sesión más oportunos en Currents, llama a requestImmediateDataFlush() en puntos del ciclo de vida, como cuando la aplicación pasa a segundo plano o vuelve a primer plano. Para obtener más información, consulta Carga y descarga de datos y El fin de sesión y el inicio de sesión tienen marcas de tiempo similares (iOS).
¿Qué ocurre si mi contenedor de almacenamiento no está disponible cuando Currents intenta escribir datos?
Si tu contenedor de almacenamiento no está disponible en el momento de la transferencia de datos, esos datos se pierden. Braze no puede rellenar los eventos que no se entregaron correctamente. Para evitar la pérdida de datos, asegúrate de que tu contenedor de almacenamiento esté disponible y correctamente configurado en todo momento.
¿Por qué veo mensajes de límite de derechos al crear o editar una integración de Currents?
Currents utiliza grupos de derechos separados para las distintas capacidades de los conectores:
- Eventos de participación: necesarios para crear o actualizar un conector estándar de Currents.
- Eventos de comportamiento del cliente: necesarios para habilitar Track Customer Behavior and User Events.
- Perfiles y atributos de usuario: necesarios para habilitar Track user profiles and attributes.
Si algún grupo se agota, Braze muestra una advertencia de derechos y bloquea esa acción. Ponte en contacto con tu director de cuentas de Braze para solicitar derechos adicionales o ayuda para ajustar tu configuración.
¿Con qué frecuencia cambia la versión de Currents en la ruta de almacenamiento?
El segmento version=<currents_version> en la ruta de almacenamiento avanza con cada lanzamiento de Currents en una cadencia mensual (por ejemplo, de version=6 a version=7). Recomendamos leer los archivos de forma recursiva desde la ruta raíz en lugar de codificar un segmento de versión específico, de modo que tu pipeline recoja automáticamente los datos tras un cambio de versión. Para más detalles sobre el formato de la ruta, consulta Semántica de entrega de eventos. Para un historial de cambios por versión, consulta el Registro de cambios de Currents.
¿Por qué faltan campaign_id o canvas_id en un evento de participación de mensaje?
Dependiendo del tipo de evento y del contexto, un evento de participación de mensaje puede no estar vinculado a una Campaign o un paso en Canvas específicos. En esos casos, campaign_id, canvas_id y los campos de nombre relacionados pueden omitirse de la carga útil del evento. Si no ves esos campos en un evento determinado, comprueba si ese tipo de evento y contexto normalmente incluyen identificadores de Campaign o Canvas.
¿Por qué las marcas de tiempo de Currents están limitadas a precisión de segundos?
El campo time en los eventos de Currents se almacena como un entero de 32 bits y, por lo tanto, está limitado a precisión de segundos. Algunos eventos también incluyen un campo de marca de tiempo separado de 64 bits con precisión de milisegundos; consulta el glosario de eventos para ver los campos disponibles en cada tipo de evento.
¿Por qué el evento users.canvas.Conversion de Currents tiene una hora distinta a la de Canvas?
La hora del evento users.canvas.Conversion en Currents refleja la ventana de conversión total —la duración de Canvas más el plazo de conversión— medida desde la entrada en Canvas.
¿Qué ocurre cuando los informes de participación se envían a S3?
Si las credenciales de S3 están configuradas para exportación de datos, pero no para Currents, Braze sube los informes de participación al contenedor de S3 especificado. El usuario indicado en el campo Send Report To recibe un correo electrónico con un enlace al informe en S3.
¿Se pueden enviar datos de usuarios anónimos a Amplitude a través de Braze Currents?
Los datos de usuarios anónimos, identificados por device_id, se pueden enviar a Amplitude a través de Currents. Esto requiere la habilitación de la característica por parte de tu equipo de cuentas de Braze.
¿Cómo se registran los usuarios del grupo de control en Currents para Content Cards, mensajes dentro de la aplicación y Banners?
Cuando un usuario se asigna a un grupo de control para una Campaign de Content Cards o de mensajes dentro de la aplicación, Currents emite un evento users.campaigns.EnrollInControl en lugar de un evento de impresión.
Las Campaigns de Banners funcionan de manera diferente. Los usuarios de control no se registran en users.campaigns.EnrollInControl. En su lugar, la exposición al control se registra como un evento users.messages.banner.Impression después de que el SDK registre una impresión, incluso cuando tu integración llama a insertBanner para un Banner de control y oculta el contenedor. Para identificar a los usuarios de control en Currents o en el uso compartido de datos, filtra por el message_variation_id o message_variation_name (Control Group) de la variante de control.
Para consultar los esquemas de tabla, visita Eventos de impresión de Banner y USERS_MESSAGES_BANNER_IMPRESSION_SHARED.
¿Qué ocurre cuando se dirige a un usuario inexistente a través de la API?
Cuando te diriges a un usuario que no existe, la API devuelve una respuesta 200, pero el envío se cancela con el resultado “Unknown external ID”. No se generan eventos de Currents para ese envío. Ten en cuenta que el parámetro send_to_existing_only tiene como valor predeterminado true, por lo que los envíos a usuarios desconocidos se omiten silenciosamente a menos que lo establezcas explícitamente en false.