Pular para o conteúdo principal

​
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ário ONESIGNAL 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:
-- Criar o usuário OneSignal
CREATE USER ONESIGNAL WITH PASSWORD '<senha forte e única>';
2

Conceder acesso ao schema

Conceda ao usuário OneSignal acesso para ler do seu schema de dados de eventos:
-- Permitir que o usuário OneSignal veja seu schema de eventos
GRANT USAGE ON SCHEMA "<seu_schema_de_eventos>" TO ONESIGNAL;

-- Permitir que o usuário OneSignal leia todas as tabelas existentes neste schema
GRANT SELECT ON ALL TABLES IN SCHEMA "<seu_schema_de_eventos>" TO ONESIGNAL;

-- Permitir que o usuário OneSignal leia quaisquer novas tabelas adicionadas a este schema
ALTER DEFAULT PRIVILEGES IN SCHEMA "<seu_schema_de_eventos>" GRANT SELECT ON TABLES TO ONESIGNAL;
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:
-- Permitir que o usuário OneSignal execute funções neste schema
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA "<seu_schema_de_eventos>" TO ONESIGNAL;

-- Permitir que o usuário OneSignal execute quaisquer novas funções adicionadas a este schema
ALTER DEFAULT PRIVILEGES IN SCHEMA "<seu_schema_de_eventos>" GRANT EXECUTE ON FUNCTIONS TO ONESIGNAL;

​
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.
O Auth Proxy é obrigatório - o OneSignal não pode se conectar diretamente ao AlloyDB sem ele.
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:
Campo OneSignalDescriçãoObrigatório
nameevent_nameIdentificador de eventoSim
external_iduser_idIdentificador de usuárioSim
timestampevent_timestampQuando o evento ocorreuNão
propertiesevent_dataNão

​
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 em [email protected] ou use o chat no aplicativo para assistência com a configuração da sua integração AlloyDB.