Salta al contenuto
Nota bene: la traduzione in italiano di questo articolo è fornita solo per comodità. La traduzione viene creata automaticamente tramite un software di traduzione e potrebbe non essere stata revisionata. Pertanto, la versione inglese di questo articolo deve essere considerata come la versione di governo contenente le informazioni più recenti. È possibile accedervi qui.

Creare proprietà di calcolo

Ultimo aggiornamento: ottobre 30, 2024

Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:

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

È possibile creare proprietà che popolano i dati in base ai calcoli di altre proprietà. Con le proprietà di calcolo, è possibile impostare equazioni personalizzate basate su altre proprietà. Con le proprietà di rollup, è possibile calcolare automaticamente i valori minimi, massimi, di conteggio, di somma o di media per le proprietà sui record associati.

Ad esempio, è possibile creare:

  • Una proprietà aziendale che calcola il costo di acquisizione di un nuovo cliente in base a un'equazione personalizzata.
  • Una proprietà del contatto che calcola l'Importo medio delle offerte associate a un contatto.

Attenzione: a seconda dell'abbonamento a HubSpot, esiste un limite al numero di proprietà di calcolo che è possibile creare.

Creare proprietà di calcolo

Le proprietà di calcolo possono essere impostate in base a diversi criteri, tra cui i valori delle proprietà dei record associati, l'intervallo di tempo tra i valori di due proprietà o le equazioni personalizzate. Per creare una proprietà di calcolo o rollup:

  • Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.
  • Nel menu della barra laterale sinistra, spostarsi su Proprietà.

  • Fare clic sul menu a discesa Seleziona un oggetto , quindi selezionare Proprietà [Oggetto] per creare una proprietà per quell'oggetto.

  • Inserire i dettagli di base della proprietà, quindi fare clic sullascheda Tipo di campo .
  • Per creare un'equazione personalizzata o a tempo intermedio, selezionare Calcolo come tipo di campo. Fare clic sul menu a discesa Tipo di proprietà calcolata e selezionare il tipo di formula che si desidera creare:
  • Per creare una proprietà che calcola il minimo, il massimo, il conteggio, la somma o la media, selezionare Arrotolamento. Fare clic sul menu a discesa Tipo di rollup e selezionare il tipo di formula che si desidera creare. Per saperne di più sulla creazione di questi tipi di proprietà.

Calcolo dei valori in base alle proprietà dei record associati

È possibile creare proprietà per un oggetto che verranno calcolate in base a determinati valori di proprietà dei record associati all'oggetto. È possibile calcolare in base a tutti i record associati di quell'oggetto o per specifiche etichette di associazione, comprese le associazioni dello stesso oggetto.

Ad esempio, è possibile creare una proprietà di un affare che conta il numero totale di attività di vendita registrate per i contatti associati a un affare con l'etichetta Decision maker .

  • Fare clic sul menu a discesa Tipo di rollup e selezionare uno dei seguenti tipi:
    • Min: visualizza il valore minimo della proprietà numero selezionata sui record associati dell'oggetto selezionato.
    • Max: visualizza il valore massimo della proprietà numero selezionata su tutti i record associati all'oggetto selezionato.
    • Conta: conta il numero totale di record associati all'oggetto selezionato che hanno un valore per la proprietà number selezionata.
    • Somma: somma i valori della proprietà number selezionati in tutti i record associati dell'oggetto selezionato.
    • Media: calcola la media dei valori della proprietà number selezionati su tutti i record associati dell'oggetto selezionato.
  • Per scegliere come formattare i valori della proprietà, fare clic sul menu a discesa Formato numero, quindi selezionare uno dei seguenti formati: Numero formattato, Numero non formattato, Valuta, Percentuale o Durata.
  • Se si seleziona Valuta come formato per una proprietà di un affare, la proprietà utilizzerà per impostazione predefinita la valuta dell 'azienda del conto. Per utilizzare la valuta di ciascun record dell'affare, selezionare la casella di controllo Usa la valuta del record invece della valuta dell'azienda. L'uso della valuta del record influisce solo sulla visualizzazione del valore e non applica automaticamente un tasso di cambio.

average-rollup-property

  • Selezionare l'oggetto associato e la proprietà del record associato su cui calcolare la proprietà.
  • Per calcolare solo i record con un'etichetta specifica, fare clic su Seleziona etichette associazione, quindi selezionare le etichette da includere.
  • Per aggiungere una condizione aggiuntiva, fare clic su Crea condizione. Quando si imposta una condizione aggiuntiva, questa deve essere soddisfatta affinché la proprietà venga calcolata (ad esempio, calcolare la proprietà quando l'importo dell'affare recente è > 1000).
    • Nel primo menu a discesa, selezionare una proprietà.
    • Nel secondo menu a discesa, selezionare un operatore che confronterà il valore della prima proprietà con un numero o con il valore di un'altra proprietà.
    • Nel terzo menu a tendina, selezionare una proprietà o inserire un numero da confrontare con la prima proprietà.
  • Fare clic su Crea. Una volta creata, il tipo di campo visualizzato della proprietà sarà Rollup.

Nota bene: i valori di durata grezzi sono memorizzati in millisecondi. Se si utilizza una proprietà di calcolo della durata in altri strumenti di HubSpot (ad esempio, filtri, formule di proprietà di calcolo), potrebbe essere necessario utilizzare valori in millisecondi.

Calcolo dei valori in base all'intervallo di tempo tra due proprietà

È possibile creare proprietà che calcolano l'intervallo di tempo tra due proprietà del selezionatore di date selezionate all'interno dello stesso oggetto. Ad esempio, è possibile calcolare l'intervallo di tempo tra l'assegnazione del proprietario di un ticket e la sua chiusura. Per saperne di più su come vengono visualizzati i valori della proprietà di calcolo Time Between.

Se si sta cercando di costruire una proprietà basata sulla data odierna, si possono trovare ulteriori informazioni su come utilizzare l'ora relativa nelle proprietà e nei filtri.

  • Fare clic sul menu a discesa Tipo di proprietà calcolata e selezionare Tempo tra.
  • Fare clic sui menu a discesa per selezionare le proprietà Data inizio e Data fine.

time-between-calc-property-example

  • Per aggiungere una condizione aggiuntiva, fare clic su Crea condizione. Quando si imposta una condizione aggiuntiva, questa deve essere soddisfatta affinché la proprietà venga calcolata (ad esempio, calcolare la proprietà quando l'importo dell'affare recente è > 1000).
    • Nel primo menu a discesa, selezionare una proprietà.
    • Nel secondo menu a discesa, selezionare un operatore che confronterà il valore della prima proprietà con un numero o con il valore di un'altra proprietà.
    • Nel terzo menu a discesa, selezionare una proprietà o immettere un numero da confrontare con la prima proprietà.
  • Fare clic su Crea. Una volta creata, il tipo di campo visualizzato della proprietà sarà Calculation.

Quando si visualizzano i valori delle proprietà di tempo tra i calcoli, ci si aspetta il seguente comportamento:

  • L'ora sarà visualizzata in modo diverso nei vari strumenti di HubSpot.
  • Per le proprietà di data senza timestamp, l'ora predefinita utilizzata nel calcolo sarà le 12:00 UTC del giorno selezionato.
  • Su un record (ad esempio, un record di contatto), il valore visualizzato sarà in ore, giorni, mesi o anni e sarà arrotondato all'unità superiore in base a soglie specifiche. Ad esempio, se il tempo calcolato è di un mese e venti giorni, il valore visualizzato sarà di un mese, ma se il tempo calcolato è di un mese e ventisette giorni, il valore visualizzato sarà di due mesi. Le soglie sono:
    • 45 secondi o più arrotonda a un minuto
    • 45 minuti o più arrotondamenti fino a un'ora
    • 22 ore o più arrotondamenti fino a un giorno
    • 26 giorni o più turni fino a un mese
    • 11 mesi o più turni fino a un anno
  • Nei report personalizzati che utilizzano una proprietà con questo tipo di campo, il valore visualizzato sarà in giorni. Ad esempio, se il tempo calcolato è di un anno e venti giorni, il valore visualizzato sarà di 385 giorni.

Nota bene: in HubSpot, i valori grezzi dei tipi di proprietà Tempo tra e Media sono memorizzati in millisecondi. Se un'equazione con questi valori produce un valore più alto del previsto, utilizzare un convertitore di millisecondi per convertire nell'unità di tempo desiderata.


Calcolo dei valori in base a un'equazione personalizzata

È anche possibile creare proprietà che calcolano i valori in base a criteri personalizzati. Le equazioni personalizzate possono essere impostate solo per le proprietà numeriche all'interno dello stesso oggetto per il quale si sta creando la nuova proprietà. Ad esempio, è possibile creare un'equazione per calcolare l'importo della transazione più recente di un'azienda(Importo della transazione più recente) rispetto al numero di volte in cui l'azienda è stata contattata(Numero di volte contattate).

È possibile costruire equazioni personalizzate con operatori aritmetici, operatori di confronto, operatori logici, dichiarazioni condizionali e altre funzioni. Queste equazioni possono restituire valori numerici, booleani, stringhe o date. Per saperne di più sugli operatori e le funzioni disponibili e su come formattare le formule.

Per costruire una proprietà di calcolo dell'equazione personalizzata:

  • Fare clic sul menu a discesa Tipo di proprietà calcolata, quindi selezionare Equazione personalizzata.
  • Fare clic sul menu a tendina Tipo di output, quindi selezionare il tipo di output che verrà restituito dal calcolo. È possibile selezionare una delle seguenti opzioni: Numero, Booleano, Stringa o Data.

Attenzione: il tipo di output selezionato deve corrispondere al tipo di output mostrato in alto a destra nell'editor, altrimenti non sarà possibile creare la proprietà. Per le proprietà che restituiscono una data, è possibile utilizzare il tipo di output number o date, che determina la modalità di visualizzazione dei valori (ad esempio, number visualizza la data in millisecondi, date visualizza la data formattata).

  • Se è stato selezionato il tipo di uscita Numero:
    • Fare clic sul menu a discesa Formato numero, quindi selezionare come formattare i valori della proprietà. È possibile selezionare una delle seguenti opzioni: Numero formattato, Numero non formattato, Valuta, Percentuale o Durata.
    • Se si seleziona Valuta come formato del numero per una proprietà di un affare, la proprietà utilizzerà la valutaaziendale dell'account per impostazione predefinita. Per utilizzare la valuta di ciascun record dell'affare, selezionare la casella di controllo Usa la valuta del record invece della valuta dell'azienda.

Attenzione: l 'uso di una valuta record influisce solo sulla visualizzazione del valore e non applica automaticamente un tasso di cambio. Per aggiungere un tasso di cambio, è possibile includere le funzioni exchange_rate o dated_exchange_rate nell'equazione.


  • Nell'editor, inserire, digitare o incollare funzioni e proprietà per costruire l'equazione personalizzata. Per saperne di più sulla sintassi delle equazioni di calcolo personalizzate. Per inserire elementi di formula:
    • Fare clic sul menu a discesa Inserisci.
    • Per inserire funzioni nell'equazione, selezionare Funzioni, quindi selezionare una funzione.
    • Per inserire le proprietà nell'equazione, selezionare Proprietà, e poi selezionare una proprietà. È possibile creare equazioni personalizzate solo utilizzando proprietà dello stesso oggetto per il quale si sta creando la proprietà.

custom-equation-example

  • Se l'equazione presenta errori, fare clic su [x] sopra l'editor per visualizzare i motivi degli errori. Se l'equazione presenta errori non risolti, non sarà possibile creare la proprietà. Per saperne di più su come formattare le equazioni.
  • Per visualizzare l'anteprima del risultato della formula, fare clic su Prova formula.
calculated-property-preview

Nota bene: se una delle proprietà numeriche di un'equazione personalizzata non ha valore o ha un valore nullo, il calcolo non verrà eseguito e il valore della proprietà di calcolo sarà vuoto. Il valore sarà vuoto anche se l'equazione contiene un numero costante. In questa situazione, si possono usare le funzioni if e is_known per impostare il valore a 0.


  • Fare clic su Crea. Una volta creata, il tipo di campo visualizzato della proprietà sarà Calculation.

Sintassi di equazione personalizzata

Nell'editor di formule è possibile creare equazioni personalizzate utilizzando dati letterali, dati di altre proprietà, operatori e funzioni. Di seguito, si illustra la sintassi per la scrittura di equazioni di calcolo personalizzate e si esaminano esempi di formule comunemente utilizzate.

Sintassi letterale

Utilizzando i dati letterali, è possibile aggiungere alle equazioni stringhe di testo, numeri e valori veri o falsi. È possibile formattare stringhe, numeri, booleani e costanti di data nei seguenti modi:

  • Letterale di stringa: testo circondato da virgolette. Questi possono essere rappresentati con virgolette singole ('constant') o doppie ("constant").

  • Numeri letterali: numeri senza virgolette. I numeri costanti possono essere qualsiasi numero reale e possono includere la notazione puntuale. Ad esempio, sia 1005 che 1.5589 sono numeri costanti validi.

  • Letterale booleano: i booleani costanti possono essere true o false.

  • Data letterale: una data in millisecondi. Ad esempio, 1698508800000.

Sintassi della proprietà

È possibile includere altre proprietà dello stesso oggetto nell'equazione personalizzata. Se una proprietà viene inserita nell'editor, viene automaticamente formattata e convalidata come parte di un'equazione.

Se si sceglie di digitare o incollare manualmente una proprietà nell'editor, questa deve essere formattata come [properties.{propertyInternalName}]. Ad esempio, per aggiungere la proprietà Test score, che ha un valore interno di Test_score, la si digita nell'editor come [properties.Test_score].

Quando si usano proprietà di enumerazione in un'equazione (ad esempio, selezione a discesa, selezione via radio):

  • I valori sono considerati stringhe, quindi devono essere racchiusi tra doppi apici. Ad esempio, "subscriber".
  • È necessario utilizzare il nome interno delle opzioni di proprietà. Ad esempio, "appointmentscheduled".

Operatori

È possibile utilizzare gli operatori nelle equazioni per aggiornare, valutare o confrontare le costanti e i valori delle proprietà. Quando si utilizzano più operatori, questi seguono l'ordine delle operazioni di PEMDAS. A seconda del tipo di dati utilizzati, è possibile includere i seguenti operatori nelle equazioni personalizzate.

Operatore Descrizione
+ Aggiunge numeri o stringhe. Restituisce un numero.
- Sottrae i numeri. Restituisce un numero.
* Moltiplica i numeri. Restituisce un numero.
/ Divide i numeri. Restituisce un numero.
< Verifica se un valore è minore di un altro. Supportato da proprietà o costanti numeriche. Restituisce un booleano.
> Verifica se un valore è maggiore di un altro. Supportato da proprietà o costanti numeriche. Restituisce un booleano.
<= Verifica se un valore è minore o uguale a un altro. Supportato da proprietà o costanti numeriche. Restituisce un booleano.
>= Verifica se un valore è maggiore o uguale a un altro. Supportato da proprietà o costanti numeriche. Restituisce un booleano.
! Verifica se nessuno dei valori è vero. Restituisce un booleano.
= o == Verifica se un valore è uguale a un altro. Supportato da numeri e stringhe. Restituisce un booleano.
!= Verifica se un valore non è uguale a un altro. Supportato da numeri e stringhe. Restituisce un booleano.
or o || Verifica se uno dei due valori è vero. Restituisce un booleano.
and o && Verifica se entrambi i valori sono veri. Restituisce un booleano.

Funzioni

È possibile utilizzare le funzioni all'interno delle formule personalizzate per calcolare valori e completare azioni con i dati. A seconda del tipo di dati utilizzati, è possibile includere le seguenti funzioni nelle equazioni personalizzate.

Funzione Argomenti Esempi

abs

Ottiene il valore assoluto dei numeri. Restituisce un numero.

abs(number)

numero: il numero di cui si vuole ottenere il valore assoluto.

abs(-100) = 100

concatenate

Combina fino a 100 stringhe in un unico valore. Restituisce una stringa.

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

arg1: la stringa alla quale verrà aggiunto l'arg 2.

arg2: la stringa da aggiungere all'arg 1.

concatenate("Example", " Test") = "Esempio di test"

contains

Filtra le stringhe che contengono una specifica sequenza di caratteri. Restituisce una stringa.

contains(property, text)

proprietà: la proprietà di cui si vogliono controllare i valori per il testo.

testo: la sequenza di caratteri che i valori devono contenere.

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

currency_decimal_places

Ottiene il numero di cifre decimali per una valuta. Restituisce un numero.

currency_decimal_places(currency)

valuta: la stringa di valuta per la quale si desidera calcolare il numero di cifre decimali.

currency_decimal_places("USD")

dated_exchange_rate

Ottiene il valore di un tasso di cambio in un determinato momento. Restituisce un numero.

dated_exchange_rate(currency, date)

valuta: la stringa di valuta per la quale si desidera calcolare il tasso di cambio in una data specifica (ad esempio, "USD").

data: la proprietà datetime per la quale si desidera calcolare il tasso di cambio.

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

exchange_rate

Ottiene il tasso di cambio più recente. Restituisce un numero.

exchange_rate(currency)

valuta: la stringa di valuta per la quale si desidera calcolare il tasso di cambio.

exchange_rate("USD")

if

Impostare un'espressione condizionale.

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

condizione: l'istruzione booleana che determina il valore calcolato.

arg2: un booleano, un numero o una stringa che sarà il valore calcolato se la condizione è soddisfatta.

arg3 (opzionale): il valore calcolato se la condizione non è soddisfatta. Se incluso, deve essere dello stesso tipo di arg2. Se non viene utilizzato, il valore sarà null quando la condizione non è soddisfatta.

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

is_known

Determina se è noto un valore per il token. Restituisce un booleano.

is_known(property)

proprietà: la proprietà di cui si vuole verificare il valore.

is_known([properties.name]) = vero

last_updated

Ottiene la data dell'ultimo aggiornamento del token. Restituisce un timestamp in millisecondi come stringa.

last_updated(property)

proprietà: la proprietà per la quale si desidera verificare la data di aggiornamento più recente.

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

lowercase

Cambia tutti i caratteri in minuscolo. Restituisce una stringa.

lowercase(text)

testo: la stringa o la proprietà di testo con i valori che si desidera cambiare in minuscolo.

lowercase("heLLo") = "ciao"


lowercase([properties.test])

max

Ottiene il massimo di due numeri. Restituisce un numero.

max(arg1, arg2)

arg1: il primo numero o la prima proprietà numerica.

arg2: il secondo numero o proprietà numerica.

max(500,[properties.amount]) = 500, se il valore dell'importo è inferiore a 500.

min

Ottiene il minimo di due numeri. Restituisce un numero.

min(arg1, arg2)

arg1: il primo numero o la prima proprietà numerica.

arg2: il secondo numero o proprietà numerica.

min(500, 250) = 250

month

Ottiene il mese numerico di una data determinata. Restituisce un numero.

month(date)

date: la proprietà datetime per la quale si vuole calcolare il mese.

month([properties.closedate])

number_to_string

Converte un numero in una stringa. Restituisce una stringa.

number_to_string(number_to_convert)

number_to_convert: il numero o la proprietà numerica che si desidera trasformare in stringa.

number_to_string(1000) = "1000"

pipeline_probability

Ottiene la probabilità di una fase della pipeline. Restituisce un numero.

pipeline_probability(pipeline)

pipeline: il nome della pipeline per la quale si vuole calcolare la probabilità.

pipeline_probability("newdeal")

power

Eleva un numero al valore di un altro numero. Restituisce un numero.

power(base, exponent)

base: il numero di base.

esponente: il valore a cui elevare la base.

power(5, 2) = 25

round_down

Arrotonda un numero per difetto a una precisione specificata. Restituisce un numero.

round_down(number_to_round, precision)

numero_da_arrotondare: il numero o la proprietà del numero che si desidera arrotondare per difetto.

precisione: il numero di cifre decimali da arrotondare per difetto.

round_down(4.353, 1) = 4.3

round_nearest

Arrotonda un numero alla precisione specificata. Restituisce un numero.

round_nearest(number_to_round, precision)

numero_da_arrotondare: il numero o la proprietà numerica i cui valori si vogliono arrotondare.

precisione: il numero di cifre decimali da arrotondare.

round_nearest(4.32, 1) = 4.3

round_up

Arrotonda un numero fino alla precisione specificata. Restituisce un numero.

round_up(number_to_round, precision)

numero_da_arrotondare: il numero o la proprietà numerica di cui si vuole arrotondare il valore.

precisione: il numero di cifre decimali da arrotondare per eccesso.

round_up(4.353, 1) = 4.4

sqrt

Ottiene la radice quadrata di un numero. Restituisce un numero.

sqrt(number)

numero: il numero di cui si vuole ottenere la radice quadrata.

sqrt(144) = 12

starts_with

Filtra le stringhe che iniziano con una specifica sequenza di caratteri. Restituisce una stringa.

starts_with(property, text)

proprietà: la proprietà i cui valori si desidera controllare per i caratteri iniziali.

testo: la sequenza di caratteri con cui devono iniziare i valori.

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

string_to_number

Converte una stringa in un numero. Restituisce un numero.

string_to_number(string_to_convert)

string_to_convert: la proprietà stringa o testo i cui valori si vogliono convertire in numero.

string_to_number("1000") = 1000

time_between

Ottiene la differenza di orario tra due date. Restituisce un numero.

time_between(date1, date2)

date1: la proprietà datetime iniziale.

date2: la proprietà datetime finale.

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

uppercase

Cambia tutti i caratteri in maiuscolo. Restituisce un numero.

uppercase(text)

testo: la stringa o la proprietà di testo che si desidera cambiare in maiuscolo.

uppercase("hello") = "CIAO"

year

Ottiene l'anno numerico di una determinata data. Restituisce un numero.

year(date)

date: la proprietà datetime per la quale si vuole calcolare l'anno.

year([properties.closedate])

Esempi

Di seguito sono riportate formule di esempio basate su casi d'uso comuni.

  • È possibile impostare dichiarazioni if else, comprese le dichiarazioni con condizioni multiple e all'interno di funzioni:
    • 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")
  • Quando si utilizzano le proprietà dei numeri in una formula personalizzata, è possibile includere le funzioni if e is_known per impostare il valore a 0 quando la proprietà del numero è vuota. Ad esempio, if(is_known([properties.number]), [properties.number], 0).
  • Quando si utilizza una valuta record in una formula, per aggiungere un tasso di cambio, è possibile includere le funzioni exchange_rate o dated_exchange_rate nell'equazione. Ad esempio, [properties.amount] * exchange_rate('CAD').
L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.