Perguntas frequentes
Esta página fornece respostas a algumas perguntas frequentes sobre o Currents.
Como faço para obter dados históricos?
O Currents é um fluxo de dados ao vivo e em tempo real, o que significa que os eventos não podem ser reproduzidos. No entanto, é possível armazenar os dados do Currents em um data warehouse, como o Amazon S3 ou o Microsoft Azure Blob Storage, para que você possa agir com base em eventos passados conforme achar necessário. Os dados são retidos por 30 dias, mas para obter mais dados históricos, você pode consultar o Snowflake.
Por que o Currents gera dados no formato Avro, e não em JSON?
O Avro, ao contrário do JSON sem esquema, suporta nativamente a evolução do esquema. Você também se beneficiará da capacidade de enviar arquivos Avro com menos largura de banda e economizar espaço de armazenamento, pois o Avro é altamente compactável.
Como a Braze lida com a sobrecarga de arquivos?
Criamos um processo de extração, transformação e carga (ETL), que permite extrair grandes quantidades de dados de um banco de dados para colocá-los e armazená-los em outro.
Onde devo armazenar esses dados para consulta?
A Braze tem parceria com vários data warehouses nos quais você pode armazenar seus dados para consulta. Recomendamos o uso de:
Qual é a confiabilidade dos dados do Currents?
O Currents garante a entrega “pelo menos uma vez” (at-least-once), o que significa que eventos duplicados podem ser gravados ocasionalmente no seu bucket de armazenamento. Se o seu caso de uso exigir entrega exatamente uma vez, você pode deduplicar eventos usando o campo de identificador único (id) enviado com cada evento. Para mais informações, consulte Semântica de entrega de eventos.
Com que frequência os dados são sincronizados com o Currents?
Os dados são transmitidos continuamente. A Braze envia um lote de eventos sempre que há um lote completo para enviar, ou a cada 5 minutos, o que ocorrer primeiro. Para conectores de alto volume, os dados chegam quase em tempo real. Para conectores de baixo volume, espere que os dados cheguem entre 5 e 30 minutos. Para mais informações, consulte Limite de gravação Avro.
Se um dispositivo não estiver conectado à internet, pode haver um atraso na criação do evento. Isso é mais comum para eventos de mensagens no app, já que mensagens no app podem ser disparadas offline.
Como descubro quais eventos estão disponíveis para o Currents?
Para uma lista completa dos eventos que o Currents registra, consulte os glossários de Eventos de comportamento do cliente e Eventos de engajamento com mensagem. Você pode filtrar esses glossários por tipo de evento (como envios, entregas ou aberturas).
Por que o external_id no meu evento de abertura ou clique de e-mail do Currents é diferente do perfil de usuário no dashboard da Braze?
- No dashboard da Braze: Quando um usuário associado a um endereço de e-mail abre ou clica em um e-mail, todos os perfis de usuário que compartilham esse endereço de e-mail são marcados como tendo aberto ou clicado nesse e-mail. Para mais informações, consulte O que acontece quando um e-mail é enviado e vários perfis têm o mesmo endereço de e-mail?.
- No Currents: Essa mesma abertura ou clique é armazenado em um único perfil. A Braze atribui o evento ao perfil que foi originalmente direcionado para o envio, caso esse perfil ainda compartilhe o endereço de e-mail. Caso contrário, a Braze atribui o evento a um perfil selecionado aleatoriamente entre aqueles que compartilham o endereço de e-mail.
Por isso, o external_id em um evento de abertura ou clique de e-mail do Currents pode não corresponder ao perfil de usuário que você espera ao comparar o Currents com o dashboard da Braze.
Todos os eventos de envio são registrados no Currents?
Todos os eventos são registrados no Currents. Não há cenários em que um evento seria intencionalmente suprimido do fluxo do Currents.
Os dados podem ser corrompidos no Currents?
Em circunstâncias normais, os dados do Currents não são corrompidos. Embora sempre exista a possibilidade de um problema raro, não há condições conhecidas em que os dados seriam sistematicamente corrompidos.
Por que vejo dados de eventos personalizados com datas anteriores à configuração da minha integração com o Currents?
A Braze não preenche retroativamente eventos no Currents. No entanto, eventos personalizados podem ser registrados com um timestamp passado (por exemplo, se um dispositivo estava offline quando o evento ocorreu e sincronizou depois). Nesses casos, o timestamp do evento reflete quando o evento ocorreu originalmente, o que pode ser antes da configuração da integração com o Currents.
Posso incluir atributos personalizados nos eventos de envio do Currents?
Não. O Currents não inclui atributos personalizados nos eventos de envio. O Currents registra eventos personalizados e eventos de engajamento com mensagem. Para uma lista completa dos campos disponíveis, consulte os glossários de eventos.
O Currents inclui tags de campanha ou pares chave-valor?
Não. O Currents não inclui tags de campanha ou pares chave-valor no nível da mensagem. Como alternativa, você pode usar um canal de webhook na campanha para enviar essas informações ao seu próprio endpoint, usando Liquid para modelar os dados de tags e pares chave-valor.
Como a Braze notifica os clientes sobre mudanças no Currents?
Quando ocorrem mudanças no Currents (como novos campos de evento ou tipos de evento), a Braze envia um e-mail para todos os clientes com integrações ativas do Currents que usaram o dashboard nos últimos 30 dias. Você também pode consultar o changelog do Currents para ver as últimas alterações.
Quanto armazenamento eu preciso para os dados do Currents?
Os requisitos de armazenamento dependem do volume de eventos e dos tipos de eventos que você está exportando. A Braze fornece exemplos de eventos no formato Avro que você pode usar para estimar o tamanho dos arquivos para o seu caso de uso.
Por que o nome da campanha ou o nome da etapa do Canvas está NULL nos meus dados do Currents?
Quando você cria uma nova campanha ou Canvas, o nome pode levar algum tempo para se propagar por todos os sistemas da Braze. Eventos enviados pelo Currents durante esse intervalo podem ter NULL nos campos de nome (como campaign_name ou canvas_step_name). Isso também é esperado se o nome foi modificado pouco antes dos eventos serem registrados. Para evitar isso, aguarde algum tempo após criar ou renomear uma campanha ou etapa do Canvas antes de enviar.
O que acontece se meu bucket de armazenamento estiver indisponível quando o Currents tentar gravar dados?
Se o seu bucket de armazenamento estiver indisponível no momento da transferência de dados, esses dados serão perdidos. A Braze não consegue preencher retroativamente eventos que não foram entregues com sucesso. Para evitar perda de dados, certifique-se de que seu bucket de armazenamento esteja disponível e configurado corretamente o tempo todo.
Por que vejo “You do not have any remaining Customer Behavior Events entitlements” ao editar minha integração com o Currents?
Essa mensagem pode aparecer quando você atualiza uma integração existente do Currents e seu espaço de trabalho atingiu o limite de direitos para eventos de comportamento do cliente. Entre em contato com o gerente de conta da Braze para solicitar um aumento de direitos ou ajustar sua configuração.
Com que frequência a versão do Currents no caminho de armazenamento muda?
O segmento version=<currents_version> no caminho de armazenamento avança a cada lançamento do Currents em uma cadência mensal (por exemplo, de version=6 para version=7). Recomendamos ler os arquivos recursivamente a partir do caminho raiz em vez de codificar um segmento de versão específico, para que seu pipeline capture automaticamente os dados após uma mudança de versão. Para mais informações sobre o formato do caminho, consulte Semântica de entrega de eventos. Para um histórico de alterações por versão, consulte o changelog do Currents.
Por que campaign_id ou canvas_id estão ausentes em um evento de engajamento com mensagem?
Dependendo do tipo de evento e do contexto, um evento de engajamento com mensagem pode não estar vinculado a uma campanha ou etapa do Canvas específica. Nesses casos, campaign_id, canvas_id e campos de nome relacionados podem ser omitidos da carga útil do evento. Se você não encontrar esses campos em um determinado evento, verifique se aquele tipo de evento e contexto normalmente incluem identificadores de campanha ou Canvas.