Configurar Currents

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

Se você vir a mensagem “Você não tem mais integrações de Currents disponíveis” ao adicionar uma nova integração, as causas mais comuns são:

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

Entre em contato com seu gerente de conta da Braze para solicitar uma permissão ou ajustar sua configuração.

Requisitos

O uso do Currents com qualquer um de nossos parceiros requer 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 em que esses arquivos devem ser gravados, especificamente nomes de buckets ou chaves.

Os requisitos a seguir são os requisitos básicos e mínimos para a 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 nuances associadas a esses requisitos básicos.

Requisito	Origin	Acesso	Descrição
Conta com parceiro	Crie uma conta com esse parceiro ou entre em contato com seu gerente de conta da Braze para sugestões.	Verifique o site desse parceiro ou entre em contato para se inscrever.	A Braze não enviará dados a um parceiro se você não tiver acesso a esses dados por meio da conta da sua empresa.
Chave de API ou token do parceiro	Normalmente, o dashboard do parceiro.	Copie e cole no campo designado da Braze.	A Braze tem um campo designado para isso na página de integrações para esse parceiro. Precisamos disso para mapear para onde enviamos seus dados. Mantenha suas chaves ou tokens de parceiro atualizados; credenciais inválidas podem desativar seu conector e descartar eventos.
Código/chave de autenticação, chave secreta, arquivo de certificado	Entre em contato com um representante da sua conta com esse parceiro. Também pode existir no dashboard do parceiro.	Copie e cole as chaves no campo designado da Braze. Gere e faça upload de arquivos .json ou outros arquivos de certificado no local apropriado na Braze.	A Braze tem um campo designado para isso na página de integrações para esse parceiro. Isso fornece credenciais à Braze e nos autoriza a gravar arquivos na sua conta de parceiro. É importante manter suas informações de autenticação atualizadas; credenciais inválidas podem resultar na desativação do conector e no descarte de eventos.
Bucket, caminho da pasta	Alguns parceiros organizam e classificam os dados por buckets. Isso pode ser encontrado no dashboard do parceiro.	Se isso for necessário, copie o nome do bucket ou o caminho do arquivo exatamente no espaço designado na Braze.	Embora isso seja necessário para alguns parceiros, é importante acertar quando você precisar.

Configuração do Currents

Etapa 1: Escolha seu parceiro

O Braze Currents permite a integração por meio do armazenamento de dados usando arquivos simples ou com nossos parceiros de análise comportamental 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 é a mais adequada para seus objetivos. Por exemplo, se você já utiliza o mParticle e o Segment e gostaria que os dados da Braze fossem enviados para lá, seria melhor usar uma carga útil JSON em lote. Se preferir manipular os dados por conta própria ou tiver um sistema mais complexo de análise de dados, talvez seja melhor usar o armazenamento de dados (a Braze usa esse método!)

Etapa 2: Abra o Currents

Para começar, acesse Integrações de parceiros > Currents. Você será levado à página de gerenciamento de integração do Currents.

Etapa 3: Adicione seu parceiro

Adicione um parceiro, às vezes chamado de “conector de 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 em suas respectivas páginas.

Etapa 4: Configure seus eventos

Escolha os eventos que você deseja enviar para esse parceiro marcando as opções disponíveis. Você pode encontrar listas 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 sobre 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 em que esse campo aparecer. Por exemplo, ao selecionar email_address para hash, o campo email_address será submetido a hash 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

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

Enviando eventos de teste

Para testar sua integração, você pode selecionar Enviar eventos de teste para enviar um evento de cada um dos seus 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.

Teste de conectores de Currents

Os conectores de teste de Currents são versões gratuitas de nossos conectores existentes que podem ser usados para testar e experimentar diferentes destinos. Os Currents de teste têm:

• Até 10 conectores de teste de 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 de hora em hora no dashboard.

Após seus conectores de teste de 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 de Currents, edite a integração no dashboard e selecione Fazer upgrade da integração de teste.

Atualização do Currents

Para atualizar seu conector Currents após a inicialização, faça o seguinte:

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

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

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)