Curso de aprendizado do Braze](https://learning.braze.com/currents-the-basics-2/){: style=”float:right;width:120px;border:0;” class=”noimgborder”} Configurando correntes
Esta página delineia e descreve o processo genérico de integração e configuração do Braze Currents.
As correntes estão incluídas em determinados pacotes do Braze. Entre em contato com seu representante Braze se tiver alguma dúvida ou quiser obter acesso.
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 o Braze tenha permissão para gravar e enviar arquivos de dados para eles, e o Braze solicita o local em que eles devem gravar esses arquivos, especificamente nomes ou chaves de bucket.
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 nuances associadas a esses requisitos básicos.
| Requisito | Origem | Acesso | Descrição |
|---|---|---|---|
| Conta com parceiro | Organize uma conta com esse parceiro ou entre em contato com seu gerente de conta Braze para obter sugestões. | Verifique o site do parceiro ou entre em contato com ele para se inscrever. | O Braze não enviará dados a um parceiro se você não tiver acesso a esses dados por meio da conta de sua empresa. |
| Chave ou token da API do parceiro | Normalmente, o painel de controle do parceiro. | Basta copiá-lo e colá-lo no campo Braze designado. | O Braze tem um campo designado para isso na página de integrações para esse parceiro. Precisamos disso para mapear para onde estamos enviando seus dados. É importante manter as chaves de parceiro ou os tokens atualizados; credenciais inválidas podem resultar na desativação do conector e na interrupção de eventos. |
| Código/chave de autenticação, chave secreta, arquivo de certificação | Entre em contato com um representante da sua conta com esse parceiro. Também pode existir no painel de controle do parceiro. | Copie e cole as chaves no campo Braze designado. Gerar e carregar .json ou outros arquivos de certificação no local apropriado no Braze. |
O 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 em sua conta de parceiro. É importante manter seus detalhes de autenticação atualizados; credenciais inválidas podem resultar na desativação do seu conector e no descarte de eventos. |
| Bucket, caminho da pasta | Alguns parceiros organizam e classificam os dados por grupos. Isso deve ser encontrado no painel de controle do parceiro. | Se isso for necessário, certifique-se de copiar o nome do bucket ou o caminho do arquivo exatamente no espaço designado no Braze. Não queremos que seus dados se percam! | Embora isso seja necessário para alguns parceiros, é importante acertar quando você precisar. |
É importante manter suas chaves de parceiro, tokens de parceiro e detalhes 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 de correntes
Etapa 1: Escolha seu parceiro
O Braze Currents permite que você faça a integração por meio do armazenamento de dados usando arquivos simples ou com nossos parceiros de análise comportamental e dados de clientes usando cargas JSON em lote para um endpoint designado.
Antes de iniciar sua integração, é melhor decidir qual integração é a melhor para seus objetivos. Por exemplo, se você já usa o mParticle e o Segment e gostaria que os dados do Braze fossem transmitidos para lá, seria melhor usar um payload JSON em lote. Se você preferir manipular os dados por conta própria ou tiver um sistema mais complexo de análise de dados, talvez seja melhor usar o Data Storage(o Braze usa esse método!)
Etapa 2: Correntes abertas
Para começar, vá para Partner Integrations > Data Export. Você será levado à página de gerenciamento da integração do Currents.
!Página atual no painel de controle do Braze
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 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 passar para esse parceiro marcando uma das opções disponíveis. Você pode encontrar listas desses eventos em nossas bibliotecas Customer Behavior Events e Message Engagement Events.
Se necessário, você pode saber mais sobre nossos eventos em nosso artigo sobre semântica de entrega de eventos.
Etapa 5: Configurar transformações de campo
Você pode usar as transformações de campo do Currents para remover ou colocar em hash um campo de cadeia de caracteres.
- Remover: Substitui o campo 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 da cadeia de caracteres.
A seleção de um campo para uma dessas transformações aplicará essa transformação a todos os eventos em que esse campo aparecer. Por exemplo, a seleção de email_address para hashing fará o hash do campo email_address nos eventos Email Send (Envio de e-mail), Email Open (Abertura de e-mail), Email Bounce (Rejeição de e-mail) e Subscription Group State Change (Mudança de estado do grupo de assinatura).
!Adicionando transformações de campo
Etapa 6: Teste sua integração
O Currents descartará eventos com cargas úteis excessivamente grandes, superiores a 900 KB.
Antes de testar, considere verificar nossos dados de amostra do Currents no GitHub. Quando estiver pronto para testar, escolha uma opção abaixo:
Envio de eventos de teste
Para testar sua integração, você pode selecionar Send Test Events (Enviar eventos de teste ) para enviar um evento de cada um dos tipos de evento selecionados para essa corrente. Para obter informações detalhadas sobre cada tipo de evento, consulte nossas bibliotecas Customer Behavior Events e Message Engagement Events.
A página “Currents Test” (Teste de correntes) no painel do Braze.](/docs/pt-br/assets/img/currents/current_test_events.png?7eacf3ea5ba54b85103ccab11ec52f9d){: style=”max-width:70%;”}
Teste de conectores de corrente
Os conectores Test Currents são versões gratuitas de nossos conectores existentes que podem ser usados para testar e experimentar diferentes destinos. As correntes de teste têm:
- Não há limite para o número de conectores Test Currents que você pode construir.
- Um máximo agregado de 10.000 eventos por período contínuo de sete dias. Esse total de eventos é atualizado a cada hora no painel.
Depois que seus conectores Test Currents atingirem o limite de envio, seu conector não enviará eventos até o próximo período de sete dias.
Para atualizar seu conector Test Currents, edite a integração no painel e selecione Atualizar integração de teste.
Atualização de correntes
Para atualizar seu conector Currents após a inicialização, faça o seguinte:
- Na Braze, navegue até Integrações com parceiros > Exportação de dados.
- Localize e seu conector Currents na lista.
- Selecione Edit.
- Faça suas alterações.
- 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.
Pode levar algum tempo para que suas alterações entrem em vigor.
Lista de permissões de IP
O Braze enviará dados Currents dos IPs listados:
Para as instâncias US-01, US-02, US-03, US-04, US-05, US-06, US-07, esses são os endereços IP relevantes:
23.21.118.19134.206.23.17350.16.249.952.4.160.21454.87.8.3454.156.35.25152.54.89.23818.205.178.15
Por exemplo US-08, estes são os endereços IP relevantes:
52.151.246.5152.170.163.18240.76.166.15740.76.166.17040.76.166.16740.76.166.16140.76.166.15640.76.166.16640.76.166.16040.88.51.7452.154.67.1740.76.166.8040.76.166.8440.76.166.8540.76.166.8140.76.166.7140.76.166.14440.76.166.145
Por exemplo US-10, estes são os endereços IP relevantes:
100.25.232.16435.168.86.17952.7.44.1173.92.153.1835.172.3.12950.19.162.19
Para as instâncias EU-01 e EU-02, esses são os endereços IP relevantes:
52.58.142.24252.29.193.12135.158.29.22818.157.135.973.123.166.463.64.27.363.65.88.253.68.144.1883.70.107.88
Por exemplo AU-01, estes são os endereços IP relevantes:
13.210.1.14513.211.70.15913.238.45.5452.65.73.16754.153.242.23954.206.45.213
Por exemplo ID-01, estes são os endereços IP relevantes:
108.136.157.246108.137.30.20716.78.128.7116.78.14.13416.78.162.20843.218.73.35
Editar esta página no GitHub