Armazenamento
Saiba mais sobre as diferentes propriedades em nível de dispositivo que são armazenadas pelo Braze SDK.
Propriedades do dispositivo
Por padrão, o Braze coletará as seguintes propriedades em nível de dispositivo para permitir a personalização de mensagens com base no dispositivo, no idioma e no fuso horário:
- AD_TRACKING_ENABLED
- ANDROID_VERSION
- CARRIER
- IS_BACKGROUND_RESTRICTED
- LOCALE
- MODEL
- NOTIFICIATION_ENABLED
- RESOLUTION
- TIMEZONE
AD_TRACKING_ENABLED e TIMEZONE não são coletados se forem null ou estiverem em branco. GOOGLE_ADVERTISING_ID não é coletado automaticamente pelo SDK e deve ser passado via setGoogleAdvertisingId.
- Operadora de dispositivos (consulte a nota sobre a depreciação do siteCTCarrier)
- Localidade do dispositivo
- Modelo do dispositivo
- Versão do sistema operacional do dispositivo
- Status da autorização push
- Opções do visor push
- Push ativado
- Resolução do dispositivo
- Fuso horário do dispositivo
O SDK do Braze não coleta o IDFA automaticamente. Os apps podem, opcionalmente, passar o IDFA para a Braze implementando os métodos diretamente abaixo. Os apps precisam obter a aceitação explícita do rastreamento pelo usuário final por meio da estrutura App Tracking Transparency antes de passar o IDFA para a Braze.
- Para definir o estado de rastreamento de publicidade, use set(adTrackingEnabled:).
- Para definir o identificador do anunciante (IDFA), use set(identifierForAdvertiser:).
- BROWSER
- BROWSER_VERSION
- LANGUAGE
- OS
- RESOLUTION
- TIME_ZONE
- USER_AGENT
Por padrão, todas as propriedades estão ativadas. No entanto, você pode optar por ativar ou desativar esses recursos manualmente. Lembre-se de que alguns recursos do Braze SDK exigem propriedades específicas (como entrega no horário local e fuso horário), portanto, certifique-se de testar sua configuração antes de liberá-la para a produção.
Por exemplo, você pode especificar a versão do sistema operacional Android e a localidade do dispositivo a serem incluídos na lista de permissões. Para saber mais, consulte a seção setDeviceObjectAllowlistEnabled() e setDeviceObjectAllowlist() métodos.
1
2
3
new BrazeConfig.Builder()
    .setDeviceObjectAllowlistEnabled(true)
    .setDeviceObjectAllowlist(EnumSet.of(DeviceKey.ANDROID_VERSION, DeviceKey.LOCALE));
Por exemplo, você pode especificar o fuso horário e a coleção de locais a serem permitidos. Para saber mais, consulte a propriedade devicePropertyAllowList do objeto configuration.
1
configuration.devicePropertyAllowList = [.timeZone, .locale]
1
2
3
4
configuration.devicePropertyAllowList = @[
    BRZDeviceProperty.timeZone,
    BRZDeviceProperty.locale
];
Por exemplo, você pode especificar o idioma do dispositivo a ser incluído na lista de permissões. Para saber mais, consulte a opção 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
});
Para saber mais sobre as propriedades do dispositivo coletadas automaticamente, consulte Coleta de dados do SDK.
Armazenamento de cookies (somente na Web)
Depois de inicializar o SDK do Web Braze, ele criará e armazenará cookies com uma expiração de 400 dias que se renova automaticamente em novas sessões.
Os seguintes cookies são armazenados:
| Cookie | Descrição | Tamanho | 
|---|---|---|
| ab.storage.userId.[your-api-key] | Usado para determinar se o usuário atualmente registrado foi alterado e para associar eventos ao usuário atual. | Com base no tamanho do valor passado para changeUser | 
| ab.storage.sessionId.[your-api-key] | String gerada aleatoriamente usada para determinar se o usuário está iniciando uma sessão nova ou existente para sincronizar mensagens e calcular a análise de dados da sessão. | ~200 bytes | 
| ab.storage.deviceId.[your-api-key] | String gerada aleatoriamente usada para identificar usuários anônimos e para diferenciar os dispositivos dos usuários e ativar o envio de mensagens com base no dispositivo. | ~200 bytes | 
| ab.optOut | Usado para armazenar a preferência de opt-out do usuário quando disableSDKé chamado | ~40 bytes | 
| ab._gd | Criado temporariamente (e depois excluído) para determinar o domínio do cookie de nível raiz, o que permite que o SDK funcione corretamente em subdomínios. | n/a | 
Desativação de cookies
Para desativar todos os cookies, use a opção noCookies ao inicializar o Web SDK. Isso evitará que você associe usuários anônimos que navegam entre subdomínios e resultará em um novo usuário em cada subdomínio.
1
2
3
4
5
import * as braze from"@braze/web-sdk";
braze.initialize("API-KEY", {
    baseUrl: "BASE-URL",
    noCookies: true
});
Para interromper o rastreamento da Braze em geral ou para limpar todos os dados armazenados do navegador, consulte os métodos do SDK disableSDK e wipeData, respectivamente. Esses dois métodos podem ser úteis se um usuário revogar o consentimento ou se você quiser interromper todas as funcionalidades do Braze depois que o SDK já tiver sido inicializado.
 Editar esta página no GitHub
   Editar esta página no GitHub