Extensiones de segmentos SQL
Puede generar una Extensión de Segmento utilizando consultas SQL Snowflake de datos Snowflake. SQL puede ayudarle a desbloquear nuevos casos de uso de los segmentos, ya que ofrece la flexibilidad necesaria para describir las relaciones entre los datos de formas que no son posibles con otras funciones de segmentación.
Al igual que las extensiones de segmento estándar, puede consultar eventos de hasta los dos últimos años (730 días) en su extensión de segmento SQL. A diferencia de las extensiones de segmento estándar, las extensiones de segmento SQL consumen créditos.
Requisitos previos
Dado que esta característica permite acceder a datos PII, debes disponer de permisos PII para ejecutar consultas de segmentos SQL.
Crear una extensión de segmento
Paso 1: Elige un editor
Hay dos tipos de editores SQL entre los que puedes elegir para crear tu Extensión de Segmento SQL: el Editor SQL y el Editor SQL Incremental.
- Actualización completa: Cada vez que se actualice su segmento, Braze consultará todos los datos disponibles para actualizarlo, lo que consumirá más créditos que las actualizaciones incrementales. Las extensiones de actualización completa pueden regenerar automáticamente la afiliación a diario, pero no pueden actualizarse mediante la actualización incremental.
- Actualización incremental: La actualización incremental es una forma más rentable de configurar tu consulta, aunque la configuración implica algunos pasos más. Si puedes completar estos pasos adicionales al crear tu segmento, vale la pena elegir esta opción, ya que tu consulta se ejecutará utilizando menos créditos.
- Generador SQL con IA: El generador SQL de IA te permite escribir una indicación en lenguaje sencillo y la convierte en una consulta SQL para tu segmento. Es una forma rápida de empezar sin necesidad de escribir el código SQL tú mismo.
Puede realizar una actualización manual completa de todos los segmentos SQL creados en cualquiera de los dos editores SQL.
Para crear una extensión de segmento SQL de actualización completa:
- Vaya a Audiencia > Extensiones de segmento.
- Selecciona Crear nueva extensión y, a continuación, selecciona Actualización completa.

- Añada un nombre para su Extensión de Segmento e introduzca su SQL. Consulta el paso 2 para conocer los requisitos y recursos necesarios.

- Guarda tu extensión de segmento.
Para crear una actualización incremental Extensión de segmento SQL:
- Vaya a Audiencia > Extensiones de segmento.
Si está utilizando la navegación antigua, puede encontrar esta página en Compromiso > Segmentos > Extensiones de segmento.
2. Selecciona Crear nueva extensión y selecciona Actualización incremental.

3. Añada un nombre para su Extensión de Segmento e introduzca su SQL. Consulte la sección Escribir SQL para conocer los requisitos y recursos.

4. Si lo desea, seleccione Regenerar extensión diariamente.

Si se selecciona esta opción, Braze actualizará automáticamente cada día el número de miembros del segmento. Esto significa que cada día a medianoche en la zona horaria de su empresa (con un retraso potencial de una hora), Braze comprobará si hay nuevos usuarios en su segmento y los añadirá automáticamente a su segmento. Si una Extensión de Segmento no se ha utilizado en 7 días, Braze pausará automáticamente la regeneración diaria. Una Extensión de Segmento no utilizada es aquella que no forma parte de una campaña o Lienzo (no es necesario que la campaña o el Lienzo estén activos para que la extensión se considere “utilizada”).
5. Guarda tu extensión de segmento.
El generador de SQL con IA está disponible actualmente como característica beta. Ponte en contacto con tu administrador del éxito del cliente si estás interesado en participar en esta prueba beta.
El generador de SQL con IA aprovecha la GPT, impulsada por OpenAI, para recomendar SQL para tu segmento SQL.

Para utilizar el generador de SQL con IA, haz lo siguiente:
- Selecciona Iniciar generador de SQL de IA después de crear un segmento SQL utilizando la actualización completa o incremental.
- Escribe tu comando y selecciona Generar para traducir tu comando a SQL.
- Revisa el SQL generado para asegurarte de que parece correcto y, a continuación, guarda tu segmento.
Ejemplos de indicaciones
- 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ícese con las tablas de datos Snowflake disponibles. Pedir datos que no existen en estas tablas puede hacer que ChatGPT invente una tabla falsa.
- Familiarízate con las reglas de escritura SQL para esta característica. El incumplimiento de estas normas provocará un error. Por ejemplo, tu código SQL debe seleccionar la columna
user_id. Empezar tu pregunta con “usuarios que” puede ayudar. - Puedes enviar hasta 20 consultas por minuto con el generador de SQL con IA.
#### ¿Cómo se utilizan y envían mis datos a OpenAI? {#ai-policy}
Para generar resultados de IA a través de las características de IA de Braze que Braze identifique como que aprovechan OpenAI (“Resultados”), Braze enviará tus indicaciones, como contenido de mensajes, directrices de marca, datos de campañas anteriores o cualquier otra entrada, según corresponda (“Entrada”) a OpenAI. Las entradas enviadas a OpenAI desde Braze no te identifican a ti ni a tus usuarios, a menos que elijas incluir información identificadora única en tus entradas. 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 o mejorar los modelos de OpenAI y OpenAI los eliminará de sus sistemas transcurridos 30 días. Entre tú y Braze, la Salida es tu propiedad intelectual. Braze no hará valer ninguna reclamación de propiedad de derechos de autor sobre dicha Salida. Braze no ofrece garantías de ningún tipo con respecto a ningún contenido generado por IA en general, incluida la Salida.
Las consultas SQL que tarden más de 20 minutos en ejecutarse agotarán el tiempo de espera.
Cuando la extensión termine de procesarse, podrás crear un segmento utilizando tu extensión de segmento y dirigirte a este nuevo segmento con tus campañas y lienzos.
Paso 2: Escribe tu SQL
Su consulta SQL debe escribirse utilizando la sintaxis Snowflake. Consulte la referencia de la tabla para obtener una lista completa de las tablas y columnas disponibles para su consulta.
Nota que las tablas disponibles para consulta solo contienen datos de eventos. Si desea consultar los atributos de los usuarios, deberá combinar su segmento SQL con filtros de atributos personalizados del segmentador clásico.
Además, su SQL debe cumplir las siguientes normas:
- Escriba una única sentencia SQL. No incluya ningún punto y coma.
- Su SQL debe seleccionar sólo una columna: la columna
user_id. Esto significa que su 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 tendría que seguir esta solución:
- Escriba una consulta para seleccionar los usuarios que tienen el evento MÁS de X veces.
- Cuando haga referencia a su Extensión de segmento en su segmento, seleccione
doesn't includepara invertir el resultado.
Normas adicionales
Además, tu consulta SQL estándar debe cumplir las siguientes reglas:
- No puedes utilizar
DECLAREdeclaraciones.
Todas las consultas de actualización incremental constan de dos partes: una consulta y los detalles del esquema.
- En el editor, escriba una consulta que seleccione
user_ids de la tabla que desee. - Añada detalles del esquema seleccionando un Operador, Número de veces y Periodo de tiempo en los campos situados encima del editor. La consulta comprobará si la suma de la columna agregada cumple una determinada condición especificada por los marcadores de posición
{{operator}}y{{number of times}}. Esto funciona de forma similar al flujo de trabajo para crear Extensiones de Segmento clásicas.
- Operador: Indica si el suceso ha ocurrido más, menos o igual que un número de veces.

- Número de veces: Cuántas veces quieres evaluar el suceso en relación con el operador.

- Período de tiempo: Número de días de 1 a 730 en los que desea comprobar las instancias del evento. Este periodo de tiempo se refiere a días pasados en relación con el día actual. El siguiente ejemplo muestra la consulta de usuarios que realizaron el evento más de 5 veces en los últimos 365 días.

- Operador: Indica si el suceso ha ocurrido más, menos o igual que un número de veces.
En el siguiente ejemplo, el segmento resultante contendría los usuarios que realizaron el evento favorited más de 3 veces durante los últimos 30 días, después de una fecha especificada.


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 SDK que no se enviaron en el momento en que se capturaron).
Normas adicionales
Además, tu consulta de actualización incremental debe cumplir las siguientes reglas:
- Escriba una única sentencia SQL. No incluya ningún punto y coma.
- Su segmento SQL incremental podría referirse a un único evento. Los desplegables de fecha y recuento hacen referencia al evento elegido.
- Su SQL debe tener las siguientes columnas:
user_id,$start_date, y una función de agregación (comoCOUNT). Cualquier SQL guardado sin estos tres campos dará lugar a un error. - No puedes utilizar
DECLAREdeclaraciones.
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: Vista previa de la consulta
Antes de guardar, puedes ejecutar una vista previa de tu consulta. Las previsualizaciones de consultas se limitan automáticamente a 100 filas y expiran a los 60 segundos. El requisito de la columna user_id no se aplica cuando se ejecuta una vista previa.
En el caso de las extensiones incrementales de segmentos SQL, la vista previa no incluirá los criterios adicionales de los campos 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 realizar consultas directas sobre usuarios sin eventos, puedes utilizar Invert SQL para seleccionar a estos usuarios.
De forma predeterminada, la opción Invertir SQL no se alterna. Sin embargo, si utilizas el generador SQL de IA para generar una instrucción SQL que debe negarse, ChatGPT podría devolver un resultado que alterné automáticamente esta característica.
Por ejemplo, para dirigirte a usuarios que hayan realizado menos de tres compras, primero escribe una consulta para seleccionar a los usuarios que hayan realizado tres o más compras. A continuación, selecciona Invertir SQL para dirigirte a los usuarios con menos de tres compras (incluidos aquellos con cero compras).
A menos que tu objetivo específico sea dirigirte a usuarios sin eventos, no será necesario invertir el SQL. Si se selecciona Invertir SQL, confirma que la característica es necesaria y que el segmento coincide con tu audiencia. Por ejemplo, si una consulta se dirige a usuarios con al menos un evento, solo se dirigirá a usuarios sin eventos cuando se invierta.

Actualizar la membresía de segmentos
Para actualizar la pertenencia a un segmento de cualquier extensión de segmento creada mediante SQL, abra la extensión de segmento y seleccione Actualizar.
Si ha creado un segmento en el que espera que los usuarios entren y salgan con regularidad, actualice manualmente la Extensión de segmento que utiliza antes de dirigirse a ese segmento en una campaña 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.
Seleccione una extensión de segmento SQL para ver dónde se está utilizando la extensión, archivar la extensión o actualizar manualmente la pertenencia al segmento.

Designación de 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 tu número de usuarios en ese momento. Utiliza el comportamiento predeterminado si sólo 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.
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 lo están:
- No se utiliza en ninguna campaña, lienzo o segmento activo o inactivo (borrador, detenido, archivado).
- No tuvo modificaciones en los últimos 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 esté en 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á.
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.
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.
- Sólo 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 caduca. Una extensión de segmento es antigua si cumple los siguientes criterios:
- No se ha utilizado en ninguna campaña o Canvas activos
- No se utiliza en ningún segmento que esté en una campaña 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 campaña o Canvas (incluidos borradores), o 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 Braze dispone de 5 créditos Snowflake al mes. Si necesita más créditos, póngase en contacto con su gestor de cuenta. Los créditos se utilizan cada vez que se actualiza, o se guarda y actualiza, la suscripción a un segmento SQL. Los créditos no se utilizan cuando se ejecutan vistas previas dentro de un Segmento SQL o se guarda o actualiza una Extensión de Segmento clásica.
Los créditos copo de nieve no se comparten entre funciones. Por ejemplo, los créditos de las extensiones de segmentos SQL y del Generador de consultas son independientes entre sí.
El uso de créditos está correlacionado con el tiempo de ejecución de su 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 las consultas a lo largo del tiempo. Cuanto más complejas y frecuentes sean las consultas, mayor será la asignación de recursos y más rápido el tiempo de ejecución.
Para ahorrar créditos, previsualice su consulta para asegurarse de que es correcta antes de guardar la Extensión de Segmento SQL.
Tus créditos volverán a ser 5 el primer día de cada mes a las 12 am UTC. Puede controlar el uso de sus créditos a lo largo del mes en el panel de uso de créditos. En la página Extensiones de segmento, haga 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 dejan de actualizarse, lo que afecta a los miembros de estos segmentos y a cualquier campaña o lienzo que se dirija a estos segmentos.
- Sólo puede 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 agotado el 50%, el 80% y el 100% de los créditos. Después de que sus créditos se restablezcan al comienzo del mes siguiente, podrá crear más segmentos SQL y se reanudarán las actualizaciones automáticas.
Si desea adquirir más créditos de Segmento SQL o Extensiones de Segmento adicionales, póngase en contacto con su gestor de cuenta.
Editar esta página en GitHub