Ir a contenido principal
Nota: Este contenido se tradujo a través de un software y es posible que no haya sido revisado. La versión en inglés se considera, por tanto, la versión oficial y es posible que haya sido actualizada. Para acceder a la versión en inglés, haz clic aquí.

Crear propiedades de cálculo

Última actualización: marzo 19, 2024

Disponible con cualquiera de las siguientes suscripciones, a no ser que se indique de otro modo:

Marketing Hub Pro, Enterprise
Sales Hub Pro, Enterprise
Service Hub Pro, Enterprise
Operations Hub Pro
CMS Hub Pro, Enterprise

Las propiedades de cálculo en HubSpot te permiten calcular automáticamente el valor mínimo, máximo, recuento, suma o promedio de las propiedades en los registros asociados o configurar ecuaciones personalizadas basadas en otras propiedades. 

Por ejemplo, puedes crear:

  • Una propiedad de contacto que calcula la Cantidad promedio de los negocios asociados a un contacto. 
  • Una propiedad de la empresa que calcula el costo de adquisición de un nuevo cliente basándose en una ecuación personalizada.

Nota: según tu suscripción de HubSpot, hay un límite para el número de propiedades calculadas que puedes crear.

Crear propiedades de cálculo

Las propiedades calculadas pueden configurarse en función de distintos criterios, como los valores de las propiedades de los registros asociados, el tiempo transcurrido entre los valores de dos propiedades o tus propias ecuaciones personalizadas. Para crear una propiedad calculada:

  • En tu cuenta de HubSpot, haz clic en el icono de Configuración settings en la barra de navegación principal.
  • En el menú de la barra lateral izquierda, navega a Propiedades.

  • Haz clic en el menú desplegable Seleccionar un objeto y luego selecciona Propiedades [del objeto] para crear una propiedad para ese objeto.

  • Introduce la información básica de tu propiedad, luego haz clic en Siguiente.
  • Selecciona Cálculo para el Tipo de campo. Una vez que se crea tu propiedad Cálculo, no se puede editar el tipo de campo.
  • Haz clic en Generar cálculo.
  • Haz clic en Tipo de propiedad calculada en el menú desplegable y selecciona el tipo de fórmula que deseas crear:

Calcular valores a partir de propiedades e registros asociados

Puedes crear propiedades para un objeto que se calcularán en función de determinados valores de propiedades de los registros asociados a ese objeto. Puedes realizar el cálculo basándote en todos los registros asociados de ese objeto o para etiquetas de asociación específicas, incluidas las asociaciones del mismo objeto.

Por ejemplo, puedes crear una propiedad de operación que cuente el número total de actividades de ventas registradas para los contactos asociados a una operación con la etiqueta Responsable de tomar decisiones.

  • Haz clic en el menú desplegable Tipo de propiedad calculada y selecciona uno de los siguientes tipos:
    • Mínimo: muestra el valor mínimo de la propiedad numérica seleccionada en los registros asociados del objeto seleccionado.
    • Máximo: muestra el valor máximo para la propiedad numérica seleccionado en todos los registros asociados del objeto seleccionado.
    • Conteo: cuenta el número total de registros asociados dentro del tipo de registro seleccionado que tienen un valor para la propiedad numérica seleccionada.
    • Suma: suma los valores de la propiedad numérica seleccionada en todos los registros asociados del objeto seleccionado.
    • Promedio: calcula el promedio de valores de la propiedad numérica seleccionada en todos los registros asociados dentro del tipo de registro seleccionado.
  • Para elegir el formato de los valores de la propiedad, haz clic en el menú desplegable Formato de número y selecciona uno de los siguientes formatos: Con formato Número, Número sin formato, Moneda, Porcentaje, o Duración.
  • Si seleccionas Moneda como formato para una propiedad de negocio, la propiedad utilizará por defecto la moneda de tu cuenta Empresa  . Para utilizar la moneda de cada registro de negocio, selecciona la casilla Utilizar la moneda del registro en lugar de la moneda de la empresa.

Ten en cuenta: utilizar una moneda de registro sólo afecta a cómo se muestra el valor, y no aplicará automáticamente un tipo de cambio.

calculation-property-associated-record

  • Selecciona el objeto asociado y la propiedad de registro asociada para calcular la propiedad en base a ellos. 
  • Para calcular basándote sólo en los registros con una etiqueta específica, haz clic en Seleccionar etiquetas de asociación, y luego selecciona las etiquetas que quieras incluir.
  • Para agregar una condición adicional, haz clic en Crear condición. Cuando se establece una condición adicional, dicha condición debe cumplirse para que se calcule la propiedad (por ejemplo, calcular la propiedad cuando la Cantidad de negocio reciente > 1000).
    • En el primer menú desplegable, selecciona una propiedad.
    • En el segundo menú desplegable, selecciona un operador que comparará el valor de la primera propiedad con un número o con el valor de otra propiedad.
    • En el tercer menú desplegable, selecciona una propiedad o introduce un número que se comparará con la primera propiedad.
  • Haz clic en Crear. Una vez creado, el tipo de campo mostrado de la propiedad será Resumen.

Calcular valores en función del tiempo transcurrido entre dos propiedades

Puedes crear propiedades que calculen el tiempo entre dos propiedades seleccionadas del selector de fecha dentro del mismo objeto. Por ejemplo, puedes calcular el tiempo transcurrido entre la asignación del propietario de un ticket y el cierre del mismo. Más información sobre cómo se muestran los valores de las propiedades de cálculo Tiempo Entre.

  • Haz clic en el menú desplegable Tipo de propiedad calculada y selecciona Tiempo entre.
  • Haz clic en los menús desplegables y selecciona tus propiedades de Fecha de inicio y Hora de inicio.

time-between-calculation-property

  • Para agregar una condición adicional, haz clic en Crear condición. Cuando se establece una condición adicional, dicha condición debe cumplirse para que se calcule la propiedad (por ejemplo, calcular la propiedad cuando la Cantidad de negocio reciente > 1000).
    • En el primer menú desplegable, selecciona una propiedad.
    • En el segundo menú desplegable, selecciona un operador que comparará el valor de la primera propiedad con un número o con el valor de otra propiedad.
    • En el tercer menú desplegable, selecciona una propiedad o introduce un número que se comparará con la primera propiedad.
  • Haz clic en Crear. Una vez creado, el tipo de campo mostrado de la propiedad será Resumen.

Se espera el siguiente comportamiento al mostrar valores para las propiedades de tiempo entre cálculos:

  • El tiempo se mostrará de manera diferente en diferentes herramientas de HubSpot.
  • Para las propiedades de fecha sin marca de tiempo, la hora predeterminada utilizada en el cálculo será las 12:00 am UTC del día seleccionado.
  • En un registro de objeto (por ejemplo, un registro de contacto ), el valor mostrado estará en horas, días, meses, o años, y se redondeará hacia arriba a la siguiente unidad en función de umbrales específicos. Por ejemplo, si el tiempo calculado es de un mes y veinte días, el valor mostrado será Un mes, pero si el tiempo calculado es de un mes y veintisiete días, el valor mostrado será Dos meses. Los umbrales son:
    • 45 segundos o más se redondea hasta un minuto
    • 45 minutos o más se redondea hasta una hora
    • 22 horas o más se redondea hasta un día
    • 26 días o más se redondea hasta un mes
    • 11 meses o más se redondea hasta un año
  • En informes personalizados que usan una propiedad con este tipo de campo, el valor que se muestra estará en días. Por ejemplo, si el tiempo calculado es un año y 20 días, el valor que se muestra será 385 días.

Nota: dentro de HubSpot, los valores sin procesar de Tiempo entre y Promedio se almacena en milisegundos. Si una ecuación con estos valores produce un valor más alto que lo esperado, usa un conversor de milisegundos para convertir a la unidad de tiempo que desees.

Calcular valores basados en el redondeo de los valores de propiedad

Puedes crear propiedades calculadas que especifiquen cómo redondear los valores numéricos de otras propiedades. Por ejemplo, puedes crear una propiedad calculada que redondee una propiedad de comisión a los dos decimales más próximos.

  • Haz clic en el menú desplegable Tipo de propiedad calculada y selecciona una opción de redondeo:
    • Redondear solo hacia abajo: redondea siempre los valores hacia abajo hasta el número de decimales especificado. 
    • Redondear solo hacia arriba: redondea siempre los valores hacia arriba hasta el número de decimales especificado.
    • Redondear al más cercano: redondea los valores al número de decimales más cercano especificado en función de la proximidad.
  • Para elegir el formato de los valores de la propiedad, haz clic en el menú desplegable Formato de número y selecciona uno de los siguientes formatos: Con formato Número, Número sin formato, Moneda, Porcentaje, o Duración.
  • Si seleccionas Moneda como formato para una propiedad de negocio, la propiedad utilizará por defecto la moneda de tu cuenta Empresa  . Para utilizar la moneda de cada registro de negocio, selecciona la casilla Utilizar la moneda del registro en lugar de la moneda de la empresa.

Ten en cuenta: utilizar una moneda de registro sólo afecta a cómo se muestra el valor, y no aplicará automáticamente un tipo de cambio.

  • Haz clic en el menú desplegable Elige la propiedad del registro y luego selecciona la propiedad con los valores que desees redondear. Puedes seleccionar cualquier propiedad de puntuación, cálculo o número dentro de ese objeto.
  • En el cuadro de texto Decimales a los que redondear, introduce el número de decimales a los que deseas redondear los valores.

Nota: para propiedades de moneda, esta función redondeará el valor a la precisión elegida, pero seguirá mostrando los valores como una moneda con la cantidad correcta de dígitos.

rounding-calculation-property

  • Para agregar una condición adicional, haz clic en Crear condición. Cuando se establece una condición adicional, dicha condición debe cumplirse para que se calcule la propiedad (por ejemplo, calcular la propiedad cuando la Cantidad de negocio reciente > 1000).
    • En el primer menú desplegable, selecciona una propiedad.
    • En el segundo menú desplegable, selecciona un operador que comparará el valor de la primera propiedad con un número o con el valor de otra propiedad.
    • En el tercer menú desplegable, selecciona una propiedad o introduce un número que se comparará con la primera propiedad.
  • Haz clic en Crear. Una vez creado, el tipo de campo mostrado de la propiedad será Cálculo.

Calcular valores a partir de una ecuación personalizada

También puedes crear propiedades que calculen valores en función de tus propios criterios. Las ecuaciones personalizadas solo pueden configurarse para propiedades numéricas dentro del mismo objeto para el que estás creando la nueva propiedad. Por ejemplo, puedes crear una ecuación para calcular el cantidad del negocio más reciente de una empresa (Cantidad del negocio más reciente) comparado con el número de veces que tu empresa contactó a la empresa (Cantidad de veces contactado).

Puedes construir tu ecuación personalizada con operadores aritméticos, operadores de comparación, operadores lógicos, sentencias condicionales y otras funciones. Estas ecuaciones pueden devolver valores numéricos, booleanos, de cadena o de fecha. Obtén más información sobre los operadores y funciones disponibles, y sobre cómo dar formato a tus fórmulas

Para construir una propiedad calculada de ecuaciones personalizadas:

  • Haz clic en el menú desplegable Tipo de propiedad calculada y, a continuación, selecciona Ecuación personalizada.
  • Haz clic en el menú desplegable Tipo de salida, y selecciona el tipo de salida que devolverá tu cálculo. Puedes seleccionar uno de los siguientes: Número, Booleano, Cadena o Fecha.

Nota: el tipo de salida seleccionado debe coincidir con el tipo de salida mostrado en la parte superior derecha del editor o no podrás crear la propiedad. Para las propiedades que devuelven una fecha, puedes utilizar el tipo de salida número o fecha, que determina cómo se muestran los valores (es decir, número muestra la fecha en milisegundos, fecha muestra la fecha formateada).

  • Si has seleccionado el tipo de salida Número:
    • Haz clic en el menú desplegable Formato de número y selecciona cómo formatear los valores de la propiedad. Puedes seleccionar uno de los siguientes: Número con formato, Número sin formato, Moneda, Porcentaje o Duración.
    • Si seleccionas Moneda como formato numérico para una propiedad de negocio, la propiedad utilizará por defecto la moneda de tu cuenta Empresa . Para utilizar la moneda de cada registro de negocio, selecciona la casilla Utilizar la moneda del registro en lugar de la moneda de la empresa.

Ten en cuenta: utilizar una moneda de registro sólo afecta a cómo se muestra el valor, y no aplicará automáticamente un tipo de cambio. Para añadir un tipo de cambio, puedes incluir las funciones exchange_rate o dated_exchange_rate en tu ecuación.


  • En el editor, inserta, escribe o pega funciones y propiedades para construir tu ecuación personalizada. Más información sobre sintaxis de ecuaciones de cálculo personalizadas. Para insertar elementos de fórmula:
    • Haz clic en el menú desplegable Insertar .
    • Para insertar funciones en tu ecuación, selecciona Funciones y luego selecciona una función .
    • Para insertar propiedades en tu ecuación, selecciona Propiedades y luego selecciona una propiedad. Solo puedes crear ecuaciones personalizadas utilizando propiedades del mismo objeto para el que estás creando la propiedad.

cálculo-propiedad-ejemplo-inserción

  • Si tu ecuación tiene errores, haz clic en [x] problemas por encima del editor para ver las razones de los errores. No podrás crear la propiedad si tu ecuación tiene errores sin resolver. Más información sobre cómo formatear tus ecuaciones.
  • Para obtener una vista preliminar del resultado de tu fórmula, haz clic en Probar fórmula.
calculated-property-preview

Nota: si alguna de las propiedades numéricas utilizadas en una ecuación personalizada no tiene valor o tiene un valor nulo, el valor de propiedad calculado estará vacío. El valor estará vacío incluso si hay un número constante incluido en la ecuación. En esta situación, ¿puede utilizar las funciones if y is_known para poner el valor a 0 en lugar de.


  • Haz clic en Crear. Una vez creado, el tipo de campo mostrado de la propiedad será Cálculo.

Sintaxis de ecuación personalizada

En el Editor de fórmulas, puedes construir tus propias ecuaciones personalizadas utilizando datos literales, datos de otras propiedades, operadores y funciones. A continuación, aprende la sintaxis para escribir ecuaciones de cálculo personalizadas y revisa ejemplos de fórmulas de uso común.

Sintaxis literal

Utilizando datos literales, puedes agregar cadenas de texto, números y valores verdaderos o falsos a tus ecuaciones. Puedes formatear cadenas, números, booleanos y constantes de fecha de las siguientes maneras:

  • Cadena literal: texto entre comillas. Pueden representarse con comillas simples ('constant') o dobles ("constant").

  • Número literal: números sin comillas. Los números constantes pueden ser cualquier número real y pueden incluir notación de puntos. Por ejemplo, tanto 1005 como 1.5589 son números constantes válidos.

  • Literal booleano: los booleanos constantes pueden ser true o false.

  • Fecha literal: una fecha en milisegundos. Por ejemplo, 1698508800000.

Sintaxis de propiedad

Puedes incluir otras propiedades del mismo objeto en tu ecuación personalizada. Si se inserta una propiedad en el editor, se formatea y valida automáticamente como parte de una ecuación.

Si decides escribir o pegar manualmente una propiedad en el editor, debe tener el formato [properties.{propertyInternalName}]. Por ejemplo, para añadir la propiedad Test score, que tiene un valor interno de Test_score, lo escribirías en el editor como [properties.Test_score].

Al utilizar propiedades de enumeración en una ecuación (por ejemplo, selección desplegable, selección de radio), los valores se consideran cadenas, por lo que deben ir entre comillas dobles. Por ejemplo, "subscriber".

Operadores

Puedes utilizar operadores en tu ecuación para actualizar, evaluar o comparar constantes y valores de propiedades. Cuando se utilizan varios operadores, éstos siguen el orden de operaciones de PEMDAS. Dependiendo del tipo de datos que estés utilizando, puedes incluir los siguientes operadores en tus ecuaciones personalizadas.

Operador Descripción
+ Agrega números o cadenas. Devuelve un número.
- Restar números. Devuelve un número.
* Multiplicar números. Devuelve un número.
/ Dividir números. Devuelve un número.
< Comprueba si un valor es menor que otro. Compatible con propiedades numéricas o constantes. Devuelve un booleano.
> Comprueba si un valor es mayor que otro. Compatible con propiedades numéricas o constantes. Devuelve un booleano.
<= Comprueba si un valor es menor o igual que otro. Compatible con propiedades numéricas o constantes. Devuelve un booleano.
>= Comprueba si un valor es mayor o igual que otro. Compatible con propiedades numéricas o constantes. Devuelve un booleano.
! Comprueba si ninguno de los valores es verdadero. Devuelve un booleano.
= o == Comprueba si un valor es igual a otro. Compatible con números y cadenas. Devuelve un booleano.
!= Comprueba si un valor no es igual a otro. Compatible con números y cadenas. Devuelve un booleano.
or o || Comprueba si cualquiera de los dos valores es verdadero Devuelve un booleano.
and o && Comprueba si ambos valores son verdaderos. Devuelve un booleano.

Funciones

Puedes utilizar funciones dentro de fórmulas personalizadas para calcular valores y completar acciones con tus datos. Dependiendo del tipo de datos que utilices, puedes incluir las siguientes funciones en tus ecuaciones personalizadas.

Función Argumentos Ejemplos

abs

Obtén el valor absoluto de los números. Devuelve un número.

abs(number)

número: el número del que quieres obtener el valor absoluto.

abs(-100) = 100

concatenate

Combina hasta 100 cadenas en un solo valor. Devuelve una cadena.

concatenate("arg 1", "arg 2")

arg1: la cadena a la que se agregará arg2.

arg2: la cadena a agregar a arg 1.

concatenate("Example", " Test") = "Ejemplo de prueba"

contains

Filtra las cadenas que contengan una secuencia concreta de caracteres. Devuelve una cadena. 

contains(property, text)

propiedad: la propiedad cuyos valores quieres comprobar para el texto.

texto: la secuencia de caracteres que deben contener los valores.

contains([properties.name], "Spot")= HubSpot

currency_decimal_places

Obtener la cantidad de decimales de una moneda. Devuelve un número.

currency_decimal_places(currency)

currency: la cadena de texto de moneda para la que deseas calcular el número de lugares decimales.

currency_decimal_places("USD")

dated_exchange_rate

Obtener el valor de una tasa de cambio en un momento determinado. Devuelve un número. 

dated_exchange_rate(currency, date)

moneda: La cadena de texto de moneda para la que deseas calcular la tasa de cambio en una fecha específica (p. ej., "USD").

fecha: la propiedad de fecha y hora para la que deseas calcular la tasa de cambio.

dated_exchange_rate("USD", [properties.closedate])

exchange_rate

Obtener la tasa de cambio más reciente. Devuelve un número.

exchange_rate(currency)

currency: la cadena de texto de moneda para la que deseas calcular la tasa de cambio.

exchange_rate("USD")

if

Configurar una expresión condicional.

if(condition, arg2) o if(condition, arg2, arg3)

condition: la instrucción booleana que determina cuál será el valor calculado.

arg2: un valor numérico, booleano o de cadena que será el valor calculado si se cumple la condición. 

arg3 (opcional): el valor calculado si no se cumple la condición. Si se incluye, debe ser del mismo tipo que arg2. Si no se utiliza, el valor será null cuando no se cumpla la condición. 

if([properties.amount] > 1000, "large", "small")

 

is_known

Determina si hay un valor conocido para el token. Devuelve un booleano.

is_known(property)

property: la propiedad cuyo valor deseas verificar.

is_known([properties.name]) = verdadero

last_updated

Obtener la última fecha en la que se actualizó la ficha. Devuelve una marca de tiempo en milisegundos como cadena.

last_updated(property)

propiedad: la propiedad para la que deseas comprobar la fecha de actualización más reciente.

last_updated([properties.amount]) = "1672531200000"

lowercase

Cambiar todos los caracteres a minúscula. Devuelve una cadena.

lowercase(text)

texto: la cadena o propiedad de texto con valores que deseas cambiar a minúsculas.

lowercase("heLLo") = "hola"


lowercase([properties.test])

max

Obtener el máximo de dos números. Devuelve un número. 

max(arg1, arg2)

arg1: el primer número o propiedad de número.

arg2: el segundo número o propiedad de número.

max(500,[properties.amount]) = 500, si el valor de la cantidad es inferior a 500.

min

Obtener el mínimo de dos números. Devuelve un número.

min(arg1, arg2)

arg1: el primer número o propiedad de número.

arg2: el segundo número o propiedad de número.

min(500, 250) = 250

month

Obtener el número de mes de una fecha determinada. Devuelve un número.

month(date)

date: la propiedad de fecha y hora para la que deseas calcular el mes.

month([properties.closedate])

number_to_string

Convertir un número en una cadena. Devuelve una cadena.

number_to_string(number_to_convert)

number_to_convert: el número o propiedad de número que deseas cambiar a cadena de texto.

number_to_string(1000) = "1000"

pipeline_probability

Obtener la probabilidad de una etapa de pipeline. Devuelve un número.

pipeline_probability(pipeline)

pipeline: el nombre de la pipeline para el que deseas calcular la probabilidad.

pipeline_probability("newdeal")

power

Eleva un número al valor de otro número. Devuelve un número.

power(base, exponent)

base: el número de base.

exponente: el valor al que elevar la base.

power(5, 2) = 25

round_down

Redondear un número hacia abajo con una precisión especificada. Devuelve un número.

round_down(number_to_round, precision)

pipeline: el número o propiedad de número que deseas redondear hacia abajo.

pipeline: el número de lugares decimales a los que redondear hacia abajo.

round_down(4.353, 1) = 4.3

round_nearest

Redondear un número con una precisión especificada. Devuelve un número.

round_nearest(number_to_round, precision)

número_a_redondear: el número o la propiedad numérica cuyos valores quieres redondear.

precisión: el número de decimales al que redondear.

round_nearest(4.32, 1) = 4.3

round_up

Redondear un número hacia arriba con una precisión especificada. Devuelve un número.

round_up(number_to_round, precision)

number_to_round: el número o la propiedad numérica cuyos valores deseas redondear.

precision: el número de lugares decimales a los que redondear hacia arriba.

round_up(4.353, 1) = 4.4

sqrt

Obtén la raíz cuadrada de un número. Devuelve un número.

sqrt(number)

número: el número del que quieres obtener la raíz cuadrada.

sqrt(144) = 12

starts_with

Filtra las cadenas que empiecen por una secuencia concreta de caracteres. Devuelve una cadena.

starts_with(property, text)

propiedad: la propiedad cuyos valores quieres comprobar para los caracteres iniciales.

texto: la secuencia de caracteres con la que deben empezar los valores. 

starts_with([properties.name], "Hub") = HubSpot 

string_to_number

Convertir una cadena en un número. Devuelve un número.

string_to_number(string_to_convert)

string_to_convert: la cadena o propiedad de texto cuyos valores deseas convertir a un número.

string_to_number("1000") = 1000

time_between

Obtener la diferencia horaria entre dos fechas. Devuelve un número.

time_between(date1, date2)

date1: la propiedad de fecha y hora de inicio.

date2: la propiedad de fecha y hora de fin.

time_between([properties.createdate],[properties.closedate])

uppercase

Cambiar todos los caracteres a mayúscula. Devuelve un número.

uppercase(text)

text: la cadena de texto o propiedad de texto que deseas cambiar a mayúsculas.

uppercase("hello") = "HOLA"

year

Obtener el número del año de una fecha determinada. Devuelve un número.

year(date)

date: la propiedad de fecha y hora para la que deseas calcular el año.

year([properties.closedate])

Ejemplos

A continuación se presentan fórmulas de ejemplo basadas en casos de uso habituales.

  • Puedes configurar sentencias if else, incluyendo sentencias con múltiples condiciones y dentro de funciones:
    • if([properties.number] < 4, "less than four", "more than four")
    • if([properties.number] < 4, if([properties.other_number] < 2, "both true", "one true"), "not true")
    • concatenate(if([properties.number] < 4, "less", "more"), " than four")
  • Cuando utilices propiedades numéricas en una fórmula personalizada, puedes incluir las funciones if y is_known para establecer el valor en 0 cuando la propiedad numérica esté vacía. Por ejemplo, if(is_known([properties.number]), [properties.number], 0).
  • Cuando utilices una moneda de registro en una fórmula, para añadir un tipo de cambio, puedes incluir en tu ecuación las funciones exchange_rate o dated_exchange_rate . Por ejemplo, [properties.amount] * exchange_rate('CAD').
¿Te resultó útil este artículo?
Este formulario se utiliza solo para recibir comentarios a la documentación. Cómo recibir ayuda con HubSpot.