Entendendo o Data Warehouse Import no Klaviyo

Introdução

O Data Warehouse Import permite que a Klaviyo se conecte diretamente ao seu data warehouse do Snowflake, BigQuery, Redshift ou Databricks e configure sincronizações de importação para tabelas (ou visualizações) de dados de perfil e de evento.

Como funciona a Data Warehouse Import no Klaviyo?

Depois de estabelecer uma conexão com seu data warehouse, você pode selecionar um conjunto de dados (por exemplo, uma tabela ou uma visualização) para sincronizar.

Sua tabela ou visualização precisa incluir uma coluna de carimbo de data/hora que registre quando cada linha foi adicionada ou atualizada, como updated_at ou modified_at. Selecione essa coluna em Detecção de alterações ao configurar a sincronização. Atualize o valor dela sempre que uma linha mudar e não volte para um horário anterior.

Para uma sincronização de perfil, inclua pelo menos 1 identificador de perfil, como um endereço de e-mail, número de telefone ou ID externo. Mapeie suas colunas de dados para as Propriedades do perfil que você quer atualizar, incluindo propriedades personalizadas.

Para uma sincronização de evento, mapeie um registro de data e hora do evento e pelo menos 1 identificador de perfil. Escolha um único tipo de evento para a sincronização ou mapeie uma coluna que contenha um tipo de evento para cada linha. Use uma coluna separada para detecção de alterações, para que as datas históricas de eventos não determinem quando as linhas são selecionadas para importação.

As sincronizações agendadas importam os dados existentes e continuam importando linhas novas ou atualizadas no intervalo escolhido (por exemplo, de hora em hora ou diariamente), usando o carimbo de data/hora de detecção de alterações para identificar mudanças. As sincronizações de perfil criam ou atualizam perfis; as sincronizações de eventos adicionam eventos.

Você também pode escolher uma sincronização manual, que é executada quando você seleciona Executar sincronização.

Se você não tiver um conjunto de dados totalmente unificado com todos os campos que quer sincronizar, pode criar várias sincronizações com diferentes mapeamentos de campos (por exemplo, informações de contato, saldos de fidelidade e segmentos personalizados).

Ao usar várias sincronizações de perfis, use identificadores consistentes em todas as suas tabelas para ajudar a corresponder as linhas ao mesmo perfil. Cada propriedade do perfil que não seja um identificador pode ser mapeada a partir de apenas uma origem; os identificadores podem ser reutilizados em diferentes origens.

O consentimento para e-mail e mensagens de texto usa os mesmos valores e formatos válidos que uploads de arquivo ou SFTP. Para campos de consentimento e orientações de formatação, consulte Como importar assinantes para uma lista.

Casos de uso comuns

Gerenciamento de perfis

• Crie novos perfis no Klaviyo que se originam em sistemas não integrados diretamente ao Klaviyo (por exemplo, sistemas de PDV, reserva ou gestão de pedidos).
• Atualize as informações do perfil no Klaviyo a partir de fontes off-line disponíveis no armazém.

Enriquecimento de perfil

• Sincronize os saldos do programa de fidelidade para uma propriedade personalizada Loyalty_Balance.
• Sincronize pontuações ou categorias de modelos personalizados executados no data warehouse (por exemplo, pontuações de intenção para eventos de ciclo de vida sob medida, categorias de afinidade, risco de taxa de desistência ou métricas de LTV).
• Sincronize dados demográficos ou comportamentais de enriquecimento de terceiros com Propriedades do perfil personalizadas.
• Sincronize pontos de contato de suporte ou serviço em campos de perfil personalizados para indicar se o cliente tem solicitações de serviço em aberto, há quantos dias foi a última visita de serviço ou a categoria mais recente de interação com o suporte.

Segmentação personalizada

• Realize segmentação complexa no warehouse e sincronize os nomes dos segmentos com Propriedades do perfil personalizadas para usar como critérios em segmentos ou no fluxo.
• Realize a segmentação no warehouse com base em dados sensíveis, confidenciais ou regulamentados e sincronize as atribuições de grupos de segmentos ou as sinalizações de perfil com nomes sanitizados (ex.: Group A, Group B) como uma Propriedades do perfil personalizada.

Guia de configuração

Como estabelecer uma conexão

Estes artigos fornecem instruções passo a passo para configurar o Data Warehouse Import.

Conectar a Klaviyo e o Snowflake

Conectando o Klaviyo e o BigQuery

Conectando a Klaviyo e o Redshift

Conectando a Klaviyo e o Databricks

Criar uma sincronização de importação de perfil

Depois de preparar seu armazém e validar a conexão, crie uma sincronização de importação de perfil no Klaviyo:

1. Vá para Avançado > Gerenciamento de dados > Sincronização e selecione a conexão do seu data warehouse.
2. Clique em Adicionar origem. Insira um nome de sincronização exclusivo no campo Nome e selecione sua tabela ou visualização em Origem de dados.
3. Selecione Perfis em Tipos de objeto de dados.
4. Em Cadência, escolha Agendar execução e defina o intervalo, a data de início, o horário de início e o fuso horário. Escolha Manual se você quiser iniciar cada execução por conta própria.
5. Clique em Avançar. Em Detecção de alterações, selecione sua coluna de carimbo de data/hora em Detecção de nova linha. Mapeie pelo menos 1 identificador de perfil e as outras Propriedades do perfil que você quer importar.
6. Clique em Concluído para salvar a sincronização.

Se você escolheu Manual, abra a sincronização salva e selecione Executar sincronização para começar a importar.

Importando dados de eventos

Para campos específicos de eventos e instruções de configuração, consulte Understanding data warehouse event import in Klaviyo.

Solução de problemas de sincronização

Se uma sincronização não importar os dados que você espera, verifique o status e os detalhes do erro antes de testar os dados do seu perfil com um upload de CSV.

1. Acesse Avançado > Gerenciamento de dados > Sincronização, selecione a conexão do seu data warehouse e clique no nome da sincronização.
2. Na guia Execuções, confira as contagens de Ingeridos e Com falha. Um status Concluído ainda pode incluir linhas com falha.
3. Para uma execução concluída com linhas com falha, abra o menu da execução e selecione Baixar arquivo de erro se a opção estiver disponível.
4. Abra a guia Logs e confira os logs Periódicos ou Históricos para ver detalhes sobre a sincronização afetada.

Valide os dados de perfil com uma importação de CSV

Uma importação de CSV pode ajudar a identificar problemas de formatação de dados de perfil, especialmente com valores de consentimento e carimbos de data/hora. Ela não testa sua conexão com o data warehouse nem a configuração de detecção de alterações da sincronização. Para ver o procedimento completo de upload, consulte Como importar assinantes para uma lista.

Use uma lista de teste separada sem fluxos acionados por lista. A importação ainda cria ou atualiza perfis na sua conta e aplica quaisquer valores de consentimento que você mapear a partir do arquivo.

1. Exporte sua tabela ou visualização de perfil para um arquivo CSV.
2. Acesse Público > Listas e segmentos na Klaviyo.
3. Selecione uma lista de teste separada ou crie uma nova lista para testar.
4. Selecione Importar contatos no menu Gerenciar lista no canto superior direito.
5. Faça o upload do arquivo CSV da etapa 1.
6. Mapeie as colunas que você quer testar para as mesmas Propriedades do perfil do Klaviyo e os tipos de dados usados pela sincronização do seu data warehouse.
7. Se você vir Próximo após o mapeamento, clique nele e selecione Não na tela de confirmação de consentimento para evitar adicionar consentimento em massa. Os valores de consentimento mapeados a partir do arquivo ainda se aplicam.
8. Clique em Importar. Quando o processamento terminar, revise os detalhes da importação e selecione Baixar arquivo de erros, se disponível, para ver as linhas ignoradas e os respectivos erros.

Corrija quaisquer erros nos dados do seu data warehouse e avance os carimbos de data/hora de detecção de alterações das linhas afetadas para refletir quando você as corrigiu, para que uma sincronização incremental posterior possa importá-las.