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:

-- 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.

1. No Klaviyo, navegue até Advanced → Syncing (Avançado → Sincronização ) na barra lateral esquerda.
2. Clique em Criar sincronização.
3. Selecione Importar ou exportar dados para seu data warehouse.
4. Escolha o BigQuery como seu data warehouse.
5. Clique em Conectar ao BigQuery.

Quando solicitado, forneça os seguintes detalhes de configuração de conexão:

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.