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 esmaecido, 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 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 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.

Requisitos

Para usar o Currents com qualquer um de nossos parceiros, são necessários 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 para eles, e a Braze solicita o local onde esses arquivos devem ser gravados, especificamente nomes de bucket ou chaves.

Os requisitos a seguir são os requisitos básicos e mínimos para integração com a maioria de nossos parceiros. Alguns parceiros exigirão parâmetros adicionais, que estão listados em suas respectivas documentações de parceiros, juntamente 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, ele 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ê se integre por meio do 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á, seria melhor usar uma carga útil JSON em lote. Se você preferir manipular os dados por conta própria ou tiver um sistema mais complexo de análise de dados, 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ções do Currents.

Etapa 3: Adicione seu parceiro

Adicione um parceiro, às vezes chamado de “conector Currents”, selecionando o menu suspenso na parte superior 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 enviar para esse parceiro marcando as opções disponíveis. Você pode encontrar listagens 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 as 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 o seu parceiro rejeitar 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 aparece. Por exemplo, selecionar email_address para hash aplicará hash ao campo email_address nos eventos de envio de e-mail, abertura de e-mail, bounce de e-mail e alteração de estado do grupo de inscrições.

Etapa 6: Teste sua integração

Importante

O Currents descartará eventos com cargas úteis excessivamente grandes, superiores a 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 evento selecionados para este 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 usados para testes e para experimentar diferentes destinos. Os conectores de teste do Currents 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ões de IP

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)