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

Você precisará garantir que o data warehouse com o qual está se conectando esteja configurado como um destino. Para confirmar que você configurou tudo corretamente:

• Garanta que o usuário fornecido ao Klaviyo tenha as permissões corretas.
• Não se esqueça de definir as tabelas com os nomes apropriados, mostrados abaixo, com base no seu data warehouse.

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

Para adicionar uma conexão de data warehouse ao Klaviyo, navegue até Advanced Klaviyo Data Platform > Gerenciamento de dados > Sincronização.

Para adicionar um data warehouse, selecione um data warehouse compatível na modal Selecionar um conector.

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

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

Importe dados por SFTP

Se você quiser importar dados do seu data warehouse para a Klaviyo, pode fazer isso via SFTP.

Para importar seus dados para a Klaviyo, selecione Importar dados ao conectar um destino de warehouse pela primeira vez ou clique no botão Importar na página Sincronização de dados se você já tiver uma conexão estabelecida.

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.

Depois de exportar os dados desejados do seu data warehouse, gere uma nova Chave SSH na sua máquina local e adicione-a ao Klaviyo selecionando o botão Adicionar Chave SSH.

Configure o cliente SFTP e importe.

Depois que sua Chave SSH for adicionada com sucesso à Klaviyo, você precisará configurar seu cliente SFTP e importar os dados.

1. Abra seu cliente SFTP e configure uma nova conexão com as credenciais apresentadas no Klaviyo. Você verá as credenciais apresentadas após adicionar sua Chave SSH com sucesso.
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 seu banco de dados pelo seu cliente SFTP e revise

Você também verá uma visualização em lista das 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.

Exporte dados para o seu data warehouse 

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

Amazon Redshift

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

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

• Nome: O nome do seu banco de dados no Redshift (recomenda-se 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 para identificar sua fonte de dados
• 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 um destino, defina os nomes das tabelas como klaviyo_profile e klaviyo_event.

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

• Nome: O nome legível por máquina para o banco de dados do Amazon S3.
• 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 destino, execute o seguinte script para definir as tabelas klaviyo_profile e klaviyo_event . 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 esse 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 e klaviyo_event .

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 do banco de dados do pool de SQL exclusivo.
• 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:

text Copy

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:

text Copy

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ê deve ter os privilégios securityadmin e sysadmin para concluir a configuração abaixo. Para revisar quais função(ões) você tem, execute SHOW GRANTS TO USER <your_username> e garanta que você tenha ambas as funções listadas. Fale com um administrador de sistema se precisar ter sua função ajustada.

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.
  

Depois de inserir suas credenciais do data warehouse com o qual você está sincronizando, escolha os dados que você quer sincronizar da Klaviyo.

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

O valor definido para o campo Cadência de sincronização periódica na seção chamada Selecione a frequência de sincronização dos seus dados define com que frequência ocorrerá uma sincronização da Klaviyo para seu data warehouse.

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

Depois de conectar sua integração, se a configuração tiver sido bem-sucedida, você verá uma tela final indicando que a conexão está Ativada, junto com:

• Detalhes da sincronização que você 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 sucesso, em vez disso você verá o status Não foi possível conectar, além de opções para tentar a conexão novamente ou editar as informações nas suas credenciais.

Depois de conectar seu data warehouse com sucesso, você será levado(a) de volta à página principal da lista de Sincronização de dados. Aqui, você verá seus(as):

• Destinodo depósito
• O status Ativado
• 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 carimbo de data/hora deste evento

Como você só poderá conectar 1 destino, você só verá 1 destino refletido nesta exibição de lista.

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 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.
  • Em andamento
    Os dados estão sendo sincronizados ativamente com o 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 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.
  • Pausado
    Você pausou a sincronização manualmente.
  • Desativado
    A sincronização foi desativada porque as integrações em si foram desativadas ou removidas.
• 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 tem registros que mostram o status das suas sincronizações periódicas. À medida que os clientes continuarem interagindo 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.

Você 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 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.
  • Em andamento
    Os dados estão sendo sincronizados ativamente com o 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.
  • Falhou
    A sincronização falhou completamente, mesmo depois de tentar restabelecer uma conexão. Isso significa que você precisará revisar as configurações ou até mesmo a configuração do data warehouse.
  • Pausada
    Você pausou a sincronização manualmente.
  • Desativada
    A sincronização foi desativada porque a integração em si foi desativada ou removida.
• Atualidade dos dados
  Atualidade dos dados se refere a quão atualizados seus dados estão. Por exemplo, se uma sincronização tiver uma atualidade de 2 minutos, isso significa que quaisquer novos dados criados no Klaviyo nos últimos 2 minutos ainda não estão no seu data warehouse.
• Botões para Pausar, Retomar e reativar sincronizações individuais.

Removendo conexões de data warehouse

Para excluir uma conexão de data warehouse da sua conta do Klaviyo, selecione a guia Integrações.

Abra o menu ao lado da integração do seu data warehouse e selecione Remover integração para remover a conexão.

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:

• 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