Preguntas frecuentes

Esta página ofrece respuestas a algunas preguntas frecuentes sobre Currents.

¿Puedo exportar datos de Campaign o Canvas para un intervalo de fechas concreto?

Para obtener métricas de Campaign o Canvas de un intervalo de fechas definido, usa uno de los siguientes métodos:

• 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 de análisis de Canvas con los parámetros ending_at y length (o usa /campaigns/data_series y /canvas/data_series) para obtener datos de series temporales.
• Transmite eventos a tu almacén de datos con Currents cuando necesites datos de participación con 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 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 una vez que se completa la carga. Azure puede bloquear la eliminación de un blob mientras haya una carga 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 se pueden volver a 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 oportuno. Los datos se conservan durante 30 días, pero si necesitas datos más históricos, puedes consultar Snowflake.

¿Por qué Currents genera los datos en formato Avro y no en JSON?

A diferencia de JSON, que no tiene esquema, Avro admite de forma nativa la evolución de esquemas. Además, podrás enviar archivos Avro con menos ancho de banda y ahorrar espacio de almacenamiento, ya que Avro se puede comprimir mucho.

¿Cómo gestiona Braze la sobrecarga de archivos?

Creamos un proceso ETL (extraer, transformar, cargar), 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:

• Amazon S3
• Microsoft Azure Blob Storage
• Google Cloud Storage.

¿Qué tan confiables son los datos 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 los eventos utilizando el campo de identificador único (id) que se envía con cada evento. Para más información, 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. En los conectores de gran volumen, los datos llegan casi en tiempo real. En los conectores de bajo volumen, los datos suelen llegar en un plazo de 5 a 30 minutos. Para más información, consulta Umbral de escritura de Avro.

¿Cómo encuentro qué eventos están disponibles para Currents?

Para ver la lista completa de eventos que registra Currents, consulta los glosarios de eventos de comportamiento del cliente y de eventos de participación en mensajes. Puedes filtrar estos glosarios por tipo de evento (como envíos, entregas o aperturas).

¿Por qué el recuento de eventos de Currents no coincide con las métricas de mi panel o del informe de participación?

Currents y el panel de Braze calculan algunas métricas de forma diferente, así que no cabe esperar una coincidencia exacta entre los eventos de Currents y las métricas del panel.

Clics únicos: En el correo electrónico, el panel hace un seguimiento de los clics únicos durante un periodo de siete días y los mide por dispatch_id. Currents registra cada evento de clic sin procesar. Para que el recuento de clics únicos basado en Currents coincida con las métricas del panel, filtra 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 para cancelar la suscripción de Braze. Las páginas personalizadas para cancelar la suscripción no incrementan esta métrica, a menos que actualices el 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 para cancelar la suscripción en el cuerpo o el pie del correo electrónico, o a través del encabezado list-unsubscribe. No representa todos los cambios de estado de suscripción al 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 los datos de Currents por día natural sin convertirlos a la zona horaria de tu empresa, los recuentos pueden quedar asignados a días distintos de los que aparecen en el panel.

Eventos duplicados: Currents ofrece entrega al menos una vez, lo que significa que, ocasionalmente, pueden escribirse eventos duplicados. Elimina los duplicados usando 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) de mi evento de apertura o clic de correo electrónico en Currents no coincide con el perfil de usuario del panel de Braze?

• En el panel de Braze: Cuando un usuario asociado a una dirección de correo electrónico abre un correo o hace clic en él, todos los perfiles de usuario que comparten esa dirección aparecen como si hubieran abierto ese correo o hecho clic en él. Para más información, consulta ¿Qué sucede 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 al que se dirigió originalmente el envío si ese perfil todavía comparte la dirección de correo electrónico. Si no, Braze lo atribuye a un perfil elegido al azar entre los que comparten esa dirección.

Por eso, el valor external_user_id (llamado external_id en la tabla de mapeado del esquema de Braze) de un evento de apertura o clic de correo electrónico en Currents puede no coincidir con el perfil de usuario que esperas al comparar Currents con el panel de Braze.

¿Se registran todos los eventos de envío en Currents?

Braze registra en Currents los eventos de campañas en vivo y Canvas. Aparte de los envíos de prueba, Braze no suprime intencionadamente ningún evento de la transmisión de Currents.

Los envíos de prueba no generan eventos de participación con mensajes en Currents. Esto incluye los mensajes de prueba enviados desde una Campaign o un paso en Canvas y los mensajes enviados con Send All Test Messages al probar un Canvas. Para ver eventos de participación con mensajes en Currents, envía desde una campaña en vivo o un Canvas.

¿Se pueden corromper los datos en Currents?

En circunstancias normales, los datos de Currents no se corrompen. Aunque siempre existe la posibilidad de que surja algún problema poco común, no se conoce ninguna condición en la 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 retroactivamente los eventos 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ó más tarde). En estos casos, la marca de tiempo del evento refleja el momento en que ocurrió originalmente, 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 los eventos, etiquetado como external_id en la tabla de mapeado 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 envías datos de Currents a un almacén de datos o a un CRM y necesitas combinarlos con datos del perfil, haz esa combinación en tu sistema de destino usando user_id o external_user_id.

¿Qué es el campo app_group_id en los eventos de Currents?

El campo app_group_id contiene el identificador de API del espacio de trabajo al que pertenece el evento. Este valor es un UUID. Es el mismo valor que la columna app_group_api_id de las tablas SQL del Generador de consultas, las extensiones de segmento SQL y el uso compartido de datos de Snowflake, así que puedes usarlo para unir los datos de Currents con esas tablas.

Currents usa identificadores de API en lugar de los ID internos de Braze en sus campos de ID, por lo que los demás campos siguen el mismo patrón. Por ejemplo, canvas_id en Currents contiene el identificador de API del Canvas.

El valor de app_group_id no es una credencial, así que no puedes usarlo para autenticar solicitudes a la REST API. Para hacer solicitudes a la REST API para un espacio de trabajo, usa una clave de API REST.

¿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 ver una lista completa de los campos disponibles, consulta los glosarios de eventos.

¿Currents incluye etiquetas o pares clave-valor de Campaign o Canvas?

No. Currents no incluye etiquetas de Campaign o Canvas ni pares clave-valor a nivel de mensaje. Para recuperar datos de etiquetas, usa 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, usando Liquid para crear la plantilla de los valores.

¿Cómo notifica Braze a los clientes los cambios en Currents?

En el raro caso de que se produzcan cambios importantes, Braze envía un correo electrónico por adelantado 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 los cambios no importantes, 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.

¿Qué periodo de tiempo cubre una notificación de recuperación de Currents?

Cuando una integración de Currents se recupera de un error, como credenciales incorrectas o errores 500 del endpoint del destino, Braze envía un correo electrónico al contacto de la integración para indicar que la integración “se está recuperando”. Cuando la integración se pone al día, Braze indica que “se ha recuperado por completo” y que se han enviado todos los datos acumulados. Estas notificaciones de recuperación no indican qué periodo de tiempo cubren los datos acumulados.

Para determinar el periodo de tiempo recuperado:

1. Busca la primera notificación de error que Braze envió para la misma integración. Indica aproximadamente cuándo empezó a fallar la integración.
2. Anota cuándo recibiste la notificación de que la integración “se ha recuperado por completo”.

Los datos acumulados que envió Braze cubren los eventos desde que la integración empezó a fallar hasta que se recuperó.

Si la integración estuvo fallando durante más de cinco días, es posible que se hayan descartado algunos eventos. Los eventos descartados no se pueden recuperar. Para más información, consulta Requisitos.

¿Cuánto almacenamiento necesito para los datos de Currents?

Los requisitos de almacenamiento dependen de tu volumen de eventos y de los tipos de eventos que exportes. 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 un nuevo Canvas, el nombre puede tardar un tiempo en propagarse por todos los sistemas de Braze. Los eventos enviados a través de Currents durante ese intervalo pueden tener NULL en los campos de nombre (como campaign_name o canvas_step_name). Esto también es normal si el nombre se modificó poco antes de que se registraran los eventos. Para evitarlo, deja pasar un tiempo después de crear o renombrar una Campaign o un paso en Canvas antes de hacer el envío.

¿Por qué los eventos de fin de sesión llegan con retraso o faltan en Currents?

Los eventos de fin de sesión siguen el calendario de carga habitual del SDK. El SDK de Braze almacena en caché los datos de sesión localmente y los envía periódicamente según la calidad de la red; por ejemplo, aproximadamente cada 10 segundos con una conexión sólida. Hasta que el SDK carga el evento, este no aparece en Currents.

Si un usuario fuerza el cierre de la aplicación o se queda sin conexión antes del siguiente envío, el evento de fin de sesión puede llegar tarde o no llegar nunca. En iOS, los eventos de fin de sesión a menudo no se envían hasta que se vuelve a abrir la aplicación, porque el SDK no puede enviar datos mientras la aplicación está en segundo plano.

Si necesitas límites de sesión más puntuales en Currents, llama a requestImmediateDataFlush() en momentos del ciclo de vida, como cuando la aplicación pasa a segundo plano o vuelve al 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é ocurre si mi contenedor de almacenamiento no está disponible cuando Currents intenta escribir datos?

Si Braze no puede escribir en tu contenedor de almacenamiento, pone en cola los eventos que no puede escribir y sigue reintentándolo, sea cual sea el error que devuelva tu contenedor. Cuando el contenedor vuelve a aceptar escrituras, Braze entrega primero los eventos en cola y después los eventos nuevos.

Mientras Braze no pueda escribir en tu contenedor, es posible que recibas una notificación de error de integración en el correo electrónico de contacto de tu integración. Según el error que devuelva tu contenedor, la notificación puede indicar que tus credenciales no son válidas, aunque no hayan cambiado.

Si el problema dura más de cinco días, Braze empieza a descartar eventos, y los eventos descartados no se pueden recuperar. Para más información, consulta Requisitos.

Cómo asegurarte de que tu contenedor está disponible

Tu contenedor está disponible cuando existe con el nombre guardado en tu integración de Currents y acepta escrituras de Braze. Para comprobarlo, haz lo siguiente:

1. En Braze, ve a Integraciones con socios > Currents y abre tu integración. Anota el nombre del contenedor (o el nombre del contenedor de blobs en Azure Blob Storage) y la ruta de carpeta o el prefijo.
2. En la consola de tu proveedor de servicios en el cloud, confirma que existe un contenedor con ese nombre exacto:
   • En Amazon S3, revisa la cuenta de AWS propietaria del contenedor.
   • En Google Cloud Storage, revisa el proyecto que aparece como project_id en tu archivo de clave JSON.
   • En Azure Blob Storage, revisa la cuenta de almacenamiento indicada en el endpoint de tu cuenta o en tu cadena de conexión.
3. Si el contenedor no existe, crea uno nuevo y actualiza tu integración con su nombre.
4. Si restringes el acceso de red a tu contenedor, por ejemplo con reglas de firewall o endpoints privados, confirma que tus reglas permiten que Braze escriba. Para conocer las direcciones IP desde las que Braze envía los datos de Currents, consulta Lista de IP permitidas. Para Azure Blob Storage, consulta ¿Puede Braze proporcionar direcciones IP para incluir en la lista de permitidas de Azure Blob Storage?.
5. Cuando tu contenedor acepte escrituras, comprueba si hay archivos nuevos en la ruta de carpeta o el prefijo. Braze entrega primero los eventos en cola y después los eventos nuevos.

Cómo asegurarte de que tu contenedor está bien configurado

Braze necesita el nombre exacto del contenedor, credenciales válidas y permiso para escribir en tu contenedor. Para comprobar tu configuración, haz lo siguiente:

1. En tu integración de Currents, confirma que el nombre del contenedor coincide exactamente con el de tu contenedor. Introduce solo el nombre del contenedor en el campo correspondiente, sin barras ni rutas. Introduce cualquier ruta en el campo de ruta de carpeta o prefijo.
2. Confirma que las credenciales de tu integración tienen los permisos necesarios:
   • Amazon S3: Tu política de IAM permite s3:ListBucket y s3:GetBucketLocation en el contenedor, y s3:PutObject y s3:GetObject en los objetos del contenedor. Además, tu contenedor no puede usar cifrado SSE-KMS ni Object Lock. Para más información, consulta Integración de Amazon S3 y Solución de problemas.
   • Google Cloud Storage: El rol de tu cuenta de servicio incluye storage.objects.create, storage.objects.delete, storage.objects.list, storage.objects.get y storage.buckets.get. Si tu contenedor usa un espacio de nombres jerárquico, el rol también necesita storage.folders.create. Para más información, consulta Paso 1: Crear un rol.
   • Azure Blob Storage: Si usas la autenticación de entidad de servicio con certificado, el registro de tu aplicación tiene el rol Storage Blob Data Contributor en tu contenedor. Las asignaciones de roles pueden tardar hasta 30 minutos en hacerse efectivas. Para más información, consulta Paso 4: Concede acceso a tu cuenta de almacenamiento.
3. Confirma que tus credenciales están vigentes. Si has rotado una clave, un rol o un certificado, actualiza tu integración. Para más información, consulta Actualizar las credenciales de Amazon S3 para Currents, Actualizar las credenciales de Azure para Currents o Actualizar Currents.

¿Puedo reubicar mi contenedor de almacenamiento sin perder datos de Currents?

Sí. Si reubicas un contenedor de almacenamiento conectado a una integración de Currents en vivo (por ejemplo, con la reubicación de contenedores de Google Cloud Storage) y el nombre del contenedor, las credenciales y el prefijo no cambian, no necesitas editar tu integración de Currents. Durante la reubicación, Braze pone en cola los eventos que no puede escribir y los entrega cuando el contenedor vuelve a aceptar escrituras.

Completa la reubicación en un plazo de cinco días para evitar la pérdida de eventos.

¿Por qué veo mensajes de límite de derechos de uso al crear o editar una integración de Currents?

Currents usa grupos de derechos de uso independientes para las distintas capacidades del conector:

• 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 de uso y bloquea esa acción. Ponte en contacto con tu director de cuentas de Braze para solicitar derechos de uso adicionales o para que te ayude a ajustar tu configuración.

¿Con qué frecuencia cambia la versión de Currents en la ruta de almacenamiento?

El segmento version=<currents_version> de la ruta de almacenamiento avanza con cada versión de Currents con una cadencia mensual (por ejemplo, de version=6 a version=7). Te recomendamos leer los archivos de forma recursiva desde la ruta raíz en lugar de codificar un segmento de versión concreto, para que tu canalización 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 ver el 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 con mensajes?

Según el tipo de evento y el contexto, es posible que un evento de participación con mensajes no esté vinculado a una Campaign o a un paso en Canvas concretos. 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 ese contexto suelen incluir identificadores de Campaign o de Canvas.

¿Por qué las marcas de tiempo de Currents están limitadas a una precisión de segundos?

El campo time de los eventos de Currents se almacena como un número entero de 32 bits, por lo que su precisión se limita a segundos. Algunos eventos también incluyen un campo de marca de tiempo independiente 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 el periodo de conversión total, es decir, la duración del Canvas más el plazo de conversión, medido desde la entrada en el Canvas.

¿Qué ocurre cuando los informes de participación se envían 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 Enviar informe a 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. Para ello, tu equipo de cuenta de Braze debe habilitar esta característica.

¿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 te diriges 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 el valor predeterminado true, por lo que los envíos a usuarios desconocidos se omiten sin aviso, a menos que lo establezcas explícitamente en false.