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.
O Advanced Klaviyo Data Platform e o Klaviyo Marketing Analytics não estão incluídos no aplicativo de marketing padrão do Klaviyo, e é necessária uma assinatura para acessar a funcionalidade associada. Acesse nosso guia de cobrança para saber como comprar esses planos.
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/3252.206.71.52/323.227.146.32/3244.198.39.11/3235.172.58.121/323.228.37.244/3254.88.219.8/323.214.211.176/32
Conectar-se a um data warehouse
Para adicionar uma conexão data warehouse a Klaviyo, navegue até Advanced Klaviyo Data Platform > dados management > Syncing.
- Para adicionar um data warehouse, clique no botão New connection ( Nova conexão ).
- No modal Select a destination (Selecionar um destino ), selecione um data warehouse compatível para se conectar ao Klaviyo.
O senhor só pode ter um destino de data warehouse por conta.
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:
- Exporte os dados desejados de seu data warehouse.
- Gere o Chave SSH em seu computador local.
- Configurar o cliente SFTP e importar.
Isso é demonstrado com o Snowflake, mas o processo de importação é semelhante, independentemente da integração do seu depósito.
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.
Formate os dados exportados com base no formato CSV e nas limitações de tamanho.
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.
Ao adicionar sua chave, verifique se ela começa com um dos seguintes caracteres:
- Ssh-ras
- Ecdsa-sha2
- Ssh-ed
- Sk-ecdsa
- sk-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.
- 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.
- Depois de autenticado, verifique se o banco de dados segue as diretrizes recomendadas antes de importar.
- 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.
Amazon Redshift
Para configurar o Amazon Redshift como um destino, execute o seguinte script para criar as tabelas klaviyo_event e klaviyo_profile.
Depois de configurado como um destino, conecte seu depósito ao Klaviyo usando o seguinte conjunto de credenciais:
- Name (Nome): O nome do seu banco de dados no Redshift (é recomendável 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 usada pelo Redshift
- Esquema: Seu esquema de banco de dados
- Username: 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 configurado como um destino, conecte seu depósito ao Klaviyo usando o seguinte conjunto de credenciais:
- Nome: O nome legível por máquina do banco de dados do Amazon S3.
- Bucket: O nome do seu bucket.
- Localização do bucket: O nome da região que foi escolhido quando o bucket de armazenamento foi criado.
- ID da chave de acesso: seu ID da chave de acesso ao AWS.
-
Chave de acesso secreta: Sua chave de acesso secreta do AWS.
Google BigQuery
Para configurar o Google BigQuery como um destino, execute o seguinte script para definir as tabelas klaviyo_profile e klaviyo_event . Sua conta do Google BigQuery deve ter um perfil de pagamento para que o processo de conexão seja bem-sucedido.
Observe que, nesse script, o senhor deve substituir o espaço reservado "SERVICE ACCOUNT EMAIL" pelo e-mail da sua conta de serviço do BigQuery.
Depois de configurado como um destino, conecte seu depósito ao Klaviyo usando o seguinte conjunto de credenciais:
- Name (Nome): Um nome para ajudar o senhor a identificar esse destino
- ID do projeto: É conhecida como ID do projeto e pode ser encontrada no console da API.
- Conjunto de dados: Também conhecido como esquema. Esse é o mesmo nome que o senhor usou no script que deveria ter executado para a configuração.
-
Chave da conta de serviço: Cole todo o conteúdo do arquivo JSON que o senhor baixou ao criar sua conta de serviço no BigQuery.
Análise de sinapse do Microsoft Azure
Para configurar o Microsoft Azure como um destino, execute o seguinte script para criar as tabelas klaviyo_profile e klaviyo_event .
- Nome: Recomenda-se usar o mesmo nome do seu banco de dados no Azure.
- Workspace: O nome do espaço de trabalho do Azure Synapse.
- Nome do banco de dados: identifica o banco de dados do Dedicated SQL Pool.
- Nome de usuário: seu nome de usuário de login para o banco de dados do Dedicated SQL Pool.
- 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 o senhor 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 preparação temporária para transferência de dados.
Snowflake
Para configurar o Snowflake como um destino, siga as etapas a seguir:
1. Gere uma chave privada executando o seguinte comando em seu terminal:
openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt
2. Gere uma chave pública que faça referência à chave privada executando o seguinte comando em seu terminal:
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub
3. Execute o script a seguir para definir as tabelas perfil, KLAVIYO_EVENT e métrica. O senhor deve ter privilégios securityadmin e sysadmin para concluir a configuração abaixo. Para verificar as funções que o senhor tem, execute SHOW GRANTS TO USER <your_username> e verifique se as duas funções estão listadas. Entre em contato com um administrador do sistema se o senhor precisar ajustar sua função.
Depois de configurado como um destino, conecte seu depósito ao Klaviyo usando o seguinte conjunto de credenciais:
- Nome: Recomenda-se usar o mesmo nome do seu banco de dados no Snowflake.
-
Username: Nome de usuário para se conectar ao seu banco de dados. Ele deve ser o mesmo que user_name no script de configuração.
-
Chave privada: A chave privada do Snowflake gerada.
- Armazém: Seu armazém em Snowflake.
- Conta: Sua conta no Snowflake.
- Banco de dados: O nome do seu banco de dados. Ele deve ser o mesmo que database_name no script de configuração.
-
Esquema: Seu esquema de banco de dados. Ele deve ser o mesmo que schema_name no script de configuração.
Depois de inserir suas credenciais para o data warehouse com o qual está sincronizando, escolha os dados que deseja sincronizar do Klaviyo.
Objetos de dadosObjetos 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.
O Klaviyo usa uma estrutura JSON aninhada ao enviar dados para seu data warehouse. Os perfis e eventos são enviados como uma única tabela, o que permite que o senhor consulte uma tabela em vez de um grande número de nomes de tabelas potenciais em seu data warehouse.
A sincronização de todos os dados do Klaviyo pode fazer com que o senhor incorra em cobranças adicionais do seu data warehouse.
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.
A exclusão de dados de integração específicos é apenas para dados de eventos e não exclui dados de perfil.
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.
Esse campo só aparecerá se o senhor selecionar o objeto de dados Eventos .
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.
A cadência de sincronização periódica é definida como sendo de hora em hora por padrão e não pode ser alterada.
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
O senhor pode incorrer em custos adicionais do seu data warehouse se sincronizar uma grande quantidade de dados de uma só vez.
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 dadosPainel 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.
-
Concluído
-
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.
-
Concluído
-
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