Pular para o conteúdo principal

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)

MotherDuck

  • 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

1

Criar token de serviço MotherDuck

Gere um token de acesso para o OneSignal se conectar ao MotherDuck:
  1. Faça login na Interface Web do MotherDuck em app.motherduck.com
  2. Clique em seu perfil no canto superior esquerdo
  3. Navegue até Settings > General > Access Tokens
  4. Clique em Create Token
  5. Defina a data de expiração (ou deixe ilimitado)
  6. Copie o token de serviço gerado
2

Preparar seus dados de eventos

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

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
4

Configurar sincronização de dados

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

Mapeamento de dados de evento

Mapeie seu para o formato de eventos personalizados do OneSignal:

Exemplo de Consulta de Evento


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:

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.