Generador de consultas

El Generador de consultas genera informes utilizando datos de Braze en Snowflake. El Generador de consultas incluye plantillas de consultas SQL predefinidas para empezar, o puedes escribir tus propias consultas SQL personalizadas para obtener aún más información.

Dado que el Generador de consultas permite el acceso directo a algunos datos de clientes, solo puedes acceder a él si tienes el permiso “Ver PII”.

Tablas de datos disponibles

El Generador de consultas utiliza las mismas tablas SQL de Snowflake que las extensiones de segmento SQL y Snowflake Data Sharing. Para obtener una lista completa de las tablas disponibles y sus columnas, consulta la referencia de tablas SQL.

Ejecutar informes en el Generador de consultas

Para ejecutar un informe del Generador de consultas:

1. Ve a Análisis > Generador de consultas.
2. Selecciona Crear consulta SQL. Si necesitas inspiración o ayuda para elaborar tu consulta, selecciona Plantilla de consulta y elige una plantilla de la lista. De lo contrario, selecciona Editor SQL para ir directamente al editor.
3. Tu informe recibe automáticamente un nombre con la fecha y hora actuales. Pasa el ratón por encima del nombre y selecciona para dar un nombre significativo a tu consulta SQL.
4. Escribe tu consulta SQL en el editor u obtén ayuda de IA desde la pestaña Generador de consultas con IA. Si escribes tu propio SQL, consulta Escribir consultas SQL personalizadas para conocer los requisitos y los recursos.
5. Selecciona Ejecutar consulta.
6. Guarda tu consulta.
7. Para descargar un CSV de tu informe, selecciona Exportar.

Los resultados de cada informe pueden generarse una vez al día. Si ejecutas el mismo informe más de una vez en un día natural, verás los mismos resultados en ambos informes.

Plantillas de consulta

Accede a las plantillas de consulta seleccionando Crear consulta SQL > Plantilla de consulta al crear un informe por primera vez.

Consulta Plantillas de consulta para ver una lista de las plantillas disponibles.

Plazo de los datos

Todas las consultas muestran datos de los últimos 60 días.

Zona horaria del Generador de consultas

La zona horaria predeterminada para consultar nuestra base de datos de Snowflake es UTC. Como resultado, puede haber algunas discrepancias de datos entre tu página de Interacción con el canal de correo electrónico (que sigue la zona horaria de tu empresa) y los resultados de tu Generador de consultas.

Para convertir la zona horaria en los resultados de tu consulta, añade el siguiente SQL a tu consulta y personalízalo para la zona horaria de tu empresa:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
SELECT
DATE_TRUNC(
'day',
CONVERT_TIMEZONE('UTC','Australia/Sydney', TO_TIMESTAMP(TIME))
) AS send_date_sydney,
COUNT(ID) AS emails_sent
USERS_MESSAGES_EMAIL_SEND_SHARED
WHERE
-- Apply the date range in Sydney time as well
CONVERT_TIMEZONE('UTC','Australia/Sydney', TO_TIMESTAMP(TIME)) >= '2025-03-25 00:00:00'
AND CONVERT_TIMEZONE('UTC','Australia/Sydney', TO_TIMESTAMP(TIME)) < '2025-03-29 00:00:00'
AND APP_GROUP_ID = 'your app group ID'
GROUP BY
send_date_sydney
ORDER BY
send_date_sydney;

Historial de consultas

La sección Historial de consultas del Generador de consultas muestra tus consultas ejecutadas anteriormente para ayudarte a hacer un seguimiento y reutilizar tu trabajo. El historial de consultas se conserva durante siete días, lo que significa que las consultas con más de siete días de antigüedad se eliminan automáticamente.

Si necesitas auditar el uso de consultas durante periodos más largos o mantener registros más allá de siete días, te recomendamos exportar o guardar los resultados de consultas importantes antes de que caduquen.

Generar SQL con el Generador de consultas con IA

El Generador de consultas con IA aprovecha GPT, impulsado por OpenAI, para recomendar SQL para tu consulta.

Para generar SQL con el Generador de consultas con IA:

1. Tras crear un informe en el Generador de consultas, selecciona la pestaña Generador de consultas con IA.
2. Escribe tu prompt o selecciona un prompt de ejemplo y selecciona Generar para traducir tu prompt a SQL.
3. Revisa el SQL generado para asegurarte de que parece correcto y, a continuación, selecciona Insertar en el editor.

Consejos

• Familiarízate con las tablas y columnas disponibles en la referencia de tablas SQL. 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 reglas provocará un error.
• Puedes enviar hasta 20 prompts por minuto con el Generador de consultas con IA.

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

Para generar tu SQL, Braze enviará tus prompts a la plataforma API de OpenAI. Todas las consultas enviadas a OpenAI desde Braze son anónimas, lo que significa que OpenAI no podrá identificar quién envió la consulta a menos que incluyas información identificable de forma única en el contenido que proporciones. Como se detalla en 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 sus modelos y se eliminarán al cabo de 30 días. Asegúrate de que cumples las políticas de OpenAI relevantes para ti, incluida la Política de uso. Braze no ofrece garantías de ningún tipo con respecto a los contenidos generados por IA.

Redacción de consultas SQL personalizadas

Escribe tu consulta SQL utilizando la sintaxis de Snowflake. Consulta la referencia de tablas para obtener una lista completa de las tablas y columnas disponibles para tu consulta.

Para ver los detalles de la tabla en el Generador de consultas:

1. En la página Generador de consultas, abre el panel Referencia y selecciona Tablas de datos disponibles para ver las tablas de datos disponibles y sus nombres.
2. Selecciona Ver detalles para ver la descripción de la tabla e información sobre las columnas de la tabla, como los tipos de datos.
3. Para insertar el nombre de la tabla en tu SQL, selecciona .

Para utilizar consultas preescritas proporcionadas por Braze, selecciona Plantilla de consulta al crear un informe por primera vez en el Generador de consultas.

Restringir tu consulta a un periodo de tiempo específico te ayudará a generar resultados más rápidamente. A continuación se muestra un ejemplo de consulta que obtiene el número de compras y los ingresos generados durante la última hora.

1
2
3
SELECT COUNT(*) as Purchases, SUM(price) as Revenue
FROM USERS_BEHAVIORS_PURCHASE_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('hour', -1, date_trunc('day',CURRENT_DATE()));

Esta consulta recupera el número de envíos de correo electrónico en el último mes:

1
2
3
SELECT COUNT(*) as Sends
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('month', -1, date_trunc('day',CURRENT_DATE()));

Si consultas por CANVAS_ID, CANVAS_VARIATION_API_ID o CAMPAIGN_ID, sus columnas de nombre asociadas se incluirán automáticamente en la tabla de resultados. No es necesario que las incluyas en la propia consulta SELECT.

Esta consulta recupera los tres ID y sus columnas de nombre asociadas con un máximo de 100 filas:

1
2
3
SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED 
LIMIT 100

Rellenar automáticamente el nombre de la variante de campaña

Si quieres que el nombre de la variante de campaña se rellene automáticamente, incluye el nombre de la columna MESSAGE_VARIATION_API_ID en tu consulta, como en este ejemplo:

1
2
3
SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID, MESSAGE_VARIATION_API_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED 
LIMIT 100

Solución de problemas

Tu consulta puede fallar por cualquiera de las siguientes razones:

• Errores de sintaxis en la consulta SQL
• Tiempo de espera de procesamiento (después de 6 minutos)
  • Los informes que tarden más de 6 minutos en ejecutarse agotarán el tiempo de espera.
  • Si se agota el tiempo de espera de un informe, intenta limitar el intervalo de tiempo en el que consultas los datos o consulta un conjunto de datos más específico.

Utilización de variables

Utiliza variables para usar tipos de variables predefinidas en SQL y referenciar valores sin necesidad de copiar manualmente el valor. Por ejemplo, en lugar de copiar manualmente el ID de una campaña en el editor SQL, puedes usar {{campaign.${My campaign}}} para seleccionar directamente una campaña en un desplegable de la pestaña Variables.

Una vez creada una variable, aparecerá en la pestaña Variables de tu informe del Generador de consultas. Entre las ventajas de utilizar variables SQL se incluyen:

• Ahorra tiempo creando una variable de campaña para seleccionarla de una lista al crear tu informe, en lugar de pegar los ID de campaña.
• Intercambia valores añadiendo variables que te permitan reutilizar el informe para casos de uso ligeramente diferentes en el futuro (como un evento personalizado diferente).
• Reduce los errores del usuario al editar tu SQL reduciendo la cantidad de edición necesaria para cada informe. Los compañeros de equipo que se sienten más cómodos con SQL pueden crear informes que los compañeros menos técnicos pueden utilizar después.

Directrices

Las variables deben ajustarse a la siguiente sintaxis de Liquid: {{ type.${name}}}, donde type debe ser uno de los tipos aceptados y name puede ser cualquier cosa que elijas. Las etiquetas de estas variables son por defecto el nombre de la variable.

Por defecto, todas las variables son obligatorias (y tu informe no se ejecutará a menos que se seleccionen los valores de las variables) excepto el intervalo de fechas, que por defecto es de los últimos 30 días cuando no se proporciona el valor.

Tipos de variables

Se aceptan los siguientes tipos de variables:

• Número
• Intervalo de fechas
• Mensajería
• Productos
• Eventos personalizados
• Propiedades de eventos personalizados
• Espacio de trabajo
• Catálogos
• Campos del catálogo
• Opciones
• Segmentos
• Cadena
• Etiquetas

Número

• Valor de sustitución: El valor proporcionado, como 5.5
• Ejemplo de uso: some_number_column < {{number.${some name}}}

Intervalo de fechas

Si utilizas start_date y end_date, deben tener el mismo nombre para que puedas utilizarlos como intervalo de fechas.

Ejemplos de valores

El tipo de intervalo de fechas puede ser relativo, fecha de inicio, fecha final o intervalo de fechas.

Se muestran los cuatro tipos si se utilizan start_date y end_date con el mismo nombre. Si solo se utiliza uno, solo se mostrarán los tipos correspondientes.

• Valor de sustitución: Sustituye start_date y end_date por una marca de tiempo Unix en segundos para una fecha especificada en UTC, como 1696517353.
• Ejemplo de uso: Para todas las variables relativas, fecha de inicio, fecha final e intervalo de fechas:
  • time > {{start_date.${some name}}} AND time < {{end_date.${some name}}}
    • Puedes utilizar start_date o end_date si no deseas un intervalo de fechas.

Mensajería

Todas las variables de mensajería deben compartir el mismo identificador cuando quieras vincular su estado en un grupo.

Canvas

Para seleccionar un Canvas. Si comparte el mismo nombre con una campaña, aparecerá un botón de opción en la pestaña Variables para seleccionar Canvas o campaña.

• Valor de sustitución: ID BSON del Canvas
• Ejemplo de uso: canvas_id = '{{canvas.${some name}}}'

Canvas

Para seleccionar varios Canvas. Si comparte el mismo nombre con una campaña, aparecerá un botón de opción en la pestaña Variables para seleccionar Canvas o campaña.

• Valor de sustitución: ID BSON de los Canvas
• Ejemplo de uso: canvas_id IN ({{canvases.${some name}}})

Campaña

Para seleccionar una campaña. Si comparte el mismo nombre con un Canvas, aparecerá un botón de opción en la pestaña Variables para seleccionar Canvas o campaña.

• Valor de sustitución: ID BSON de la campaña
• Ejemplo de uso: campaign_id = '{{campaign.${some name}}}'

Campañas

Para selección múltiple de campañas. Si comparte el mismo nombre con un Canvas, aparecerá un botón de opción en la pestaña Variables para seleccionar Canvas o campaña.

• Valor de sustitución: ID BSON de las campañas
• Ejemplo de uso: campaign_id IN ({{campaigns.${some name}}})

Variantes de campaña

Para seleccionar las variantes de campaña que pertenecen a la campaña seleccionada. Debe utilizarse junto con una variable de campaña o campañas.

• Valor de sustitución: ID de API de variantes de campaña, cadenas delimitadas por comas como api-id1, api-id2.
• Ejemplo de uso: message_variation_api_id IN ({{campaign_variants.${some name}}})

Variantes en Canvas

Para seleccionar las variantes en Canvas que pertenecen a un Canvas elegido. Debe utilizarse con una variable de Canvas o Canvas.

• Valor de sustitución: ID de API de las variantes en Canvas, cadenas delimitadas por comas como en api-id1, api-id2.
• Ejemplo de uso: canvas_variation_api_id IN ({{canvas_variants.${some name}}})

Paso en Canvas

Para seleccionar un paso en Canvas que pertenezca a un Canvas elegido. Debe utilizarse con una variable de Canvas.

• Valor de sustitución: ID de API del paso en Canvas
• Ejemplo de uso: canvas_step_api_id = '{{canvas_step.${some name}}}'

Pasos en Canvas

Para seleccionar los pasos en Canvas que pertenecen a los Canvas elegidos. Debe utilizarse con una variable de Canvas o Canvas.

• Valor de sustitución: ID de API de los pasos en Canvas
• Ejemplo de uso: canvas_step_api_id IN ({{canvas_steps.${some name}}})