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 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 continuos y consultables de participación en mensajes 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. Si no seleccionas 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 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 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 usando menos ancho de banda y ahorrando espacio de almacenamiento, porque Avro es altamente comprimible.

¿Cómo gestiona Braze la sobrecarga de archivos?

Creamos un proceso de 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 realizar consultas?

Braze tiene alianzas con varios almacenes de datos en los que puedes almacenar tus datos para realizar consultas. Te recomendamos usar:

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

¿Qué tan fiables son los datos de Currents?

Currents garantiza una entrega «al menos una vez», lo que significa que, en ocasiones, pueden escribirse eventos duplicados en tu contenedor de almacenamiento. Si tu caso de uso necesita una entrega exactamente una vez, puedes deduplicar los eventos con 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 alto volumen, los datos llegan casi en tiempo real. En los conectores de bajo volumen, los datos suelen llegar en un plazo de entre 5 y 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 Eventos de participación en 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 del panel o del informe de participación?

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

Clics únicos: Para el correo electrónico, el panel registra 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 los recuentos de clics únicos basados en Currents se ajusten a 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 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 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 de cancelación de suscripción en el cuerpo o el pie del correo electrónico, o mediante el 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 en días distintos 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) 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 quedan marcados como que lo abrieron o hicieron clic. 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 ese mismo clic se almacena en un solo perfil. Braze lo atribuye al perfil al que se dirigió originalmente el envío, siempre que ese perfil siga compartiendo la dirección de correo electrónico. Si no es así, Braze lo atribuye a un perfil elegido al azar entre los que comparten la dirección de correo electrónico.

Por eso, al comparar Currents con el panel de Braze, 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.

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

Braze registra en Currents los eventos de las Campaigns en vivo y de los Canvas. Salvo los envíos de prueba, Braze no excluye intencionadamente ningún evento de la transmisión de Currents.

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

¿Pueden corromperse 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 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 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 cuándo ocurrió originalmente, lo que puede ser antes de que se configurara la integración de Currents.

¿Qué identificadores de usuario se incluyen en los eventos de Currents?

Los eventos de participació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 participació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 CRM y necesitas combinarlos con datos del perfil, realiza esa combinación en tu sistema posterior 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 Snowflake Data Sharing, 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 de 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 la lista completa de campos disponibles, consulta los glosarios de eventos.

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

No. Currents no incluye etiquetas de Campaign o de Canvas ni pares clave-valor a nivel de mensaje. Para obtener los datos de las etiquetas, usa la API REST de exportación. Otra alternativa es usar un canal de webhook en una Campaign para enviar las etiquetas o los pares clave-valor a tu propio endpoint, con Liquid para crear la plantilla de los valores.

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

En el raro caso de que se produzcan cambios importantes, 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 usado el panel en los últimos 30 días. Para los cambios que no afectan a la compatibilidad, 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 conocer 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 de 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 completamente» y que se enviaron todos los datos pendientes. Estas notificaciones de recuperación no indican qué periodo de tiempo cubren los datos pendientes.

Para determinar el periodo de tiempo recuperado:

1. Busca la primera notificación de error que Braze envió para la misma integración. En ella se 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 completamente».

Los datos pendientes 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 ofrece eventos de ejemplo en formato Avro que puedes usar para estimar el tamaño de los archivos según 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). 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 se retrasan o no aparecen en Currents?

Los eventos de fin de sesión siguen el calendario de carga normal del SDK. El SDK de Braze almacena en caché los datos de sesión localmente y los vacía periódicamente según la calidad de la red; por ejemplo, aproximadamente cada 10 segundos con una conexión fuerte. Hasta que el SDK no 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 vaciado, 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 vací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 puntuales en Currents, llama a requestImmediateDataFlush() en momentos 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é pasa 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. Esto ocurre independientemente del error que devuelva tu contenedor. Cuando el contenedor vuelve a aceptar escrituras, Braze entrega los eventos en cola y, a continuación, 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 persiste durante 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 de socios > Currents y abre tu integración. Anota el nombre del contenedor (o del container, en el caso de 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:
   • Para Amazon S3, revisa la cuenta de AWS propietaria del contenedor.
   • Para Google Cloud Storage, revisa el proyecto indicado como project_id en tu archivo de clave JSON.
   • Para Azure Blob Storage, revisa la cuenta de almacenamiento de tu endpoint de cuenta o de 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 direcciones 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, revisa la ruta de carpeta o el prefijo para ver si hay archivos nuevos. Braze entrega primero los eventos en cola y, a continuación, 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 por entidad de servicio con certificado o por federación de identidades de carga de trabajo, el registro de tu aplicación tiene el rol Storage Blob Data Contributor en tu container. Las asignaciones de roles pueden tardar hasta 30 minutos en hacerse efectivas. Para la federación de identidades de carga de trabajo, confirma también que el emisor, el identificador de sujeto y la audiencia de la credencial federada coinciden con los valores que muestra Braze. Para más información, consulta Paso 4: Conceder acceso a tu cuenta de almacenamiento para la entidad de servicio con certificado, o Paso 2: Añadir una credencial federada y Paso 3: Conceder acceso a tu cuenta de almacenamiento para la federación de identidades de carga de trabajo.
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 trasladar mi contenedor de almacenamiento sin perder datos de Currents?

Sí. Si trasladas 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 siguen siendo los mismos, no necesitas editar tu integración de Currents. Durante el traslado, Braze pone en cola los eventos que no puede escribir y los entrega cuando el contenedor vuelve a aceptar escrituras.

Completa el traslado 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 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 Seguimiento del comportamiento del cliente y de los eventos de usuario.
• Perfiles y atributos de usuario: Necesarios para habilitar Seguimiento de perfiles y atributos de usuario.

Si se agota algún grupo, 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 más derechos de uso 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 específico, para que tu canalización recoja automáticamente los datos después de un cambio de versión. Para más información 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 interacción con mensajes?

Según el tipo de evento y el contexto, es posible que un evento de interacció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 entero de 32 bits, por lo que su precisión está limitada 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 la ventana de conversión total, es decir, la duración del Canvas más la fecha límite de conversión, medida desde la entrada en el Canvas.

¿Qué ocurre cuando se envían los informes de participación a S3?

Si hay credenciales de S3 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 mediante Braze Currents?

Los datos de usuarios anónimos, identificados por device_id, se pueden enviar a Amplitude mediante Currents. Para ello, tu equipo de cuentas 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?

Si 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 genera ningún evento de Currents para ese envío. El parámetro send_to_existing_only tiene el valor predeterminado true, así que los envíos a usuarios desconocidos se omiten sin aviso a menos que lo establezcas explícitamente en false.