Visão geral do SDK para desenvolvedores
Antes de começar a integrar os SDKs da Braze, você pode se perguntar o que exatamente está desenvolvendo e integrando. Talvez você esteja curioso para saber como pode personalizar o SDK para atender ainda mais às suas necessidades. Este artigo pode ajudar a esclarecer todas as suas dúvidas sobre o SDK.
Você é um profissional de marketing e está procurando um resumo básico do SDK? Em vez disso, dê uma olhada em nossa visão geral para profissionais de marketing.
Em resumo, o SDK da Braze:
- Coleta e sincroniza dados de usuários em um perfil de usuário consolidado
- Coleta automaticamente dados da sessão, informações do dispositivo e tokens por push
- Captura dados de engajamento de marketing e dados personalizados específicos do seu negócio
- Potencializa as notificações por push, as mensagens no app e os canais de envio de mensagens do cartão de conteúdo
Assista ao vídeo a seguir para uma breve introdução aos conceitos básicos de integração do SDK da Braze e suas funcionalidades principais.
Performance do app
A Braze não deve ter nenhum impacto negativo na performance do seu app.
Os SDKs da Braze têm uma pegada muito pequena. Nós ajustamos automaticamente a taxa de envio dos dados de usuários dependendo da qualidade da rede, além de permitir o controle manual da rede. Agrupamos automaticamente as solicitações de API do SDK para garantir que os dados sejam registrados rapidamente, mantendo a máxima eficiência de rede. Por fim, a quantidade de dados enviados do cliente para a Braze em cada chamada de API é extremamente pequena.
Compatibilidade do SDK
O SDK da Braze foi projetado para funcionar muito bem e não interferir com outros SDKs presentes no seu app. Se você estiver enfrentando problemas que possam ser causados por incompatibilidade com outro SDK, entre em contato com o suporte da Braze.
Tratamento padrão de análise de dados e sessões
Alguns dados de usuário são coletados automaticamente pelo nosso SDK — por exemplo, Primeiro Uso do App, Último Uso do App, Contagem Total de Sessões, SO do Dispositivo, etc. Se você seguir nossos guias de integração para implementar nossos SDKs, poderá aproveitar essa coleta de dados padrão. Verificar essa lista pode ajudar a evitar o armazenamento das mesmas informações sobre os usuários mais de uma vez. 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.
Todos os nossos recursos são configuráveis, mas é uma boa ideia implementar completamente o modelo de coleta de dados padrão.
Se necessário para o seu caso de uso, você pode limitar a coleta de determinados dados após a conclusão da integração.
Upload e download de dados
O SDK da Braze armazena dados em cache (sessões, eventos personalizados, etc.) e faz upload periodicamente. Os valores só serão atualizados no dashboard após o upload dos dados. O intervalo de upload leva em consideração o estado do dispositivo e é determinado pela qualidade da conexão de rede:
| Qualidade da conexão de rede | Intervalo de envio de dados |
|---|---|
| Ótima | 10 segundos |
| Boa | 30 segundos |
| Ruim | 60 segundos |
Se não houver conexão de rede, os dados serão armazenados em cache localmente no dispositivo até que a conexão seja restabelecida. Quando a conexão for restabelecida, os dados serão enviados para a Braze.
A Braze envia dados para o SDK no início de uma sessão com base nos Segments em que o usuário se encontra no momento da sessão. As novas mensagens no app não serão atualizadas durante a sessão. No entanto, os dados do usuário durante a sessão continuarão sendo processados conforme são enviados pelo cliente. Por exemplo, um usuário inativo (que não usou o app há mais de 7 dias) ainda receberá conteúdo direcionado a usuários inativos em sua primeira sessão de volta ao app.
Bloqueio da coleta de dados
É possível (embora não recomendado) bloquear a coleta automática de determinados dados da sua integração SDK ou adicionar processos a uma lista de permissões.
Bloquear a coleta de dados não é recomendado, pois remover dados analíticos reduz a capacidade da sua plataforma de personalização e direcionamento. Por exemplo:
- Se você optar por não integrar totalmente a localização em um dos SDKs, não será possível personalizar suas mensagens com base no idioma ou local.
- Se você optar por não integrar o fuso horário, talvez não consiga enviar mensagens no fuso horário do usuário.
- Se você optar por não integrar informações visuais específicas do dispositivo, o conteúdo das mensagens pode não ser otimizado para aquele dispositivo.
Recomendamos fortemente a integração completa dos SDKs para aproveitar ao máximo os recursos do nosso produto.
Você pode simplesmente não integrar determinadas partes do SDK ou usar disableSDK para um usuário. Esse método sincronizará os dados registrados antes da chamada de disableSDK() e fará com que todas as chamadas subsequentes ao SDK da Braze para Web nessa página e em carregamentos futuros sejam ignoradas. Se você quiser retomar a coleta de dados posteriormente, poderá usar o método enableSDK() para retomar a coleta de dados. Saiba mais sobre isso no nosso artigo Desativando o rastreamento web.
Você pode usar setDeviceObjectAllowlist para configurar o SDK de modo que envie apenas um subconjunto das chaves ou valores do objeto de dispositivo de acordo com uma lista de permissões definida. Isso deve ser ativado via setDeviceObjectAllowlistEnabled.
Uma lista de permissões vazia fará com que nenhum dado do dispositivo seja enviado à Braze.
Você pode atribuir um conjunto de campos elegíveis a configuration.devicePropertyAllowList na sua Braze.Configuration para especificar uma lista de permissões para os campos de dispositivo coletados pelo SDK. A lista completa de campos está definida em Braze.Configuration.DeviceProperty. Para desativar a coleta de todos os campos de dispositivo, defina o valor dessa propriedade como um conjunto vazio ([]).
Por padrão, todos os campos são coletados pelo SDK Swift da Braze. A remoção de algumas propriedades do dispositivo pode desativar recursos do SDK.
Para mais detalhes de uso, consulte Armazenamento na documentação do SDK Swift.
Qual versão do SDK estou usando?
Você pode usar o dashboard para ver a versão do SDK de um app específico acessando Configurações > Configurações do app. A Versão do SDK ativo lista a versão mais recente do SDK da Braze utilizada pelo seu aplicativo ativo mais recente para pelo menos 5% dos seus usuários.
Se você tem um app iOS, pode confirmar que está usando o Swift SDK em vez do legado Objective-C iOS SDK se a sua Versão do SDK ativo for igual ou superior a 5.0.0, que foi a primeira versão lançada do Swift SDK.