Integrações de armazenamento de data warehouse

1. Certifique-se de que o acesso do Braze seja permitido às tabelas do Redshift que você deseja sincronizar. O Braze se conectará ao Redshift pela Internet.
2. Em sua instância do Redshift, configure a(s) tabela(s) ou visualização(ões) que deseja sincronizar com o Braze.
3. Crie uma nova integração no dashboard do Braze.
4. Teste a integração e inicie a sincronização.

Etapa 1: Preparar a mesa

Opcionalmente, configure um novo banco de dados e esquema para manter sua tabela de origem

1
2
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

Crie uma tabela (ou visualização) para usar em sua integração CDI

1
2
3
4
5
6
7
8
9
10
11
12
13
14
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
   updated_at timestamptz default sysdate,
   --at least one of external_id, alias_name and alias_label, or braze_id is required
   external_id varchar,
   --if using user alias, both alias_name and alias_label are required
   alias_label varchar,
   alias_name varchar,
   --braze_id can only be used to update existing users created through the Braze SDK
   braze_id varchar,
   --If you include both email and phone, we will use the email as the primary identifier
   email varchar,
   phone varchar,
   payload varchar(max)
)

Você pode nomear o banco de dados, o esquema e a tabela como quiser, mas os nomes das colunas devem corresponder à definição anterior.

• UPDATED_AT - A hora em que essa linha foi atualizada ou adicionada à tabela. Sincronizaremos apenas as linhas que foram adicionadas ou atualizadas desde a última sincronização.
• Colunas de identificador de usuário. Sua tabela pode conter uma ou mais colunas de identificador de usuário. Cada linha deve conter apenas um identificador ( external_id, a combinação de alias_name e alias_label, ou braze_id. Uma tabela de origem pode conter colunas para um, dois ou todos os três tipos de identificadores.
  • EXTERNAL_ID - Isso identifica o usuário que você deseja atualizar. Esse valor deve corresponder ao valor external_id usado no Braze.
  • ALIAS_NAME e ALIAS_LABEL - Essas duas colunas criam um objeto de alias de usuário. alias_name deve ser um identificador exclusivo e alias_label especifica o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas apenas um alias_name por alias_label.
  • BRAZE_ID - O identificador de usuário do Braze. Isso é gerado pelo SDK da Braze, e novos usuários não podem ser criados usando um Braze ID por meio da ingestão de dados na nuvem. Para criar novos usuários, especifique um ID de usuário externo ou um alias de usuário.
  • EMAIL - O endereço de e-mail do usuário. Se houver vários perfis com o mesmo endereço de e-mail, o perfil atualizado mais recentemente terá prioridade para atualizações. Se você incluir e-mail e telefone, usaremos o e-mail como identificador principal.
  • PHONE - O número de telefone do usuário. Se houver vários perfis com o mesmo número de telefone, o perfil atualizado mais recentemente terá prioridade nas atualizações.
• PAYLOAD - Essa é uma string JSON dos campos que você deseja sincronizar com o usuário no Braze.

Etapa 2: Criar usuário e conceder permissões

1
2
3
CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;

Essas são as permissões mínimas necessárias para esse usuário. Se estiver criando várias integrações CDI, talvez você queira conceder permissões a um esquema ou gerenciar as permissões usando um grupo.

Etapa 3: Permitir acesso aos IPs do Braze

Se você tiver um firewall ou outras políticas de rede, deverá conceder à Braze acesso à rede para sua instância do Redshift. Um exemplo de ponto de extremidade de URL do Redshift é “example-cluster.ap-northeast-2.redshift.amazonaws.com”.

Alguns aspectos importantes a saber:

• Também pode ser necessário alterar seus grupos de segurança para permitir que o Braze acesse seus dados no Redshift.
• Certifique-se de permitir explicitamente o tráfego de entrada nos IPs da tabela e na porta usada para consultar seu cluster Redshift (o padrão é 5439). Você deve permitir explicitamente a conectividade TCP do Redshift nessa porta, mesmo que as regras de entrada estejam definidas como “permitir tudo”.
• O endpoint do cluster Redshift deve ser acessível publicamente para que o Braze se conecte ao seu cluster.
  • Se não quiser que o cluster do Redshift seja acessível publicamente, você pode configurar uma instância VPC e EC2 para usar um túnel SSH para acessar os dados do Redshift. Para saber mais, confira esta postagem do Centro de Conhecimento da AWS.

Permita o acesso dos seguintes IPs correspondentes à região de seu dashboard do Braze.

Acesse Integrações de parceiros > Parceiros de tecnologia. Localize a página do Redshift e selecione Criar nova sincronização de importação.

Etapa 1: Adicionar informações de conexão e tabela de origem do Redshift

Insira as informações de seu data warehouse Redshift e da tabela de origem. Se estiver usando um túnel de rede privada, alterne o controle deslizante e insira as informações do túnel. Em seguida, prossiga para a próxima etapa.

Etapa 2: Configurar detalhes de sincronização

Em seguida, escolha um nome para sua sincronização e insira os e-mails dos contatos. Usaremos essas informações de contato para notificá-lo sobre quaisquer erros de integração, como a remoção inesperada do acesso à tabela.

Os e-mails de contato receberão apenas notificações de erros globais ou de nível de sincronização, como tabelas ausentes, permissões e outros. Eles não receberão edições em nível de linha. Os erros globais indicam problemas críticos com a conexão que impedem a execução das sincronizações. Esses problemas podem incluir o seguinte:

• Problemas de conectividade
• Falta de recursos
• Problemas de permissões
• (Somente para sincronizações de catálogos) A camada do catálogo está sem espaço

Você também escolherá o tipo de dados e a frequência de sincronização. A frequência pode variar de cada 15 minutos a uma vez por mês. Usaremos o fuso horário configurado em seu dashboard do Braze para agendar a sincronização recorrente. Os tipos de dados compatíveis são Atributos personalizados, Eventos personalizados e Eventos de compra, e o tipo de dados de uma sincronização não pode ser alterado após a criação.

Retorne ao dashboard do Braze e selecione Testar conexão. Se for bem-sucedido, você verá uma prévia dos dados. Se, por algum motivo, não conseguirmos nos conectar, exibiremos uma mensagem de erro para ajudá-lo a solucionar o problema.

Você pode configurar várias integrações com o Braze, mas cada integração deve ser configurada para sincronizar uma tabela diferente. Ao criar sincronizações adicionais, você pode reutilizar as credenciais existentes se estiver se conectando à mesma conta do Snowflake ou do Redshift.

Se você reutilizar o mesmo usuário em várias integrações, não será possível excluir o usuário no dashboard do Braze até que ele seja removido de todas as sincronizações ativas.

Quando ativada, sua sincronização será executada de acordo com a programação configurada durante a instalação. Se você quiser executar a sincronização fora da programação normal de testes ou buscar os dados mais recentes, selecione Sync Now (Sincronizar agora). Essa execução não afetará as sincronizações futuras programadas regularmente.