MySQL

Visão geral

A integração OneSignal + MySQL permite a sincronização de eventos personalizados do seu banco de dados MySQL para o OneSignal para acionar campanhas de mensagens automatizadas e Journeys com base no comportamento do usuário. MySQL é um sistema de gerenciamento de banco de dados relacional de código aberto amplamente usado, ideal para armazenar dados de eventos estruturados que podem alimentar campanhas de mensagens personalizadas.

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)

MySQL Community 5.7 ou posterior, ou versões recentes do MariaDB
Tabelas de eventos contendo dados comportamentais estruturados
Conectividade de rede do OneSignal para sua instância MySQL
TLS v1.2 ou superior suportado

Configuração

Criar usuário dedicado para OneSignal

Crie uma conta de usuário dedicada com permissões somente leitura:

-- Create census user with ability to sign in with a password
CREATE USER CENSUS IDENTIFIED BY '<strong, unique password>';

-- Grant read-only access to your event schema
GRANT SELECT ON <your_schema>.* TO CENSUS;

Se você tiver vários esquemas que contêm dados de eventos, repita a instrução GRANT SELECT para cada esquema.

Configurar conexão OneSignal

No OneSignal, vá para Data > Integrations e clique em Add Integration.Selecione MySQL e forneça seus detalhes de conexão:

Host: Nome do host do seu servidor MySQL
Port: Porta MySQL (tipicamente 3306)
Database: Nome do banco de dados contendo suas tabelas de eventos
Username: CENSUS
Password: A senha que você criou acima

Testar conexão

Clique em Test Connection para verificar se o OneSignal pode se conectar com sucesso ao seu banco de dados MySQL e acessar suas tabelas de eventos.

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 Esquema de Tabela de Evento

CREATE TABLE user_events (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    event_name VARCHAR(100) NOT NULL,
    user_id VARCHAR(255) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    event_data JSON,
    session_id VARCHAR(255),
    device_type VARCHAR(50)
);

Modo de Tabela

Selecione sua tabela de eventos diretamente e o OneSignal sincronizará todas as linhas como eventos individuais.

Modo de Consulta SQL

Escreva consultas SQL personalizadas para transformar seus dados de eventos:

-- Example: Recent high-value events
SELECT
    event_name,
    user_id,
    created_at as timestamp,
    event_data as payload
FROM user_events
WHERE created_at >= DATE_SUB(NOW(), INTERVAL 7 DAY)
    AND JSON_EXTRACT(event_data, '$.value') > 100
ORDER BY created_at DESC;

Configuração Avançada de Rede

O OneSignal pode se conectar com sucesso a instâncias MySQL usando controles de rede avançados, incluindo restrições de região, listas de permissão de endereços IP ou Túnel SSH. O OneSignal suporta MySQL com versões TLS 1.2 e superior para conexões seguras.

FAQ

Quais versões do MySQL são suportadas?

O OneSignal suporta MySQL Community 5.7 ou posterior, assim como versões recentes do MariaDB.

Posso me conectar ao MySQL em uma rede privada?

Sim, o OneSignal suporta túnel SSH e listas de permissão de IP para conectar a instâncias MySQL em redes privadas ou atrás de firewalls.

Primeiros passos & configurações

Canais de mensagem

Jornadas

Público & eventos personalizados

Análises & Integrações

Privacidade & Segurança

MySQL

Visão geral

Requisitos

MySQL

Configuração

Mapeamento de dados de evento

Exemplo de Esquema de Tabela de Evento

Modo de Tabela

Modo de Consulta SQL

Configuração Avançada de Rede

FAQ

Quais versões do MySQL são suportadas?

Posso me conectar ao MySQL em uma rede privada?

​Visão geral

​Requisitos

​MySQL

​Configuração

​Mapeamento de dados de evento

​Exemplo de Esquema de Tabela de Evento

​Modo de Tabela

​Modo de Consulta SQL

​Configuração Avançada de Rede

​FAQ

​Quais versões do MySQL são suportadas?

​Posso me conectar ao MySQL em uma rede privada?

Visão geral

Requisitos

MySQL

Configuração

Mapeamento de dados de evento

Exemplo de Esquema de Tabela de Evento

Modo de Tabela

Modo de Consulta SQL

Configuração Avançada de Rede

FAQ

Quais versões do MySQL são suportadas?

Posso me conectar ao MySQL em uma rede privada?