Skip to content

Importação de coortes do Treasure Data

Este artigo descreve como fazer a importação de coortes de usuários do Treasure Data para o Braze para que você possa enviar campanhas direcionadas com base em dados que podem existir apenas em seu data warehouse.

Pré-requisitos

Integração de importação de dados

Etapa 1: Obtenha sua chave de importação de dados do Braze

Na Braze, navegue até Integrações de parceiros > Parceiros de tecnologia e selecione Treasure Data. Aqui você encontra o endpoint REST e gera sua chave de importação de dados da Braze. Depois que a chave é gerada, você pode criar outra ou invalidar uma existente.

Etapa 2: Criar uma conexão de dados

Antes de criar sua conexão de dados no Treasure Data, você precisará se autenticar. Primeiro, selecione Integrations Hub (Hub de integrações) e, em seguida, Catalog (Catálogo).

Catálogo do Hub de Integrações de Dados do Tesouro

Procure a integração do Braze no catálogo, passe o mouse sobre o ícone e selecione Create Authentication (Criar autenticação). Digite suas credenciais, dê um nome à sua autenticação e selecione Done (Concluído).

Catálogo do Hub de Integrações de Dados do Tesouro

Etapa 3: Defina o público de seu coorte

Sincronize seus coortes com o Braze por meio de uma ativação no Audience Studio ou da execução de uma consulta no Data Workbench.

Etapa 3.1: defina sua consulta

  1. Navegue até Data Workbench (Workbench de dados) > Queries (Consultas).
  2. Selecione New Query (Nova consulta).
  3. Execute a consulta para validar o conjunto de resultados.

Catálogo do Hub de Integrações de Dados do Tesouro

Caso de uso: Sincronização de coortes por identificador

Aqui está um exemplo de tabela no Treasure Data:

external_id e-mail device_ids
TDCohort1 [email protected] 1a2b3c
TDCohort2 [email protected] 4d5f6g
TDCohort3 [email protected] 7h8j9k
TDCohort4 [email protected] 1ab2cd

Para sincronizar coortes usando o ID externo, execute a seguinte consulta:

1
2
3
4

SELECT
  external_id as user_ids
FROM
  example_cohort_table

Depois de executar a consulta, estes aliases de usuário serão adicionados à coorte na Braze:

  • TDCohort1
  • TDCohort2
  • TDCohort3
  • TDCohort4

Aqui está um exemplo de tabela no Treasure Data:

external_id e-mail device_ids
TDCohort1 [email protected] 1a2b3c
TDCohort2 [email protected] 4d5f6g
TDCohort3 [email protected] 7h8j9k
TDCohort4 [email protected] 1ab2cd

Para sincronizar coortes usando o alias de usuário, execute a seguinte consulta:

1
2
3
4

SELECT
  email
FROM
  example_cohort_table

Depois de executar a consulta, estes aliases de usuário serão adicionados à coorte na Braze:

Aqui está um exemplo de tabela no Treasure Data:

external_id e-mail device_ids
TDCohort1 [email protected] 1a2b3c
TDCohort2 [email protected] 4d5f6g
TDCohort3 [email protected] 7h8j9k
TDCohort4 [email protected] 1ab2cd

Para sincronizar coortes usando o ID do dispositivo, execute a seguinte consulta:

1
2
3
4

SELECT
  device_ids
FROM
  example_cohort_table

Depois de executar a consulta, estes IDs de dispositivo serão adicionados à coorte na Braze:

  • 1a2b3c
  • 4d5f6g
  • 7h8j9k
  • 1ab2cd

Etapa 3.2: Especifique o direcionamento da exportação de resultados

Depois que a consulta tiver sido criada, selecione Export Results (Exportar resultados). Você pode selecionar uma autenticação existente, como a criada nas últimas etapas, ou criar uma nova autenticação a ser usada na saída.

Catálogo do Hub de Integrações de Dados do Tesouro

Mapeamento de resultados de exportação Descrição
ID do coorte Esse é o identificador de coorte de backend que será enviado ao Braze.
Nome do coorte (opcional) Esse é o nome que aparecerá no Filtro de coorte na ferramenta de segmentação do Braze. Se isso não for definido, o Cohort ID será usado como Cohort Name.
Operação Usado para determinar se a consulta deve adicionar ou remover perfis do coorte no Braze.
Aliases (opcional) Quando definido, o nome da coluna correspondente em sua consulta será enviado como alias_label, e os valores de cada linha na coluna serão enviados como alias_name.
Contagem de fios Número de chamadas simultâneas à API.

Siga as etapas do Treasure Data para configurar sua exportação para atender ao seu caso de uso.

Etapa 3.3: Executar a consulta

Salve a consulta com um nome e execute, ou simplesmente execute a consulta. Após a conclusão bem-sucedida da consulta, o resultado é automaticamente exportado para a Braze.

Etapa 3.1: Criar uma ativação

Crie um novo segmento ou escolha um segmento existente para sincronizar com o Braze como um coorte. No segmento, selecione Criar ativação.

Etapa 3.2: preencha seus dados de ativação

Dados de ativação das integrações do Treasure Data

Configuração de detalhes de ativação Descrição
Nome da ativação O nome de sua ativação.
Descrição da ativação Uma breve descrição da ativação.
Autenticação Selecione a autenticação de coorte da Braze criada na etapa 2.
ID do coorte Esse é o identificador de coorte de backend que será enviado ao Braze.
Nome do coorte (opcional) Esse é o nome que aparecerá no Filtro de coorte na ferramenta de segmentação do Braze. Se isso não for definido, o Cohort ID será usado como Cohort Name.
Operação Usado para determinar se a consulta deve adicionar ou remover perfis do coorte no Braze.
Aliases (opcional) Quando definido, o nome da coluna correspondente em sua consulta será enviado como alias_label, e os valores de cada linha na coluna serão enviados como alias_name.
Contagem de fios Número de chamadas simultâneas à API.

Etapa 3.3: Configurar o mapeamento de saída

Integrações de dados do Tesouro Mapeamento de saída de ativação

Mapeamento de saída de ativação Descrição
Colunas de atribuição Determine as colunas de seu banco de dados de segmentos que serão mapeadas como identificadores ao sincronizar perfis com um coorte Braze.
Criador de strings O construtor de string não é necessário para a integração com o Braze.

Todos os nomes de colunas não relevantes ou com nomes incorretos serão ignorados. Você pode optar por usar mais de um identificador em suas sincronizações.

Etapa 3.4: defina seu cronograma de ativação

Defina o cronograma de sincronização desejado e salve a ativação.

Cronograma de ativação das integrações do Treasure Data

Etapa 4: crie um segmento da Braze a partir da exportação do Treasure Data

No Braze, navegue até Segments (Segmentos), crie um novo segmento e selecione Treasure Data Cohorts (Coortes de dados do Tesouro ) como seu filtro. Nessa tela, você pode escolher qual coorte do Treasure Data deseja incluir. Depois que o segmento de coorte da Treasure Data for criado, você poderá selecioná-lo como um filtro de público ao criar uma campanha ou canva.

Catálogo do Hub de Integrações de Dados do Tesouro

Correspondência de Usuário

Usuários identificados podem ser correspondidos pelo seu external_id ou alias. Usuários anônimos podem ser correspondidos pelo seu device_id. Usuários identificados que foram originalmente criados como usuários anônimos não podem ser identificados pelo seu device_id, e devem ser identificados pelo seu external_id ou alias.

Github   Editar esta página no GitHub
QUÃO ÚTIL FOI ESTA PÁGINA?
New Stuff!