A Advanced Klaviyo Data Platform não está incluída no aplicativo de marketing padrão do Klaviyo, e é necessária uma assinatura para acessar a funcionalidade associada. Acesse nosso guia de faturamento para saber como adquirir esse plano.
Configuração e conexão do ambiente
Visão geral: Siga estas etapas para preparar o BigQuery para o Klaviyo. Você criará os esquemas necessários (em um conjunto de dados/projeto), configurará uma conta de serviço e uma chave dedicadas, atribuirá os privilégios mínimos necessários, verificará a configuração e conectará o BigQuery ao Klaviyo.
Para obter detalhes sobre como a importação do Data Warehouse funciona em Klaviyo, incluindo a estrutura do esquema, as tabelas necessárias e os mapeamentos de campo, consulte Como funciona a importação do Data Warehouse em Klaviyo.
1) Criar esquemas/conjuntos de dados necessários
No BigQuery, crie dois conjuntos de dados no projeto que você usará para o Klaviyo.
CRIE O ESQUEMA `KLAVIYO_IMPORT_FROM_DWH`; CRIE O ESQUEMA `KLAVIYO_TMP`;
-
KLAVIYO_IMPORT_FROM_DWH: as tabelas e exibições criadas nesse conjunto de dados estarão disponíveis para leitura/gravação pelo Klaviyo. -
KLAVIYO_TMP: dados temporários ou de preparação usados durante as operações de sincronização.
2) Crie a conta e a chave Klaviyo Service
Crie uma conta de serviço do Google (por exemplo, você pode criar uma conta de serviço do Google). KLAVIYO_DATA_TRANSFER_USER) que o Klaviyo usará exclusivamente para essas integrações. Baixe uma chave JSON para essa conta e armazene-a com segurança.
- Acesse IAM & Administrador → Contas de serviço no Console do GCP.
- Crie uma nova conta de serviço (ou selecione uma conta existente dedicada ao Klaviyo).
- Na guia Keys (Chaves), crie uma nova chave do tipo JSON. Mantenha esse arquivo de chave em segurança - você precisará dele ao configurar a conexão no Klaviyo.
3) Atribua as permissões necessárias
Conceda à conta de serviço as seguintes funções, com escopo para os dois conjuntos de dados que você criou:
| Conjunto de dados | Funções mínimas exigidas | Descrição |
|---|---|---|
KLAVIYO_TMP |
Editor de dados do BigQuery + Usuário de trabalho do BigQuery
|
Permite que o Klaviyo crie e gerencie tabelas temporárias, trabalhos, etc. |
KLAVIYO_IMPORT_FROM_DWH |
Visualizador de dados do BigQuery + usuário do trabalho do BigQuery
|
Permite que o Klaviyo leia suas tabelas. |
-- Exemplo de comandos na CLI do GCP (substitua os espaços reservados): gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \ --member="serviceAccount:KLAVIYO_DATA_TRANSFER_USER@YOUR_PROJECT_ID.iam.gserviceaccount.com" \ --role="roles/bigquery.dataEditor" \ --condition=None \ --dataset="KLAVIYO_TMP" gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \ --member="serviceAccount:KLAVIYO_DATA_TRANSFER_USER@YOUR_PROJECT_ID.iam.gserviceaccount.com" \ --role="roles/bigquery.dataViewer" \ --condition=None \ --dataset="KLAVIYO_IMPORT_FROM_DWH"
4) Verifique sua configuração (opcional)
4.1 Confirmar a existência dos conjuntos de dados
SELECT schema_name
FROM `YOUR_PROJECT_ID.INFORMATION_SCHEMA.SCHEMATA`
WHERE schema_name IN ('KLAVIYO_IMPORT_FROM_DWH','KLAVIYO_TMP');
4.2 Confirmar o acesso à conta de serviço
Use a chave da conta de serviço para se autenticar na CLI ou API do BigQuery e executar uma consulta simples:
bq --project_id=YOUR_PROJECT_ID \ --dataset_id=KLAVIYO_IMPORT_FROM_DWH \ query --use_legacy_sql=false \ 'SELECT COUNT(*) FROM `YOUR_PROJECT_ID.KLAVIYO_IMPORT_FROM_DWH.some_table` LIMIT 1'
4.3 Verifique as permissões em cada conjunto de dados
SELECT * FROM `YOUR_PROJECT_ID.KLAVIYO_IMPORT_FROM_DWH.INFORMATION_SCHEMA.OBJECT_PRIVILEGES` WHERE grantee = 'KLAVIYO_DATA_TRANSFER_USER@YOUR_PROJECT_ID.iam.gserviceaccount.com';
4.4 Opcional: Validar operações de criação/leitura
-- Teste a criação no KLAVIYO_TMP CREATE TABLE `YOUR_PROJECT_ID.KLAVIYO_TMP.test_permissions` (id INT64); DROP TABLE `YOUR_PROJECT_ID.KLAVIYO_TMP.test_permissions`; -- Teste a seleção em KLAVIYO_IMPORT_FROM_DWH SELECT * FROM `YOUR_PROJECT_ID.KLAVIYO_IMPORT_FROM_DWH.some_existing_table` LIMIT 1;
Dica: Execute essas verificações usando a mesma conta de serviço e chave que você fornecerá à Klaviyo. Mantenha uma cópia dos resultados para auditoria.
5) Conecte o Klaviyo ao BigQuery
Depois que seu ambiente BigQuery estiver configurado, conclua a conexão no Klaviyo.
- No Klaviyo, navegue até Advanced → Syncing (Avançado → Sincronização ) na barra lateral esquerda.
- Clique em Criar sincronização.
- Selecione Importar ou exportar dados para seu data warehouse.
- Escolha o BigQuery como seu data warehouse.
- Clique em Conectar ao BigQuery.
Quando solicitado, forneça os seguintes detalhes de configuração de conexão:
| Campo | Descrição | Onde você pode encontrá-lo |
|---|---|---|
| ID do projeto | Seu ID de projeto do Google Cloud. | Encontrado no console do GCP na parte superior da página do projeto. |
| Conjunto de dados | O conjunto de dados (esquema) que contém as tabelas do Klaviyo (por exemplo, KLAVIYO_IMPORT_FROM_DWH). |
Use o conjunto de dados que você criou na Etapa 1. Selecione esse conjunto de dados quando você estiver configurando a conexão. |
| Chave da conta de serviço (JSON) | O arquivo de chave JSON que você baixou para a conta de serviço. | Carregue ou cole o conteúdo do arquivo de chave JSON que você criou na Etapa 2. |
Depois que você se conectar: A Klaviyo validará a conexão, testará o acesso aos seus conjuntos de dados e, em seguida, permitirá que você configure as sincronizações - tanto para importar dados para a Klaviyo quanto para exportar dados da Klaviyo para o BigQuery.
Próxima etapa: Depois de se conectar com sucesso, crie sua primeira sincronização de importação ou exportação no Klaviyo e comece a mover dados de ou para o BigQuery.