Skip to content

Perguntas frequentes

Esta página fornece respostas a algumas perguntas frequentes sobre o Currents.

Posso exportar dados de Campaign ou Canvas para um período específico?

Para obter métricas de Campaign ou Canvas em um intervalo de datas definido, use uma das seguintes abordagens:

Como edito uma integração ativa do Currents?

Para alterar um conector ativo do Currents, abra a integração e clique em Editar no canto inferior esquerdo da página. Sem o botão Editar, a interface da integração permanece somente leitura e você não consegue modificar as configurações do conector apenas pelos ícones.

Como a Braze lida com arquivos Avro do Azure Blob Storage após o upload?

A Braze não modifica arquivos Avro no Microsoft Azure Blob Storage após a conclusão do upload. O Azure pode bloquear a exclusão de um blob enquanto um upload ainda estiver em andamento.

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.

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 as contagens de eventos do Currents não correspondem às métricas do meu dashboard ou relatório de engajamento?

O Currents e o dashboard da Braze calculam certas métricas de formas diferentes, então correspondências exatas entre os eventos do Currents e as métricas do dashboard não são esperadas.

Cliques únicos: Para e-mail, o dashboard rastreia cliques únicos em um período de sete dias e os mede por dispatch_id. O Currents registra cada evento de clique bruto. Para alinhar as contagens de cliques únicos baseadas no Currents com as métricas do dashboard, filtre por eventos em que is_unique seja true.

Cancelamentos de inscrição: A métrica Unsub do dashboard reflete cliques no link padrão de cancelamento de inscrição da Braze. Páginas personalizadas de cancelamento de inscrição não incrementam essa métrica, a menos que você atualize o usuário pela API. O evento users.messages.email.Unsubscribe do Currents é um evento de clique especializado que é disparado quando um usuário clica em um link de cancelamento de inscrição no corpo ou rodapé do e-mail, ou pelo cabeçalho list-unsubscribe. Ele não representa toda mudança de estado de inscrição de e-mail.

Timestamps e fusos horários: Todos os timestamps do Currents estão em UTC. As métricas do dashboard seguem o fuso horário da sua empresa. Agregar dados do Currents por dia do calendário sem converter para o fuso horário da sua empresa pode fazer com que as contagens caiam em intervalos de datas diferentes dos exibidos no dashboard.

Eventos duplicados: O Currents fornece entrega pelo menos uma vez (at-least-once), o que significa que eventos duplicados podem ser gravados ocasionalmente. Deduplique pelo campo único id em cada evento antes de comparar os totais com as métricas do dashboard.

Por que o external_user_id (esquema Braze: 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 valor de external_user_id (chamado external_id na tabela de mapeamento do esquema Braze) 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.

Quais identificadores de usuário estão incluídos nos eventos do Currents?

Os eventos de engajamento com mensagem (envios, aberturas, cliques etc.) incluem o ID de usuário da Braze (user_id) e, quando presente no perfil, o identificador externo (external_user_id nas cargas úteis de evento, rotulado como external_id na tabela de mapeamento do esquema Braze). Alguns eventos de engajamento com mensagem de e-mail também incluem email_address. Atributos personalizados não são incluídos — veja abaixo.

Se você estiver roteando dados do Currents para um data warehouse ou CRM e precisar fazer join com dados de perfil, realize esse join no seu sistema downstream usando user_id ou external_user_id.

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 Campaign ou Canvas, ou pares chave-valor?

Não. O Currents não inclui tags de Campaign ou Canvas, nem pares chave-valor no nível da mensagem. Para recuperar dados de tags, use a REST API de exportação. Como alternativa, você pode usar um canal de webhook em uma Campaign para enviar dados de tags ou pares chave-valor ao seu próprio endpoint, usando Liquid para modelar os valores.

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 Campaign ou o nome da etapa do Canvas está NULL nos meus dados do Currents?

Quando você cria uma nova Campaign 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 Campaign ou etapa do Canvas antes de enviar.

Por que os eventos de fim de sessão estão atrasados ou ausentes no Currents?

Os eventos de fim de sessão seguem o cronograma normal de upload do SDK. O SDK da Braze armazena os dados de sessão localmente em cache e os envia periodicamente com base na qualidade da rede — por exemplo, a cada 10 segundos em uma conexão estável. Até que o SDK faça o upload do evento, ele não aparece no Currents.

Se um usuário forçar o encerramento do app ou ficar offline antes do próximo envio, o evento de fim de sessão pode chegar com atraso ou não chegar. No iOS, os eventos de fim de sessão geralmente não são enviados até que o app seja reaberto, pois o SDK não consegue enviar dados enquanto o app está em segundo plano.

Quando você precisar de limites de sessão mais precisos no Currents, chame requestImmediateDataFlush() em pontos do ciclo de vida, como quando o app vai para segundo plano ou retorna ao primeiro plano. Para mais informações, consulte Upload e download de dados e Fim de sessão e início de sessão com timestamps semelhantes (iOS).

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 Campaign 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 Campaign ou Canvas.

Por que os timestamps do Currents são limitados à precisão de segundos?

O campo time nos eventos do Currents é armazenado como um inteiro de 32 bits e, portanto, é limitado à precisão de segundos. Alguns eventos também incluem um campo de timestamp separado de 64 bits com precisão de milissegundos; consulte o glossário de eventos para ver os campos disponíveis em cada tipo de evento.

Por que o evento users.canvas.Conversion do Currents tem um horário diferente do Canvas?

O horário do evento users.canvas.Conversion no Currents reflete a janela de conversão total — a duração do Canvas mais o prazo de conversão — medida a partir da entrada no Canvas.

O que acontece quando relatórios de engajamento são enviados para o S3?

Se as credenciais do S3 estiverem configuradas para exportação de dados, mas não para o Currents, a Braze faz o upload dos relatórios de engajamento para o bucket S3 especificado. O usuário listado no campo Enviar relatório para recebe um e-mail com um link para o relatório no S3.

Dados de usuários anônimos podem ser enviados para o Amplitude pelo Braze Currents?

Dados de usuários anônimos, identificados por device_id, podem ser enviados para o Amplitude pelo Currents. Isso requer a ativação do recurso pela equipe de conta da Braze.

Como as impressões do grupo de controle para Content Cards e mensagens no app são registradas no Currents?

Quando um usuário é atribuído a um grupo de controle de uma Campaign de Content Cards ou mensagem no app, o Currents emite um evento users.campaigns.EnrollInControl em vez de um evento de impressão.

O que acontece quando você direciona um usuário inexistente pela API?

Quando você direciona um usuário que não existe, a API retorna uma resposta 200, mas o envio é cancelado com o resultado “Unknown external ID”. Nenhum evento do Currents é gerado para esse envio. Observe que o parâmetro send_to_existing_only tem o valor padrão true, então envios para usuários desconhecidos são silenciosamente ignorados, a menos que você defina explicitamente o valor como false.
New Stuff!