Criar propriedades cumulativas e de cálculo

Você pode criar propriedades que preencham dados com base em cálculos de outras propriedades. Você também pode calcular automaticamente os valores mínimo, máximo, contagem, soma ou média das propriedades nos registros associados. Com as propriedades de cálculo, você pode configurar equações com base no tempo entre, até ou desde um valor de propriedade, ou criar equações personalizadas com base nas propriedades de um objeto. 

Observação: sua conta pode usar nomes personalizados para cada objeto (por exemplo, conta em vez de empresa). Este documento se refere aos objetos por seus nomes padrão de HubSpot.

Por exemplo, você pode criar:

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

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 acúmulo com base nas propriedades de registros associados

Você pode criar propriedades para um objeto que será calculado com base em determinados valores de propriedade dos registros associados desse objeto. Você pode calcular com base em todos os registros associados desse objeto ou para rótulos de associações específicos, incluindo as mesmas associações de objeto.

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.

1. Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.

2. No menu da barra lateral esquerda, vá para Propriedades.

3. Clique no menu suspenso Selecionar um objeto e selecione [Objeto] propriedades para criar uma propriedade para esse objeto.

4. Insira os detalhes básicos da sua propriedade e clique na guia Tipo de campo .
5. Clique no menu suspenso Tipo de campo e selecione Totalização.
6. Clique no menu suspenso Tipo de acúmulo 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.
7. 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.
8. Se você selecionar Moeda como o formato de uma propriedade de negócio, a propriedade usará a moedada Empresa da sua conta por padrão. Para usar a moeda de cada registro de negócio, marque a caixa de seleção Usar moeda de registro em vez da moeda da empresa . O uso de uma moeda de registro afeta apenas a exibição do valor e não aplicará automaticamente uma taxa de câmbio.
9. Selecione o objeto associado e a propriedade de registro associada com base nos quais calcular a propriedade. 
10. Para calcular com base apenas em registros com um rótulo específico, clique em Selecionar rótulos de associação e, em seguida, selecione os rótulos que deseja incluir.
11. Para adicionar condições adicionais, clique em Adicionar condição. Quando são estabelecidas condições adicionais, essas condições devem ser cumpridas para que a propriedade seja calculada (por exemplo, calcular a propriedade quando valor do negócio recente > 1000 e probabilidade de Negócio >= 800). Você pode configurar até 50 condições por propriedade de rollup.
    • 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 Salvar.
12. Clique em Criar. Depois de criada, o tipo de campo exibido da propriedade será Acumulado.

Observação: os valores de duração brutos são armazenados em milissegundos. Se você estiver usando uma propriedade de cálculo de duração em outras ferramentas da HubSpot (por exemplo, filtros, fórmulas de propriedade de cálculo), talvez seja necessário usar valores em milissegundos.

Criar propriedades de cálculo de tempo desde ou tempo até

Você pode criar propriedades que calculam o tempo entre duas datas ou que controlam o valor de tempo desde ou até uma data, determinado pelos valores das propriedades do seletor de data ou data e hora. As propriedades de Tempo entre somente podem ser usadas com propriedades de um mesmo objeto.

Por exemplo:

• Crie uma propriedade de Tempo entre para calcular o tempo entre quando o proprietário de um ticket foi atribuído e quando o ticket foi fechado.
• Crie uma propriedade de Tempo desde a abertura para acompanhar por quanto tempo um negócio está aberto.
• Crie uma propriedade de Tempo até o fechamento para acompanhar até quando um cliente está definido para fechar.

Para criar uma propriedade cujos valores exibam o tempo relativo com base na data de hoje em vez de um valor de propriedade, saiba como criar uma propriedade de seletor de data/data e hora relativa. Você também pode criar uma propriedade de tempo fixo usando uma equação personalizada.

Para criar propriedades de cálculo de Tempo entre, Tempo desde ou Tempo até:

1. Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.

2. No menu da barra lateral esquerda, vá para Propriedades.

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

4. Insira os detalhes básicos da sua propriedade e clique na guia Tipo de campo .
5. Clique no menu suspenso Tipo de campo e selecione Cálculo.
6. Clique no menu suspenso Tipo de propriedade de cálculo, selecione o tipo e configure o cálculo:
   • Tempo entre: selecione as propriedades de Data de início e a Data de término.
   • Tempo desde: selecione a propriedade de seletor de data/data e hora cujo valor será a data de início. A data final será sempre a data de hoje.
   • Tempo até: selecione a propriedade de seletor de data/data e hora cujo valor será a data de término. A data de início será sempre a data de hoje.
7. Para Tempo entre propriedades apenas, para adicionar uma condição adicional, clique em Adicionar condição. Quando são estabelecidas condições adicionais, essas condições devem ser cumpridas para que a propriedade seja calculada (por exemplo, calcular a propriedade quando valor do negócio recente > 1000 e probabilidade de Negócio >= 800).
   • 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 Salvar.
8. Clique em Criar. Depois de criada, o tipo de campo exibido da propriedade será Cálculo. Você não poderá editar se é Tempo entre, Tempo desde ou Tempo até, mas poderá selecionar diferentes propriedades de data de início ou término.

O seguinte comportamento é esperado ao exibir valores de duração:

• Para propriedades de data sem um carimbo de data/hora, a hora predefinida utilizada no cálculo será 12h00 UTC para o dia selecionado.
• O valor exibido será em segundos, minutos, horas, dias, meses ou anos com base em limites específicos. Os limites para as unidades são:
  • 2,5 anos ou mais serão exibidos em anos.
  • 3 meses ou mais serão exibidos em meses.
  • 1 dia ou mais será exibido em dias.
  • 2,5 horas ou mais serão exibidas em horas.
  • 2,5 minutos ou mais serão exibidos em minutos.
  • Menos de 2,5 minutos serão exibidos em segundos.

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.

Criar propriedades de cálculo com equações personalizadas

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).

Você pode criar sua equação personalizada usando operadores aritméticos, operadores de comparação, operadores lógicos, instruções condicionais e outras funções. Essas equações podem retornar valores number, boolean, string, date ou datetime. Saiba mais sobre os operadores, funções e como formatar suas fórmulas. Você também pode revisar exemplos de fórmulas usadas com frequência.

Para criar uma propriedade de cálculo de equação personalizada:

1. Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.

2. No menu da barra lateral esquerda, vá para Propriedades.

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

4. Insira os detalhes básicos da sua propriedade e clique na guia Tipo de campo .
5. Clique no menu suspenso Tipo de campo e selecione Cálculo.
6. Clique no menu suspenso Tipo de propriedade calculada e selecione Equação personalizada.
7. Clique no menu suspenso Tipo de saída e selecione o tipo de saída que seu cálculo retornará. Você pode selecionar um dos seguintes: Número, Booleano, String, String ,

Observe: o tipo de saída selecionado deve corresponder ao tipo de saída mostrado no canto superior direito do editor ou você não pode criar a propriedade. Para propriedades que retornam uma data, você pode usar o tipo de saída de número ou data que determina como os valores são exibidos (ou seja, "número" exibe a data em milissegundos; "data" exibe a data formatada).

8. 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.
   • Se você selecionar Moeda como o formato de número para uma propriedade de negócio, a propriedade usará a moeda da Empresa da sua conta por padrão . Para usar a moeda de cada registro de negócio, marque a caixa de seleção Usar moeda de registro em vez da moeda da empresa .

9. 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 . Só é possível criar equações personalizadas usando propriedades do mesmo objeto para o qual você está criando a propriedade.
10. 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.
11. Para visualizar a saída da fórmula, clique em Testar fórmula.
12. Clique em Criar. Depois de criada, o tipo de campo exibido da propriedade será Cálculo.

Observe: você pode aninhar até 70 parênteses abertos em sua fórmula de cálculo (por exemplo, (((1+2)+3)+4) resulta em uma contagem de ninho de 4).

Criar propriedades de cálculo personalizadas com AI

1. Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.

2. No menu da barra lateral esquerda, vá para Propriedades.

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

4. Insira os detalhes básicos da propriedade e clique na guia Tipo de campo.
5. Clique no menu suspenso Tipo de campo e selecione Cálculo.
6. Abaixo do campo de texto da fórmula, clique em Gerar fórmula.
7. Na caixa pop-up:
   • Passe o mouse sobre o link Exemplos para exibir os prompts recomendados.
   • No campo de texto O que você deseja que esta propriedade calcule para você? , digite um prompt.
   • Clique em Gerar.
8. Revise a fórmula gerada e faça alterações, se necessário.
9. Clique no menu suspenso Tipo de saída e selecione o tipo que corresponde ao valor exibido no campo de texto da fórmula (por exemplo, string).
10. Para visualizar a saída da fórmula, clique em Testar fórmula.
11. Clique em Criar.

Sintaxe de equação personalizada

• Sintaxe literal: usando dados literais, você pode adicionar strings de texto, números e valores true ou false às suas equações. Você pode formatar strings, números, booleanos e constantes de data 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.

  • Literal de data: uma data em milissegundos. Por exemplo, 1698508800000.
• 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 pontuação Test da propriedade , que tem um valor interno de ? [properties.Test_score].
  • Ao usar propriedades de enumeração em uma equação (por exemplo, seleção suspensa, seleção de opção), os valores são considerados strings, portanto devem ser dispostos entre aspas duplas ("por exemplo, "subscriber") e yVocê também deve usar o nome interno das opções de propriedade (por exemplo, "appointmentscheduled").
  • Ao usar as propriedades de data em uma equação, os valores são armazenados como UTC midnight em milissegundos.
  • Ao usar as propriedades de data e hora em uma equação, os valores são armazenados como época UTC em milissegundos. Esse valor é exibido com base no seu fuso horário. Isso significa que usuários em fusos horários diferentes verão valores diferentes.

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.

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.

Revisar exemplos de equações personalizadas

Veja exemplos de fórmulas baseadas em casos de uso comuns.

Usar instruções if else

Você pode configurar instruções if else, incluindo instruções com várias condições e dentro de funções.

Por exemplo, você pode criar um cálculo para rotular negociações ativas. Os itens a seguir retornarão Verdadeiro somente se o status de um negócio for ativo e o Valor for maior que zero.

• if([properties.amount] < 0 && [properties.dealstage] == "qualifiedtobuy", "True", "False")

Executar cálculos de valor nulo 

Ao usar propriedades de número em uma fórmula personalizada, você pode incluir as funções if e is_known para definir o valor como 0 quando a propriedade estiver vazia. Dessa forma, o cálculo é executado independentemente da propriedade que contém um valor nulo. Por exemplo:

•  if(is_known([properties.number]), [properties.number], 0).
  
  

Anexar taxa de câmbio a um cálculo de moeda

Para adicionar uma taxa de câmbio, você pode incluir a função exchange_rate ou dated_exchange_rate na sua equação. Por exemplo:

• [properties.amount] * exchange_rate('CAD').

Criar um cálculo de tempo fixo 

Você pode configurar um cálculo para obter o tempo fixo entre duas datas. Por padrão, o valor bruto é retornado em milissegundos. Você pode usar a divisão e a round_nearest função para formatar em horas, dias, etc. e eliminar decimais no valor final. Por exemplo, o seguinte retornará um valor de dia fixo:

• round_nearest((((((([properties.closedate]-[properties.createdate]) / 1000) / 60) ) /60) /24), 0).

Observe: é recomendável especificar o nome e a descrição da propriedade. Dessa forma, os usuários estão cientes do tempo sendo calculado (por exemplo, horas ou dias).

Calcular descontos de negócio como uma porcentagem

Ao usar itens de linha em suas ofertas, você pode usar uma totalização e uma propriedade de cálculo para rastrear o desconto total como uma porcentagem. A propriedade de totalização soma o Desconto Total Calculado da propriedade de item de linha para todos os itens de linha associados. A propriedade de cálculo divide a propriedade acumulada sozinha mais a propriedade de Valor de negócio padrão.

Para criar a propriedade de totalização:

1. Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.

2. No menu da barra lateral esquerda, vá para Propriedades.

3. Clique no menu suspenso Selecionar um objeto e selecione Propriedades da negociação.

4. Clique em Criar propriedade e selecione Criar manualmente.

5. No campo de texto rótulo de Propriedade , informe valor de desconto calculado.
6. Insira os outros detalhes básicos da propriedade .
7. Clique na guia Tipo de campo .
8. Clique no menu suspenso Tipo de campo e selecione Totalização.
9. Clique no menu suspenso Tipo de acúmulo e selecione Soma.
10. Clique no menu suspenso Formato de número e selecione Moeda.
11. Clique no menu suspenso Escolher o tipo de registro associado e selecione Item de linha .
12. Clique no menu suspenso Escolher a propriedade de registro associada e selecione Desconto Total Calculado.
13. Na parte superior direita, clique em Criar.

Para criar a propriedade de cálculo:

1. Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.

2. No menu da barra lateral esquerda, vá para Propriedades.

3. Clique no menu suspenso Selecionar um objeto e selecione Propriedades da negociação.

4. Clique em Criar propriedade e selecione Criar manualmente.

5. No campo de texto rótulo de Propriedade , digite Porcentagem de desconto calculada. 
6. Insira os outros detalhes básicos da propriedade .
7. Clique na guia Tipo de campo .
8. Clique no menu suspenso Tipo de campo e selecione Cálculo.
9. Clique no menu suspenso Formato de número e selecione Porcentagem.
10. No campo de texto de fórmula de cálculo, informe (Calculated discount amount / (Calculated discount amount + Amount)). Você também pode clicar em Gerar fórmula para usar o Breeze para gerá-la.
11. No canto superior direito, clique em Criar.