Segmentos externos

Los segmentos externos te permiten dirigirte a personas que ya están almacenadas en tu propia base de datos, como tu CRM o almacén de datos, en lugar de exportarlas a un CSV y volver a cargarlo cada vez que la lista cambia. Le proporcionas a Pushwoosh una consulta SQL que devuelve los ID de usuario correctos, y Pushwoosh sigue reejecutando esa consulta para mantener el segmento actualizado. Una vez configurado, puedes usar a estos usuarios de la misma manera que cualquier otro segmento.

Se necesita ayuda de un desarrollador

Necesitarás ayuda de tu desarrollador o administrador de base de datos para configurar la conexión. Comparte esta guía con ellos para empezar.

Configurar una conexión afecta a tu base de datos de producción. Antes de empezar, pide a tu desarrollador o administrador de base de datos que:

• Prepare un usuario de solo lectura (o, para BigQuery, una cuenta de servicio de solo lectura)
• Confirme la consulta que planea usar
• Si la base de datos está detrás de un firewall, pregunte al soporte de Pushwoosh qué direcciones IP permitir

Crear un segmento externo

Nombrar el segmento y elegir la base de datos

1. Ve a Audiencia → Segmentos externos.
2. Haz clic en Crear segmento externo.

3. Introduce un Nombre para el segmento (hasta 100 caracteres).
4. Elige el Tipo de base de datos: PostgreSQL, MySQL, Google BigQuery o Microsoft SQL Server / Fabric.

Rellenar los campos de conexión

PostgreSQL y MySQL

Para PostgreSQL y MySQL, rellena:

• Host y Puerto: la dirección de tu servidor de base de datos. Pushwoosh requiere un host accesible públicamente y rechaza direcciones privadas, internas o de bucle local cuando compruebas la conexión o guardas el segmento.
• Base de datos: el nombre de la base de datos.
• Usuario y Contraseña: credenciales para una cuenta de solo lectura.
• Modo SSL (solo PostgreSQL, ya que las conexiones MySQL no usan TLS) establece cómo se aplica SSL/TLS, el protocolo que cifra la conexión, a tu conexión de base de datos. Pregunta a tu administrador de base de datos qué modo usar:
  • Desactivar: sin cifrado.
  • Requerir: cifra la conexión, pero no comprueba la identidad del servidor de base de datos.
  • Verificar CA: cifra la conexión y comprueba que el certificado del servidor fue emitido por una autoridad de certificación (CA) de confianza.
  • Verificación completa: igual que Verificar CA, y también comprueba que el certificado coincide con el nombre de host de tu base de datos. La opción más segura.
• Para cualquier modo que no sea Desactivar, proporciona el Certificado CA en Fuente del certificado (Subir archivos o Pegar PEM), además de un Certificado de cliente y una Clave de cliente si tu base de datos los requiere.

BigQuery

Para Google BigQuery, rellena:

• ID del proyecto: el proyecto de GCP que contiene tu conjunto de datos.
• JSON de la cuenta de servicio: la clave para una cuenta de servicio con acceso de lectura a BigQuery.
• Ubicación: la región del conjunto de datos (por ejemplo, EU, US o europe-west3). Déjalo vacío para resolver la ubicación automáticamente desde el conjunto de datos.

SQL Server / Fabric

Para Microsoft SQL Server / Fabric, rellena:

• Host y Puerto: la dirección de tu servidor de base de datos, o tu punto de conexión de análisis SQL de Fabric. Pushwoosh requiere un host accesible públicamente y rechaza direcciones privadas, internas o de bucle local cuando compruebas la conexión o guardas el segmento.
• Base de datos: el nombre de la base de datos.
• Usuario y Contraseña: credenciales para una cuenta de solo lectura.
• ID de inquilino de Microsoft Entra: opcional. Déjalo vacío para un inicio de sesión de SQL Server. Para Microsoft Fabric, cuyo punto de conexión de análisis SQL no tiene inicios de sesión SQL, configúralo para iniciar sesión como una entidad de servicio en su lugar. Introduce su ID de aplicación (cliente) como Usuario y su secreto de cliente como Contraseña.

Introducir la consulta

1. Introduce la Consulta. Debe devolver una única columna llamada user_id, con una fila por cada usuario que quieras en el segmento. Por ejemplo:

SELECT user_id FROM loyalty_members WHERE tier = 'gold'

Nota

Los valores de user_id deben coincidir con los ID de usuario de Pushwoosh que has configurado para tus usuarios (el mismo identificador utilizado por Crear segmentos por ID de usuario). Una consulta que devuelva ID que Pushwoosh no reconoce no coincidirá con ningún dispositivo.

2. Haz clic en Comprobar conexión para confirmar que Pushwoosh puede acceder a la base de datos (se agota el tiempo de espera después de 30 segundos).
3. Haz clic en Comprobar consulta para confirmar que la consulta se ejecuta y devuelve la columna correcta (también se agota el tiempo de espera después de 30 segundos).

Verificar y crear

Cuando ambas comprobaciones tengan éxito, haz clic en Crear. Pushwoosh guarda el segmento y lo añade a la lista de Segmentos externos inmediatamente.

Cómo se mantiene actualizado el segmento

Pushwoosh no ejecuta tu consulta en un horario fijo. En su lugar, actualiza el segmento basándose en cuán recientemente se usó por última vez:

• Si los datos del segmento tienen menos de una hora, Pushwoosh utiliza los datos actuales tal cual.
• Si tienen más de una hora, Pushwoosh sigue utilizando los datos actuales mientras se actualiza en segundo plano.
• Si tienen más de tres horas, Pushwoosh espera a una nueva actualización antes de usar el segmento.

En la práctica, esto significa que un segmento que usas regularmente (por ejemplo, en un journey recurrente) se mantiene actualizado, mientras que un segmento que rara vez tocas puede tardar un momento en actualizarse la primera vez que lo uses de nuevo.

Si una actualización falla (por ejemplo, la base de datos se vuelve inaccesible o la consulta comienza a dar errores), Pushwoosh registra el error, pero el estado del segmento en la lista de Segmentos externos no cambia por sí solo. Después de que hayas solucionado el problema por tu parte, abre el segmento y haz clic en Comprobar conexión para confirmar la solución. El error se borra automáticamente la próxima vez que los datos del segmento se actualicen con éxito.

Usar un segmento externo

Una vez que lo has creado, el segmento externo aparece automáticamente en Audiencia → Segmentos con el mismo nombre, listo para ser usado como cualquier otro segmento, por ejemplo, como audiencia de una campaña o un journey.

Para combinarlo con otras condiciones, añádelo como un filtro:

1. Ve a Audiencia → Segmentos → Crear segmento.
2. Haz clic en Añadir filtro por → Segmento.
3. Selecciona tu segmento externo por su nombre.

El mismo filtro de Segmento está disponible en filtros compuestos y cuando eliges la audiencia en la Entrada basada en audiencia. Para más información sobre cómo combinar segmentos, consulta Crear segmentos a partir de segmentos existentes.

Comprobar cuántas personas hay en el segmento

La lista de Segmentos externos no muestra un recuento de miembros. Abre el contenedor del segmento en Audiencia → Segmentos (consulta Usar un segmento externo) y calcula su tamaño allí.

Gestionar segmentos externos

En la lista de Segmentos externos, cada fila muestra el nombre del segmento, el Código (el identificador utilizado para hacer referencia al segmento en las llamadas a la API), el tipo de base de datos, el host y el estado (válido o inválido).

• Haz clic en Editar para cambiar la conexión o la consulta. El tipo de base de datos no se puede cambiar después de la creación. En su lugar, crea un nuevo segmento.
• Haz clic en Eliminar para quitar un segmento. Pushwoosh bloquea la eliminación mientras el segmento esté siendo utilizado por una campaña, journey, filtro o formulario emergente. Elimina esas referencias primero y luego elimina el segmento. Esta acción no se puede deshacer.