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 que puedas 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 al Generador de consultas 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 el Uso compartido de datos de Snowflake. Para obtener una lista completa de las tablas disponibles y sus columnas, consulta la referencia de tablas SQL.

Ejecución de informes en el Generador de consultas

Para ejecutar un informe del Generador de consultas:

1. Ve a Analytics > Query Builder.
2. Selecciona Create SQL Query. Si necesitas inspiración o ayuda para elaborar tu consulta, selecciona Query Template y elige una plantilla de la lista. De lo contrario, selecciona SQL Editor para ir directamente al editor.
3. Tu informe recibe automáticamente un nombre con la fecha y hora actuales. Pasa el cursor sobre el nombre y selecciona para darle a tu consulta SQL un nombre significativo.
4. Escribe tu consulta SQL en el editor u obtén ayuda de la IA desde la pestaña AI Query Builder. Si escribes tu propio SQL, consulta Escritura de consultas SQL personalizadas para conocer los requisitos y recursos.
5. Selecciona Run Query.
6. Guarda tu consulta.
7. Para descargar un CSV de tu informe, selecciona Export.

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

Plantillas de consultas

Accede a las plantillas de consultas seleccionando Create SQL Query > Query Template al crear un informe por primera vez.

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

Periodo de tiempo de los datos

Las consultas devuelven datos de los últimos 60 días. Si utilizas Currents o el Uso compartido de datos de Snowflake, es posible que puedas consultar hasta dos años de datos, que es el tiempo que se retienen tus datos en Snowflake. Para más detalles sobre la retención extendida de datos, ponte en contacto con tu administrador del éxito del cliente.

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 Email Channel Engagement (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 Query history en el Generador de consultas muestra tus consultas ejecutadas anteriormente para ayudarte a rastrear 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.

Generación de SQL con el AI Query Builder

El AI Query Builder aprovecha GPT, impulsado por OpenAI, para recomendar SQL para tu consulta.

Para generar SQL con el AI Query Builder:

1. Después de crear un informe en el Generador de consultas, selecciona la pestaña AI Query Builder.
2. Escribe tu indicación o selecciona una indicación de ejemplo y selecciona Generate para traducir tu indicación a SQL.
3. Revisa el SQL generado para asegurarte de que sea correcto y luego selecciona Insert into Editor.

Consejos

• Familiarízate con las tablas y columnas disponibles en la referencia de tablas SQL. 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.
• Puedes enviar hasta 20 indicaciones por minuto con el AI Query Builder.

¿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.

Escritura 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 consultar.

Para ver los detalles de las tablas dentro del Generador de consultas:

1. Desde la página del Query Builder, abre el panel Reference y selecciona Available Data Tables para ver las tablas de datos disponibles y sus nombres.
2. Selecciona See Details 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 Query Template 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ápido. El siguiente es un ejemplo de consulta que obtiene el número de compras y los ingresos generados en 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 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 necesitas incluirlas 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 deseas que el nombre de la variante de campaña se rellene automáticamente, incluye el nombre de 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 tu consulta SQL
• Tiempo de espera de procesamiento agotado (después de 6 minutos)
  • Los informes que tardan más de 6 minutos en ejecutarse agotarán el tiempo de espera.
  • Si un informe agota el tiempo de espera, intenta limitar el rango de tiempo en el que consultas los datos o consulta un conjunto de datos más específico.

Uso de variables

Utiliza variables para usar tipos de variables predefinidos en SQL para hacer referencia a valores sin necesidad de copiar manualmente el valor. Por ejemplo, en lugar de copiar manualmente el ID de una campaña al editor SQL, puedes usar {{campaign.${My campaign}}} para seleccionar directamente una campaña desde un menú desplegable en la pestaña Variables.

Después de crear una variable, aparecerá en la pestaña Variables de tu informe del Generador de consultas. Los beneficios de usar variables SQL incluyen:

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

Directrices

Las variables deben seguir 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 se establecen de forma predeterminada con el nombre de la variable.

De forma predeterminada, todas las variables son obligatorias (y tu informe no se ejecutará a menos que se seleccionen valores de variables), excepto el rango de fechas, que se establece de forma predeterminada en los últimos 30 días cuando no se proporciona el valor.

Tipos de variables

Se aceptan los siguientes tipos de variables:

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

Número

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

Rango de fechas

Si usas tanto start_date como end_date, deben tener el mismo nombre para que puedas usarlos como un rango de fechas.

Valores de ejemplo

El tipo de rango de fechas puede ser relativo, fecha de inicio, fecha de fin o rango de fechas.

Los cuatro tipos se muestran si se usan tanto start_date como end_date con el mismo nombre. Si solo se usa uno, solo se mostrarán los tipos relevantes.

• Valor de reemplazo: Reemplaza start_date y end_date con una marca de tiempo Unix en segundos para una fecha especificada en UTC, como 1696517353.
• Ejemplo de uso: Para todas las variables de relativo, fecha de inicio, fecha de fin y rango de fechas:
  • time > {{start_date.${some name}}} AND time < {{end_date.${some name}}}
    • Puedes usar start_date o end_date si no deseas un rango de fechas.

Mensajería

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

Canvas

Para seleccionar un Canvas. Compartir el mismo nombre con una campaña resultará en un botón de opción dentro de la pestaña Variables para seleccionar Canvas o campaña.

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

Canvas (múltiples)

Para seleccionar múltiples Canvas. Compartir el mismo nombre con una campaña resultará en un botón de opción dentro de la pestaña Variables para seleccionar Canvas o campaña.

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

Campaign

Para seleccionar una Campaign. Compartir el mismo nombre con un Canvas resultará en un botón de opción dentro de la pestaña Variables para seleccionar Canvas o campaña.

• Valor de reemplazo: ID BSON de la Campaign
• Ejemplo de uso: campaign_id = '{{campaign.${some name}}}'

Campaigns (múltiples)

Para seleccionar múltiples Campaigns. Compartir el mismo nombre con un Canvas resultará en un botón de opción dentro de la pestaña Variables para seleccionar Canvas o campaña.

• Valor de reemplazo: ID BSON de las Campaigns
• Ejemplo de uso: campaign_id IN ({{campaigns.${some name}}})

Variantes de campaña

Para seleccionar variantes de campaña que pertenecen a la Campaign seleccionada. Debe usarse junto con una variable de Campaign o Campaigns.

• Valor de reemplazo: ID de API de las 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 variantes en Canvas que pertenecen a un Canvas elegido. Debe usarse con una variable de Canvas o Canvas (múltiples).

• Valor de reemplazo: 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 pertenece a un Canvas elegido. Debe usarse con una variable de Canvas.

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

Pasos en Canvas

Para seleccionar pasos en Canvas que pertenecen a los Canvas elegidos. Debe usarse con una variable de Canvas o Canvas (múltiples).

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