Extensiones de segmentos SQL

Puedes generar una extensión de segmento utilizando consultas SQL de Snowflake sobre datos de Snowflake. SQL puede ayudarte a desbloquear nuevos casos de uso de segmentos, ya que ofrece la flexibilidad necesaria para describir las relaciones entre los datos de formas que no son posibles con otras características de segmentación.

Al igual que las extensiones de segmento estándar, puedes consultar eventos de hasta los dos últimos años (730 días) en tu extensión de segmento SQL. A diferencia de las extensiones de segmento estándar, las extensiones de segmento SQL consumen créditos.

Requisitos previos

Debido a que es posible acceder a datos PII a través de esta característica, debes tener permisos PII para ejecutar consultas SQL de segmento.

Creación de una extensión de Segment

Paso 1: Elige un editor

Hay dos tipos de editores SQL entre los que elegir cuando creas tu extensión de Segment SQL: el editor SQL y el editor SQL incremental.

• Actualización completa: Cada vez que tu segmento se actualice, Braze consultará todos los datos disponibles para actualizar tu segmento, lo que consumirá más créditos que las actualizaciones incrementales. Las extensiones de actualización completa pueden regenerar automáticamente la membresía diariamente, pero no pueden actualizarse utilizando la actualización incremental.
• Actualización incremental: La actualización incremental es una forma más eficiente en costes de configurar tu consulta, aunque la configuración implica algunos pasos adicionales. Si puedes completar estos pasos adicionales al construir tu segmento, vale la pena elegir esta opción porque tu consulta se ejecutará utilizando menos créditos.
• Generador de SQL con IA: El generador de SQL con IA te permite escribir un enunciado en lenguaje natural y lo convierte en una consulta SQL para tu segmento. Es una forma rápida de empezar sin necesidad de escribir el SQL tú mismo.

Consejo

Puedes hacer una actualización completa manual en todos los segmentos SQL creados en cualquiera de los editores SQL.

• actualización completa
• actualización incremental
• generador de sql con ia

Para crear una extensión de Segment SQL de actualización completa:

1. Ve a Audiencia > Extensiones de Segment.
2. Selecciona Crear nueva extensión y luego selecciona Actualización completa.
   
   
   
   
3. Añade un nombre para tu extensión de Segment e introduce tu SQL. Consulta el Paso 2 para requisitos y recursos.
   
   
   
   
4. Guarda tu extensión de Segment.

Para crear una extensión de Segment SQL de actualización incremental:

1. Ve a Audiencia > Extensiones de Segment.
2. Selecciona Crear nueva extensión y selecciona Actualización incremental.
   
   
   
   
3. Añade un nombre para tu extensión de Segment e introduce tu SQL. Consulta la sección Escribir SQL para requisitos y recursos.
   
   
   
   
4. Si lo deseas, selecciona Regenerar extensión diariamente.
   
   
   
   Cuando se selecciona, Braze actualizará la membresía del segmento cada día automáticamente. Esto significa que cada día a medianoche en la zona horaria de tu empresa (con un posible retraso de una hora), Braze comprobará si hay nuevos usuarios en tu segmento y los añadirá automáticamente. Si una extensión de Segment no se ha utilizado en 7 días, Braze pausará automáticamente la regeneración diaria. Una extensión de Segment no utilizada es aquella que no forma parte de una Campaign o Canvas (la Campaign o el Canvas no necesitan estar activos para que la extensión se considere “utilizada”).
   
   
5. Guarda tu extensión de Segment.

Nota

El generador de SQL con IA está disponible actualmente como característica en fase beta. Contacta con tu CSM si estás interesado en participar en esta prueba beta.

El generador de SQL con IA aprovecha GPT, impulsado por OpenAI, para recomendar SQL para tu segmento SQL.

Para usar el generador de SQL con IA, haz lo siguiente:

1. Selecciona Iniciar generador de SQL con IA después de crear un segmento SQL usando actualización completa o incremental.
2. Escribe tu enunciado y selecciona Generar para traducir tu enunciado a SQL.
3. Revisa el SQL generado para asegurarte de que es correcto, y luego guarda tu segmento.

Enunciados de ejemplo

• Usuarios que recibieron un correo electrónico en el último mes
• Usuarios que realizaron menos de cinco compras en el último año

Consejos

• Familiarízate con las tablas de datos de Snowflake disponibles. Solicitar datos que no existen en estas tablas puede hacer que ChatGPT invente una tabla ficticia.
• Familiarízate con las reglas de escritura SQL para esta característica. No seguir estas reglas provocará un error. Por ejemplo, tu código SQL debe seleccionar la columna user_id. Empezar tu enunciado con “usuarios que” puede ayudar.
• Puedes enviar hasta 20 enunciados por minuto con el generador de SQL con IA.

¿Cómo se utilizan y envían mis datos a OpenAI?

Para generar resultados de IA a través de las características de BrazeAI que aprovechan OpenAI (“Resultados”), Braze enviará cierta información (“Entrada”) a OpenAI. La Entrada consiste en tus indicaciones y puede incluir el contenido mostrado en el dashboard, así como otros datos del espacio de trabajo relevantes para tus consultas, según corresponda. Según los compromisos de la plataforma API de OpenAI, los datos enviados a la API de OpenAI a través de Braze no se utilizan para entrenar ni mejorar los modelos de OpenAI. OpenAI puede conservar los datos durante 30 días con fines de supervisión de abusos, tras lo cual se eliminan. Entre tú y Braze, los Resultados son tu propiedad intelectual. Braze no hará valer ninguna reclamación de propiedad de derechos de autor sobre dichos Resultados. Braze no ofrece garantías de ningún tipo con respecto a ningún contenido generado por IA, incluidos los Resultados.

Nota

Las consultas SQL que tarden más de 20 minutos en ejecutarse se agotarán por tiempo.

Cuando la extensión termine de procesarse, puedes crear un segmento utilizando tu extensión de Segment y dirigir este nuevo segmento a tus Campaigns y Canvas.

Paso 2: Escribe tu SQL

Tu consulta SQL debe estar escrita utilizando sintaxis de Snowflake. Consulta la referencia de tablas para una lista completa de tablas y columnas disponibles para consultar.

Importante

Ten en cuenta que las tablas disponibles para consultar solo contienen datos de eventos. Si deseas consultar atributos de usuario, debes combinar tu segmento SQL con filtros de atributos personalizados del segmentador clásico.

• editor sql
• editor sql incremental

Tu SQL además debe cumplir con las siguientes reglas:

• Escribe una sola sentencia SQL. No incluyas puntos y coma.
• Tu SQL debe seleccionar solo una columna: la columna user_id. Esto significa que tu SQL debe contener:

1
SELECT DISTINCT user_id FROM "INSERT TABLE NAME"

• No es posible consultar usuarios con cero eventos, lo que significa que cualquier consulta de usuarios que hayan realizado un evento menos de X veces necesitaría seguir esta solución alternativa:
  1. Escribe una consulta para seleccionar usuarios que hayan realizado el evento MÁS de X veces.
  2. Cuando hagas referencia a tu extensión de Segment en tu segmento, selecciona doesn't include para invertir el resultado.

Reglas adicionales

Adicionalmente, tu consulta SQL estándar debe cumplir con las siguientes reglas:

• No puedes usar sentencias DECLARE.

Todas las consultas de actualización incremental constan de dos partes: una consulta y detalles del esquema.

1. En el editor, escribe una consulta que seleccione user_ids de la tabla deseada.
2. Añade detalles del esquema seleccionando un Operador, Número de veces y Periodo de tiempo en los campos de la parte superior del editor. La consulta comprobará si la suma de la columna de agregación cumple una determinada condición especificada por los marcadores de posición {{operator}} y {{number of times}}. Esto funciona de manera similar al flujo de trabajo para crear extensiones de Segment clásicas.
   
   
   • Operador: Indica si el evento ha ocurrido más de, menos de o igual a un número de ocurrencias.
     
     
     
   • Número de veces: Cuántas veces deseas evaluar el evento en relación con el operador.
     
     
     
   • Periodo de tiempo: Número de días del 1 al 730 en los que deseas comprobar las instancias del evento. Este periodo de tiempo se refiere a días pasados relativos al día actual. El siguiente ejemplo muestra una consulta de usuarios que realizaron el evento más de 5 veces en los últimos 365 días.
     

En el siguiente ejemplo, el segmento resultante contendría usuarios que realizaron el evento favorited más de 3 veces durante los últimos 30 días, después de una fecha especificada.

Consejo

Los segmentos de actualización incremental tienen en cuenta los eventos tardíos, que son eventos que ocurrieron hace más de 2 días (por ejemplo, eventos del SDK que no se enviaron en el momento en que fueron capturados).

Reglas adicionales

Adicionalmente, tu consulta de actualización incremental debe cumplir con las siguientes reglas:

• Escribe una sola sentencia SQL. No incluyas puntos y coma.
• Tu segmento SQL incremental solo podrá hacer referencia a un único evento. Tus desplegables de fecha y recuento hacen referencia al evento elegido.
• Tu SQL debe contener las siguientes columnas: user_id, $start_date y una función de agregación (como COUNT). Cualquier SQL guardado sin estos tres campos producirá un error.
• No puedes usar sentencias DECLARE.

Nota

Si estás creando un segmento SQL que utiliza la tabla CATALOGS_ITEMS_SHARED, debes especificar un ID de catálogo. Por ejemplo:

1
2
3
SELECT * FROM CATALOGS_ITEMS_SHARED
WHERE CATALOG_ID = 'XYZ'
LIMIT 10

Paso 3: Previsualiza la consulta

Antes de guardar, puedes ejecutar una vista previa de tu consulta. Las vistas previas de consultas están automáticamente limitadas a 100 filas y tendrán un tiempo de espera de 60 segundos. El requisito de la columna user_id no se aplica al ejecutar una vista previa.

Para las extensiones de Segment SQL incrementales, la vista previa no incluirá los criterios adicionales de tus campos de operador, número de veces y periodo de tiempo.

Paso 4: Determina si necesitas invertir SQL

A continuación, determina si necesitas invertir SQL. Aunque no es posible consultar directamente usuarios con cero eventos, puedes usar Invertir SQL para dirigirte a estos usuarios.

Nota

De forma predeterminada, Invertir SQL no está activado. Sin embargo, si utilizas el generador de SQL con IA para generar una sentencia SQL que necesita ser negada, ChatGPT podría devolver un resultado que active automáticamente esta característica.

Por ejemplo, para dirigirte a usuarios que tengan menos de tres compras, primero escribe una consulta para seleccionar usuarios que tengan tres o más compras. Luego, selecciona Invertir SQL para dirigirte a usuarios con menos de tres compras (incluyendo aquellos con cero compras).

Importante

A menos que tu objetivo específico sea dirigirte a usuarios con cero eventos, no necesitarás invertir SQL. Si Invertir SQL está seleccionado, confirma que la característica es necesaria y que el segmento coincide con tu audiencia deseada. Por ejemplo, si una consulta se dirige a usuarios con al menos un evento, solo se dirigirá a usuarios con cero eventos cuando se invierta.

Actualización de la membresía de segmento

Para actualizar la membresía de segmento de cualquier extensión de segmento creada mediante SQL, abre la extensión de segmento y selecciona Actualizar.

Consejo

Si creaste un segmento en el que esperas que los usuarios entren y salgan con regularidad, actualiza manualmente la extensión de segmento que utiliza antes de segmentar ese segmento en una Campaign o Canvas.

Gestión de tus extensiones de segmento

En la página Extensiones de segmento, los segmentos generados mediante SQL se indican con junto a su nombre.

Selecciona una extensión de segmento SQL para ver dónde se está utilizando la extensión, archivarla o actualizar manualmente la membresía del segmento.

Designar la configuración de actualización

Si no necesitas que tu extensión se actualice de forma periódica, puedes guardarla sin utilizar la configuración de actualización, y Braze generará por defecto tu extensión de segmento basándose en la pertenencia de usuarios en ese momento. Utiliza el comportamiento predeterminado si solo quieres generar la audiencia una vez y luego dirigirte a ella con una campaña puntual.

Tu segmento siempre empezará a procesarse después del guardado inicial. Cada vez que se actualice tu segmento, Braze volverá a ejecutar el segmento y actualizará la pertenencia al mismo para reflejar los usuarios de tu segmento en el momento de la actualización. Esto puede ayudar a que tus campañas recurrentes lleguen a los usuarios más relevantes.

Configurar una actualización periódica

Para establecer una programación recurrente designando la configuración de actualización, selecciona Habilitar actualización. La opción de designar la configuración de actualización está disponible para todos los tipos de extensiones de segmento, incluidos los segmentos SQL, las extensiones de segmento CDI y las extensiones de segmento basadas en formularios simples.

Importante

Para optimizar tu gestión de datos, la configuración de actualización se desactiva automáticamente para las extensiones de segmento no utilizadas. Las extensiones de segmento se consideran no utilizadas cuando:

• No se utilizan en ninguna Campaign, Canvas o segmento activo o inactivo (borrador, detenido, archivado).
• No se han modificado en más de 7 días.

Braze notificará al contacto de la empresa y al creador de la extensión si se desactiva esta configuración. La opción de regenerar las extensiones diariamente puede volver a activarse en cualquier momento.

Seleccionar tu configuración de actualización

En el panel Configuración del intervalo de actualización, puedes seleccionar la frecuencia con la que se actualizará esta extensión de segmento: cada hora, cada día, cada semana o cada mes. También se te pedirá que selecciones la hora concreta (que corresponde a la zona horaria de tu empresa) a la que se produciría la actualización, por ejemplo:

• Si tienes una campaña de correo electrónico que se envía todos los lunes a las 11 de la mañana, hora de la empresa, y quieres asegurarte de que tu segmento se actualiza justo antes de enviarlo, debes elegir un programa de actualización semanal a las 10 de la mañana de los lunes.
• Si quieres que tu segmento se actualice todos los días, selecciona la frecuencia de actualización diaria y, a continuación, elige la hora del día en que se actualizará.

Nota

La posibilidad de establecer un programa de actualización por horas no está disponible para las extensiones de segmento basadas en formularios (pero puedes establecer programas diarios, semanales o mensuales).

Consumo de créditos y costes adicionales

Como las actualizaciones vuelven a ejecutar la consulta de tu segmento, cada actualización de segmentos SQL consumirá créditos de segmentos SQL, y cada actualización de extensiones de segmento CDI supondrá un coste dentro de tu almacén de datos de terceros.

Nota

La actualización de los segmentos podría requerir hasta 60 minutos debido a los tiempos de procesamiento de los datos. Los segmentos que estén actualmente en proceso de actualización tendrán un estado de “Procesando” dentro de tu lista de extensiones de segmento. Esto tiene un par de implicaciones:

• Para terminar de procesar tu segmento antes de una hora determinada, elige una hora de actualización que sea 60 minutos antes.
• Solo puede producirse una actualización a la vez para una extensión de segmento específica. Si hay un conflicto en el que se inicia una nueva actualización cuando una actualización existente ya ha comenzado a procesarse, Braze cancelará la nueva solicitud de actualización y continuará el procesamiento en curso.

Criterios para desactivar automáticamente las extensiones obsoletas

Las actualizaciones programadas se desactivan automáticamente cuando una extensión de segmento queda obsoleta. Una extensión de segmento se considera obsoleta si cumple los siguientes criterios:

• No se utiliza en ninguna Campaign o Canvas activos
• No se utiliza en ningún segmento que esté en una Campaign o Canvas activos
• No se utiliza en ningún segmento que tenga activado el seguimiento de análisis
• No se ha modificado en más de siete días
• No se ha añadido a una Campaign o Canvas (incluidos borradores), ni a un segmento en más de siete días

Si la actualización programada está desactivada para una extensión de segmento, dicha extensión tendrá una notificación que así lo indique.

Cuando estés listo para utilizar una extensión de segmento obsoleta, revisa la configuración de actualización, selecciona el programa de actualización que se ajuste a tu caso de uso y, a continuación, guarda las modificaciones.

Créditos de Snowflake

Cada espacio de trabajo de Braze dispone de 5 créditos de Snowflake al mes. Si necesitas más créditos, ponte en contacto con tu director de cuentas. Los créditos se utilizan cada vez que actualizas, o guardas y actualizas, la membresía de un segmento SQL. Los créditos no se utilizan cuando ejecutas vistas previas dentro de un segmento SQL o guardas o actualizas una extensión de segmento clásica.

Nota

Los créditos de Snowflake no se comparten entre características. Por ejemplo, los créditos de las extensiones de segmento SQL y del Generador de consultas son independientes entre sí.

El uso de créditos está correlacionado con el tiempo de ejecución de tu consulta SQL. Cuanto mayor sea el tiempo de ejecución, más créditos costará una consulta. El tiempo de ejecución puede variar en función de la complejidad y el tamaño de tus consultas a lo largo del tiempo. Cuanto más complejas y frecuentes sean las consultas que ejecutes, mayor será la asignación de recursos y más rápido será el tiempo de ejecución.

Para ahorrar créditos, previsualiza tu consulta para asegurarte de que es correcta antes de guardar la extensión de segmento SQL.

Tus créditos se restablecerán a 5 el primer día de cada mes a las 12 am UTC. Puedes monitorizar el uso de tus créditos a lo largo del mes en el panel de uso de créditos. Desde la página Extensiones de segmento, haz clic en Ver uso de créditos SQL.

Cuando tus créditos lleguen a cero, ocurrirá lo siguiente:

• Todas las extensiones de segmento SQL configuradas para actualizarse automáticamente dejarán de actualizarse, lo que afectará a la membresía de estos segmentos y a cualquier Campaign o Canvas que se dirija a estos segmentos.
• Solo podrás guardar nuevas extensiones de segmento SQL como borradores durante el resto del mes.

Todos los usuarios de la empresa que hayan creado un segmento SQL y los administradores de la empresa recibirán una notificación por correo electrónico cuando se haya utilizado el 50 %, el 80 % y el 100 % de los créditos. Después de que tus créditos se restablezcan al inicio del mes siguiente, podrás crear más segmentos SQL y se reanudarán las actualizaciones automáticas.

Si deseas adquirir más créditos de segmento SQL o extensiones de segmento adicionales, ponte en contacto con tu director de cuentas.