Generador de consultas

Aprende a utilizar el Generador de consultas, para que puedas generar 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.

Requisitos previos

Para usar el Generador de consultas, necesitarás los siguientes permisos:

• Ver PII: El Generador de consultas permite el acceso directo a algunos datos de clientes.
• Ver informes del panel: Este permiso es necesario para que los usuarios que no son administradores puedan ver el Generador de consultas en el panel.

Usar el Generador de consultas

Paso 1: Crear una consulta SQL

Para crear una nueva consulta, ve a Analytics > Generador de consultas y selecciona Crear consulta SQL.

Si necesitas inspiración o ayuda para elaborar tu consulta, elige Plantilla de consulta y selecciona una plantilla predefinida. Para empezar con una consulta en blanco, selecciona Editor SQL.

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.

Paso 2: Construir tu consulta

Al construir tu consulta, puedes elegir obtener ayuda de la IA o construirla por tu cuenta.

• usando brazeai
• por mi cuenta

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()));

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()));

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

Paso 3: Generar tu informe

Cuando hayas terminado de construir tu consulta, selecciona Ejecutar consulta. Si no hay errores ni tiempos de espera del informe, se generará un archivo CSV a partir de la consulta.

Para descargar el informe CSV, selecciona Exportar.

Importante

Cada informe solo puede generar resultados una vez al día. Si ejecutas el mismo informe varias veces en un solo día del calendario, verás los mismos resultados en cada informe.

Tiempos de espera en los informes

Los informes que tardan más de seis minutos en ejecutarse agotarán el tiempo de espera. Si esta es la primera consulta que ejecutas en un tiempo, puede tardar más en procesarse y, por lo tanto, tiene una mayor probabilidad de agotar el tiempo de espera. Si esto ocurre, intenta ejecutar el informe de nuevo.

Si tu informe sigue agotando el tiempo de espera después de varios intentos, contacta con el equipo de soporte.

Consultar razones de aborto

Puedes consultar la columna ABORT_TYPE en cualquier tabla USERS_MESSAGES_*_ABORT_SHARED para analizar por qué no se enviaron los mensajes. El campo ABORT_TYPE contiene un valor de cadena que describe el motivo específico del aborto, y el campo complementario ABORT_LOG contiene detalles adicionales (como la regla de limitación de frecuencia que se activó).

Por ejemplo, para contar los abortos de correo electrónico por tipo en los últimos 30 días:

1
2
3
4
5
SELECT ABORT_TYPE, COUNT(*) as abort_count
FROM USERS_MESSAGES_EMAIL_ABORT_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('day', -30, CURRENT_DATE())
GROUP BY ABORT_TYPE
ORDER BY abort_count DESC

Para ver la lista completa de valores de ABORT_TYPE y sus descripciones, consulta Tipos de aborto.

Datos y resultados

Todas las consultas muestran datos de los últimos 60 días. Cuando exportes tus resultados, solo contendrán hasta 1,000 filas. Para informes que requieran mayores cantidades de datos, puedes usar herramientas como Currents o el endpoint de API de exportación.

Créditos de Snowflake

Cada empresa tiene 5 créditos de Snowflake disponibles por mes, compartidos entre todos los espacios de trabajo. Se utiliza una pequeña porción de un crédito de Snowflake cada vez que ejecutas una consulta o previsualizas una tabla.

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, mayor será la porción de un crédito de Snowflake que costará una consulta. El tiempo de ejecución puede variar dependiendo 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á tu asignación de recursos y más rápido será tu tiempo de ejecución.

Los créditos no se utilizan al escribir, editar o guardar informes dentro del editor SQL de Braze. Tus créditos se restablecerán a 5 el primer día de cada mes a las 12 am UTC. Puedes monitorear tu uso mensual de créditos en la parte superior de la página del Generador de consultas.

Cuando alcances el límite de créditos, no podrás ejecutar consultas, pero sí podrás crear, editar y guardar informes SQL. Si deseas comprar más créditos del Generador de consultas, ponte en contacto con tu director de cuentas.