Preguntas frecuentes
Esta página ofrece respuestas a algunas preguntas frecuentes sobre Currents.
¿Puedo exportar datos de Campaign o Canvas para un período de fechas específico?
Para obtener métricas de Campaign o Canvas en un rango de fechas definido, utiliza uno de los siguientes enfoques:
- Envía una solicitud de producto para exportaciones alineadas por fecha cuando necesites informes de estilo panel fuera de las ventanas estándar de la API.
- 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 continuos y consultables de interacción con mensajes en Amazon S3, Azure Blob Storage u otro destino compatible.
¿Cómo edito una integración de Currents en vivo?
Para modificar 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 solo 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 después de que se completa la carga. Azure puede bloquear la eliminación de un blob mientras una carga aún está en curso.
¿Cómo obtengo datos históricos?
Currents es una transmisión de datos en vivo y en tiempo real, lo que significa que los eventos no pueden reproducirse. 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 según te convenga. Los datos se conservan durante 30 días, pero para obtener más datos históricos, puedes consultar Snowflake.
¿Por qué Currents emite los datos en formato Avro y no JSON?
Avro, a diferencia de JSON sin esquema, admite de forma nativa la evolución del esquema. También te beneficiarás de la posibilidad de enviar archivos Avro con menos ancho de banda y ahorrando espacio de almacenamiento, porque Avro es altamente compresible.
¿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 realizar consultas?
Braze está asociado con varios almacenes de datos en los que puedes guardar tus datos para realizar consultas. Recomendamos utilizar:
¿Qué tan fiables son los datos de Currents?
Currents garantiza la 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 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 listo 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, espera que los datos lleguen en un plazo de 5 a 30 minutos. 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 común en los eventos de mensajes dentro de la aplicación, ya que los mensajes dentro de la aplicación pueden desencadenarse sin conexión.
¿Cómo puedo saber qué eventos están disponibles para Currents?
Para obtener una lista completa de los eventos que registra Currents, 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 los informes 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: para el correo electrónico, el panel rastrea 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 los eventos donde 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. Agregar datos de Currents por día calendario sin convertir a la zona horaria de tu empresa puede hacer que los recuentos caigan en contenedores de fechas diferentes a los que aparecen en el panel.
Eventos duplicados: Currents proporciona entrega 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 en 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 abrieron o hicieron 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 solo 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 (denominado external_id en la tabla de mapeo del esquema de Braze) en un evento de apertura o clic de correo electrónico en Currents puede no coincidir con el perfil de usuario que esperas cuando comparas Currents con el panel de Braze.
¿Se registran todos los eventos de envío en Currents?
Todos los eventos se registran en Currents. No hay escenarios en los que un evento se suprima intencionalmente de la transmisión 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 retroactivamente 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, 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 interacción con 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 eventos, etiquetado como external_id en la tabla de mapeo del esquema de Braze). Algunos eventos de interacción con 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 unirlos con datos de perfil, realiza esa unión en tu sistema de destino 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 interacción con 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 obtener datos de etiquetas, usa la REST API de exportación. Como alternativa, puedes usar un canal webhook en una Campaign para enviar datos de etiquetas o pares clave-valor a tu propio endpoint, utilizando Liquid para incluir los valores mediante plantillas.
¿Cómo notifica Braze a los clientes sobre cambios en Currents?
En las raras circunstancias en que se producen cambios incompatibles, Braze envía un correo electrónico anticipado 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 no incompatibles, como nuevos eventos o nuevos campos en un evento existente, Braze no envía una notificación. Puedes consultar el registro de cambios de Currents para ver los últimos cambios.
¿Cuánto almacenamiento necesito para los datos de Currents?
Los requisitos de almacenamiento dependen del volumen de eventos y 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 para 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 por todos los sistemas de Braze. Los eventos enviados a través de Currents durante este período pueden tener NULL en los campos de nombre (como campaign_name o canvas_step_name). Esto también es esperado si el nombre se modificó poco antes de que se registraran los eventos. Para evitar esto, espera un tiempo después de crear o renombrar una Campaign o un paso en Canvas antes de realizar envíos.
¿Por qué los eventos de fin de sesión se retrasan o faltan en Currents?
Los eventos de fin de sesión siguen la programación de carga normal del SDK. El SDK de Braze almacena en caché los datos de sesión localmente y los envía periódicamente en función de la calidad de la red; por ejemplo, aproximadamente cada 10 segundos en una conexión estable. Hasta que el SDK carga el evento, este no aparece en Currents.
Si un usuario cierra la aplicación de forma forzada o se queda sin conexión antes del siguiente envío, el evento de fin de sesión puede llegar tarde 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, porque 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 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é sucede 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 retroactivamente 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 «No tienes derechos restantes de eventos de comportamiento del cliente» al editar mi integración de Currents?
Este mensaje puede aparecer cuando actualizas una integración de Currents existente y tu espacio de trabajo ha alcanzado el límite de derechos para eventos de comportamiento del cliente. Ponte en contacto con tu director de cuentas de Braze para solicitar un derecho o 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, para que tu pipeline recoja automáticamente los datos después de 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 interacción con mensajes?
Dependiendo del tipo de evento y el contexto, un evento de interacción con mensajes puede no estar vinculado a una Campaign o paso en Canvas específico. 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, verifica 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 diferente a la del Canvas?
La hora del evento users.canvas.Conversion en Currents refleja la ventana de conversión total —la duración del Canvas más el plazo de conversión— medida desde la entrada al Canvas.
¿Qué sucede cuando se envían informes de participación a S3?
Si las credenciales de S3 están configuradas para la exportación de datos pero no para Currents, Braze carga los informes de participación en el 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 las impresiones del grupo de control para Content Cards y mensajes dentro de la aplicación en Currents?
Cuando un usuario es asignado a un grupo de control para una Campaign de Content Cards o mensajes dentro de la aplicación, Currents emite un evento users.campaigns.EnrollInControl en lugar de un evento de impresión.
¿Qué sucede 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.