Entendendo a importação de eventos do data warehouse no Klaviyo

O que você vai aprender

Saiba como usar a importação de eventos dodata warehouse para sincronizar dados de eventos do seu warehouse para o Klaviyo, para que você possa alimentar segmentos, fluxos e relatórios com comportamento originado fora das integrações nativas do Klaviyo(por exemplo, sistemas de PDV, plataformas de suporte ou aplicativos personalizados).

O que é importação de eventos do data warehouse?

A importação de eventos do data warehouse permite que o Klaviyo se conecte diretamente ao seu data warehouse e configure sincronizações de importação de tabelas ou exibições do warehouse que contenham dados de eventos.

Cada linha da tabela de origem é tratada como um único evento no Klaviyo:

• Os registros de data e hora, o nome da métrica e os identificadores da linha definem o que aconteceu, quando e para quem.
• As colunas adicionais tornam-se propriedades de eventos que você pode usar em segmentação, fluxo e análise.

A importação de eventos foi desenvolvida com base na mesma infraestrutura de importação do Data Warehouse Import que a importação do perfil, mas tem como alvo o pipeline de ingestão de eventos do Klaviyoem vez do perfil.

Como funciona a importação de eventos do data warehouse?

Depois que você conectar o Klaviyo ao seu depósito e configurar uma sincronização de eventos:

1. O Klaviyo consulta seu warehouse em busca da tabela ou visualização configurada.
2. Em cada execução, o Klaviyo lê apenas as linhas cujo registro de data e hora de detecção de alterações é mais recente do que a última sincronização bem-sucedida. Isso permite importações incrementais sem reprocessar a tabela inteira.
3. Cada linha é processada da seguinte forma:
   • O Klaviyo determina o nome da métrica (tipo de evento) com base nas opções selecionadas durante a configuração da sincronização: uma única métrica escolhida ou dinamicamente com base no valor de uma coluna de nome de métrica designada na tabela de origem.
   • O registro de data e hora do evento, os identificadores de perfil e a moeda de valor, valor e ID exclusivos opcionais são definidos com base nos mapeamentos de campo configurados durante a configuração da sincronização.
   • Todas as colunas restantes são ingeridas como propriedades de eventos, usando os nomes das colunas como nomes de propriedades. Nomes de colunas com três sublinhados (por exemplo, parent___child1, parent___child2) podem ser usados para criar uma propriedade de evento(parent) com propriedades child.
4. Klaviyo carrega os eventos resultantes em sua conta, onde eles se comportam como outros API métrica personalizada em segmentação, fluxo e análise.

As importações são executadas em uma cadência recorrente (por exemplo, de hora em hora), de modo que as linhas novas ou atualizadas em seu depósito são regularmente traduzidas em eventos no Klaviyo.

Antes de começar

Certifique-se de que os seguintes requisitos sejam atendidos antes de criar uma sincronização de importação de eventos:

• Você tem acesso ao Advanced Klaviyo Data Platform e ao Data Warehouse Import.
• Você criou e validou uma conexão de data warehouse no Klaviyo. Consulte os artigos da central de suporte para seu data warehouse para obter detalhes sobre a conta de serviço e os esquemas necessários.
• Sua tabela ou exibição de origem contém as colunas necessárias abaixo.
• Você tem privilégios suficientes em seu depósito para expor as tabelas/visualizações necessárias ao usuário de serviço do Klaviyo.

Estrutura da tabela de origem para eventos

Para garantir que os dados do seu evento possam ser importados corretamente, a tabela ou visualização de origem deve atender aos campos e à estrutura exigidos pelo Klaviyo.

Campos obrigatórios

As colunas a seguir são necessárias na V1 da importação de eventos do data warehouse:

Campos opcionais

Esses campos são recomendados quando aplicáveis, mas não são estritamente obrigatórios:

Propriedades do evento

Todas as outras colunas em sua tabela são tratadas como propriedades de eventos:

• As colunas são importadas como propriedades achatadas, com o nome da coluna usado diretamente como o nome da propriedade no Klaviyo.
• Você não precisa mapear explicitamente todas as propriedades; as colunas não mapeadas serão incluídas como propriedades de eventos.
• O JSON aninhado pode ser armazenado dentro de um valor de propriedade individual, se necessário (por exemplo, um objeto JSON de itens de linha), mas o próprio nome da propriedade vem de uma coluna de nível superior.

O Klaviyo executa a análise de tipo de melhor esforço para propriedades de eventos e não fornece lógica de transformação por campo como parte da configuração de importação de eventos.

Casos de uso comuns

Normalmente, os clientes usam a importação de eventos do data warehouse para:

1) Importação de eventos off-line ou de PDV

Traga eventos na loja ou off-line (por exemplo, compras no PDV, devoluções ou compromissos) de seu depósito para que eles se comportem como outros eventos e métrica do Klaviyo.

Exemplos:

• Eventos de compra na loja com totais de pedidos, localização da loja e tipo de proposta
• Compromisso Eventos concluídos com membro da equipe, tipo de serviço e duração

2) Interações de serviço e suporte

Sincronize eventos de suporte e serviço, como criação de tíquetes, resolução ou devoluções, para enriquecer as linhas do tempo de seus clientes e enviar mensagens com base no histórico de serviços.

Exemplos:

• Ticket de suporte criado e ticket de suporte resolvido
• Pedido devolvido com códigos de motivo e valores de reembolso

3) Eventos modelados ou derivados

Converta os comportamentos modelados pelo armazém em eventos que são mais fáceis de usar no Klaviyo.

Exemplos:

• Alta taxa de desistência Eventos de risco gerados a partir de um modelo em seu depósito
• Eventos de marcos de ciclo de vida alcançados quando um cliente muda de estágio em um modelo de ciclo de vida personalizado

Configurar uma sincronização de importação de eventos do data warehouse

1) Conecte seu data warehouse

Se você ainda não conectou seu depósito:

1. Em Klaviyo, vá para Advanced Klaviyo Data Platform > Data management > Syncing (Sincronização).
2. Clique em Adicionar data warehouse e selecione seu conector de warehouse.
3. Conclua as etapas de conexão para sua plataforma seguindo o guia de conexão aplicável vinculado ao artigo de visão geral da importação do Data Warehouse.

Klaviyo suporta um com atividade data warehouse conexão por conta.

2) Crie uma nova sincronização de importação de eventos

Quando o depósito estiver conectado:

1. Em Advanced Klaviyo Data Platform > Data management > Syncing, selecione a conexão do seu depósito.
2. Escolha Importar dados (se você estiver configurando importações pela primeira vez) ou clique em Criar sincronização / Adicionar sincronização para uma conexão existente.
3. Quando for solicitado o tipo de dados, selecione Eventos (em vez de perfil).
4. Selecione a tabela ou visualização em seu depósito que contém os eventos que você deseja importar.

3) Mapear os campos obrigatórios

Em seguida, você mapeará as colunas da tabela do seu warehouse para os campos de eventos obrigatórios do Klaviyo.

A configuração de importação de eventos exige que você forneça mapeamentos para:

• Registro de data e hora do evento
• nome da métrica (uma constante que você seleciona na configuração ou uma coluna que contém o nome da métrica por linha)
• Identificador de perfil (pelo menos um)
• Registro de data e hora da detecção de alterações

Você também pode mapear os campos recomendados:

• ID única
• Valor
• Moeda de valor

Todas as colunas restantes que você não mapear explicitamente para esses campos principais se tornarão automaticamente propriedades de eventos.

A interface de configuração impede que você mapeie várias colunas para o mesmo campo de nível superior e valida se todos os campos obrigatórios estão presentes antes de permitir que você salve.

4) Escolha a cadência de sincronização e o escopo histórico

Quando você salva a importação do evento:

• O Klaviyo programa sincronizações recorrentes para serem executadas em uma cadência regular (geralmente de hora em hora).
• Em cada execução, somente as linhas cujo registro de data e hora de detecção de alterações é mais recente do que a última execução bem-sucedida são processadas, garantindo que as importações sejam incrementais.

Para o preenchimento histórico, você pode:

• Aponte a importação de eventos para uma tabela ou exibição que já inclua todos os eventos históricos relevantes, ou
• Comece com uma tabela histórica dedicada e, posteriormente, mude para uma visualização apoiada na captura de dados de alterações para atualizações contínuas.

Como os eventos importados se comportam no Klaviyo

Uma vez importado:

• Cada linha aparece como um evento de uma métrica de API personalizada no Klaviyo.
• O nome da métrica que você mapeou (ou configurou como uma constante) determina o nome do tipo de evento que você vê no produto (por exemplo, Placed Order).
• Todos os identificadores de perfil são resolvidos para o perfil existente sempre que possível; caso contrário, o Klaviyo cria um novo perfil usando os campos de identificador fornecidos, de forma semelhante a outros caminhos de ingestão de eventos.

Você pode usar esses eventos para:

• Crie segmentos com base no que alguém fez e filtre pelas propriedades do evento.
• disparador e filtro fluxo.
• Analisar o comportamento em métrica e relatórios juntamente com eventos de outras fontes.

Limitações e práticas recomendadas

Tenha em mente o seguinte ao usar a importação de eventos do data warehouse:

• A versão 1 da importação de eventos se concentra apenas nos dados do evento. As atualizações de Propriedades do perfil derivadas de eventos podem ser adicionadas em uma iteração posterior; por enquanto, Propriedades do perfil deve ser atualizado por meio de importação de perfil ou outros caminhos compatíveis.
• O registro de data e hora da detecção de alterações deve ser diferente do registro de data e hora do evento. Usar a mesma coluna para ambos pode impedir que você importe eventos históricos com segurança após a primeira sincronização.
• Para obter a velocidade ideal, defina o campo de detecção de alterações como o carimbo de data/hora de quando a nova tabela foi criada. Os registros são agrupados em ciclos de sincronização usando esse valor, de modo que o tempo para importar registros históricos pode ser reduzido se todos os registros históricos tiverem carimbos de data e hora de detecção de alterações em um intervalo estreito (por exemplo, o carimbo de data e hora de um trabalho que cria a nova tabela).
• Use uma ID exclusiva e estável por evento sempre que possível para melhorar a deduplicação e facilitar a depuração downstream.
• Se a sua tabela contiver vários tipos de eventos (métrica) com diferentes conjuntos de colunas, geralmente não há problema em mantê-los juntos: as colunas que são NULL para determinadas linhas são simplesmente ignoradas para esses eventos em Klaviyo.
• Para objetos aninhados complexos (por exemplo, matrizes de itens de linha), recomendamos o achatamento em várias colunas sempre que possível, especialmente para propriedades que você espera usar em segmentação ou fluxo.

```