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

Necesitarás permisos de “Ver PII” para usar el Generador de consultas, ya que permite el acceso directo a algunos datos de clientes.

Uso del Generador de consultas

Paso 1: Crear una consulta SQL

Para crear una nueva consulta, ve a Analytics > Query Builder y selecciona Create SQL Query.

Si necesitas inspiración o ayuda para elaborar tu consulta, elige Query Template y selecciona una plantilla prediseñada. Para comenzar con una consulta en blanco, selecciona SQL Editor.

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 hacerlo 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 Run Query. Si no hay errores ni tiempos de espera de informe agotados, se generará un archivo CSV a partir de la consulta.

Para descargar el informe CSV, selecciona Export.

Importante

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

Tiempos de espera en informes

Los informes que tardan más de seis minutos en ejecutarse agotarán el tiempo de espera. Si 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 sucede, intenta ejecutar el informe de nuevo.

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

Consultar motivos de cancelación

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 de la cancelación, y el campo complementario ABORT_LOG contiene detalles adicionales (como la regla de limitación de frecuencia que se activó).

Por ejemplo, para contar las cancelaciones 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 cancelación.

Datos y resultados

Todas las consultas muestran datos de los últimos 60 días. Cuando exportas tus resultados, solo contendrán hasta 1000 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 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.