Saltar al contenido principal

​
Descripción general

La integración de OneSignal + Google AlloyDB habilita la sincronización automática de eventos personalizados desde su base de datos AlloyDB directamente a la API de eventos personalizados de OneSignal. Esto le permite activar Journeys automatizados y campañas de mensajería personalizadas basadas en el comportamiento real del usuario almacenado en su base de datos. Puede sincronizar eventos como compras, vistas de productos, cambios de suscripción o cualquier acción de usuario personalizada para activar automáticamente secuencias de incorporación, campañas de reactivación, mensajes transaccionales y promociones dirigidas a través de notificaciones push, correo electrónico, mensajes en la aplicación y SMS.

​
Requisitos

​
Google AlloyDB

  • Cuenta de Google Cloud Platform con instancia de AlloyDB
  • Auth Proxy configurado según lo requerido por Google Cloud
  • Permisos de base de datos para crear usuarios y otorgar acceso
  • Acceso de red a su instancia de AlloyDB

​
Configuración

​
Configurar permisos de AlloyDB

OneSignal necesita leer datos de eventos desde su base de datos AlloyDB. Recomendamos crear una cuenta de usuario ONESIGNAL dedicada con acceso de solo lectura a sus tablas de eventos.
1

Crear usuario de base de datos OneSignal

Cree una cuenta de usuario dedicada con una contraseña fuerte y única:
-- Crear el usuario de OneSignal
CREATE USER ONESIGNAL WITH PASSWORD '<contraseña fuerte y única>';
2

Otorgar acceso al esquema

Otorgue al usuario de OneSignal acceso para leer desde su esquema de datos de eventos:
-- Permitir que el usuario de OneSignal vea su esquema de eventos
GRANT USAGE ON SCHEMA "<your_event_schema>" TO ONESIGNAL;

-- Permitir que el usuario de OneSignal lea todas las tablas existentes en este esquema
GRANT SELECT ON ALL TABLES IN SCHEMA "<your_event_schema>" TO ONESIGNAL;

-- Permitir que el usuario de OneSignal lea cualquier tabla nueva agregada a este esquema
ALTER DEFAULT PRIVILEGES IN SCHEMA "<your_event_schema>" GRANT SELECT ON TABLES TO ONESIGNAL;
Reemplace <your_event_schema> con el esquema real que contiene sus tablas de eventos.
3

Otorgar permisos de función (si es necesario)

Si usa procedimientos almacenados o funciones para datos de eventos:
-- Permitir que el usuario de OneSignal ejecute funciones en este esquema
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA "<your_event_schema>" TO ONESIGNAL;

-- Permitir que el usuario de OneSignal ejecute cualquier función nueva agregada a este esquema
ALTER DEFAULT PRIVILEGES IN SCHEMA "<your_event_schema>" GRANT EXECUTE ON FUNCTIONS TO ONESIGNAL;

​
Configurar Auth Proxy

1

Configurar Auth Proxy

AlloyDB requiere un Auth Proxy para conexiones de terceros. Siga la documentación de Auth Proxy de Google para configurar esto.
El Auth Proxy es requerido: OneSignal no puede conectarse directamente a AlloyDB sin él.
2

Anotar detalles de conexión

Guarde la siguiente información de conexión:
  • Host: Endpoint de Auth Proxy
  • Port: Puerto de Auth Proxy (típicamente 5432)
  • Database: Nombre de su base de datos AlloyDB
  • Username: ONESIGNAL (creado anteriormente)
  • Password: La contraseña que estableció

​
Configurar conexión de OneSignal a AlloyDB

1

Navegar a integraciones

In OneSignal, go to Data > Integrations and click Add Integration.
2

Seleccionar Google AlloyDB

Elija Google AlloyDB de la lista de integraciones disponibles.
3

Ingresar detalles de conexión

Proporcione la información de conexión de AlloyDB:
  • Host: Su endpoint de Auth Proxy
  • Port: Puerto de Auth Proxy
  • Database: Nombre de base de datos AlloyDB
  • Username: ONESIGNAL
  • Password: Contraseña de usuario
  • SSL: Habilitado (recomendado)
4

Probar la conexión

Haga clic en Test Connection para verificar que OneSignal puede acceder a su instancia de AlloyDB.

​
Mapeo de datos de eventos

Una vez conectado, deberá mapear las columnas de su tabla AlloyDB a los campos de eventos personalizados de OneSignal:
1

Seleccionar tablas de eventos

Elija las tablas que contienen sus datos de eventos que desea sincronizar con OneSignal.
2

Mapear campos de eventos requeridos

Mapee los campos requeridos para eventos personalizados:
  • Event Name: Columna que contiene el tipo de evento (por ejemplo, “purchase”, “signup”)
  • User Identifier: Columna de External User ID, Email o Phone Number
  • Event Timestamp: Cuándo ocurrió el evento (opcional)
3

Mapear datos de carga útil del evento

Mapee columnas adicionales a propiedades de carga útil del evento:
  • Propiedades de evento personalizadas (product_id, price, category, etc.)
  • Datos contextuales (source, campaign, etc.)
  • Métricas de comportamiento (value, quantity, etc.)
4

Configurar ajustes de sincronización

Establezca su frecuencia de procesamiento de eventos y preferencias de entrega.

​
Event data mapping

Map your to OneSignal’s custom events format:
OneSignal FieldDescriptionRequired
nameevent_nameEvent identifierYes
external_iduser_idUser identifierYes
timestampevent_timestampWhen event occurredNo
propertiesevent_dataNo

​
Configuración de red avanzada

​
Listas de permitidos de direcciones IP

Si su instancia de AlloyDB usa listas de permitidos de IP, agregue las direcciones IP de OneSignal. Puede encontrar los rangos de IP actuales en su panel de OneSignal en Data > Integrations > Network Access.

​
Túnel SSH

OneSignal admite la conexión a AlloyDB a través de túneles SSH para seguridad adicional:
1

Crear usuario SSH

Cree una cuenta de usuario dedicada para OneSignal en su servidor host SSH.
2

Configurar túnel SSH

En la configuración de conexión de OneSignal AlloyDB, habilite Use SSH Tunnel y proporcione:
  • SSH Host
  • SSH Port
  • SSH Username
3

Agregar clave SSH

OneSignal generará un par de claves SSH. Copie la clave pública al archivo authorized_keys de su host SSH para el usuario de OneSignal.

​
Limitaciones

  • Rendimiento: Evite conectarse a bases de datos de producción durante el uso pico
  • Permisos: OneSignal requiere acceso de solo lectura a tablas de eventos
  • Auth Proxy: Requerido para todas las conexiones de AlloyDB

​
Preguntas frecuentes

​
¿Qué sucede si cambia la estructura de mi tabla de eventos?

OneSignal detectará cambios de esquema y puede requerir un nuevo mapeo de campos. Actualice sus mapeos de campos en la configuración de integración.

​
¿Con qué frecuencia sincroniza OneSignal los eventos?

OneSignal verifica nuevos eventos según su frecuencia de sincronización configurada, con un intervalo mínimo de 15 minutos.

​
¿Necesita ayuda?

Contacte a nuestro equipo de soporte en [email protected] o use el chat en la aplicación para obtener ayuda con la configuración de su integración de AlloyDB.