Appearance
🌐 Integración BigQuery → Acoustic Connect
Guía de implementación del CSV exportado desde BigQuery
Este documento explica cómo cargar en Acoustic Connect el CSV generado desde BigQuery (vista acoustic_sample_snapshot o acoustic_profiles_v).
✅ Requisitos previos
| Sistema | Qué necesitas |
|---|---|
| BigQuery | CSV exportado desde la vista acoustic_sample_snapshot o acoustic_profiles_v |
| Acoustic Connect | Acceso a módulo: Data → Sources (antes llamado Contact Sources) |
1. Exportar desde BigQuery a CSV (ya implementado)
Este paso ya se ejecutó desde BigQuery.
sql
EXPORT DATA OPTIONS(
uri='gs://minuto-verde-data/acoustic/sample/acoustic_sample_*.csv',
format='CSV',
overwrite=true,
header=true
) AS
SELECT * FROM `minuto-verde-cortex-poc.mkt_curated.acoustic_sample_snapshot`;
2. Cargar archivo en Acoustic Connect
🟦 Paso 1: Acceder a Sources
Ingresar al tenant de Acoustic Connect
En el menú:
Data → Sources
Haz clic:
Create Source
Selecciona:
Upload file (CSV upload)
3. Subir el archivo CSV
📤 Sube el archivo exportado desde BigQuery (acoustic_sample_*.csv).
Acoustic detectará las columnas automáticamente.
4. Mapeo de Campos
Mapear los campos según la estructura creada en BigQuery:
| CSV (BigQuery) | Acoustic Connect | Tipo |
|---|---|---|
Email | Email (Primary Key / Unique ID) | Obligatorio |
FirstName | First Name | Personalización |
LastName | Last Name | Personalización |
CustomerID | Customer ID (Attribute) | Segmentación |
Consent | Consent Status | Privacidad |
ConsentDate (si existe) | Consent Date | Auditoría |
📌 Importante
Marcar Email como:
✅ Unique Identifier / Primary Key
5. Configuración del Import Job
En la pantalla final de configuración, seleccionar:
| Configuración | Selección recomendada |
|---|---|
| Overwrite existing contacts? | ✅ YES (upsert) |
| Delete contacts not present in file? | ❌ NO |
| Treat blank values as null? | ✅ NO |
Esto asegura que solo se actualicen registros existentes o se creen nuevos.
6. Validación del import
Una vez finalizado:
Ir a:
Data → Queries (Audiences)
Crear una Query o Audience usando condiciones como:
text
Consent = TRUE
CustomerID IS NOT NULL
7. Uso en campaña o journey
Desde el menú:
Channels → Email → Send Mailing
ó
Orchestration → Programs (Journey Builder)
Campos disponibles para personalización:
%%FirstName%%%%CustomerID%%
🔁 (Opcional) Automatización sin CSV
Si quieres evitar la carga manual, Acoustic permite importar desde GCS vía SFTP / API.
Esto permite un flujo completamente automático:
SAP → BigQuery → Archivo en GCS → Acoustic Connect
📌 Resumen del flujo completo
SAP → Aercorsoft (CDC) → BigQuery (CDC_SAP)
→ Vistas curadas (mkt_curated)
→ Snapshot de 1000 registros para prueba
→ CSV en Cloud Storage
→ Acoustic Connect (Upload / Upsert)
🚀 Resultado
Con esta carga mínima:
✔ Se valida la integración con Acoustic
✔ Se evita costo innecesario en BigQuery
✔ Se puede probar personalización, audiencias y journeys