Treasure Data para Currents

O Treasure Data é uma plataforma de dados do cliente (CDP) que coleta e encaminha informações de várias fontes para uma variedade de outros locais na sua pilha de marketing.

A integração entre a Braze e o Treasure Data permite que você controle o fluxo de informações entre os dois sistemas. Com o Currents, você pode transmitir dados de eventos da Braze para o Treasure Data e torná-los acionáveis em toda a sua growth stack.

O método recomendado é o conector Braze Currents Streaming no Treasure Data, combinado com uma Custom Currents Export na Braze. Essa abordagem oferece:

• Transmissão de eventos em tempo real da Braze para o Treasure Data
• Roteamento automático opcional de tabelas por tipo de evento
• Um esquema plano, consultável via SQL, que não exige análise de JSON

Importante

O conector Braze Currents Streaming está em beta. Entre em contato com o suporte do Treasure Data para ativá-lo na sua conta do Treasure Data. Para detalhes de configuração do lado do parceiro, consulte a documentação do Treasure Data sobre Integração de importação do Braze Currents.

Pré-requisitos

Integração

Etapa 1: configure o conector no Treasure Data

1. No console do Treasure Data, acesse Connections > New Connection.
2. Selecione Braze Currents Streaming.
3. Em Authentication, insira sua chave de API de escrita do Treasure Data.
4. Em Source Settings, configure o seguinte:

1. Após salvar, copie o Unique ID (task_id). Você precisará desse valor na próxima etapa.

Etapa 2: crie uma Custom Currents Export na Braze

A opção Treasure Data Export na interface de Currents da Braze usa o método legado de API de Postback e não é mais recomendada. Use Custom Currents Export em vez disso.

1. Na Braze, acesse Partner Integrations > Data Export.
2. Selecione Create New Current > Custom Currents Export.
3. Insira um nome de integração e um e-mail de contato para notificações de erro.
4. Em Credentials, insira a URL do endpoint para a sua região do Treasure Data. Insira sua chave de API de escrita do Treasure Data como o Bearer Token.

Substitua {TASK_ID} pelo Unique ID que você copiou na Etapa 1.

1. Selecione os tipos de evento que deseja exportar. As conexões Custom Currents podem enviar eventos para usuários identificados e para usuários sem um external_user_id. O Treasure Data ingere ambos.
2. Selecione Launch Current.

Aviso

Mantenha sua chave de API de escrita do Treasure Data e a URL do endpoint atualizadas. Se o endpoint ficar inacessível por mais de 5 dias, a Braze descartará os eventos do conector e os dados serão perdidos permanentemente.

Consulte seus dados

Depois que os eventos estiverem fluindo, consulte-os com SQL. O Treasure Data achata a carga útil, então você não precisa analisar JSON.

1
2
3
4
5
6
7
8
9
SELECT
  id AS event_id,
  event_type,
  user_external_user_id,
  properties_campaign_name,
  properties_email_address,
  time
FROM your_database.your_table
WHERE TD_INTERVAL(time, '-1d', 'JST')

Nota

O campo time no Treasure Data é o timestamp de quando o Treasure Data recebeu e processou o evento, não o horário original de ocorrência do evento na Braze.

Se você selecionou Multiple Tables, cada tipo de evento será armazenado em sua própria tabela (por exemplo, users_message_email_open ou users_behaviors_purchase).

Para confirmar que os dados estão chegando, execute uma consulta de contagem alguns minutos após iniciar o Current:

1
2
3
SELECT COUNT(*)
FROM your_table
WHERE TD_INTERVAL(time, '-1h')

Esquema de dados

O Treasure Data achata JSON aninhado em até dois níveis de profundidade:

Os nomes das colunas usam apenas letras minúsculas e underscores.

Limites

Detalhes da integração

A Braze oferece suporte à exportação de todos os dados listados nos glossários de eventos do Currents para o Treasure Data. Isso inclui todas as propriedades nos eventos de engajamento com mensagem e de comportamento do cliente.

A estrutura de carga útil para dados exportados é a mesma dos conectores HTTP personalizados. Você pode revisar exemplos de carga útil no repositório de exemplos para conectores HTTP personalizados.

Migrar do método legado de Postback

Se você usava anteriormente o Treasure Data Export (Postback) na Braze:

1. Conclua a configuração da Custom Currents Export descrita neste artigo.
2. Confirme que os eventos estão fluindo para a nova tabela.
3. Desative o Current antigo baseado em Postback na Braze.

Dados legados armazenados como arrays JSON brutos ainda podem ser consultados com JSON_PARSE e UNNEST. Novos dados ingeridos pelo conector de streaming usam o esquema plano descrito em Esquema de dados.