Criar propriedades 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. 

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.

Dependendo de sua assinatura do HubSpot, há um limite para o número de propriedades de cálculo que você pode criar.

Criar propriedades de acúmulo com base em propriedades de 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 daquele objeto ou para rótulos de associação , incluindo as mesmas associações de objetos.

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.

• 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 os detalhes básicos da sua propriedade e clique na guia Tipo de campo .
• Selecione Totalização .
• 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.
• 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.
• 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 Use a moeda do registro em vez da moeda da empresa. O uso de uma moeda de registro afeta apenas a forma como o valor é exibido e não aplicará automaticamente uma taxa de câmbio.

• Selecione o objeto associado e a propriedade de registro associada com base nos quais calcular a propriedade. 
• 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.
• 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.

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 tempo entre propriedades de cálculo

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

Se você está tentando criar uma propriedade com base na data de hoje, saiba mais sobre como usar tempo relativo em propriedades e filtros.

• 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 os detalhes básicos da sua propriedade e clique na guia Tipo de campo .
• Selecione Cálculo como o tipo de campo.
• Clique no menu suspenso Tipo de propriedade calculado e selecione Tempo entre.
• Clique nos menus suspensos para selecionar as propriedades de Data de início e Data de término.

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

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.
• Em um registro (por exemplo, um registro de contato), o valor exibido será em horas, dias, meses, ou anos e será arredondado acima para a próxima unidade com base em limites específicos. Por exemplo, se o tempo calculado for 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.

Criar propriedades de cálculo de tempo decorrido ou tempo decorrido

Para rastrear o valor do tempo desde ou até uma data, você pode criar um tempo desde ou até a propriedades de cálculo. Por exemplo, você pode criar um Tempo desde a abertura da propriedade para rastrear por quanto tempo um negócio está aberto ou um Tempo até a propriedade fechar para rastrear o quão longe de hoje um cliente está definido para fechar.

Um tempo desde ou até que o valor da propriedades de cálculo seja calculado com base no valor de uma propriedade selecionadora de data ou selecionadora de data e hora. Para criar uma propriedade cujos valores exibam o tempo relativo com base na data de hoje, aprenda como criar uma propriedade selecionadora de data/data e hora relativa. Saiba mais sobre como usar a data e a hora relativa de hoje no HubSpot.

Para criar um horário desde ou até a propriedades de cálculo:

• 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 os detalhes básicos da sua propriedade e clique na guia Tipo de campo .
• Selecione Cálculo como o tipo de campo.
• Clique no menu suspenso Tipo de propriedade Calculado e selecione Tempo desde ou Tempo até.
  
  • Para Hora desde, selecione a propriedade selecionadora de data/data e hora cujo valor será a data de início. A data final será sempre a data de hoje.
  • Para Hora até, selecione a propriedade selecionadora de data/data e hora cujo valor será a data de término. A data de início será sempre a data de hoje.

• Clique em Criar. Uma vez salvo, você não pode editar se é Hora desde ou Tempo até, mas você pode selecionar uma propriedade de data de início ou de término diferente.

Depois de criar uma Hora desde ou Hora até à propriedade, aprenda a visualizar a propriedade e usá-la em filters.

Criar propriedades de cálculo de equação 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 construir sua equação personalizada com operadores aritméticos, operadores de comparação, operadores lógicos, instruções condicionais e outras funções. Essas equações podem retornar valores numéricos, booleanos, strings ou datas. Saiba mais sobre operadores, funções e disponíveis , e como personalizar 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:

• 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 os detalhes básicos da sua propriedade e clique na guia Tipo de campo .
• Selecione Cálculo como o tipo de campo.
• Clique no menu suspenso Tipo de propriedade calculada e selecione Equação personalizada.
• 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.

Observação: o tipo de saída selecionado deve corresponder ao tipo de saída mostrado no canto superior direito do editor ou você não poderá 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).

• 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 formato numérico para uma propriedade de negócio, a propriedade usará o nome da sua conta Empresa moeda por padrão. Para usar a moeda de cada registro de negócio, marque a caixa de seleção Use a moeda do registro em vez da moeda da empresa.

Observação: o uso de uma moeda de registro afeta apenas a forma como o valor é exibido e não aplicará automaticamente uma taxa de câmbio. Para adicionar uma taxa de câmbio, você pode incluir a função exchange_rate ou dated_exchange_rate na sua equaçã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.

• 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.
• Para visualizar a saída da fórmula, clique em Testar fórmula.

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. Nesse caso, você pode usar as funções if e is_known para definir o valor como 0.

• Clique em Criar. Depois de criada, o tipo de campo exibido da propriedade será Cálculo.

Sintaxe de equação personalizada

• Sincronização 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, 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 da Propriedade : Você pode incluir outras propriedades do mesmo objeto em sua equação personalizada.
  • Se uma propriedade for inserida no editor, ela será automaticamente formatada e validada como parte de uma equação.
  • Se você optar por 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").

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.

Exemplos

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

• Você pode configurar instruções if else, incluindo instruções com várias condições e dentro de funções:
  • 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")
• 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. Por exemplo, if(is_known([properties.number]), [properties.number], 0).
• 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').