Entenda a sincronização do data warehouse no Klaviyo

O que você vai aprender

Saiba como sincronizar dados do Klaviyo com seu data warehouse e importar dados do warehouse para o Klaviyo via SFTP. O senhor pode sincronizar seu perfil de cliente e dados de eventos, o que lhe permite armazenar e analisar informações importantes sobre seus clientes fora do site Klaviyo. 

Antes de começar

O senhor precisará garantir que o data warehouse ao qual está se conectando esteja configurado como um destino. Para ter certeza de que o senhor configurou isso corretamente:

• Certifique-se de que o usuário fornecido ao Klaviyo tenha as permissões corretas
• Certifique-se de definir as tabelas com os nomes apropriados, mostrados abaixo, com base em seu depósito.

Além disso, certifique-se de incluir na lista de permissões os endereços IP do tráfego de saída do data warehouse da Klaviyo. Isso garantirá que as solicitações do Klaviyo não sejam bloqueadas por sua camada de segurança. Esses endereços são representados pelos seguintes intervalos CIDR:

• 184.72.183.187/32
• 52.206.71.52/32
• 3.227.146.32/32
• 44.198.39.11/32
• 35.172.58.121/32
• 3.228.37.244/32
• 54.88.219.8/32
• 3.214.211.176/32

Conectar-se a um data warehouse 

Para adicionar uma conexão de data warehouse ao Klaviyo, navegue até Data management (Gerenciamento de dados) > Syncing (Sincronização).

1. Para adicionar um data warehouse, clique no botão New connection ( Nova conexão ). 
2. No modal Select a destination (Selecionar um destino ), selecione um data warehouse compatível para se conectar ao Klaviyo.

Como alternativa, o senhor pode selecionar seu data warehouse no diretório de integração do Klaviyo, acessando Account > Integration.

Ao conectar um warehouse, o senhor pode importar dados do seu data warehouse para o Klaviyo ou definir um warehouse como destino de sincronização de saída.

importar dados via SFTP

Se quiser importar dados do seu data warehouse para o Klaviyo, o senhor pode fazer isso via SFTP.

Para importar seus dados para Klaviyo, selecione importar dados ao conectar pela primeira vez um destino de depósito ou clique no botão importar na página Data syncing (Sincronização de dados ) se o senhor já tiver uma conexão estabelecida.

O processo de importação dos dados do armazém para o site Klaviyo é o seguinte:

1. Exporte os dados desejados de seu data warehouse.
2. Gere o Chave SSH em seu computador local.
3. Configurar o cliente SFTP e importar.

Exportar seu banco de dados

Primeiro, o senhor precisará exportar os dados do seu warehouse. Faça login no seu warehouse e exporte os dados que deseja importar para o Klaviyo em um arquivo CSV.

Gerar o Chave SSH em seu computador local

Depois que os dados desejados forem exportados do depósito, gere um novo Chave SSH em sua máquina local e adicione-o a Klaviyo selecionando o botão Add Chave SSH.

Configurar o cliente SFTP e importar

Depois que o Chave SSH tiver sido adicionado com sucesso a Klaviyo, o senhor precisará configurar o cliente SFTP e importar os dados.

1. Abra seu cliente SFTP e configure uma nova conexão com as credenciais apresentadas no Klaviyo. O senhor verá as credenciais apresentadas após adicionar com êxito o Chave SSH.
2. Depois de autenticado, verifique se o banco de dados segue as diretrizes recomendadas antes de importar.
3. Faça o upload do arquivo do banco de dados por meio do cliente SFTP e revise.

O senhor também verá uma lista de suas importações recentes com as seguintes informações:

• Status
  Concluído ou incompleto.
• Linhas processadas
  Porcentagem do total de linhas processadas até o momento.
• data de importação
  Data da importação.
• Importado por
  Usuário que importou os dados.

Exportar dados para seu depósito  

Para configurar seu data warehouse como destino, o senhor precisará do seguinte conjunto de informações e credenciais para cada data warehouse.

Depois de inserir suas credenciais para o data warehouse com o qual está sincronizando, escolha os dados que deseja sincronizar do Klaviyo. 

Objetos de dados 

Na seção Objetos de dados , o senhor pode optar por sincronizar todos os dados de perfil, apenas dados de eventos específicos ou ambos os tipos de dados, marcando a(s) caixa(s) aplicável(is) ao lado de cada opção.

Integrações a serem excluídas

No campo Integrações a serem excluídas, o senhor pode selecionar a(s) integração(ões) específica(s) que deseja excluir na sincronização do data warehouse. Isso é útil se o senhor quiser remover da sincronização os dados de uma integração específica que já tenha sido conectada ao Klaviyo.

Sincronização seletiva

No campo Selective sync (Sincronização seletiva ), o usuário seleciona os eventos específicos que deseja sincronizar com o data warehouse do Klaviyo. Por padrão, todos os eventos são incluídos. Quando o senhor define eventos específicos para sincronizar com esse campo, somente os eventos selecionados serão sincronizados. 

Selecione a frequência com que seus dados serão sincronizados

O valor definido para o campo Periodic sync cadence (Cadência de sincronização periódica ) na seção Select how often your data will sync (Selecione a frequência com que seus dados serão sincronizados ) define a frequência com que ocorrerá a sincronização do Klaviyo com o seu data warehouse. 

Selecione a quantidade de dados históricos que o senhor deseja sincronizar 

Na seção Select how much historical data you want to sync (Selecione a quantidade de dados históricos que deseja sincronizar), é possível definir a quantidade de dados históricos que deseja sincronizar do Klaviyo com o data warehouse durante a conexão inicial. O senhor pode escolher: 

• 30 dias 
• 90 dias
• 1 ano
• Todo o tempo 

Análise do Sync

Depois de conectar a integração, se a configuração tiver sido bem-sucedida, o senhor verá uma tela final informando que a conexão está habilitada, juntamente com: 

• Detalhes da sincronização que o senhor configurou.
• Quais dados estão sendo compartilhados (perfis, eventos ou ambos).
• Quaisquer integrações excluídas.

Se a sincronização não tiver sido conectada com êxito, o usuário verá o status Unable to connect (Não foi possível conectar ), juntamente com opções para tentar novamente a conexão ou editar as informações das credenciais.

Depois de conectar o data warehouse com sucesso, o senhor será levado de volta à página principal da lista de sincronização de dados. Aqui o senhor verá o seu:

• Destino do depósito 
• O status Enabled
• Quaisquer possíveis erros que possam ter ocorrido com sua sincronização nas últimas 24 horas.
• A última sincronização que ocorreu junto com um registro de data e hora desse evento.

Como o senhor só poderá conectar um destino, verá apenas um destino refletido nessa exibição de lista.

Painel de sincronização de dados

Quando a conexão for bem-sucedida, clique em sua integração na página da lista de sincronização de dados. A partir daí, o senhor será levado ao painel de sincronização de dados que fornece informações históricas e atuais sobre as sincronizações de dados que foram executadas.

Aqui, o senhor verá as informações de sincronização divididas em duas guias:

• Histórico
• Periódico

Histórico 

A guia Historical (Histórico ) tem registros que mostram o status das suas sincronizações de dados históricos. As sincronizações históricas referem-se à sincronização dos dados existentes da Klaviyo com o seu data warehouse quando o senhor estabelece uma conexão. 

O senhor verá as seguintes informações para cada sincronização: 

• Nome
  Os dados estão sendo incluídos na sincronização.
• Status
  Status e progresso potencial da sincronização com uma porcentagem estimada ou erros potenciais observados. Esses status podem incluir:
  
  
  • Concluído
    Seus dados terminaram de ser sincronizados para essa sincronização única. Ele não será sincronizado novamente de forma automática.
  • Programada
    Quando a próxima sincronização estiver programada para ser executada automaticamente.
  • Em andamento
    Os dados estão sendo sincronizados ativamente com seu data warehouse com uma porcentagem estimada de conclusão.
  • Erro
    Ocorreu um erro, mas o Klaviyo continuará tentando restabelecer a conexão. Dependendo da integração, esse tempo pode ser ligeiramente diferente.
  • Failed
    A sincronização falhou completamente, mesmo depois de tentar restabelecer uma conexão. Isso significa que o senhor precisará rever suas definições de configuração ou até mesmo a configuração do data warehouse.
  • Pausado
    O senhor pausou a sincronização manualmente.
  • Desativado
    A sincronização foi desativada porque a própria integração foi desativada ou removida.
• Iniciado em
  Hora de início da sincronização.
• Terminou em
  Hora final da sincronização.

Periódico

A guia Periodic tem registros que mostram o status das suas sincronizações periódicas. À medida que os clientes continuarem a interagir com sua marca e novos dados forem criados, eles serão enviados rotineiramente ao seu data warehouse. Ao configurar uma conexão de data warehouse, as sincronizações periódicas ocorrerão a cada hora. 

O senhor verá as seguintes informações para cada sincronização: 

• Nome
  Os dados estão sendo incluídos na sincronização.
• Status
  Status e progresso potencial da sincronização com uma porcentagem estimada ou erros potenciais observados. Esses status podem incluir:
  
  
  • Concluído
    Seus dados terminaram de ser sincronizados para essa sincronização única. Ele não será sincronizado novamente de forma automática.
  • Programada
    Quando a próxima sincronização estiver programada para ser executada automaticamente.
  • Em andamento
    Os dados estão sendo sincronizados ativamente com seu data warehouse com uma porcentagem estimada de conclusão.
  • Erro
    Ocorreu um erro, mas o Klaviyo continuará tentando restabelecer a conexão. Dependendo da integração, esse tempo pode ser ligeiramente diferente.
  • Failed
    A sincronização falhou completamente, mesmo depois de tentar restabelecer uma conexão. Isso significa que o senhor precisará rever suas definições de configuração ou até mesmo a configuração do data warehouse.
  • Pausado
    O senhor pausou a sincronização manualmente.
  • Desativado
    A sincronização foi desativada porque a própria integração foi desativada ou removida.
• Atualidade dos dados
  A atualização dos dados refere-se ao grau de atualização dos dados. Por exemplo, se uma sincronização tiver um frescor de 2 minutos, isso significa que todos os novos dados criados no Klaviyo nos últimos 2 minutos ainda não estão em seu data warehouse. 
• Botões para pausar, retomar e reativar sincronizações individuais.

Remoção de conexões de data warehouse 

Para excluir uma conexão de data warehouse de sua conta da Klaviyo, navegue até a página Integrations (Integrações ) na Klaviyo no menu da conta no canto inferior esquerdo.  

Na página Integrations (Integrações), abra o menu ao lado da integração do data warehouse e selecione Remove integration (Remover integração ) para remover a conexão.

Exibir registros de erros 

Se o senhor estiver enfrentando problemas com a sincronização de dados entre a Klaviyo e seu data warehouse, a visualização dos logs de erro associados pode fornecer informações adicionais sobre a causa do problema. 

Para visualizar os erros, clique no destino do depósito na página Syncing (Sincronização ). Nas guias Historical (Histórico ) e Periodic sync (Sincronização periódica ), o senhor verá uma lista das exportações e seu status, juntamente com um indicador que mostra se há algum erro ativo.

Para ver mais detalhes sobre um erro específico, clique na exportação que está apresentando a falha. 

Aqui, o senhor verá uma linha do tempo das sincronizações de saída, juntamente com uma mensagem de erro ou sucesso com base no status da sincronização. 

Ao clicar em um erro específico, será aberta uma gaveta com as seguintes informações:

• Resumo
  Uma breve descrição do erro retornado pelo data warehouse. 
• Código
  O código de erro do erro.
• Mensagem externa
  A mensagem de erro real retornada pelo data warehouse.
• Data
  A data e a hora do erro. 

Recursos adicionais 

Entender como as informações são trocadas entre a Klaviyo e os aplicativos

Compreender os tipos de informações trocadas entre a Klaviyo e os aplicativos