Generador de consultas Variables SQL

Aprende a utilizar variables SQL en el Generador de consultas, para que puedas reutilizar tus consultas y evitar codificar datos en tu código.

¿Por qué utilizar variables SQL?

Las ventajas de utilizar variables SQL son

• Ahorre tiempo creando una variable de campaña para seleccionarla de una lista al crear su informe, en lugar de pegar los ID de campaña.
• Intercambie valores añadiendo variables que le permitan reutilizar el informe para casos de uso ligeramente diferentes en el futuro (como un evento personalizado diferente).
• Reduzca los errores del usuario al editar su 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 de equipo menos técnicos pueden utilizar después.

Utilización de variables

Paso 1: Añade una variable

Para añadir una variable a tu consulta, utiliza la siguiente sintaxis:

1
{{variable_type.${custom_label}}}

Sustituye lo siguiente:

En el siguiente ejemplo, se consulta el número total de usuarios entre el primer y el último día de un mes para una campaña. A cada variable se le asignará un valor en el paso siguiente.

1
2
3
4
5
SELECT COUNT(*) AS total_users
FROM USERS_CAMPAIGNS_REVENUE_SHARED
WHERE campaign_id = '{{campaign.${Campaign}}}'
  AND TIME > '{{start_date.${Month First Day}}}'
  AND TIME < '{{end_date.${Month Last Day}}}';

Paso 2: Asignar un valor

Por predeterminado, la pestaña Variables no se muestra en el Generador de consultas. Sólo aparece después de añadir tu primera variable a la consulta. Allí podrás asignarle un valor. Los valores concretos que puedes elegir dependerán del tipo específico de esa variable.

En el siguiente ejemplo, se asigna un valor a la campaña “Lanzamiento de características en verano”, junto con el primer y el último día de junio de 2025.

Tipos de variables generales

Número

number puede utilizarse en combinación con otras variables que no sean cadenas. Acepta cualquier número positivo o negativo, incluidos los decimales, como 5.5.

• uso

1
some_number_column < {{number.${custom_label}}}

Cadena

Para cambiar valores de cadenas repetitivas entre ejecuciones de informes. Utilice esta variable para evitar codificar un valor varias veces en su SQL.

• uso

1
'{{string.${add a string here.}}}'

Lista

Para seleccionar entre una lista de opciones.

• elige uno
• elige varios

1
{{options.${metrics} | is_radio_button: 'true' | options: '[{"label": "test", "value": "test_value"}, {"label": "test2", "value": "test_value2"}]'}}

1
{{options.${metrics} | is_multi_select: 'true' | options: '[{"label": "test", "value": "test_value"}, {"label": "test2", "value": "test_value2"}]'}}

Botón de radio

Para mostrar opciones como botones de radio en lugar de un desplegable de selección en la pestaña Variables. No se puede utilizar solo, sino en combinación con una lista.

• uso

1
is_radio_button: 'true'

Selección múltiple

Para saber si el desplegable de selección permite una selección única o múltiple. No se puede utilizar solo, sino en combinación con una lista.

• uso

1
is_multi_select: 'true'

Opciones

Para proporcionar la lista de opciones seleccionables en forma de etiqueta y valor. La etiqueta es lo que se muestra y el valor es lo que sustituye a la variable cuando se selecciona la opción. No se puede utilizar solo, sino en combinación con una lista.

• uso

1
options: '[{"label": "test", "value": "test_value"}, {"label": "test2", "value": "test_value2"}]'

Tipos de variables específicas de Braze

Intervalo de fechas

Para mostrar un calendario en el que seleccionar fechas. Sustituye start_date y end_date por una marca de tiempo Unix en segundos para una fecha especificada en UTC, como 1696517353. Opcionalmente, puedes configurar sólo una start_date o end_date para mostrar sólo una fecha en el calendario. Si las etiquetas de tus start_date y end_date no coinciden, se tratarán como dos fechas distintas, en lugar de como un intervalo de fechas.

• uso

1
time > {{start_date.${custom_label}}} AND time < {{end_date.${custom_label}}}

Puedes establecer el intervalo de fechas en cualquiera de las siguientes opciones. Si se utilizan tanto start_date como end_date y comparten la misma etiqueta, se mostrarán todas las opciones. De lo contrario, si sólo se utiliza una, sólo se mostrará la opción especificada.

Tu Liquid se utilizará para mostrar un calendario dentro del intervalo de fechas indicado:

Campañas

• una campaña
• múltiples campañas
• variantes de campaña

1
campaign_id = '{{campaign.${custom_label}}}'

1
campaign_id IN ({{campaigns.${custom_label}}})

1
message_variation_api_id IN ({{campaign_variants.${custom_label}}})

Canvas

• un lienzo
• múltiples lienzos
• variantes en canvas
• un paso en canvas
• múltiples pasos en canvas

1
canvas_id = '{{canvas.${custom_label}}}'

1
canvas_id IN ({{canvases.${custom_label}}})

1
canvas_variation_api_id IN ({{canvas_variants.${custom_label}}})

1
canvas_step_api_id = '{{canvas_step.${custom_label}}}'

1
canvas_step_api_id IN ({{canvas_steps.${custom_label}}})

Productos

products se utiliza para seleccionar uno o varios productos del panel de Braze.

• uso
• ejemplo

1
({{products.${custom_label}}})

1
2
3
SELECT product_name
FROM FULL_GAME_AND_DLC
WHERE product_id IN ({{products.${Games with DLC}}});

Eventos personalizados

Selecciona uno o varios eventos personalizados o propiedades del evento personalizadas de una lista.

• evento
• propiedades

1
'{{custom_events.${custom_label}}}'

1
2
3
SELECT event_name
FROM CUSTOM_EVENTS_TABLE
WHERE event_name = '{{custom_events.${Purchased Game}}}';

1
name = '{{custom_event_properties.${property names)}}}'

Espacio de trabajo

workspace se utiliza para seleccionar un único espacio de trabajo del panel Braze.

• uso

1
workspace_id = '{{workspace.${app_group_id}}}'

Catálogos

Selecciona uno o varios catologs o campos de catologs de una lista.

• catálogos
• campos del católogo

1
catalog_id = '{{catalogs.${catalog}}}'

1
field_name = '{{catalog_fields.${custom_label}}}'

Segmentos

Para seleccionar segmentos que tengan activado el seguimiento de Analytics. Ajústalo al ID de análisis del segmento, que corresponde a los ID almacenados en la columna user_segment_membership_ids en las tablas en las que esta columna está disponible.

• uso

1
{{segments.${analytics_segments}}}

Etiquetas

Para seleccionar etiquetas para campañas y lienzos. Establece en Campañas y Lienzos los ID de BSON separados por comas que están asociados a las etiquetas seleccionadas.

• uso

1
{{tags.${some tags}}}

Metadatos variables

• uso

1
{{string.${my var}| is_required: 'false' | description: 'My optional string var'}}

Booleano

Para saber si el valor de una variable está lleno. Esto es útil para variables opcionales en las que quieras cortocircuitar una condición si no se rellena el valor de una variable. Puede ajustarse a true o false en función del valor de la otra variable.

• uso

1
{{string.${type_name_has_no_value} | visible: 'false'}} or {{string.${type_name_has_value} | visible: 'false'}}

type y name se refieren a la variable referenciada. Por ejemplo, para cortocircuitar la siguiente variable opcional: {{campaigns.${messaging}}:

1
{{string.${campaigns_messaging_has_no_value}  | visible: 'false'}} OR campaign_id IN ({{campaigns.${messaging} | is_required: 'false'}})

Visible

Para saber si las variables son visibles. Todas las variables son visibles por defecto en la pestaña Variables, donde puede introducir valores.

Existen varias variables especiales cuyo valor depende de otra variable, como por ejemplo si otra variable tiene un valor. Estas variables especiales están marcadas como no visibles para que no aparezcan en la pestaña Variables.

• uso

1
visible: 'false'

Obligatoria

Para saber si las variables son obligatorias por defecto. Un valor vacío para una variable suele conducir a una consulta incorrecta.

• uso

1
required: 'false'

Pedido

Para seleccionar la posición de la variable en la pestaña Variables.

• uso

1
order: '1'

Incluir citas

• comillas simples
• comillas dobles

1
include_quotes: 'true'

1
include_double_quotes: 'true'

Marcador de posición

Para especificar el texto del marcador de posición que aparece en el campo de entrada de la variable.

• uso

1
placeholder: 'enter some value'

Descripción

Para especificar el texto de descripción que aparece bajo el campo de entrada de la variable.

• uso

1
description: 'some description'

Valor predeterminado

Para especificar el valor por defecto de la variable cuando no se especifica ningún valor.

• uso

1
default_value: '5'

Ocultar etiqueta

Para ocultar la etiqueta de la variable.

• uso

1
hide_label: 'true'