Skip to content
On this page

🌐 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

SistemaQué necesitas
BigQueryCSV exportado desde la vista acoustic_sample_snapshot o acoustic_profiles_v
Acoustic ConnectAcceso 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

  1. Ingresar al tenant de Acoustic Connect

  2. En el menú:

    Data → Sources

  3. Haz clic:

    Create Source

  4. 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 ConnectTipo
EmailEmail (Primary Key / Unique ID)Obligatorio
FirstNameFirst NamePersonalización
LastNameLast NamePersonalización
CustomerIDCustomer ID (Attribute)Segmentación
ConsentConsent StatusPrivacidad
ConsentDate (si existe)Consent DateAuditoría

📌 Importante
Marcar Email como:

Unique Identifier / Primary Key


5. Configuración del Import Job

En la pantalla final de configuración, seleccionar:

ConfiguraciónSelecció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:

  1. Ir a:

    Data → Queries (Audiences)

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