Saltar al contenido principal

Resumen

La integración de OneSignal + MotherDuck permite la sincronización automática de eventos personalizados desde tus bases de datos de MotherDuck a OneSignal para activar campañas de mensajería automatizadas y Journeys basados en comportamiento de usuario. MotherDuck es un servicio DuckDB-en-la-nube que proporciona capacidades OLAP (Procesamiento Analítico en Línea) rápidas con la simplicidad de SQL.

Requisitos

MotherDuck

  • Cuenta de MotherDuck con acceso a base de datos
  • Token de servicio para autenticación
  • Base de datos que contenga datos de eventos
  • Tablas o vistas con información de eventos estructurada

Configuración

1

Crear token de servicio de MotherDuck

Genera un token de acceso para que OneSignal se conecte a MotherDuck:
  1. Inicia sesión en la interfaz web de MotherDuck en app.motherduck.com
  2. Haz clic en tu perfil en la esquina superior izquierda
  3. Navega a Settings > General > Access Tokens
  4. Haz clic en Create Token
  5. Establece la fecha de vencimiento (o déjala ilimitada)
  6. Copia el token de servicio generado
2

Preparar tus datos de eventos

Asegúrate de que tu base de datos de MotherDuck contenga tablas de eventos estructuradas correctamente:
3

Conectar a OneSignal

In OneSignal, go to Data > Integrations and click Add Integration.Selecciona MotherDuck y proporciona:
  • Service Token: Token del Paso 1
  • Database Name: El nombre de tu base de datos de MotherDuck
  • Connection String: md:nombre_de_tu_base_de_datos
4

Configurar sincronización de datos

Selecciona las tablas o escribe consultas SQL personalizadas para definir qué datos de eventos sincronizar:

Event data mapping

Map your to OneSignal’s custom events format:

Ejemplo de consulta de eventos


Modos de procesamiento

Modo de tabla

Sincroniza tablas completas directamente desde tu base de datos de MotherDuck. OneSignal mapeará automáticamente las columnas a campos de eventos.

Modo de consulta SQL

Escribe consultas SQL personalizadas de DuckDB para transformar y filtrar tus datos de eventos:

Limitaciones

  • La complejidad de consultas afecta el rendimiento de sincronización
  • Conjuntos de resultados grandes pueden impactar la velocidad de sincronización
  • El análisis de JSON requiere tipado de columnas apropiado

Preguntas frecuentes

¿Cómo optimizo el rendimiento de consultas en MotherDuck?

Aprovecha las ventajas del almacenamiento columnar de DuckDB seleccionando solo las columnas necesarias y aplicando filtros temprano en tus consultas.

¿Puedo sincronizar desde múltiples bases de datos de MotherDuck?

Sí, puedes crear integraciones separadas para cada base de datos de MotherDuck en tu cuenta.