Skip to content

Coleta de dados do SDK

Quando você integra o SDK da Braze com seu app ou site, a Braze coleta automaticamente certos tipos de dados. Alguns desses dados são essenciais para nossos processos e outros podem ser ativados ou desativados de acordo com suas necessidades. Você também pode configurar a Braze para coletar tipos adicionais de dados para aprimorar ainda mais sua segmentação e envio de mensagens.

A Braze foi projetada para permitir a coleta flexível de dados, portanto, você pode integrar o SDK da Braze das seguintes maneiras:

  • Integração mínima: A Braze coleta automaticamente os dados necessários para a comunicação com os serviços da Braze.
  • Dados opcionais coletados por padrão: A Braze captura automaticamente alguns dados que são amplamente úteis para a maioria dos seus casos de uso. Você pode optar por desativar a coleta automática desses dados se eles não forem essenciais para a comunicação com os serviços da Braze.
  • Dados opcionais não coletados por padrão: A Braze captura alguns dados que são úteis para determinados casos de uso e não ativa automaticamente a coleta por motivos de ampla conformidade. Você pode optar por coletar esses dados onde for mais adequado aos seus casos de uso.
  • Integração personalizada: A Braze oferece a flexibilidade de coletar dados além dos dados opcionais padrão.

Integração mínima

A lista a seguir apresenta os dados estritamente necessários gerados e recebidos pela Braze quando você inicializa o SDK. Esses dados não são configuráveis e são essenciais para as funções principais da plataforma. Com exceção do início e do fim da sessão, todos os outros dados rastreados automaticamente não contam para o seu uso de pontos de dados.

Atributo Descrição Por que é coletado
App-Version-Name /
App-Version-Code		 A versão mais recente do app Esse atributo é usado para enviar mensagens relacionadas à compatibilidade da versão do app para os dispositivos corretos. Pode ser usado para notificar os usuários sobre interrupções de serviço ou bugs.
Country País identificado pela geolocalização do endereço IP. Se a geolocalização do endereço IP não estiver disponível, é identificado pelo local do dispositivo. O valor pode ser, alternativamente, o que os SDKs definem diretamente com setCountry, mas observe que passar um valor de atributo pelo SDK ou API registrará pontos de dados. Depois que o país for definido manualmente (pelo método do SDK, REST API ou upload de CSV), o SDK não atualiza mais esse valor automaticamente. Esse atributo é usado para direcionar mensagens com base na localização.
Device ID Identificador do dispositivo, uma string gerada aleatoriamente Esse atributo é usado para diferenciar os dispositivos dos usuários e enviar mensagens para o dispositivo correto.
OS and OS version Sistema operacional e versão do dispositivo ou navegador atualmente reportados Esse atributo é usado para enviar mensagens apenas para dispositivos compatíveis. Também pode ser usado na segmentação para direcionar os usuários a atualizar as versões do app.
Session start and session end Quando o usuário começa a usar seu app ou site integrado O SDK da Braze reporta dados de sessão usados pelo dashboard da Braze para calcular o engajamento dos usuários e outras análises essenciais para entender seus usuários. O momento exato em que o início e o fim da sessão são chamados pelo seu app ou site é configurável por um desenvolvedor (Android, iOS, Web).
SDK message interaction data Aberturas Diretas de push, interações com mensagens no app, interações com Content Cards Esse atributo é usado para fins de controle de qualidade, como verificar se uma mensagem foi recebida e se o envio não está duplicado.
SDK version Versão atual do SDK Esse atributo é usado para enviar mensagens apenas para dispositivos compatíveis e evitar interrupções de serviço.
Session ID and session timestamp Identificador de sessão, uma string gerada aleatoriamente e timestamp da sessão Usado para determinar se o usuário está iniciando uma sessão nova ou existente e para determinar a reelegibilidade de mensagens destinadas a esse usuário.

Certos canais de envio de mensagens, como mensagens no app e Content Cards, são sincronizados com o dispositivo no início da sessão. O backend então usa dados relacionados a quando entrou em contato pela última vez com os servidores da Braze (que o dispositivo armazena e envia de volta) para saber se o usuário é elegível para novas mensagens.

Métricas calculadas

A Braze gera métricas calculadas a partir de três fontes: dados rastreados pelo SDK (por exemplo, início e fim da sessão), dados de interação com mensagens para canais que não usam SDK e campos de relatório derivados da Braze. Esses valores são gerados pelos serviços da Braze, então um perfil de usuário pode incluir tanto dados rastreados pelo SDK quanto dados gerados pela Braze.

As métricas calculadas incluem métricas baseadas em canal (listadas no Glossário de métricas de relatório) e os seguintes atributos.

Atributo Descrição
First used app Horário
Last used app Horário
Total session count Número
Clicked card Número
Last received any message Horário
Last received email campaign Horário
Last received push campaign Horário
Number of feedback items Número
Number of sessions in the last Y days Número e horário
Received message from campaign Booleano. Esse filtro direciona os usuários com base em terem recebido ou não uma Campaign anterior.
Received message from campaign with tag Booleano. Esse filtro direciona os usuários com base em terem recebido ou não uma Campaign que atualmente possui uma tag.
Retarget campaign Booleano. Esse filtro direciona os usuários com base em terem aberto ou clicado em um e-mail, push ou mensagem no app específicos no passado.
Uninstalled Booleano e horário

Integração mínima significa que você coleta apenas os dados obrigatórios listados em Integração mínima e desativa os dados opcionais coletados por padrão ao bloquear a coleta de dados opcionais do SDK.

Dados opcionais coletados por padrão

Além dos dados mínimos de integração, os seguintes atributos são capturados automaticamente pela Braze quando você inicializa a integração SDK. Você pode desativar a coleta desses atributos para permitir uma integração mínima.

Atributo Plataforma Descrição Por que é coletado
Nome do navegador Web Nome do navegador Esse atributo é usado para enviar mensagens apenas para navegadores compatíveis. Também pode ser usado para segmentação baseada em navegador.
Localidade do dispositivo Android, iOS, Web A localidade padrão do dispositivo Esse atributo é usado para traduzir mensagens para o idioma preferido do usuário.
Localidade mais recente do dispositivo Android, iOS, Web A localidade padrão mais recente do dispositivo Esse atributo vem das configurações do dispositivo do usuário e é usado para traduzir mensagens para o idioma preferido do usuário. É independente do atributo Most Recent Location.
Modelo do dispositivo Android, iOS O hardware específico do dispositivo Esse atributo é usado para enviar mensagens apenas para dispositivos compatíveis. Também pode ser usado na segmentação.
Marca do dispositivo Android A marca do dispositivo (por exemplo, Samsung) Esse atributo é usado para enviar mensagens apenas para dispositivos compatíveis.
Operadora sem fio do dispositivo Android, iOS A operadora de celular Esse atributo é usado opcionalmente para direcionamento de mensagens.

Nota: Este campo foi descontinuado a partir do iOS 16 e terá o valor padrão -- em uma versão futura do iOS.
Idioma Android, iOS, Web Idioma do dispositivo ou navegador, obtido a partir da localidade do dispositivo. Esse atributo é usado para traduzir mensagens para o idioma preferido do usuário. É baseado na localidade do dispositivo.
Configurações de notificação Android, iOS, Web Se este app tem notificações por push ativadas. Esse atributo é usado para ativar notificações por push.
Resolução Android, iOS, Web Resolução do dispositivo ou navegador Usado opcionalmente para direcionamento de mensagens baseado em dispositivo. O formato desse valor é “<width>x<height>”.
Fuso horário Android, iOS, Web Fuso horário do dispositivo ou navegador Esse atributo é usado para enviar mensagens no horário apropriado, de acordo com o fuso local de cada usuário.
User agent Web User agent Esse atributo é usado para enviar mensagens apenas para dispositivos compatíveis. Também pode ser usado na segmentação.

Para saber mais sobre o rastreamento de propriedades no nível do dispositivo (como operadora sem fio do dispositivo, fuso horário, resolução e outros), consulte a documentação específica da plataforma: Android, iOS, Web.

Dados não coletados por padrão

Por padrão, os seguintes atributos não são coletados. Cada atributo precisa ser integrado manualmente.

Atributo Plataforma Descrição Por que não é coletado
Device Ad Tracking Enabled Android, iOS No iOS:
set(adTrackingEnabled:)

No Android:
Braze.setGoogleAdvertisingId()		 Essa propriedade requer permissões adicionais no nível do app, que devem ser concedidas pelo integrador.
Device IDFA iOS Identificador de dispositivo para anunciantes Isso requer o framework Ad Tracking Transparency, que acionará uma análise de privacidade adicional da App Store. Para saber mais, consulte set(identifierForAdvertiser:)
Google Advertising ID Android Identificador para publicidade em apps do Google Play Isso requer que o app recupere o GAID e o passe para a Braze. Para saber mais, consulte Google Advertising ID opcional.
Localização mais recente Android, iOS Esta é a última localização GPS conhecida do dispositivo do usuário. É atualizada no início da sessão e armazenada no perfil do usuário. Isso requer que o usuário conceda permissão de localização ao seu app.

Integração personalizada

Para aproveitar ao máximo a Braze, nossos integradores de SDK frequentemente implementam os SDKs da Braze e registram atributos personalizados, eventos personalizados e eventos de compra que são relevantes para o negócio, além dos dados coletados automaticamente.

Uma integração personalizada permite uma comunicação customizada e relevante para a experiência dos seus usuários.
New Stuff!