MotherDuck

Visão geral

A integração OneSignal + MotherDuck permite a sincronização automática de eventos personalizados dos seus bancos de dados MotherDuck para o OneSignal para acionar campanhas de mensagens automatizadas e Journeys com base no comportamento do usuário. MotherDuck é um serviço DuckDB-na-nuvem que fornece capacidades OLAP (Processamento Analítico Online) rápidas com a simplicidade do SQL.

Requisitos

Acesso a Event Streams para eventos de mensagem de saída (Limitações de plano e excedentes se aplicam)
Acesso a Custom Events para sincronização de eventos de entrada (Limitações de plano e excedentes se aplicam)
Plano de Conta Atualizado (não disponível em apps gratuitos)

Conta MotherDuck com acesso ao banco de dados
Token de serviço para autenticação
Banco de dados contendo dados de eventos
Tabelas ou visualizações com informações de eventos estruturadas

Configuração

Criar token de serviço MotherDuck

Gere um token de acesso para o OneSignal se conectar ao MotherDuck:

Faça login na Interface Web do MotherDuck em app.motherduck.com
Clique em seu perfil no canto superior esquerdo
Navegue até Settings > General > Access Tokens
Clique em Create Token
Defina a data de expiração (ou deixe ilimitado)
Copie o token de serviço gerado

Preparar seus dados de eventos

Certifique-se de que seu banco de dados MotherDuck contenha tabelas de eventos adequadamente estruturadas:

-- Example event table structure
CREATE TABLE user_events (
    event_name VARCHAR,
    user_id VARCHAR,
    event_timestamp TIMESTAMP,
    event_properties JSON,
    session_id VARCHAR
);

Conectar ao OneSignal

No OneSignal, vá para Data > Integrations e clique em Add Integration.Selecione MotherDuck e forneça:

Service Token: Token do Passo 1
Database Name: Nome do seu banco de dados MotherDuck
Connection String: md:your_database_name

Configurar sincronização de dados

Selecione as tabelas ou escreva consultas SQL personalizadas para definir quais dados de eventos sincronizar:

SELECT
    event_name,
    user_id,
    event_timestamp,
    event_properties
FROM user_events
WHERE event_timestamp >= CURRENT_DATE - INTERVAL 7 DAYS

Mapeamento de dados de evento

Mapeie seu para o formato de eventos personalizados do OneSignal:

Campo OneSignal	Descrição	Obrigatório
`name`	`event_name`	Identificador de evento	Sim
`external_id`	`user_id`	Identificador de usuário	Sim
`timestamp`	`event_timestamp`	Quando o evento ocorreu	Não
`properties`	`event_data`	Não

A Sync Key é a coluna que você designa como o identificador exclusivo de cada linha durante a sincronização. O OneSignal a utiliza para detectar se uma linha já foi processada, de modo que ressincronizar seus dados não crie eventos duplicados. Escolha uma coluna com um valor de texto exclusivo por linha. Não use um booleano nem um valor que se repita entre as linhas.

Exemplo de Consulta de Evento

-- Optimized event query for OneSignal sync
SELECT
    event_name,
    user_id,
    event_timestamp,
    {
        'source': 'motherduck',
        'session_id': session_id,
        'device_type': device_type,
        'value': event_value
    }::JSON as event_properties
FROM analytics.user_events
WHERE event_timestamp >= CURRENT_TIMESTAMP - INTERVAL 1 DAY
ORDER BY event_timestamp DESC

Modos de Processamento

Modo de Tabela

Sincronize tabelas inteiras diretamente do seu banco de dados MotherDuck. O OneSignal mapeará automaticamente as colunas para campos de evento.

Modo de Consulta SQL

Escreva consultas SQL DuckDB personalizadas para transformar e filtrar seus dados de eventos:

-- Advanced event aggregation
SELECT
    'daily_summary' as event_name,
    user_id,
    DATE_TRUNC('day', event_timestamp) as event_timestamp,
    {
        'total_events': COUNT(*),
        'unique_sessions': COUNT(DISTINCT session_id),
        'last_activity': MAX(event_timestamp)
    }::JSON as event_properties
FROM user_events
WHERE event_timestamp >= CURRENT_DATE - INTERVAL 7 DAYS
GROUP BY user_id, DATE_TRUNC('day', event_timestamp)

Limitações

A complexidade da consulta afeta o desempenho de sincronização
Conjuntos de resultados grandes podem impactar a velocidade de sincronização
A análise JSON requer tipagem adequada de coluna

FAQ

Como otimizo o desempenho de consulta no MotherDuck?

Use as vantagens de armazenamento colunar do DuckDB selecionando apenas as colunas necessárias e aplicando filtros no início de suas consultas.

Posso sincronizar de múltiplos bancos de dados MotherDuck?

Sim, você pode criar integrações separadas para cada banco de dados MotherDuck em sua conta.

Primeiros passos & configurações

Canais de mensagem

Jornadas

Público & eventos personalizados

Análises & Integrações

Privacidade & Segurança

MotherDuck

Visão geral

Requisitos

MotherDuck

Configuração

Mapeamento de dados de evento

Exemplo de Consulta de Evento

Modos de Processamento

Modo de Tabela

Modo de Consulta SQL

Limitações

FAQ

Como otimizo o desempenho de consulta no MotherDuck?

Posso sincronizar de múltiplos bancos de dados MotherDuck?

​Visão geral

​Requisitos

​MotherDuck

​Configuração

​Mapeamento de dados de evento

​Exemplo de Consulta de Evento

​Modos de Processamento

​Modo de Tabela

​Modo de Consulta SQL

​Limitações

​FAQ

​Como otimizo o desempenho de consulta no MotherDuck?

​Posso sincronizar de múltiplos bancos de dados MotherDuck?

Visão geral

Requisitos

MotherDuck

Configuração

Mapeamento de dados de evento

Exemplo de Consulta de Evento

Modos de Processamento

Modo de Tabela

Modo de Consulta SQL

Limitações

FAQ

Como otimizo o desempenho de consulta no MotherDuck?

Posso sincronizar de múltiplos bancos de dados MotherDuck?