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 perfeitamente o fluxo de informações entre os dois sistemas. Com o Currents, você também pode conectar dados ao Treasure Data para torná-los acionáveis em toda a growth stack.

Pré-requisitos

Nota

O Treasure Data registra cada evento em lotes. Para saber mais sobre como consultar o Treasure Data para obter contagens de eventos, consulte Consulta de dados.

Se você deseja integrar com o novo conector de streaming do Treasure Data para a Braze, consulte as etapas de configuração detalhadas em Integração de importação de streaming do Braze Currents. Em caso de dúvidas sobre a integração ou a configuração na Braze, entre em contato com a equipe da sua conta Braze.

Integração

A abordagem recomendada para se conectar ao Treasure Data é pela API de Postback. Esse método não requer um conector padrão, e os dados podem ser recebidos por uma abordagem de push. Todos os eventos enviados em um lote de dados estão dentro de um campo de uma linha em um array JSON, que precisa ser analisado para obter os dados necessários.

Importante

Atualmente, a ingestão no Treasure Data por meio do coletor de eventos não ocorre em tempo real e pode levar até cinco minutos.

Etapa 1: configure a API de Postback do Treasure Data com a Braze

As instruções para criar uma API de Postback podem ser encontradas no site do Treasure Data. A Braze enviará diretamente os eventos atualizados para o Treasure Data em tempo real, com exceção da ingestão por meio do coletor de eventos. Quando concluído, o Treasure Data fornecerá um URL da fonte de dados para copiar e usar na próxima etapa.

Etapa 2: crie um Current

Na Braze, navegue até Currents > + Create Current > Treasure Data Export. Forneça um nome de integração, e-mail de contato e o URL do Treasure Data. Em seguida, selecione o que deseja rastrear na lista de eventos disponíveis e clique em Launch Current.

Todos os eventos enviados ao Treasure Data incluirão o external_user_id do usuário. No momento, a Braze não envia dados de eventos ao Treasure Data para usuários que não definiram o external_user_id.

Importante

Mantenha o URL do Treasure Data atualizado. Se o URL do seu conector estiver incorreto, a Braze não poderá enviar eventos. Se isso persistir por mais de 5 dias, os eventos do conector serão descartados e os dados serão perdidos permanentemente.

Exemplo de valor de campo de evento

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
    "events": [
        {
            "event_type": "users.message.email.Open",
            "id": "a1234567-89ab-cdef-0123-456789abcdef",
            "time": 1477502783,
            "user": {
                "user_id": "user_id",
                "timezone": "America/Chicago"
        },
            "properties": {
                "campaign_id": "11234567-89ab-cdef-0123-456789abcdef",
                "campaign_name": "Test Campaign",
                "dispatch_id": "12345qwert",
                "message_variation_id": "c1234567-89ab-cdef-0123-456789abcdef",
                "email_address": "[email protected]",
                "send_id": "f123456789abcdef01234567",
                "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36"
            }
        }
    ]
}

Exemplo de visualização ingerida

Detalhes da integração

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

A estrutura de carga útil para dados exportados é a mesma que a estrutura de carga útil para conectores HTTP personalizados, que pode ser visualizada no repositório de exemplos para conectores HTTP personalizados.