Visão geral
A integração OneSignal + Google AlloyDB permite a sincronização automática de eventos personalizados do seu banco de dados AlloyDB diretamente para a API de Eventos Personalizados do OneSignal. Isso permite acionar Jornadas automatizadas e campanhas de mensagens personalizadas com base no comportamento real do usuário armazenado em seu banco de dados. Você pode sincronizar eventos como compras, visualizações de produtos, mudanças de assinatura ou quaisquer ações personalizadas do usuário para acionar automaticamente sequências de onboarding, campanhas de reengajamento, mensagens transacionais e promoções direcionadas através de notificações push, email, mensagens no aplicativo e SMS.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)
Google AlloyDB
- Conta Google Cloud Platform com instância AlloyDB
- Auth Proxy configurado conforme exigido pelo Google Cloud
- Permissões de banco de dados para criar usuários e conceder acesso
- Acesso à rede à sua instância AlloyDB
Configuração
Configurar permissões do AlloyDB
O OneSignal precisa ler dados de eventos do seu banco de dados AlloyDB. Recomendamos criar uma conta de usuárioONESIGNAL dedicada com acesso somente leitura às suas tabelas de eventos.
1
Criar usuário de banco de dados OneSignal
Crie uma conta de usuário dedicada com uma senha forte e única:
2
Conceder acesso ao schema
Conceda ao usuário OneSignal acesso para ler do seu schema de dados de eventos:
Substitua
<seu_schema_de_eventos> pelo schema real que contém suas tabelas de eventos.3
Conceder permissões de função (se necessário)
Se você usa procedimentos armazenados ou funções para dados de eventos:
Configurar Auth Proxy
1
Configurar Auth Proxy
AlloyDB requer um Auth Proxy para conexões de terceiros. Siga a documentação do Auth Proxy do Google para configurar isso.
2
Anotar detalhes de conexão
Salve as seguintes informações de conexão:
- Host: Endpoint do Auth Proxy
- Porta: Porta do Auth Proxy (geralmente 5432)
- Banco de Dados: Nome do seu banco de dados AlloyDB
- Nome de Usuário:
ONESIGNAL(criado acima) - Senha: A senha que você definiu
Configurar conexão AlloyDB do OneSignal
1
Navegar para integrações
No OneSignal, vá para Data > Integrations e clique em Add Integration.
2
Selecionar Google AlloyDB
Escolha Google AlloyDB da lista de integrações disponíveis.
3
Inserir detalhes de conexão
Forneça as informações de conexão do AlloyDB:
- Host: Seu endpoint do Auth Proxy
- Porta: Porta do Auth Proxy
- Banco de Dados: Nome do banco de dados AlloyDB
- Nome de Usuário:
ONESIGNAL - Senha: Senha do usuário
- SSL: Habilitado (recomendado)
4
Testar a conexão
Clique em Testar Conexão para verificar se o OneSignal pode acessar sua instância AlloyDB.
Mapeamento de Dados de Eventos
Depois de conectado, você precisará mapear as colunas da tabela AlloyDB para os campos de eventos personalizados do OneSignal:1
Selecionar tabelas de eventos
Escolha as tabelas contendo seus dados de eventos que você deseja sincronizar com o OneSignal.
2
Mapear campos de eventos obrigatórios
Mapeie os campos obrigatórios para eventos personalizados:
- Nome do Evento: Coluna contendo o tipo de evento (ex: “purchase”, “signup”)
- Identificador do Usuário: ID de Usuário Externo, Email ou coluna de Número de Telefone
- Timestamp do Evento: Quando o evento ocorreu (opcional)
3
Mapear dados de payload do evento
Mapeie colunas adicionais para propriedades de payload do evento:
- Propriedades de eventos personalizados (product_id, price, category, etc.)
- Dados contextuais (source, campaign, etc.)
- Métricas comportamentais (value, quantity, etc.)
4
Configurar definições de sincronização
Defina a frequência de processamento de eventos e preferências de entrega.
Mapeamento de dados de evento
Mapeie seu para o formato de eventos personalizados do OneSignal:Configuração Avançada de Rede
Listas de Permissão de Endereços IP
Se sua instância AlloyDB usa listas de permissão de IP, adicione os endereços IP do OneSignal. Você pode encontrar os intervalos de IP atuais em seu painel OneSignal em Dados > Integrações > Acesso à Rede.Tunelamento SSH
O OneSignal suporta conexão ao AlloyDB através de túneis SSH para segurança adicional:1
Criar usuário SSH
Crie uma conta de usuário dedicada para o OneSignal em seu servidor host SSH.
2
Configurar túnel SSH
Nas configurações de conexão AlloyDB do OneSignal, habilite Usar Túnel SSH e forneça:
- Host SSH
- Porta SSH
- Nome de Usuário SSH
3
Adicionar chave SSH
O OneSignal gerará um par de chaves SSH. Copie a chave pública para o arquivo
authorized_keys do seu host SSH para o usuário OneSignal.Limitações
- Desempenho: Evite conectar a bancos de dados de produção durante picos de uso
- Permissões: OneSignal requer acesso somente leitura às tabelas de eventos
- Auth Proxy: Obrigatório para todas as conexões AlloyDB
FAQ
O que acontece se a estrutura da minha tabela de eventos mudar?
O OneSignal detectará mudanças de schema e pode exigir remapeamento de campos. Atualize seus mapeamentos de campo nas configurações de integração.Com que frequência o OneSignal sincroniza eventos?
O OneSignal verifica novos eventos com base na frequência de sincronização configurada, com um intervalo mínimo de 15 minutos.Precisa de ajuda?
Entre em contato com nossa equipe de suporte emsupport@onesignal.com ou use o chat no aplicativo para assistência com a configuração da sua integração AlloyDB.