Configurar Currents

Esta página descreve o processo genérico de integração e configuração do Braze Currents.

Importante

O Currents está incluído em determinados pacotes da Braze. Entre em contato com seu representante da Braze se tiver alguma dúvida ou quiser obter acesso.

Solução de problemas

Não é possível adicionar uma nova integração do Currents

Se você vir a mensagem “You do not have any remaining Currents integrations” ao adicionar uma nova integração, ou se o botão para adicionar um novo conector do Currents estiver desativado (em cinza), as causas mais comuns são:

• Nenhum direito de uso do Currents foi adquirido para este espaço de trabalho.
• O direito de uso do Currents está disponível em outro espaço de trabalho da sua empresa.

Para resolver, confira os outros espaços de trabalho da sua empresa. Outro espaço de trabalho pode mostrar um direito de uso do Currents disponível. Se você precisar solicitar um direito de uso ou ajustar sua configuração, entre em contato com o gerente de conta da Braze.

Não é possível ativar o rastreamento de eventos adicionais

Se você consegue criar ou editar um conector, mas não consegue ativar uma das chaves opcionais de rastreamento, seu espaço de trabalho pode ter atingido o limite de direitos de uso para essa categoria de eventos.

• Track Customer Behavior and User Events exige direitos de uso de Customer Behavior Events disponíveis.
• Track user profiles and attributes exige direitos de uso de User Profiles and Attributes disponíveis.

Se você precisar de direitos de uso adicionais ou de ajuda para ajustar sua configuração, entre em contato com o gerente de conta da Braze.

Entendendo as notificações de erro da integração

Quando uma integração do Currents tem problemas para entregar eventos, a Braze envia um e-mail para os endereços de contato definidos nessa integração. Se a integração não tiver um e-mail de contato, a Braze pede à sua equipe de conta da Braze que entre em contato com a pessoa certa. Para receber esses avisos diretamente, adicione um e-mail de contato a cada integração.

Todos os avisos usam a mesma linha de assunto, “[Urgent Action Required to Prevent Data Loss] Nome da empresa Tipo de integração Currents integration failing”, inclusive os avisos de que a integração se recuperou. Para identificar qual aviso você recebeu, encontre na tabela a seguir a frase correspondente no corpo do e-mail. Se o e-mail disser que a integração foi desativada, use a linha correspondente a “disabled”, mesmo que o e-mail também diga que a integração continua falhando.

Requisitos

O uso do Currents com qualquer um de nossos parceiros exige os mesmos parâmetros básicos e a mesma metodologia de conexão.

Cada parceiro exige que a Braze tenha permissão para gravar e enviar arquivos de dados a ele. A Braze também solicita o local onde deve gravar esses arquivos, especificamente nomes de buckets ou chaves.

Os requisitos a seguir são os requisitos básicos mínimos para integrar com a maioria de nossos parceiros. Alguns parceiros exigem parâmetros adicionais, que estão listados na documentação do respectivo parceiro, junto com as particularidades associadas a esses requisitos básicos.

Importante

É importante manter suas chaves de parceiro, tokens de parceiro e dados de autenticação atualizados. Se as credenciais do seu conector expirarem, o conector deixará de enviar eventos. Se isso persistir por mais de 5 dias, os eventos do conector serão descartados e os dados serão perdidos permanentemente.

Configuração do Currents

Etapa 1: Escolha seu parceiro

Com o Braze Currents, você pode se integrar via Data Storage usando arquivos simples. Também pode se integrar aos nossos parceiros de análise de dados comportamentais e de dados de clientes, enviando cargas úteis JSON em lote para um endpoint designado.

Antes de começar a integração, decida qual opção atende melhor às suas necessidades. Por exemplo, se você já usa o mParticle e o Segment e quer transmitir os dados da Braze para eles, o ideal é usar uma carga útil JSON em lote. Se você prefere manipular os dados por conta própria ou tem um sistema de análise de dados mais complexo, o Data Storage pode ser a melhor opção (a Braze usa esse método!)

Etapa 2: Abra o Currents

Para começar, acesse Integrações de parceiros > Currents. Você será direcionado para a página de gerenciamento de integrações do Currents.

Etapa 3: Adicione seu parceiro

Adicione um parceiro, às vezes chamado de “conector do Currents”, selecionando o menu suspenso na parte superior da tela.

Cada parceiro exige um conjunto diferente de etapas de configuração. Para ativar cada integração, consulte nossa lista de parceiros disponíveis e siga as instruções nas respectivas páginas.

Forneça um e-mail de contato para notificações de erros de integração. A Braze envia notificações para esse endereço se a integração encontrar erros, como problemas de credencial ou de conectividade. Para garantir que as pessoas certas recebam os alertas, use uma lista de distribuição ou um endereço de e-mail de grupo.

Etapa 4: Configure seus eventos

Escolha os eventos que deseja enviar para esse parceiro marcando as opções disponíveis. Você encontra a lista desses eventos nas nossas bibliotecas de eventos de comportamento do cliente e de eventos de engajamento com mensagens.

Se precisar, saiba mais sobre nossos eventos no artigo sobre semântica de entrega de eventos.

Etapa 5: Configure as transformações de campo

Você pode usar as transformações de campo do Currents para remover ou aplicar hash a um campo de string.

• Remover: Substitui o campo de string por [REDACTED]. Isso é útil se o seu parceiro rejeitar eventos com campos ausentes ou em branco.
• Hash: Aplica um algoritmo de hash SHA-256 ao campo de string.

Ao selecionar um campo para uma dessas transformações, ela será aplicada a todos os eventos em que esse campo aparece. Por exemplo, ao selecionar email_address para hash, o campo email_address receberá hash nos eventos Email Send, Email Open, Email Bounce e Subscription Group State Change.

As transformações de campo funcionam apenas em campos de string. Outros tipos de campo, como arrays, não ficam disponíveis para seleção, então não é possível removê-los nem aplicar hash a eles. Por exemplo, o campo de array suspected_bot_click_reason nos eventos Email Click permanece na sua exportação.

Edite as transformações de campo em um conector ativo

Você pode adicionar, alterar ou remover transformações de campo em um conector ativo sem precisar relançá-lo. Depois de atualizar o conector, suas alterações entram em vigor em cerca de 5 minutos.

Editar as transformações de campo não altera a versão do esquema Avro nem o segmento version=<currents_version> no seu caminho de armazenamento. Somente as versões do Currents alteram esse segmento. Para saber mais, consulte Alterações no esquema Avro.

Etapa 6: Teste sua integração

Importante

O Currents descarta eventos com cargas úteis excessivamente grandes, acima de 900 KB.

Antes de testar, confira nossos dados de exemplo do Currents no GitHub. Quando estiver pronto para testar, escolha uma das opções da seção a seguir:

Envio de eventos de teste

Para testar sua integração, selecione Send Test Events para enviar um evento de cada tipo de evento selecionado para este Current. Para obter informações detalhadas sobre cada tipo de evento, consulte nossas bibliotecas de eventos de comportamento do cliente e de eventos de engajamento com mensagens.

Teste de conectores do Currents

Os conectores de teste do Currents são versões gratuitas dos nossos conectores existentes, que você pode usar para testar e experimentar diferentes destinos. Os Test Currents têm:

• Até 10 conectores de Test Currents por espaço de trabalho.
• Um máximo agregado de 1.500 eventos por período fixo de 24 horas, redefinido à meia-noite UTC. Na página Currents, você pode acompanhar seu volume de envio atual em relação a esse limite. A Braze atualiza esse total a cada hora.

A Braze verifica o uso dos Test Currents em relação a esse limite uma vez por hora. Se um grande volume de eventos chegar entre duas verificações, seus conectores de Test Currents podem exportar mais de 1.500 eventos nesse período antes que o limite entre em vigor.

Quando uma verificação horária identifica que seus conectores de Test Currents atingiram o limite de envio, a Braze desativa o conector e descarta os eventos criados enquanto o limite estiver atingido. A sincronização de eventos é retomada depois que o limite é redefinido à meia-noite UTC.

Para fazer upgrade do seu conector de Test Currents, edite a integração no dashboard e selecione Upgrade Test Integration.

Atualização do Currents

Para atualizar seu conector Currents após o lançamento, faça o seguinte:

1. Na Braze, navegue até Integrações de parceiros > Exportação de dados.
2. Localize o seu conector Currents na lista.
3. Selecione  Editar.
4. Faça suas alterações.
5. Selecione Atualizar Current.

Isso não interromperá sua exportação existente e começará a enviar eventos de acordo com sua nova seleção.

Nota

Pode levar algum tempo para que suas alterações entrem em vigor.

Lista de permissões de IP

A Braze enviará os dados do Currents a partir dos IPs listados:

• united states (us)
• european union (eu)
• australia (au)
• indonesia (id)
• japan (jp)
• south korea (kr)