Skip to content

Almacenamiento

Obtén información sobre las diferentes propiedades a nivel de dispositivo que almacena el SDK de Braze.

Propiedades del dispositivo

De forma predeterminada, Braze recopila las siguientes propiedades a nivel de dispositivo para permitir la personalización de mensajes basada en el dispositivo, el idioma y la zona horaria:

  • BROWSER
  • BROWSER_VERSION
  • LANGUAGE
  • OS
  • RESOLUTION
  • TIME_ZONE
  • USER_AGENT
  • AD_TRACKING_ENABLED
  • ANDROID_VERSION
  • CARRIER
  • IS_BACKGROUND_RESTRICTED
  • LOCALE
  • MODEL
  • NOTIFICATION_ENABLED
  • RESOLUTION
  • TIMEZONE
  • Operador del dispositivo (consulta la nota sobre la eliminación de CTCarrier)
  • Configuración regional del dispositivo
  • Modelo del dispositivo
  • Versión del sistema operativo del dispositivo
  • Estado de la autorización push
  • Opciones de visualización push
  • Push habilitado
  • Resolución del dispositivo
  • Zona horaria del dispositivo

De forma predeterminada, todas las propiedades están habilitadas. Sin embargo, puedes habilitarlas o deshabilitarlas manualmente. Ten en cuenta que algunas características del SDK de Braze requieren propiedades específicas (como la entrega según la zona horaria local y la zona horaria), así que asegúrate de probar tu configuración antes de lanzarla a producción.

Por ejemplo, puedes especificar el idioma del dispositivo para incluirlo en la lista de permitidos. Para obtener más información, consulta la opción devicePropertyAllowlist para InitializationOptions.

1
2
3
4
5

import * as braze from "@braze/web-sdk";
braze.initialize("API-KEY", {
    baseUrl: "BASE-URL",
    devicePropertyAllowlist: [ braze.DeviceProperties.LANGUAGE ] // list of `DeviceProperties` you want to collect
});

Por ejemplo, puedes especificar la versión del sistema operativo Android y la configuración regional del dispositivo para incluirlos en la lista de permitidos. Para obtener más información, consulta los métodos setDeviceObjectAllowlistEnabled() y setDeviceObjectAllowlist().

1
2
3

new BrazeConfig.Builder()
    .setDeviceObjectAllowlistEnabled(true)
    .setDeviceObjectAllowlist(EnumSet.of(DeviceKey.ANDROID_VERSION, DeviceKey.LOCALE));

Por ejemplo, puedes especificar la zona horaria y la configuración regional para incluirlas en la lista de permitidos. Para obtener más información, consulta la propiedad devicePropertyAllowList del objeto configuration.

1

configuration.devicePropertyAllowList = [.timeZone, .locale]

1
2
3
4

configuration.devicePropertyAllowList = @[
    BRZDeviceProperty.timeZone,
    BRZDeviceProperty.locale
];

Almacenamiento de cookies (solo Web)

Después de inicializar el SDK Web de Braze, el SDK crea y almacena cookies de origen (establecidas en tu propio dominio) con una caducidad de 400 días que se renuevan automáticamente en nuevas sesiones.

Las cookies solo almacenan identificadores de usuario, sesión y dispositivo. Otros datos, como los mensajes dentro de la aplicación en espera de activarse, Content Cards y eventos o atributos en cola que aún no se han sincronizado con Braze, se almacenan en localStorage.

Se almacenan las siguientes cookies:

Cookie Descripción Tamaño
ab.storage.userId.[your-api-key] Se utiliza para determinar si el usuario conectado actualmente ha cambiado y para asociar eventos con el usuario actual. En función del tamaño del valor pasado a changeUser
ab.storage.sessionId.[your-api-key] Cadena generada aleatoriamente que se utiliza para determinar si el usuario está iniciando una sesión nueva o existente, para sincronizar mensajes y calcular los análisis de la sesión. ~200 bytes
ab.storage.deviceId.[your-api-key] Cadena generada aleatoriamente que se utiliza para identificar a los usuarios anónimos, diferenciar los dispositivos de los usuarios y habilitar la mensajería basada en dispositivos. ~200 bytes
ab.optOut Se utiliza para almacenar la preferencia de exclusión de un usuario cuando se llama a disableSDK. ~40 bytes
ab._gd Se crea temporalmente (y luego se elimina) para determinar el dominio de cookie de nivel raíz, lo que permite que el SDK funcione correctamente en subdominios. n/a

De forma predeterminada, las cookies de Braze caducan después de 400 días. Para anular este valor, utiliza la opción cookieExpiryInDays al inicializar el SDK Web. Los valores deben ser mayores que 0; si la opción se omite o se establece en 0 o menos, se aplica el valor predeterminado de 400 días. Esta opción requiere el SDK Web 6.6.0 o posterior.

1
2
3
4
5

import * as braze from "@braze/web-sdk";
braze.initialize("API-KEY", {
  baseUrl: "BASE-URL",
  cookieExpiryInDays: 30 // expires after 30 days
});

Desactivar cookies

Para desactivar todas las cookies, utiliza la opción noCookies al inicializar el SDK Web. Cuando las cookies están desactivadas, el SDK utiliza localStorage en su lugar para identificar usuarios y sesiones. Esto evita que se asocien usuarios anónimos que navegan entre subdominios y da lugar a un nuevo usuario en cada subdominio.

1
2
3
4
5

import * as braze from "@braze/web-sdk";
braze.initialize("API-KEY", {
  baseUrl: "BASE-URL",
  noCookies: true
});

Para detener el seguimiento de Braze en general, o para borrar todos los datos almacenados del navegador, consulta los métodos del SDK disableSDK y wipeData, respectivamente. Estos dos métodos pueden ser útiles si un usuario revoca su consentimiento o si quieres detener toda la funcionalidad de Braze después de que el SDK se haya inicializado.
New Stuff!