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, as causas comuns são:

• Nenhuma licença do Currents foi adquirida para este espaço de trabalho.
• A licença do Currents está disponível em um espaço de trabalho diferente na sua empresa.

Para resolver isso, verifique outros espaços de trabalho na sua empresa. Um espaço de trabalho diferente pode ter uma licença do Currents disponível. Se você precisar solicitar uma licença 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 opções de rastreamento, seu espaço de trabalho pode ter atingido o limite de licença para essa categoria de eventos.

• Track Customer Behavior and User Events requer licenças disponíveis de Customer Behavior Events.
• Track user profiles and attributes requer licenças disponíveis de User Profiles and Attributes.

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

Requisitos

Para usar o Currents com qualquer um dos nossos parceiros, são necessários os mesmos parâmetros básicos e a mesma metodologia de conexão.

Cada parceiro requer que a Braze tenha permissão para gravar e enviar arquivos de dados a eles, e a Braze solicita o local onde esses arquivos devem ser gravados, especificamente nomes de buckets ou chaves.

Os requisitos a seguir são os requisitos básicos mínimos para integrar com a maioria dos nossos parceiros. Alguns parceiros exigirão parâmetros adicionais, que estão listados em suas respectivas documentações de parceiros, junto com quaisquer 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 permanentemente perdidos.

Configurando o Currents

Etapa 1: Escolha seu parceiro

O Braze Currents permite que você faça a integração por meio de Data Storage usando arquivos simples ou com nossos parceiros de análise de dados comportamentais e dados de cliente usando cargas úteis JSON em lote para um endpoint designado.

Antes de iniciar sua integração, é melhor decidir qual integração é mais adequada para seus objetivos. Por exemplo, se você já usa mParticle e Segment e gostaria que os dados da Braze fossem transmitidos para lá, o ideal seria usar uma carga útil JSON em lote. Se preferir manipular os dados por conta própria ou tiver um sistema de análise de dados mais complexo, pode ser melhor usar o Data Storage (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ção do Currents.

Etapa 3: Adicione seu parceiro

Adicione um parceiro, às vezes chamado de “conector Currents”, selecionando o menu suspenso no topo da tela.

Cada parceiro requer 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 transmitir para esse parceiro marcando as opções disponíveis. Você pode encontrar a lista desses eventos em nossas bibliotecas de Eventos de comportamento do cliente e Eventos de engajamento com mensagem.

Se necessário, você pode saber mais sobre nossos eventos no artigo de semântica de entrega de eventos.

Etapa 5: Configure transformações de campo

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

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

Selecionar um campo para uma dessas transformações aplicará essa transformação a todos os eventos nos quais esse campo aparecer. Por exemplo, selecionar email_address para hash aplicará o hash no campo email_address nos eventos Email Send, Email Open, Email Bounce e Subscription Group State Change.

Etapa 6: Teste sua integração

Importante

O Currents descartará eventos com cargas úteis excessivamente grandes, maiores que 900 KB.

Antes de testar, considere conferir nossos dados de exemplo do Currents no GitHub. Quando estiver pronto para testar, escolha uma opção na seção a seguir:

Enviando eventos de teste

Para testar sua integração, você pode selecionar Enviar eventos de teste para enviar um evento de cada um dos tipos de eventos selecionados para esse Current. Para informações detalhadas sobre cada tipo de evento, consulte nossas bibliotecas de Eventos de comportamento do cliente e Eventos de engajamento com mensagem.

Testando conectores do Currents

Os conectores de teste do Currents são versões gratuitas dos nossos conectores existentes que podem ser usadas para testar e experimentar diferentes destinos. Os Currents de teste possuem:

• Até 10 conectores de teste do Currents por espaço de trabalho.
• Um máximo agregado de 1.500 eventos por período fixo de 24 horas, reiniciando à meia-noite UTC. Esse total de eventos é atualizado a cada hora no dashboard.

Depois que seus conectores de teste do Currents atingirem o limite de envio, seu conector não enviará eventos até o dia seguinte (à meia-noite UTC).

Para fazer upgrade do seu conector de teste do Currents, edite a integração no dashboard e selecione Fazer upgrade da integração de teste.

Atualizando o 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ão de IPs

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

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