Recopilación de datos del SDK
Cuando integras el SDK de Braze con tu aplicación o sitio, Braze recopila automáticamente determinados tipos de datos. Algunos de estos datos son esenciales para nuestros procesos y otros pueden activarse o desactivarse en función de tus necesidades. También puedes configurar Braze para que recopile tipos de datos adicionales para potenciar aún más tu segmentación y mensajería.
Braze está diseñado para permitir una recopilación de datos flexible, por lo que puedes integrar el SDK de Braze de las siguientes formas:
- Integración mínima: Braze recopila automáticamente los datos necesarios para comunicarse con los servicios de Braze.
- Datos opcionales recopilados por defecto: Braze captura automáticamente algunos datos que son ampliamente útiles para la mayoría de tus casos de uso. Puedes optar por desactivar la recopilación automática de estos datos si no son esenciales para la comunicación con los servicios de Braze.
- Datos opcionales no recopilados por defecto: Braze captura algunos datos que son útiles para determinados casos de uso y no habilita automáticamente la recopilación por motivos de cumplimiento general. Puedes optar por recopilar estos datos cuando se adapten a tus casos de uso.
- Integración personalizada: Braze te da flexibilidad para recopilar datos además de los datos opcionales predeterminados.
Integración mínima
A continuación se enumeran los datos estrictamente necesarios que Braze genera y recibe cuando inicializas el SDK. Estos datos no son configurables y son esenciales para las funciones principales de la plataforma. A excepción del inicio y fin de sesión, todos los demás datos rastreados automáticamente no cuentan para tu uso de punto de datos.
| Atributo | Descripción | Por qué se recopila |
|---|---|---|
| App-Version-Name / App-Version-Code |
La versión más reciente de la aplicación | Este atributo se utiliza para enviar mensajes relacionados con la compatibilidad de la versión de la aplicación a los dispositivos correctos. Se puede usar para notificar a los usuarios sobre interrupciones del servicio o errores. |
| País | País identificado por geolocalización de la dirección IP. Si la geolocalización de la dirección IP no está disponible, se identifica por la configuración regional del dispositivo. El valor podría ser alternativamente lo que los SDK establezcan directamente con setCountry, pero ten en cuenta que pasar un valor de atributo a través del SDK o la API registrará puntos de datos. Una vez que el país se ha establecido manualmente (a través del método del SDK, la REST API o la carga de CSV), el SDK ya no actualiza automáticamente este valor. |
Este atributo se utiliza para segmentar mensajes según la ubicación. |
| ID de dispositivo | Identificador de dispositivo, una cadena generada aleatoriamente | Este atributo se utiliza para diferenciar los dispositivos de los usuarios y enviar mensajes al dispositivo correcto. |
| SO y versión del SO | Dispositivo o navegador reportado actualmente y versión del dispositivo o navegador | Este atributo se utiliza para enviar mensajes solo a dispositivos compatibles. También se puede usar dentro de la segmentación para dirigirse a usuarios para que actualicen las versiones de la aplicación. |
| Inicio de sesión y fin de sesión | Cuando el usuario comienza a usar tu aplicación o sitio integrado | El SDK de Braze reporta datos de sesión utilizados por el panel de Braze para calcular la participación de los usuarios y otros análisis integrales para comprender a tus usuarios. El momento exacto en que tu aplicación o sitio llama al inicio y fin de sesión es configurable por un desarrollador (Android, iOS, Web). |
| Datos de interacción de mensajes del SDK | Direct Opens de push, interacciones con mensajes dentro de la aplicación, interacciones con Content Cards | Este atributo se utiliza con fines de control de calidad, como verificar que un mensaje fue recibido y que el envío no se duplicó. |
| Versión del SDK | Versión actual del SDK | Este atributo se utiliza para enviar mensajes solo a dispositivos compatibles y evitar interrupciones del servicio. |
| ID de sesión y marca de tiempo de sesión | Identificador de sesión, una cadena generada aleatoriamente y marca de tiempo de sesión | Se utiliza para determinar si el usuario está iniciando una sesión nueva o existente y para determinar la reelegibilidad de mensajes destinados a este usuario. Ciertos canales de mensajería como los mensajes dentro de la aplicación y Content Cards se sincronizan con el dispositivo al inicio de la sesión. Nuestro backend entonces utilizará datos relacionados con la última vez que contactó a los servidores de Braze (que el dispositivo almacena y envía de vuelta) para saber si el usuario es elegible para nuevos mensajes. |
Métricas calculadas
Braze genera métricas calculadas a partir de tres fuentes: datos rastreados por el SDK (por ejemplo, inicio y fin de sesión), datos de interacción de mensajes para canales que no son del SDK y campos de informes derivados de Braze. Estos valores son generados por los servicios de Braze, por lo que un perfil de usuario puede incluir tanto datos rastreados por el SDK como datos generados por Braze.
Las métricas calculadas incluyen métricas basadas en canales (enumeradas en el Glosario de métricas de informes) y los siguientes atributos.
| Atributo | Descripción |
|---|---|
| Primera vez que usó la aplicación | Hora |
| Última vez que usó la aplicación | Hora |
| Recuento total de sesiones | Número |
| Tarjeta clicada | Número |
| Último mensaje recibido | Hora |
| Última Campaign de correo electrónico recibida | Hora |
| Última Campaign push recibida | Hora |
| Número de elementos de retroalimentación | Número |
| Número de sesiones en los últimos Y días | Número y hora |
| Recibió mensaje de Campaign | Booleano. Este filtro segmenta a los usuarios en función de si han recibido una Campaign anterior. |
| Recibió mensaje de Campaign con etiqueta | Booleano. Este filtro segmenta a los usuarios en función de si han recibido una Campaign que actualmente tiene una etiqueta. |
| Reorientar Campaign | Booleano. Este filtro segmenta a los usuarios en función de si han abierto o hecho clic en un correo electrónico, push o mensaje dentro de la aplicación específico en el pasado. |
| Desinstalado | Booleano y hora |
La integración mínima significa que solo recopilas los datos requeridos enumerados en Integración mínima y optas por no recopilar los datos opcionales recopilados por defecto al bloquear la recopilación de datos opcionales del SDK.
Si deseas una integración mínima y usas mParticle, Segment, Tealium o GTM, ten en cuenta lo siguiente:
- Plataformas móviles: Debes actualizar manualmente el código para estas configuraciones. mParticle y Segment no ofrecen una forma de hacerlo a través de su plataforma.
- Web: La integración de Braze debe realizarse de forma nativa para permitir la configuración de integración mínima. Los administradores de etiquetas no ofrecen una forma de hacerlo a través de su plataforma.
Datos opcionales recopilados de forma predeterminada
Además de los datos mínimos de integración, los siguientes atributos son capturados automáticamente por Braze cuando inicializas la integración de SDK. Puedes desactivar la recopilación de estos atributos para permitir una integración mínima.
| Atributo | Plataforma | Descripción | Por qué se recopila |
|---|---|---|---|
| Nombre del navegador | Web | Nombre del navegador | Este atributo se utiliza para enviar mensajes solo a navegadores compatibles. También se puede utilizar para la segmentación basada en el navegador. |
| Configuración regional del dispositivo | Android, iOS, Web | La configuración regional predeterminada del dispositivo | Este atributo se utiliza para traducir los mensajes al idioma preferido del usuario. |
| Configuración regional más reciente del dispositivo | Android, iOS, Web | La configuración regional predeterminada más reciente del dispositivo | Este atributo proviene de la configuración del dispositivo del usuario y se utiliza para traducir los mensajes al idioma preferido del usuario. Es independiente del atributo Most Recent Location. |
| Modelo del dispositivo | Android, iOS | El hardware específico del dispositivo | Este atributo se utiliza para enviar mensajes solo a dispositivos compatibles. También se puede utilizar dentro de la segmentación. |
| Marca del dispositivo | Android | La marca del dispositivo (por ejemplo, Samsung) | Este atributo se utiliza para enviar mensajes solo a dispositivos compatibles. |
| Operador inalámbrico del dispositivo | Android, iOS | El operador de telefonía móvil | Este atributo se utiliza opcionalmente para la segmentación de mensajes. Nota: Este campo ha quedado obsoleto a partir de iOS 16 y tendrá como valor predeterminado -- en una futura versión de iOS. |
| Idioma | Android, iOS, Web | Idioma del dispositivo o del navegador, tomado de la configuración regional del dispositivo. | Este atributo se utiliza para traducir los mensajes al idioma preferido del usuario. Se basa en la configuración regional del dispositivo. |
| Configuración de notificaciones | Android, iOS, Web | Si esta aplicación tiene habilitadas las notificaciones push. | Este atributo se utiliza para habilitar las notificaciones push. |
| Resolución | Android, iOS, Web | Resolución del dispositivo o del navegador | Se utiliza opcionalmente para la segmentación de mensajes basada en el dispositivo. El formato de este valor es “<width>x<height>”. |
| Zona horaria | Android, iOS, Web | Zona horaria del dispositivo o del navegador | Este atributo se utiliza para enviar mensajes en el momento adecuado, de acuerdo con la zona horaria local de cada usuario. |
| Agente de usuario | Web | Agente de usuario | Este atributo se utiliza para enviar mensajes solo a dispositivos compatibles. También se puede utilizar dentro de la segmentación. |
Para obtener más información sobre el seguimiento de propiedades a nivel de dispositivo (como el operador inalámbrico del dispositivo, la zona horaria, la resolución y otros), consulta la documentación específica de cada plataforma: Android, iOS, Web.
Datos no recopilados de forma predeterminada
De forma predeterminada, los siguientes atributos no se recopilan. Cada atributo debe integrarse manualmente.
| Atributo | Plataforma | Descripción | Por qué no se recopila |
|---|---|---|---|
| Device Ad Tracking Enabled | Android, iOS | En iOS:set(adTrackingEnabled:)En Android: Braze.setGoogleAdvertisingId() |
Esta propiedad requiere permisos adicionales a nivel de aplicación, que deben ser concedidos por el integrador. |
| Device IDFA | iOS | Identificador de dispositivo para anunciantes | Esto requiere el framework Ad Tracking Transparency, que activará una revisión de privacidad adicional por parte de la App Store. Para más detalles, consulta set(identifierForAdvertiser:) |
| Google Advertising ID | Android | Identificador para publicidad dentro de las aplicaciones de Google Play | Esto requiere que la aplicación obtenga el GAID y lo pase a Braze. Para más detalles, consulta Google Advertising ID opcional. |
| Ubicación más reciente | Android, iOS | Esta es la última ubicación GPS conocida del dispositivo del usuario. Se actualiza al inicio de la sesión y se almacena en el perfil del usuario. | Esto requiere que el usuario conceda permiso de ubicación a tu aplicación. |
El SDK de Braze no almacena ninguna dirección IP de forma local.
Integración personalizada
Para sacar el máximo provecho de Braze, nuestros integradores de SDK a menudo implementan los SDK de Braze y registran atributos personalizados, eventos personalizados y eventos de compra que son pertinentes para su negocio, además de los datos recopilados automáticamente.
Una integración personalizada permite una comunicación adaptada que es relevante para la experiencia de tus usuarios.
Braze bloqueará o prohibirá a los usuarios con más de 5.000.000 de sesiones (“usuarios ficticios”) y dejará de ingerir sus eventos de SDK. Para más información, consulta Bloqueo de correo no deseado.