Ir para o conteúdo principal
Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa. O texto oficial é a versão em inglês e sempre será o texto mais atualizado. Para ver a versão em inglês, clique aqui.

Criar propriedades de cálculo

Ultima atualização: Setembro 26, 2023

Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:

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

As propriedades de cálculo no HubSpot permitem calcular automaticamente os valores mín., máx., contagem, soma ou média das propriedades nos registros associados ou definir equações personalizadas com base em outras propriedades. 

Por exemplo, você pode criar:

  • Uma propriedade de contato que calcula o valor médio dos negócios associados de um contato. 
  • Uma propriedade de empresa que calcula o custo para adquirir um novo cliente com base em uma equação personalizada.

Observação: dependendo da sua assinatura do HubSpot, haverá um limite para o número de propriedades de cálculo que você pode criar.

Criar propriedades de cálculo

As propriedades de cálculo podem ser configuradas com base em diferentes critérios, incluindo valores de propriedade de registros associados, o tempo entre os valores de duas propriedades ou suas próprias equações personalizadas. Para criar uma propriedade de cálculo:

  • Na sua conta da HubSpot, clique em settings ícone de configuração na barra de navegação principal.
  • No menu da barra lateral esquerda, vá para Propriedades.

  • Clique no menu suspenso Selecionar um objeto e selecione Propriedades do [objeto] para criar ou editar uma propriedade para ele.

  • Insira as informações básicas da sua propriedade e clique em Próximo.
  • Selecione Cálculo no Tipo de campo. Assim que a propriedade de Cálculo for criada, o tipo de campo não poderá ser editado.
  • Clique em Criar cálculo.
  • Clique no menu suspenso Tipo de propriedade calculada e selecione o tipo de fórmula que deseja criar:

Calcular valores com base nas propriedades dos registros associados

Você pode criar propriedades para um objeto que serão calculadas com base em determinados valores de propriedade dos registros associados desse objeto. Você pode calcular com base em todos os registros associados a esse objeto ou com base em rótulos de associação específicos, incluindo relações de empresa principal/secundária.

Por exemplo, você pode criar uma propriedade de negócio que conta o número total de atividades de vendas registradas para os contatos associados de um negócio que tenham o rótulo Tomador de decisão.

  • Clique no menu suspenso Tipo de propriedade calculada e selecione um dos seguintes tipos:
    • Mínimo: apresenta o valor mínimo da propriedade numérica selecionada nos registros associados do objeto selecionado.
    • Máximo: exibe o valor máximo para a propriedade numérica selecionada em todos os registros associados ao objeto selecionado.
    • Contagem: calcula o número total de registros associados ao objeto selecionado que contêm um valor para a propriedade numérica selecionada.
    • Soma: calcula a soma dos valores de uma propriedade numérica selecionada em todos os registros associados do objeto selecionado.
    • Média: calcula a média dos valores de uma propriedade numérica selecionada em todos os registros associados do objeto selecionado.
  • Para escolher como formatar valores de propriedade, clique no menu suspenso Formato de número e selecione entre os seguintes formatos: Número formatado, Número não formatado, Moeda, Porcentagem ou Duração.

Atenção: todas as propriedades de cálculo que utilizem Moeda como formato numérico utilizarão a moeda Empresa da sua conta

calculation-property-associated-record

  • Para adicionar mais uma condição, clique em Criar condição. Quando uma condição adicional está definida, ela deve ser cumprida para que a propriedade seja calculada (por exemplo, calcular a propriedade quando Valor do negócio recente > 1000).
    • No primeiro menu suspenso, selecione uma propriedade.
    • No segundo menu suspenso, selecione um operador que irá comparar o valor da primeira propriedade com um número ou com o valor de outra propriedade.
    • No terceiro menu suspenso, selecione uma propriedade ou insira um número que será comparado com a primeira propriedade.
  • Clique em Criar. Depois de criada, o tipo de campo exibido da propriedade será Acumulado.

Calcular valores com base no tempo entre duas propriedades

É possível criar propriedades que calculam o tempo entre as duas propriedades selecionadas no seletor de datas no mesmo objeto. Por exemplo, você pode calcular o tempo decorrido entre a atribuição do proprietário do ticket e o fechamento do ticket. Saiba mais sobre como os valores da propriedade de cálculo Tempo entre são exibidos.

  • Clique no menu suspenso Tipo de propriedade calculada e selecione Tempo entre.
  • Clique nos menus suspensos para selecionar as propriedades de Data de início e Data de término.

time-between-calculation-property

  • Para adicionar mais uma condição, clique em Criar condição. Quando uma condição adicional está definida, ela deve ser cumprida para que a propriedade seja calculada (por exemplo, calcular a propriedade quando Valor do negócio recente > 1000).
    • No primeiro menu suspenso, selecione uma propriedade.
    • No segundo menu suspenso, selecione um operador que irá comparar o valor da primeira propriedade com um número ou com o valor de outra propriedade.
    • No terceiro menu suspenso, selecione uma propriedade ou insira um número que será comparado com a primeira propriedade.
  • Clique em Criar. Depois de criada, o tipo de campo exibido da propriedade será Acumulado.

O comportamento a seguir é esperado ao exibir valores para o tempo entre as propriedades de cálculo:

  • O tempo será exibido de maneira diferente em ferramentas da HubSpot distintas.
  • Para propriedades de data sem um carimbo de data/hora, a hora predefinida utilizada no cálculo será 12h00 UTC para o dia selecionado.
  • Num registo de objecto (por exemplo, um registo de contacto ), o valor apresentado será em horas, dias, meses, ou anos, e será arredondado para cima para a unidade seguinte com base em limites específicos. Por exemplo, se o tempo calculado for de um mês e vinte dias, o valor exibido será Um mês; mas se o tempo calculado for um mês e vinte e sete dias, o valor exibido será Dois meses. Os limites são:
    • 45 segundos ou mais é arredondado para um minuto
    • 45 minutos ou mais é arredondado para uma hora
    • 22 horas ou mais é arredondado para um dia
    • 26 dias ou mais é arredondado para um mês
    • 11 meses ou mais é arredondado para um ano
  • Nos relatórios personalizados que usam uma propriedade com esse tipo de campo, o valor exibido estará em dias. Por exemplo, se o tempo calculado for de um ano e vinte dias, o valor exibido será de 385 dias.

Observação: no HubSpot, o valor bruto dos tipos de propriedade Tempo entre e Médica é armazenado em milissegundos. Se uma equação com esses valores produzir um valor maior do que o esperado, use um conversor de milissegundos para converter para a unidade de tempo desejada.

Calcular valores com base no arredondamento de valores de propriedade

Você pode criar propriedades de cálculo que especificam como arredondar valores numéricos de outras propriedades. Por exemplo, você pode criar uma propriedade de cálculo que arredonda uma propriedade de comissão para as duas casas decimais mais próximas.

  • Clique no menu suspenso Tipo de propriedade calculada e selecione uma opção de arredondamento:
    • Arredondar para baixo apenas: sempre arredondar os valores para baixo até o número especificado de casas decimais. 
    • Arredondar para cima apenas: sempre arredondar os valores para cima até o número especificado de casas decimais.
    • Arredondar para o mais próximo: arredondar os valores até o número especificado de casas decimais com base na proximidade.
  • Para escolher como formatar valores de propriedade, clique no menu suspenso Formato de número e selecione entre os seguintes formatos: Número formatado, Número não formatado, Moeda, Porcentagem ou Duração.
  • Clique no menu suspenso Escolha a propriedade do registro e selecione a propriedade com os valores que deseja arredondar. Você pode selecionar qualquer propriedade de pontuação, cálculo ou número dentro desse objeto.
  • Na caixa de texto Casas decimais para arredondar, insira o número de casas decimais para as quais você deseja arredondar os valores.

Observação: para propriedades de moeda, esse recurso arredondará o valor de acordo com a precisão definida, mas ainda exibirá o valor como uma moeda com a quantidade correta de dígitos.

rounding-calculation-property

  • Para adicionar mais uma condição, clique em Criar condição. Quando uma condição adicional está definida, ela deve ser cumprida para que a propriedade seja calculada (por exemplo, calcular a propriedade quando Valor do negócio recente > 1000).
    • No primeiro menu suspenso, selecione uma propriedade.
    • No segundo menu suspenso, selecione um operador que irá comparar o valor da primeira propriedade com um número ou com o valor de outra propriedade.
    • No terceiro menu suspenso, selecione uma propriedade ou insira um número que será comparado com a primeira propriedade.
  • Clique em Criar. Depois de criada, o tipo de campo exibido da propriedade será Cálculo.

Calcular valores com base em uma equação personalizada

Você também pode criar propriedades que calculam valores com base em seus próprios critérios. As equações personalizadas somente podem ser configuradas para propriedades numéricas dentro do mesmo objeto para o qual você está criando a nova propriedade. Por exemplo, você pode criar uma equação para calcular o valor do negócio mais recente de uma empresa (Valor do negócio mais recente) em relação a quantas vezes você entrou em contato com a empresa (Número de contatos efetuados).

Para criar sua equação, você pode usar os menus suspensos de opções predefinidas ou usar o editor no modo avançado para escrever equações usando operadores aritméticos, operadores de comparação, operadores lógicos, instruções condicionais e outras funções. Saiba mais sobre os operadores e funções disponíveis e como formatar suas fórmulas.

  • Clique no menu suspenso Tipo de propriedade calculada e selecione Equação personalizada.
  • Para criar uma equação com as opções do menu suspenso:
    • Clique no menu suspenso Formato de número e selecione como formatar os valores da propriedade. Você pode selecionar uma das seguintes opções: Número formatado, Número não formatado, Moeda, Porcentagem ou Duração.
    • Clique em um menu suspenso para selecionar uma propriedade numérica ou digite um número e clique na opção Constante: [valor inserido] para incluir um número inteiro constante na equação.
    • Clique no menu suspenso função para adicionar (+), subtrair (-), multiplicar (*) ou dividir (/).
    • Para adicionar outra função à equação, clique em Adicionar à equação. Você também pode adicionar funções a uma parte da equação, clicando em Expandir entre parênteses.

dropdown-menu-custom-equations

  • Para criar uma equação no editor do modo avançado:
    • Clique para ativar o modo avançado.

advanced-mode-switch

    • Clique no menu suspenso Tipo de saída e selecione o tipo de saída que seu cálculo retornará. Você pode selecionar uma das seguintes opções: Número, Booleano, String ou Date
    • Se você selecionou o tipo de saída Número, clique no menu suspenso Formato de número e selecione como formatar os valores da propriedade. Você pode selecionar uma das seguintes opções: Número formatado, Número não formatado, Moeda, Porcentagem ou Duração.
    • No editor, insira, digite ou cole funções e propriedades para criar sua equação personalizada. Saiba mais sobre a sintaxe da equação de cálculo personalizada. Para inserir elementos de fórmula:
      • Clique no menu suspenso Inserir.
      • Para inserir funções na equação, selecione Funções e selecione uma função.
      • Para inserir propriedades na equação, selecione Propriedades e selecione uma propriedade. Você somente pode criar equações personalizadas usando as propriedades do mesmo objeto para o qual está criando a propriedade.

example-advanced-calculation-equation

    • Se a sua equação tiver erros, clique em [x] problemas acima do editor para visualizar os motivos dos erros. Você não poderá criar a propriedade se a equação tiver erros não resolvidos. Saiba mais sobre como formatar suas equações.

Observação: se alguma das propriedades numéricas usadas em uma equação personalizada não contiver um valor, ou tiver um valor nulo, o cálculo não será executado e o valor da propriedade ficará em branco. O valor ficará em branco, mesmo se um número constante estiver incluído na equação.

  • Para adicionar mais uma condição, clique em Criar condição. Quando uma condição adicional está definida, ela deve ser cumprida para que a propriedade seja calculada (por exemplo, calcular a propriedade quando Valor do negócio recente > 1000).
    • No primeiro menu suspenso, selecione uma propriedade.
    • No segundo menu suspenso, selecione um operador que irá comparar o valor da primeira propriedade com um número ou com o valor de outra propriedade.
    • No terceiro menu suspenso, selecione uma propriedade ou insira um número que será comparado com a primeira propriedade.
  • Clique em Criar. Depois de criada, o tipo de campo exibido da propriedade será Cálculo.

Sintaxe de equação personalizada

No modo avançado, você pode criar suas próprias equações personalizadas usando dados literais, dados de outras propriedades, operadores e funções. Abaixo, saiba sobre a sintaxe para escrever equações de cálculo personalizadas.

Sintaxe literal

Usando dados literais, você pode adicionar strings de texto, números e valores verdadeiros ou falsos às suas equações. Você pode formatar strings, números e constantes booleanas das seguintes maneiras:

  • String literal: texto entre aspas. Eles podem ser representados com aspas simples ('constant') ou aspas duplas ("constant").

  • Número literal: números sem aspas. Os números das constantes podem ser quaisquer números reais e podem incluir notação de ponto. Por exemplo, 1005 e1.5589 são constantes numéricas válidas.

  • Literal de booleano: booleanos de constantes podem ser true ou false.

Sintaxe de propriedade

Você pode incluir outras propriedades do mesmo objeto na equação personalizada. Se uma propriedade for inserida no editor, ela será formatada e validada automaticamente como parte de uma equação.

Se você escolher digitar ou colar manualmente uma propriedade no editor, ela deverá ser formatada como [properties.{propertyInternalName}]. Por exemplo, para adicionar a propriedade Test score, que tem um valor interno igual a Test_score, você a digitaria [properties.Test_score] no editor.

Operadores

Você pode usar operadores em sua equação para atualizar, avaliar ou comparar constantes e valores de propriedade. Ao usar vários operadores, eles seguem a ordem de operações PEMDAS. Dependendo do tipo de dados em uso, você poderá incluir os operadores a seguir nas suas equações personalizadas.

Operador Descrição
+ Some números ou strings. Retorna um número.
- Subtraia números. Retorna um número.
* Multiplique números. Retorna um número.
/ Divida números. Retorna um número.
< Verifica se um valor é menor que outro. Compatível com propriedades numéricas ou constantes. Retorna um booleano.
> Verifica se um valor é maior que outro. Compatível com propriedades numéricas ou constantes. Retorna um booleano.
<= Verifica se um valor é menor ou igual a outro. Compatível com propriedades numéricas ou constantes. Retorna um booleano.
>= Verifica se um valor é maior ou igual a outro. Compatível com propriedades numéricas ou constantes. Retorna um booleano.
! Verifica se nenhum dos valores é verdadeiro. Retorna um booleano.
= ou == Verifica se um valor é igual a outro. Compatível com números e strings. Retorna um booleano.
!= Verifica se um valor não é igual a outro. Compatível com números e strings. Retorna um booleano.
or ou || Verifica se dois valores são verdadeiros. Retorna um booleano.
and ou && Verifica se os valores são verdadeiros. Retorna um booleano.

Funções

Você pode usar funções dentro de fórmulas personalizadas para calcular valores e executar ações com seus dados. Dependendo do tipo de dados em uso, você poderá incluir as funções a seguir nas suas equações personalizadas.

Função Argumentos Exemplos

concat

Combine strings em um valor. Retorna uma string.

concat("arg 1", "arg 2")

arg1: a string à qual o arg2 será anexado.

arg2: a string a ser anexada ao arg 1.

concat("Test", " example") = "Exemplo de teste"

currency_decimal_places

Obtenha o número de casas decimais de uma moeda. Retorna um número.

currency_decimal_places(currency)

currency: a string de moeda para a qual você deseja calcular o número de casas decimais.

currency_decimal_places("USD")

dated_exchange_rate

Obtenha o valor de uma taxa de câmbio em um determinado momento. Retorna um número. 

dated_exchange_rate(currency, date)

currency: a string de moeda para a qual você deseja calcular a taxa de câmbio em uma data específica (por exemplo, "USD").

date: a propriedade de data e hora para a qual você deseja calcular a taxa de câmbio.

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

exchange_rate

Obtenha a taxa de câmbio mais recente. Retorna um número.

exchange_rate(currency)

currency: a string de moeda para a qual você deseja calcular a taxa de câmbio.

exchange_rate("USD")

if

Configure uma expressão condicional.

if(condition, arg2) ou if(condition, arg2, arg3)

condition: a declaração booleana que determina qual será o valor calculado.

currency: um booleano, número ou string que será calculado se a condição for atendida. 

arg3 (opcional): o valor calculado se a condição não for atendida. Se incluído, deve ter o mesmo tipo quearg2. Se não for usado, o valor será null quando a condição não for atendida. 

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

 

is_present

Determine se um valor está presente para o token. Retorna um booleano.

is_present(property)

property: a propriedade cujo valor você deseja verificar.

is_present([properties.name]) = verdadeiro

last_updated

Obtenha a data de quando o token foi atualizado pela última vez. Retorna a data/hora em milissegundos como uma string.

last_updated(property)

property: a propriedade para a qual você deseja verificar a data de atualização mais recente.

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

lowercase

Altere todos os caracteres para minúsculas. Retorna uma string.

lowercase(text)

text: a propriedade de string ou texto que contém os valores que você deseja alterar para minúsculas.

lowercase("heLLo") = "olá"


lowercase([properties.test])

max

Obtenha o máximo de dois números. Retorna um número. 

max(arg1, arg2)

arg1: o primeiro número ou propriedade de número.

arg2: o segundo número ou propriedade de número.

max(500,[properties.amount]) = 500, se o valor for menor que 500.

min

Obtenha o mínimo de dois números. Retorna um número.

min(arg1, arg2)

arg1: o primeiro número ou propriedade de número.

arg2: o segundo número ou propriedade de número.

min(500, 250) = 250

month

Obtenha o número do mês de uma determinada data. Retorna um número.

month(date)

date: a propriedade de data e hora para a qual você deseja calcular o mês.

month([properties.closedate])

number_to_string

Converta um número em uma string. Retorna uma string.

number_to_string(number_to_convert)

number_to_convert: o número ou a propriedade de número que você deseja alterar para uma string.

number_to_string(1000) = "1.000"

pipeline_probability

Obtenha a probabilidade de uma fase de pipeline. Retorna um número.

pipeline_probability(pipeline)

pipeline: o nome do pipeline para o qual você deseja calcular a probabilidade.

pipeline_probability("newdeal")

round_down

Arredonde um número para baixo com uma determinada precisão. Retorna um número.

round_down(number_to_round, precision)

number_to_round: o número ou a propriedade de número que você deseja arredondar para baixo.

precision: o número de casas decimais para arredondar para baixo.

round_down(4.353, 1) = 4,3

round_nearest

Arredonde um número com uma determinada precisão. Retorna um número.

round_nearest(number_to_round)

number_to_round: o número ou a propriedade de número cujos valores você deseja arredondar para o número inteiro mais próximo.

round_nearest(4,353) = 4

round_up

Arredonde um número para cima com uma determinada precisão. Retorna um número.

round_up(number_to_round, precision)

number_to_round: o número ou a propriedade de número cujos valores você deseja arredondar.

precision: o número de casas decimais para arredondar para cima.

round_up(4.353, 1) = 4,4

string_to_number

Converta uma string em um número. Retorna um número.

string_to_number(string_to_convert)

string_to_convert: a propriedade de string ou texto cujos valores você deseja converter em um número.

string_to_number("1000") = 1.000

time_between

Obtenha a diferença de tempo entre duas datas. Retorna um número.

time_between(date1, date2)

date1: a propriedade de data e hora de início.

date2: a propriedade de data e hora de término.

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

uppercase

Altere todos os caracteres para maiúsculas. Retorna um número.

uppercase(text)

text: a string ou propriedade de texto que você deseja alterar para maiúsculas.

uppercase("hello") = "OLÁ"

year

Obtenha o número do ano de uma determinada data. Retorna um número.

year(date)

date: a propriedade de data e hora para a qual você deseja calcular o ano.

year([properties.closedate])

 

Esse artigo foi útil?
Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot.