Introdução às transferências de dados do Klaviyo

É possível carregar dados do Klaviyo para o BigQuery usando o serviço de transferência de dados do BigQuery para o Klaviyo. Com o serviço de transferência de dados do BigQuery, você pode programar jobs de transferência recorrentes que adicionam seus dados mais recentes do Klaviyo ao BigQuery.

Para saber como programar uma transferência do Klaviyo, consulte Carregar dados do Klaviyo no BigQuery.

Opções de ingestão de dados

Estas seções descrevem as opções de ingestão de dados para configurar uma transferência de dados do Klaviyo.

Transferências completas ou incrementais

É possível especificar como os dados são carregados no BigQuery selecionando a preferência de gravação Completa ou Incremental na configuração de transferência quando você configura uma transferência do Klaviyo. As transferências incrementais são aceitas na versão prévia em prévia.

É possível configurar uma transferência de dados completa para transferir todos os dados dos conjuntos de dados do Klaviyo com cada transferência de dados.

Como alternativa, você pode configurar uma transferência de dados incremental (versão prévia) para transferir apenas os dados que foram alterados desde a última transferência de dados, em vez de carregar todo o conjunto de dados com cada transferência de dados. Se você selecionar Incremental para a transferência de dados, especifique os modos de gravação Adicionar ou Upsert para definir como os dados são gravados no BigQuery durante uma transferência de dados incremental. As seções a seguir descrevem os modos de gravação disponíveis.

Modo de gravação "Adicionar"

O modo de gravação "Adicionar ao final" insere apenas novas linhas na tabela de destino. Essa opção anexa estritamente os dados transferidos sem verificar os registros existentes. Portanto, esse modo pode causar duplicação de dados na tabela de destino.

Ao selecionar o modo de anexação, é necessário selecionar uma coluna de marca d'água. Uma coluna de marca d'água é necessária para que o conector do Klaviyo rastreie as mudanças na tabela de origem.

Para transferências do Klaviyo, recomendamos selecionar uma coluna que só seja atualizada quando o registro for criado e que não mude com atualizações subsequentes, por exemplo, a coluna CREATED_AT.

Modo de gravação "Upsert"

O modo de gravação "Upsert" atualiza uma linha ou insere uma nova linha na tabela de destino verificando uma chave primária. É possível especificar uma chave primária para permitir que o conector do Klaviyo determine quais mudanças são necessárias para manter a tabela de destino atualizada com a tabela de origem. Se a chave primária especificada estiver presente na tabela do BigQuery de destino durante uma transferência de dados, o conector do Klaviyo atualizará essa linha com novos dados da tabela de origem. Se uma chave primária não estiver presente durante uma transferência de dados, o conector do Klaviyo vai inserir uma nova linha.

Ao selecionar o modo de upsert, é necessário selecionar uma coluna de marca d'água e uma chave primária:

  • Uma coluna de marca d'água é necessária para que o conector do Klaviyo rastreie as mudanças na tabela de origem.
    • Selecione uma coluna de marca d'água que seja atualizada sempre que uma linha for modificada. Recomendamos colunas semelhantes à coluna UPDATED_AT ou LAST_MODIFIED.

  • A chave primária pode ser uma ou mais colunas na tabela necessárias para que o conector do Klaviyo determine se precisa inserir ou atualizar uma linha.

    Selecione colunas que contenham valores não nulos que sejam exclusivos em todas as linhas da tabela. Recomendamos colunas que incluam identificadores gerados pelo sistema, códigos de referência exclusivos (por exemplo, IDs de incremento automático) ou IDs de sequência imutáveis baseados em tempo.

    Para evitar possível perda ou corrupção de dados, as colunas de chave primária selecionadas precisam ter valores exclusivos. Se você tiver dúvidas sobre a exclusividade da coluna de chave primária escolhida, recomendamos usar o modo de gravação "Adicionar".

Mapeamento de tipo de dados

A tabela a seguir mapeia os tipos de dados do Klaviyo para os tipos de dados correspondentes do BigQuery:

Tipo de dados do Klaviyo Tipo de dados do BigQuery
String STRING
Text STRING
Integer INTEGER
Boolean BOOLEAN
Date (YYYY-MM-DD HH:MM:SS) TIMESTAMP
List ARRAY

Preços

Não há custo para transferir dados do Klaviyo para o BigQuery enquanto esse recurso estiver na versão prévia.

A seguir