Armazenamento
Saiba mais sobre as diferentes propriedades de nível de dispositivo que são armazenadas pelo SDK da Braze.
Propriedades do dispositivo
Por padrão, a Braze coletará as seguintes propriedades de nível de dispositivo para permitir a personalização de mensagens com base no dispositivo, idioma e fuso horário:
BROWSERBROWSER_VERSIONLANGUAGEOSRESOLUTIONTIME_ZONEUSER_AGENT
AD_TRACKING_ENABLEDANDROID_VERSIONCARRIERIS_BACKGROUND_RESTRICTEDLOCALEMODELNOTIFICATION_ENABLEDRESOLUTIONTIMEZONE
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 do dispositivo (consulte a nota sobre a depreciação do
CTCarrier) - Localidade do dispositivo
- Modelo do dispositivo
- Versão do sistema operacional do dispositivo
- Status da autorização push
- Opções de exibição push
- Push ativado
- Resolução do dispositivo
- Fuso horário do dispositivo
O SDK da 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 do framework 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:).
Por padrão, todas as propriedades estão ativadas. No entanto, você pode optar por ativá-las ou desativá-las manualmente. Lembre-se de que alguns recursos do SDK da Braze exigem propriedades específicas (como entrega no horário local e fuso horário), então certifique-se de testar sua configuração antes de liberar para produção.
Por exemplo, você pode especificar o idioma do dispositivo para ser incluído na lista permitida. 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
});
Por exemplo, você pode especificar a versão do Android OS e a localidade do dispositivo para serem incluídos na lista permitida. Para saber mais, consulte os métodos setDeviceObjectAllowlistEnabled() e setDeviceObjectAllowlist().
1
2
3
new BrazeConfig.Builder()
.setDeviceObjectAllowlistEnabled(true)
.setDeviceObjectAllowlist(EnumSet.of(DeviceKey.ANDROID_VERSION, DeviceKey.LOCALE));
Por exemplo, você pode especificar a coleta de fuso horário e localidade para serem incluídos na lista permitida. 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
];
Para saber mais sobre as propriedades de dispositivo coletadas automaticamente, consulte SDK Data Collection.
Armazenando cookies (apenas web)
Após inicializar o SDK Web da Braze, ele criará e armazenará cookies com um vencimento 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 conectado 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, além de 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 |
Alterando o vencimento do cookie
Por padrão, os cookies da Braze expiram após 400 dias. Para substituir esse valor, use a opção cookieExpiryInDays ao inicializar o Web SDK. Os valores devem ser maiores que 0; se a opção for omitida ou definida como 0 ou menos, o padrão de 400 dias será aplicado. Esta opção requer o Web SDK 6.6.0 ou 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
});
Desativando cookies
Para desativar todos os cookies, use a opção noCookies ao inicializar o Web SDK. Isso impedirá 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 da Braze depois que o SDK já tiver sido inicializado.
Editar esta página no GitHub