Ingestão de Dados na Nuvem da Braze
A Ingestão de Dados na Nuvem (CDI) da Braze permite que você configure uma conexão direta da sua solução de armazenamento de dados para sincronizar dados relevantes de usuários e outros dados não relacionados a usuários com a Braze. Esses dados podem ser usados para personalização ou segmentação para potencializar seus casos de uso de marketing. A integração flexível da Ingestão de Dados na Nuvem suporta estruturas de dados complexas, incluindo JSON aninhado e arrays de objetos.
Como funciona
Com a Ingestão de Dados na Nuvem (CDI) da Braze, você configura uma integração entre sua instância de data warehouse e seu espaço de trabalho da Braze para sincronizar dados de acordo com um cronograma ou sob demanda. Cada integração pode ter seu próprio cronograma.
- Sincronizações agendadas: As sincronizações recorrentes podem ser executadas a cada 5 minutos, no mínimo, ou uma vez por mês, no máximo. Por padrão, o menor intervalo que você pode definir no dashboard é de 15 minutos. Isso ajuda a controlar os custos de computação do seu data warehouse e o volume de solicitações. Para sincronizar a cada 5 minutos, entre em contato com o suporte da Braze ou com seu gerente de sucesso do cliente.
- Sincronizações sob demanda: Para sincronizar os dados assim que eles mudarem, chame o endpoint Disparar uma sincronização com o ID da sua integração quando o job de carga ou transformação do seu data warehouse terminar. As sincronizações sob demanda não afetam seu cronograma recorrente. Só é possível executar uma sincronização por integração de cada vez.
As integrações de armazenamento de arquivos (Amazon S3, Azure Blob Storage e Google Cloud Storage) são orientadas por eventos e não usam cronograma. A Braze ingere novos arquivos à medida que eles são enviados. Para saber mais sobre a configuração, consulte Amazon S3, Google Cloud Storage ou Azure Blob Storage.
Quando uma sincronização é executada, a Braze se conecta diretamente à sua instância de data warehouse, recupera todos os dados novos da tabela especificada e atualiza os dados correspondentes no seu dashboard da Braze. Sempre que a sincronização é executada, todos os dados atualizados aparecem na Braze.
Casos de uso
Com os recursos da Ingestão de Dados na Nuvem da Braze, você pode:
- Criar uma integração simples diretamente do seu data warehouse ou solução de armazenamento de arquivos para a Braze em apenas alguns minutos.
- Sincronizar com segurança dados de usuários, incluindo atributos, eventos e compras, do seu data warehouse para a Braze.
- Fechar o ciclo de dados com a Braze combinando a Ingestão de Dados na Nuvem com o Currents ou o Snowflake Data Sharing.
Além disso, as fontes conectadas são uma alternativa de cópia zero. Você pode fazer com que a Braze consulte diretamente seu data warehouse ou solução de armazenamento de arquivos para criar segmentos CDI —tudo isso sem copiar os dados subjacentes para a Braze.
Fontes de dados compatíveis
A Ingestão de Dados na Nuvem pode sincronizar dados das fontes a seguir. Cada fonte tem sua própria página de configuração em Fontes da Ingestão de Dados na Nuvem.
Data warehouses
Armazenamento de arquivos
Tipos de dados compatíveis
A Ingestão de Dados na Nuvem é compatível com os seguintes tipos de dados:
Dados de usuários
- Atributos de usuário, incluindo:
- Atributos personalizados aninhados
- Arrays de objetos
- Status de inscrição
- Eventos personalizados
- Eventos de compra
- Solicitações de exclusão de usuários
Objetos que não são de usuários
- Itens de catálogo
Envio de mensagens com cópia zero
- Disparos de Canvas
- Fontes conectadas
Identificadores de usuário para ingestão de dados
Ao sincronizar dados de usuários com a Ingestão de Dados na Nuvem, você pode identificar usuários com um ou mais dos tipos de identificador abaixo. Cada linha da sua tabela de origem deve conter um valor para apenas um tipo de identificador por vez. Mesmo assim, sua tabela pode incluir colunas para um, dois, três, quatro ou todos os cinco tipos de identificador.
| Identificador | Descrição |
|---|---|
EXTERNAL_ID |
O ID externo que identifica o perfil de usuário a ser criado ou atualizado. Ele deve corresponder ao valor de external_id usado na 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 da Braze gerado pelo SDK da Braze. Não é possível criar novos usuários com um Braze ID pela 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 tem prioridade nas atualizações. Se você incluir e-mail e telefone, o e-mail será usado 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 tem prioridade nas atualizações. |
Para saber mais sobre como configurar as colunas da tabela e os requisitos de formatação da carga útil, consulte Configuração de tabelas para a Ingestão de Dados na Nuvem.
Para instruções de configuração e exemplos de SQL específicos de cada fonte, consulte Fontes da Ingestão de Dados na Nuvem.
Como encontrar o ID da sua integração
Você encontra o ID da sua integração na URL ao visualizar uma integração no dashboard da Braze. Acesse Data Settings > Cloud Data Ingestion e selecione uma integração. O ID da integração aparece na URL no formato https://[instance].braze.com/integrations/cloud_data_ingestion/[integration_id]. Por exemplo, se a sua URL for https://dashboard-01.braze.com/integrations/cloud_data_ingestion/abc123xyz, o ID da sua integração será abc123xyz. Você pode usar esse ID ao fazer chamadas de API para disparar sincronizações ou verificar o status delas.
Uso de pontos de dados
Para clientes com faturamento baseado em pontos de dados, o faturamento de pontos de dados da Ingestão de Dados na Nuvem é equivalente ao faturamento de atualizações feitas pelo endpoint /users/track. Para saber mais, consulte Pontos de dados.

A Ingestão de Dados na Nuvem da Braze conta para o limite de frequência disponível. Então, se você estiver enviando dados por outro método, o limite de frequência será compartilhado entre a API da Braze e a Ingestão de Dados na Nuvem.
Limitações do produto
| Limitação | Descrição |
|---|---|
| Número de integrações | Não há limite para a quantidade de integrações que você pode configurar. |
| Número de linhas | Por padrão, cada execução pode sincronizar até 500 milhões de linhas. Qualquer sincronização com mais de 500 milhões de linhas novas é interrompida. Se você precisar de um limite maior, entre em contato com seu gerente de sucesso do cliente da Braze ou com o suporte da Braze. |
| Atributos por linha | Em sincronizações que usam uma coluna PAYLOAD, cada linha deve conter um único ID de usuário e um objeto JSON com até 250 atributos. Cada chave no objeto JSON conta como um atributo (ou seja, uma matriz conta como um atributo). |
| Tamanho da carga útil | Em sincronizações que usam uma coluna PAYLOAD, cada linha pode conter uma carga útil de até 1 MB. Cargas úteis maiores que 1 MB são rejeitadas, e o erro “Payload was greater than 1MB” é registrado no log de sincronização junto com o ID externo associado e a carga útil truncada. |
| Tipo de dados | Você pode sincronizar atributos de usuário, eventos personalizados, eventos de compra, itens de catálogo, solicitações de exclusão de usuários e gatilhos do Canvas por meio da Ingestão de Dados na Nuvem. |
| Região da Braze | Este produto está disponível em todas as regiões da Braze. Qualquer região da Braze pode se conectar a qualquer região de dados de origem. |
| Região de origem | A Braze se conecta ao seu data warehouse ou ambiente de nuvem em qualquer região ou provedor de nuvem. |