Antes de unificar hay que traer el dato. En Fuentes (
/cdp/setup/sources) conectás de dónde viene la información y qué objetos traés de cada origen.1
Conectar
origen y credenciales
2
Objeto de origen
qué traés
3
Preparar
limpiar y validar
4
Mapear
al modelo
5
Ingerir
según frecuencia
Antes de empezar
Necesitás las credenciales o el acceso al origen (una base, un archivo por URL, el SDK ya instalado) y saber qué clave identifica cada registro (la clave primaria del objeto de origen). Conviene tener listo tu modelo de datos para mapear contra él.
Agregar una fuente
El alta es un asistente paso a paso («Agregar fuente»):
- 1Elegí el tipo de fuente y completá la conexión.
- 2Elegí qué datos traer: cada conjunto que traés es un objeto de origen.
- 3Mapeá los campos del objeto de origen a tu modelo de datos.
- 4Definí la frecuencia de ingesta (cada cuánto se trae el dato).
- 5Guardá: la fuente queda en el inventario y empieza a ingerir según la frecuencia.
Tipos de origen
| Origen | Para qué |
|---|---|
| SDK web / móvil | Eventos en vivo de tu sitio y apps (ver SDK web). |
| Personalization | Tu instancia de Personalization como fuente first-party del CDP. |
| Bases de datos | Conectá una base y traé tablas (/cdp/setup/databases, asistente «Conectar una base nueva»). |
| Archivo CSV | Importá registros desde un archivo por URL. |
Objetos de origen
Un objeto de origen es cada conjunto de datos que traés de una fuente (por ejemplo «clientes» o «pedidos»). Define sus campos, su clave primaria y su frecuencia. Después se mapea al modelo y el linaje del pipeline te muestra el recorrido completo del dato.
Preparar el dato en el asistente
El dato casi nunca llega listo. Dentro del mismo asistente de alta (los pasos del formulario multi-paso) podés limpiarlo y normalizarlo antes de que alimente el modelo:
| Paso | Qué resuelve |
|---|---|
| Armonización | Normaliza valores de un objeto de origen (formatos de fecha, mayúsculas, espacios). |
| Catálogos de equivalencias | Mapea variantes a un valor canónico («CABA», «C.A.B.A.», «Capital» → «Buenos Aires»). |
| Campos fórmula | Deriva un campo nuevo a nivel del objeto de origen (concatenar, condicionar) antes del mapeo. |
| Reglas de calidad | Valida el dato (requerido, formato, rango) y marca lo que no cumple. |
| Readiness | Un resumen de si el objeto de origen está listo para mapear y activar. |
Monitorear la ingesta
Cada objeto de origen lleva un historial de corridas (cuánto entró, cuánto se rechazó, cuánto falló) y el detalle de errores y logs por registro, para diagnosticar una carga que no trajo lo esperado.
Escenarios a tener en cuenta
| Situación | Por qué | Qué hacer |
|---|---|---|
| Entraron menos registros de los esperados | Parte se rechazó por no cumplir una regla de calidad (requerido, formato, rango). | Mirá los rechazados de la corrida y ajustá la regla o el dato de origen. |
| La corrida falló | Un error de procesamiento (credencial vencida, origen caído, campo que no convierte). | Revisá errores y logs de la corrida; corregí y volvé a correr. |
| El objeto no está listo para mapear | Readiness marca campos sin tipo, sin clave primaria o sin mapear. | Completá lo que Readiness señala antes de activar el objeto. |
Nota
Estos pasos de preparación no son pantallas sueltas del menú: viven dentro del asistente de «Agregar fuente» / «Conectar una base nueva», en el orden en que los necesitás, para no quedar a mitad de un alta fuera de contexto.