Entenda a sincronização do data warehouse na Klaviyo

O que você vai aprender

Saiba como sincronizar dados da Klaviyo com seu data warehouse e importar dados do data warehouse para a Klaviyo via SFTP. Você pode sincronizar os dados de perfil de cliente e de eventos, permitindo armazenar e analisar informações importantes sobre seus clientes fora da Klaviyo.

This content requires Functional cookies to be enabled.

Update Cookie Settings

Antes de começar

Antes de exportar dados do Klaviyo, configure seu data warehouse como um destino:

• Garanta que o usuário fornecido ao Klaviyo tenha as permissões corretas.
• Para destinos que usam tabelas, crie as tabelas com os nomes mostrados nas instruções de configuração abaixo.

Além disso, não se esqueça de adicionar os endereços IP de tráfego de saída do data warehouse da Klaviyo à lista de permissões. Isso garantirá que as solicitações da Klaviyo não sejam bloqueadas pela 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 a um data warehouse

1. Acesse Gerenciamento de dados > Sincronização. Se você já tiver uma conexão, clique em Criar sincronização.
2. Selecione Exporte dados para o seu data warehouse.
3. Selecione seu depósito e, em seguida, clique em Conectar a [warehouse name] na página de configuração dele.

Como alternativa, você pode selecionar seu data warehouse no marketplace de aplicativos da Klaviyo acessando integrações > Explorar aplicativos e pesquisando sua plataforma.

A opção Importar dados do seu data warehouse configura uma importação direta do warehouse. Para fazer upload de arquivos CSV via SFTP, siga a próxima seção.

Importe dados por SFTP

Se você quiser importar dados do seu data warehouse para o Klaviyo, pode fazer isso via SFTP. Para uma conexão direta com o warehouse, consulte Entenda o Data Warehouse Import no Klaviyo.

Acesse Integrações, abra Gerenciar dados > Transferência de dados por SFTP e selecione a guia Configuração de SFTP.

O processo para importar dados do warehouse para a Klaviyo é o seguinte:

1. Exporte os dados desejados do seu data warehouse.
2. Gere chaves SSH no seu computador local.
3. Configure o cliente SFTP e importe.

Exporte seu banco de dados

Primeiro, você precisará exportar seus dados do seu data warehouse. Faça login no seu data warehouse e exporte os dados que você quer importar para a Klaviyo em um arquivo CSV.

Gere chaves SSH no seu computador.

Gere uma nova Chave SSH na sua máquina local. Mantenha a chave privada para o seu cliente SFTP.

1. Na configuração do SFTP, clique em Adicionar chave SSH. Insira um título da chave e cole sua chave pública em Chave SSH.
2. Clique em Adicionar chave.

Configure o cliente SFTP e importe.

Depois de adicionar sua chave pública ao Klaviyo, configure seu cliente SFTP e faça upload do seu arquivo CSV.

1. Crie uma conexão no seu cliente SFTP usando o servidor, a porta e o nome de usuário mostrados em Credenciais de SFTP em Configuração de SFTP. Autentique-se com a chave privada correspondente.
2. Antes de fazer o upload, verifique se o seu arquivo CSV segue as diretrizes de formatação recomendadas no link acima.
3. Envie o arquivo CSV pelo seu cliente SFTP.

Para verificar a importação, abra a aba Importação de dados em Transferência de dados via SFTP. Importações recentes mostra:

• Status
  Na fila, Processando, Concluída, Falha ou Cancelada. Uma importação concluída ainda pode conter erros.
• Linhas processadas
  Porcentagem do arquivo processada até o momento. Expanda uma importação para conferir as contagens de linhas processadas e ignoradas.
• Data de importação
  Data da importação.
• Importado por
  Usuário que importou os dados.

Exporte dados para o seu data warehouse 

Para configurar seu data warehouse como um destino, você vai precisar do seguinte conjunto de informações e credenciais para cada data warehouse.

Amazon Redshift

Para configurar o Amazon Redshift como um destino, execute o script a seguir para criar as tabelas klaviyo_event, klaviyo_profile e klaviyo_metric.

Peça para o administrador do seu banco de dados adaptar este exemplo antes de executá-lo: substitua os placeholders, corrija o */ sem par perto do início e execute as instruções GRANT específicas da tabela depois de criar as tabelas.

Depois de configurar como um destino, conecte seu data warehouse à Klaviyo usando o seguinte conjunto de credenciais:

• Nome: Um nome para identificar essa conexão. Você pode usar o mesmo nome do seu banco de dados no Redshift.
• URL do host: O ponto de extremidade do servidor Amazon Redshift (chamado de URL de conexão no Redshift)
• Banco de dados: O nome do banco de dados do Redshift ao qual o Klaviyo vai se conectar
• Porta: O número da porta usado pelo Redshift
• Esquema: O esquema do seu banco de dados
• Nome de usuário: o nome de usuário usado para fazer login no Redshift
• Senha do banco de dados: A senha usada para fazer login no Redshift
  

Amazon S3

Para configurar o Amazon S3 como destino, tenha o nome do bucket, a região do bucket e as credenciais de acesso à AWS em mãos.

Depois de configurar como um destino, conecte seu data warehouse à Klaviyo usando o seguinte conjunto de credenciais:

• Nome: Um nome para identificar essa conexão.
• Bucket: O nome do seu bucket.
• Localização do bucket: O nome da região escolhido quando o bucket de armazenamento foi criado.
• ID da chave de acesso: Sua ID da chave de acesso da AWS.
• Chave de acesso secreta: Sua chave de acesso secreta da AWS.
  

Google BigQuery

Para configurar o Google BigQuery como um destino, execute o script a seguir para configurar as tabelas klaviyo_profile, klaviyo_event e klaviyo_metric. Sua conta do Google BigQuery precisa ter um perfil de pagamento para que o processo de conexão seja bem-sucedido.

Observação: neste script, você precisa substituir o placeholder "SERVICE ACCOUNT EMAIL" pelo e-mail da conta de serviço do BigQuery.

Depois de configurar como um destino, conecte seu data warehouse à Klaviyo usando o seguinte conjunto de credenciais:

• Nome: Um nome para ajudar você a identificar este destino
• ID do projeto: Isso é conhecido como ID do projeto e pode ser encontrado no console da API.
• Conjunto de dados: Também conhecido como esquema. O mesmo nome usado no script que executou para a configuração.
• Chave da conta de serviço: Cole todo o conteúdo do arquivo JSON que você baixou ao criar sua conta de serviço no BigQuery.
  

Microsoft Azure Synapse Analytics

Para configurar o Microsoft Azure como destino, execute o script a seguir para criar as tabelas klaviyo_profile, klaviyo_event e klaviyo_metric. Peça para o administrador do seu banco de dados adaptar o exemplo antes de executá-lo: ele começa com instruções DROP TABLE, incluindo uma instrução DROP TABLE klaviyo_profile duplicada. Remova as instruções DROP TABLE ao criar novas tabelas ou se você precisar preservar os dados existentes.

Depois de configurar como um destino, conecte seu data warehouse à Klaviyo usando o seguinte conjunto de credenciais:

• Nome: Recomenda-se usar o mesmo nome do seu banco de dados no Azure.
• Workspace: O nome do workspace do Azure Synapse.
• Nome do banco de dados: Isso identifica o banco de dados do pool de SQL exclusivo.
• Nome de usuário: Seu nome de usuário de login para seu banco de dados do pool de SQL exclusivo.
• Senha do banco de dados: Sua senha de login para o banco de dados do Dedicated SQL Pool.
• Nome da conta: Sua conta de armazenamento do Windows Azure ou o prefixo DNS que você criou.
• Assinatura de acesso: Sua string de assinatura de acesso compartilhado (SAS) que comprova o acesso ao contêiner do Blob Storage.
• Nome do contêiner: o nome do contêiner do Azure Blob para a área de staging temporária para transferência de dados.
  

Snowflake

Para configurar o Snowflake como um destino, siga estas etapas:

1. Gere uma chave privada executando o seguinte comando no seu terminal:

textCopy

openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt

2. Gere uma chave pública que referencie a chave privada executando o seguinte comando no seu terminal:

textCopy

openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub

3. Execute o seguinte script para configurar as tabelas KLAVIYO_PROFILE, KLAVIYO_EVENT e KLAVIYO_METRIC. Você precisa ter privilégios de securityadmin e sysadmin para concluir a configuração abaixo. Para verificar qual(is) função(ões) você tem, execute SHOW GRANTS TO USER <your_username> e confirme se as duas funções estão listadas. Fale com um administrador do sistema se você precisar ajustar sua função. Antes de executar o script, substitua os placeholders SET_ pelos seus valores e GENERATE_PUBLIC_KEY pela chave pública que você gerou. O script usa CREATE OR REPLACE TABLE, que substitui quaisquer tabelas existentes com esses nomes. Use um novo banco de dados ou peça para o administrador adaptar essas instruções se você precisar preservar os dados existentes.

Depois de configurar como um destino, conecte seu data warehouse à Klaviyo usando o seguinte conjunto de credenciais:

• Nome: Recomenda-se usar o mesmo nome do seu banco de dados no Snowflake.
• Nome de usuário: Nome de usuário para conectar-se ao seu banco de dados. Isso deve ser o mesmo que user_name no script de configuração.
  
• Chave privada: A chave privada do Snowflake gerada.
  
• Depósito:  Seu depósito no Snowflake.
• Conta: Sua conta no Snowflake.
• Banco de dados: Nome do seu banco de dados. Isso deve ser o mesmo que database_name no script de configuração.
• Esquema: O esquema do seu banco de dados. Isso deve ser o mesmo que schema_name no script de configuração.
  

Databricks

Para configurar o Databricks como um destino, incluindo o script de configuração, as permissões necessárias e as credenciais de conexão, siga as etapas em Como exportar dados da Klaviyo para o Databricks.

Se o formulário de conexão mostrar uma seção Blob store, use-a para configurar o armazenamento da sua exportação. Para destinos de data warehouse, esse armazenamento prepara os dados antes de carregá-los no data warehouse. Para o Amazon S3, esse é o destino da exportação.

1. Para usar uma loja salva, selecione Usar uma configuração de blob, se essa opção for exibida, e depois escolha um Armazenamento de blob compatível. Se você deixar Usar uma configuração de blob desmarcado, continue com os detalhes da conexão listados acima. Se a Klaviyo exigir um armazenamento de blob, selecione um antes de continuar.
2. Para adicionar uma loja, escolha Criar no menu suspenso Blob store. Selecione um Provedor se solicitado, insira os detalhes de conexão e clique em Criar.
3. Se o campo Nome da configuração de armazenamento aparecer, insira o nome da configuração de armazenamento que você criou no seu data warehouse.
4. Para um destino do Amazon S3, escolha um Formato do arquivo e se deseja Comprimir arquivos exportados, caso esses controles apareçam.

Depois de inserir os detalhes da sua conexão, clique em Avançar. Em seguida, escolha os dados e o agendamento da sua exportação.

Objetos de dados

Na seção Objetos de dados , você pode escolher 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 excluir, você pode selecionar as integrações específicas que quer excluir da sincronização do data warehouse. Isso é útil se você quiser impedir que os dados de uma integração específica que você já tenha conectado ao Klaviyo sejam sincronizados também.

Sincronização seletiva

No campo Sincronização seletiva , você seleciona os eventos específicos que quer sincronizar com seu data warehouse a partir do Klaviyo. Por padrão, todos os eventos são incluídos. Quando você define eventos específicos para sincronizar com esse campo, apenas os eventos selecionados serão sincronizados.

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

Em Selecione a frequência de sincronização dos seus dados, escolha um intervalo em A cada: 1, 2, 4, 6, 12 ou 24 horas. Defina a Data de início, a Hora de início e o Fuso horário do agendamento.

Selecione a quantidade de dados históricos que deseja sincronizar

Na seção Selecione quantos dados históricos você quer sincronizar , você pode definir quantos dados históricos gostaria de sincronizar do Klaviyo para o seu data warehouse durante a conexão inicial. Você pode escolher:

• 30 dias
• 90 dias
• 1 ano
• Todo o período

Sincronizar avaliações

Clique em Próximo para abrir Revisão. Confira os detalhes da conexão e as configurações de exportação, incluindo:

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

Clique em Conectar para salvar a conexão e iniciar as sincronizações de acordo com seu cronograma.

Se o Klaviyo exibir Não foi possível conectar, clique em Editar credenciais para corrigir os detalhes da conexão e, em seguida, volte para Revisar e clique em Conectar novamente.

Depois que a conexão é salva, a Klaviyo leva você de volta para Sincronização de dados. A tabela de conexões mostra:

• Warehouse
• Tipo: importar ou exportar
• Criado em

Os destinos de exportação e as conexões de importação direta aparecem na mesma tabela. Confira Tipo para diferenciá-los.

Painel de sincronização de dados

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

Aqui, você verá as informações de sincronização com divisão em 2 abas:

• Histórico
• Periódico

Histórico

A aba Histórico tem logs que mostram o status das sincronizações dos seus dados históricos. As sincronizações históricas se referem à sincronização dos seus dados existentes da Klaviyo para o seu data warehouse quando você estabelece uma conexão.

Você verá as seguintes informações para cada sincronização:

• Nome
  Os dados que estão sendo incluídos na sincronização.
• Status
  Status e progresso potencial da sincronização com uma porcentagem estimada ou possíveis erros indicados. Esses status podem incluir:
  
  
  • Concluído
    Seus dados terminaram de ser sincronizados para esta sincronização avulsa. Eles não serão sincronizados novamente automaticamente.
  • Agendado
    Quando a próxima sincronização está agendada para ser executada automaticamente.
  • Sincronizando
    Os dados estão sendo sincronizados ativamente com seu data warehouse, com uma porcentagem estimada de conclusão.
  • Com erro
    Ocorreu um erro, mas a Klaviyo continuará tentando restabelecer uma conexão. Dependendo da integração, esse tempo pode variar um pouco.
  • Falha
    A sincronização falhou completamente, mesmo após tentar restabelecer uma conexão. Isso significa que você precisará revisar suas configurações ou até mesmo a configuração do data warehouse. Depois de resolver o problema, clique em Reativar para a sincronização.
  • Pausado
    Você pausou a sincronização manualmente.
  • Cancelada
    A sincronização foi cancelada e não está mais agendada.
• Iniciado em
  Horário de início da sincronização.
• Encerrado em
  Horário de término da sincronização.

Periódico

A guia Periódico mostra o status das sincronizações em andamento. À medida que os clientes continuam interagindo com sua marca e novos dados são criados, eles são enviados para o seu data warehouse de acordo com o agendamento que você selecionou. Depois que cada execução termina, a Klaviyo agenda a próxima execução.

Você verá as seguintes informações para cada sincronização:

• Nome
  Os dados que estão sendo incluídos na sincronização.
• Status
  O status atual da sincronização e quaisquer erros. Esses status podem incluir:
  • Agendado
    A sincronização está aguardando a próxima execução agendada.
  • Sincronizando
    Os dados estão sendo sincronizados ativamente com o seu data warehouse.
  • Com erro
    Ocorreu um erro, mas a Klaviyo continuará tentando restabelecer uma conexão. Dependendo da integração, esse tempo pode variar um pouco.
  • Falha
    A sincronização falhou completamente mesmo depois de tentar restabelecer uma conexão. Isso significa que você precisará revisar suas configurações ou até mesmo a configuração do data warehouse. Depois de resolver o problema, clique em Reativar para a sincronização.
  • Pausada
    Você pausou a sincronização manualmente.
  • Cancelada
    A sincronização foi cancelada e não está mais agendada.
• Atualização dos dados
  Atualização dos dados se refere a quão atualizados seus dados estão. Por exemplo, uma atualização de 2 minutos indica que a sincronização processou dados até aproximadamente 2 minutos atrás. Dados mais recentes ainda podem estar aguardando para serem sincronizados.
• Botões para Pausar, Retomar e reativar sincronizações individuais.

Removendo conexões de data warehouse

1. Acesse Integrações.
2. Abra o menu ao lado da sua integração de data warehouse e selecione Remover integração. Na caixa de diálogo de confirmação, clique em Remover integração novamente.

Ver registros de erro

Se você estiver enfrentando problemas com a sincronização de dados entre a Klaviyo e seu data warehouse, visualizar os logs de erro associados pode fornecer mais informações sobre a causa do problema.

Para ver erros, clique no seu destino do data warehouse na página Sincronização. Nas abas de sincronização Histórico e Periódico , você verá uma lista das exportações e o status delas, além de um indicador que mostra se há erros com atividade.

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

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

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

• Descrição
  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