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 o Braze para coletar tipos adicionais de dados para aprimorar ainda mais seu segmento de mensagens.

O Braze foi projetado para permitir a coleta flexível de dados, portanto, você pode integrar o Braze SDK 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: O Braze captura automaticamente alguns dados que são amplamente úteis para a maioria de 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 Braze.
• Dados opcionais não coletados por padrão: O 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 aceitar coletar esses dados onde for mais adequado aos seus casos de uso.
• Integração personalizada: O Braze lhe dá a flexibilidade de coletar dados além dos dados opcionais padrão.

Integração mínima

A seguir, listamos os dados estritamente necessários gerados e recebidos pelo Braze quando você inicializa o SDK. Esses dados não são configuráveis e são essenciais para as principais funções da plataforma. Com exceção do início e do fim da sessão, todos os outros dados rastreados automaticamente não contam para sua cota 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. Ele pode ser usado para notificar os usuários sobre interrupções ou bugs no serviço.
País	País identificado pela geolocalização do endereço IP	Este atributo é usado para direcionar mensagens com base na localização.
ID do dispositivo	Identificador do dispositivo, uma string gerada aleatoriamente	Esse atributo é usado para diferenciar os dispositivos dos usuários e enviar mensagens para o dispositivo correto.
Sistema Operacional e versão do Sistema Operacional	Dispositivo ou navegador relatado atualmente e versão do dispositivo ou navegador	Esse atributo é usado para enviar mensagens apenas para dispositivos compatíveis. Também pode ser usado dentro da segmentação para direcionar os usuários a fazer upgrade das versões do app.
Início da sessão e fim da sessão	Quando o usuário começa a usar seu app ou site integrado	O SDK do Braze relata dados de sessão usados pelo dashboard do Braze para calcular o engajamento do usuário e outras análise de dados integrais para entender seus usuários. O momento exato do início e o do fim da sessão é chamado pelo seu app ou site e é configurável por um desenvolvedor (Android, iOS, Web).
Dados de interação de mensagem do SDK	Push aberturas diretas, interações de mensagem no app, interações de cartão de conteúdo	Este atributo é usado para fins de controle de qualidade, como verificar se uma mensagem foi recebida e se o envio não é duplicado.
Versão do SDK	Versão atual do SDK	Esse atributo é usado para enviar mensagens apenas para dispositivos compatíveis e evitar a interrupção do serviço.
ID da sessão e timestamp da sessão	Identificador da sessão, uma string gerada aleatoriamente e timestamp da sessão	Usado para determinar se o usuário está iniciando uma nova sessão ou uma sessão existente e para determinar a re-eligibilidade das mensagens destinadas a este usuário. Certos canais de envio de mensagens, como mensagens no app e Cartões de Conteúdo, são sincronizados com o dispositivo ao iniciar a sessão. Nosso backend usará então dados relacionados a quando ele contatou os servidores da Braze pela última vez (que o dispositivo armazena e envia de volta) para saber se o usuário é elegível para novas mensagens.

Métricas calculadas

O Braze gera métricas calculadas com base em dados do SDK, dados de interação de mensagens relacionados a mensagens que não são do SDK e informações derivadas. Para maior clareza, esses dados calculados não são rastreados pelo SDK, mas gerados pelos serviços da Braze, e um perfil de usuário exibirá tanto os dados rastreados quanto os dados gerados.

Métricas calculadas incluem os seguintes atributos.

Atributo	Descrição
Usou o app pela primeira vez	Horário
Usou o app pela última vez	Horário
Contagem total de sessões	Número
Clicou no cartão	Número
Última mensagem recebida	Horário
Última campanha de e-mail recebida	Horário
Última campanha de push recebida	Horário
Número de itens de feedback	Número
Número de sessões nos últimos Y dias	Número e tempo
Mensagem recebida da campanha	Booleano. Esse filtro direciona os usuários com base no fato de eles terem recebido uma campanha anterior.
Mensagem recebida da campanha com tag	Booleano. Esse filtro direciona os usuários com base no fato de eles terem recebido uma campanha que atualmente tem uma tag.
Redirecionar campanha	Booleano. Esse filtro direciona os usuários com base no fato de eles terem aberto ou clicado em um e-mail, push ou mensagem no app específico no passado.
Desinstalou	Boolean e tempo

Dados opcionais coletados por padrão

Além dos dados mínimos de integração, as seguintes atribuições são capturadas automaticamente pelo Braze quando você inicializa a integração de SDK. É possível fazer a aceitação da coleta dessas atribuições para permitir uma integração mínima.

Atributo	Plataforma	Descrição	Por que é coletado
Nome do navegador	Web	Nome do navegador	Essa atribuição é usada para enviar mensagens apenas para navegadores compatíveis. Também pode ser usado para segmentação baseada em navegador.
dispositivo local	Android, iOS	O local padrão do dispositivo	Esse atributo é usado para traduzir mensagens para o idioma preferido do usuário.
Modelo de 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 dentro da segmentação.
Marca de 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	Operadora móvel	Este atributo é opcionalmente usado para direcionamento de mensagens. Nota: Este campo foi descontinuado a partir do iOS 16 e será padrão para -- em uma versão futura do iOS.
Idioma	Android, iOS, Web	Idioma do dispositivo ou do navegador	Esse atributo é usado para traduzir mensagens para o idioma preferido do usuário.
Configurações de notificação	Android, iOS, Web	Se este app tem notificações por push ativadas.	Este atributo é usado para ativar notificações por push.
Resolução	Android, iOS, Web	Resolução do dispositivo ou do navegador	Opcionalmente usado para direcionamento de mensagens baseado em dispositivo. O formato deste valor é “<width>x<height>”.
Fuso horário	Android, iOS, Web	Fuso horário do dispositivo ou do navegador	Essa atribuição é usada para enviar mensagens no horário apropriado, de acordo com o fuso local de cada usuário.
Agente do usuário	Web	Agente do usuário	Esse atributo é usado para enviar mensagens apenas para dispositivos compatíveis. Também pode ser usado dentro da segmentação.

Para saber mais sobre o rastreamento de propriedades em nível de 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, as seguintes atribuições não são coletadas. Cada atribuição precisa ser integrada manualmente.

Atributo	Plataforma	Descrição	Por que não é coletado
Rastreamento de anúncios no dispositivi ativado	Android, iOS	No iOS: set(adTrackingEnabled:) No Android: Braze.setGoogleAdvertisingId()	Esta propriedade requer permissões adicionais de nível de app, que devem ser concedidas pelo integrador.
IDFA do dispositivo	iOS	Identificador de dispositivo para anunciantes	Isso requer o framework de Transparência de Rastreamento de Anúncios, que disparará uma revisão adicional de privacidade da App Store. Para mais detalhes, veja set(identifierForAdvertiser:)
ID de publicidade do Google	Android	Identificador para publicidade em aplicativos do Google Play	Isso requer que o app recupere o GAID e o passe para a Braze. Para mais detalhes, consulte ID de publicidade opcional do Google.

Integração personalizada

Para aproveitar ao máximo o Braze, nossos integradores de SDK geralmente implementam os SDKs do Braze e registram atributos personalizados, eventos personalizados e eventos de compra que são pertinentes aos seus negócios, além dos dados coletados automaticamente.

Uma integração personalizada permite uma comunicação personalizada que é relevante para a experiência dos seus usuários.