Creare proprietà di calcolo e rollup

È possibile creare proprietà che popolano i dati in base ai calcoli effettuati da altre proprietà. Con le proprietà di rollup, è possibile calcolare automaticamente i valori minimi, massimi, il conteggio, la somma o la media delle proprietà sui record associati. Con le proprietà di calcolo, è possibile impostare equazioni basate sul tempo trascorso tra, fino a o da valori di proprietà, oppure creare equazioni personalizzate basate sulle proprietà di un oggetto.

Nota: il tuo account potrebbe utilizzare nomi personalizzati per ciascun oggetto (ad esempio, account invece di azienda). Questo documento fa riferimento agli oggetti con i loro nomi predefiniti HubSpot.

Ad esempio, puoi creare:

• Una proprietà aziendale che calcola il costo di acquisizione di un nuovo cliente in base a un'equazione personalizzata.
• Una proprietà di contatto che calcola l'importo medio delle trattative associate a un contatto.
• Una proprietà dell'affare che calcola il tempo trascorso dall'apertura dell'affare.
• Una proprietà relativa a fatture, abbonamenti o pagamenti che calcola l'importo del profitto al netto di eventuali sconti applicati.

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

Creare proprietà di rollup basate sulle proprietà dei record associati

Puoi creare proprietà per un oggetto che verranno calcolate in base a determinati valori delle proprietà dei record associati a quell'oggetto. Puoi effettuare il calcolo in base a tutti i record associati a quell'oggetto o per etichette di associazione specifiche, comprese le associazioni dello stesso oggetto.

Ad esempio, puoi creare una proprietà dell'opportunità che conta il numero totale di attività di vendita registrate per i contatti associati a un'opportunità con l'etichetta Decisore .

1. Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.

2. Nel menu della barra laterale sinistra, vai su Proprietà.

3. Fare clic sul menu a discesa Seleziona un oggetto e selezionare Proprietà [oggetto] per creare una proprietà per quell'oggetto.

4. Inserisci i dettagli di base della tua proprietà, quindi fai clic sulla scheda Tipo di campo.
5. Fai clic sul menu a discesa Tipo di campo e seleziona Rollup.
6. Fare clic sul menu a discesa Tipo di rollup, quindi selezionare uno dei seguenti tipi:
   • Min: visualizza il valore minimo per la proprietà numerica selezionata nei record associati dell'oggetto selezionato.
   • Max: visualizza il valore massimo per la proprietà numerica selezionata su tutti i record associati dell'oggetto selezionato.
   • Count: conta il numero totale di record associati dell'oggetto selezionato che hanno un valore per la proprietà numerica selezionata.
   • Sum ( Somma): somma i valori della proprietà numerica selezionata su tutti i record associati dell'oggetto selezionato.
   • Media: calcola la media dei valori della proprietà numerica selezionata su tutti i record associati dell'oggetto selezionato.
7. Per scegliere come formattare i valori della proprietà, fai clic sul menu a discesa Formato numero, quindi seleziona uno dei seguenti formati: Numero formattato, Numero non formattato, Valuta, Percentuale o Durata.
8. Se si seleziona Valuta come formato per una proprietà dell'affare, la proprietà utilizzerà per impostazione predefinita la valuta aziendale del proprio account. Per utilizzare la valuta di ciascun record dell'affare, selezionare la casella di controllo Usa valuta del record invece della valuta aziendale. L'utilizzo della valuta del record influisce solo sulla modalità di visualizzazione del valore e non applica automaticamente un tasso di cambio.
9. Seleziona l'oggetto associato e la proprietà del record associato su cui basare il calcolo della proprietà.
10. Per eseguire il calcolo solo in base ai record con un'etichetta specifica, fai clic su Seleziona etichette di associazione, quindi seleziona le etichette che desideri includere.
11. Per aggiungere ulteriori condizioni, fai clic su Aggiungi condizione. Quando vengono impostate condizioni aggiuntive, tali condizioni devono essere soddisfatte affinché la proprietà venga calcolata (ad esempio, calcola la proprietà quando Importo transazione recente > 1000 e Probabilità transazione >= 80). È possibile configurare fino a 50 condizioni per ogni proprietà di rollup.
    • Nel primo menu a discesa, seleziona una proprietà.
    • Nel secondo menu a discesa, seleziona 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 inserire un numero che verrà confrontato con la prima proprietà.
    • Fare clic su Salva.
12. Fai clic su Crea. Una volta creata, il tipo di campo visualizzato della proprietà sarà Rollup.

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

Creare proprietà di calcolo del tempo trascorso, del tempo trascorso da o del tempo rimanente

È possibile creare proprietà che calcolano il tempo tra due date o che tracciano il tempo trascorso da o fino a una data, determinato dai valori delle proprietà di selezione della data o della data e dell'ora. Le proprietà di tempo tra sono supportate solo per le proprietà dello stesso oggetto.

Ad esempio:

• Crea una proprietà Tempo tra per calcolare il tempo trascorso tra l'assegnazione del proprietario di un ticket e la chiusura del ticket.
• Crea una proprietà Tempo dall'apertura per monitorare da quanto tempo è aperta una trattativa.
• Crea una proprietà Tempo fino alla chiusura per monitorare quanto tempo manca alla chiusura fissata dal cliente.

Per creare una proprietà i cui valori visualizzano il tempo relativo in base alla data odierna anziché al valore della proprietà, scopri come creare una proprietà relativa al tempo con selettore di data/data e ora. Puoi anche creare una proprietà di tempo fisso utilizzando un'equazione personalizzata.

Per creare proprietà di calcolo Tempo tra, Tempo trascorso o Tempo rimanente:

1. Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.

2. Nel menu della barra laterale sinistra, vai su Proprietà.

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

4. Inserisci i dettagli di base per la tua proprietà, quindi fai clic sulla scheda Tipo di campo .
5. Fai clic sul menu a discesa Tipo di campo e seleziona Calcolo.
6. Fai clic sul menu a discesa Tipo di proprietà calcolata, quindi seleziona il tipo e imposta il calcolo:
   • Tempo tra: seleziona le proprietà Data di inizio e Data di fine .
   • Tempo trascorso da: seleziona la proprietà di selezione data/data e ora il cui valore sarà la data di inizio. La data di fine sarà sempre la data odierna.
   • Tempo fino a: seleziona la proprietà di selezione data/data e ora il cui valore sarà la data di fine. La data di inizio sarà sempre la data odierna.
7. Solo per le proprietà Tempo tra, per aggiungere una condizione aggiuntiva, fai clic su Aggiungi condizione. Quando vengono impostate condizioni aggiuntive, tali condizioni devono essere soddisfatte affinché la proprietà venga calcolata (ad esempio, calcola la proprietà quando Importo transazione recente > 1000 e Probabilità transazione >= 80).
   • Nel primo menu a discesa, selezionare una proprietà.
   • Nel secondo menu a discesa, seleziona 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, seleziona una proprietà o inserisci un numero che verrà confrontato con la prima proprietà.
   • Fare clic su Salva.
8. Fai clic su Crea. Una volta creata, il tipo di campo visualizzato della proprietà sarà Calcolo. In seguito, non potrai modificare se si tratta di Tempo tra, Tempo trascorso o Tempo rimanente, ma potrai selezionare diverse proprietà di data di inizio o fine.

Quando si visualizzano i valori di durata, è previsto il seguente comportamento:

• Per le proprietà di data senza timestamp, l'ora predefinita utilizzata nel calcolo sarà 12:00 am UTC per il giorno selezionato.
• Il valore visualizzato sarà espresso in secondi, minuti, ore, giorni, mesi o anni in base a soglie specifiche. Le soglie per le unità sono:
  • 2,5 anni o più saranno visualizzati in anni.
  • 3 mesi o più saranno visualizzati in mesi.
  • 1 giorno o più saranno visualizzati in giorni.
  • 2,5 ore o più saranno visualizzate in ore.
  • 2,5 minuti o più saranno visualizzati in minuti.
  • Meno di 2,5 minuti verranno visualizzati in secondi.

Nota: all'interno di 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 superiore al previsto, utilizza un convertitore di millisecondi per convertire l'unità di tempo desiderata.

Creare proprietà di calcolo con equazioni personalizzate

È anche possibile creare proprietà che calcolano i valori in base ai propri criteri. Le equazioni personalizzate possono essere impostate solo per le proprietà numeriche all'interno dello stesso oggetto per cui si sta creando la nuova proprietà. Ad esempio, è possibile creare un'equazione per calcolare l'importo dell'ultimo accordo di un'azienda (Importo dell'ultimo accordo) rispetto al numero di volte in cui la propria azienda ha contattato l'azienda (Numero di contatti).

Puoi creare la tua equazione personalizzata con operatori aritmetici, operatori di confronto, operatori logici, istruzioni condizionali e altre funzioni. Queste equazioni possono restituire valori numerici, booleani, stringhe, date o date e ora. Scopri di più sugli operatori disponibili, sulle funzioni e su come formattare le formule. Puoi anche consultare esempi di formule comunemente utilizzate.

Per creare una proprietà di calcolo con equazione personalizzata:

1. Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.

2. Nel menu della barra laterale sinistra, vai su Proprietà.

3. Fai clic sul menu a discesa Seleziona un oggetto , quindi seleziona Proprietà [Oggetto] per creare una proprietà per quell'oggetto.

4. Inserisci i dettagli di base della tua proprietà, quindi fai clic sulla scheda Tipo di campo.
5. Fai clic sul menu a discesa Tipo di campo e seleziona Calcolo.
6. Fai clic sul menu a discesa Tipo di proprietà calcolata, quindi seleziona Equazione personalizzata.
7. Fai clic sul menu a discesa Tipo di output, quindi seleziona il tipo di output che il tuo calcolo restituirà. Puoi selezionare una delle seguenti opzioni: Numero, Booleano, Stringa, Data o Data e ora.

Nota: 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 numerico o datato che determina la modalità di visualizzazione dei valori (ad esempio, il tipo numerico visualizza la data in millisecondi, mentre il tipo datato visualizza la data formattata).

8. Se hai selezionato il tipo di output Numero:
   • Fai clic sul menu a discesa Formato numero, quindi seleziona come formattare i valori della proprietà. Puoi selezionare una delle seguenti opzioni: Numero formattato, Numero non formattato, Valuta, Percentuale o Durata.
   • Se selezioni Valuta come formato numerico per una proprietà dell'operazione, la proprietà utilizzerà per impostazione predefinita la valuta aziendale del tuo account. Per utilizzare la valuta di ciascun record dell'operazione, seleziona la casella di controllo Usa valuta del record invece della valuta aziendale.

9. Nell'editor, inserisci, digita o incolla funzioni e proprietà per creare la tua equazione personalizzata. Ulteriori informazioni sulla sintassi delle equazioni di calcolo personalizzate. Per inserire elementi di formula:
   
   • Fai clic sul menu a discesa Inserisci.
   • Per inserire funzioni nell'equazione, seleziona Funzioni, quindi seleziona una funzione.
   • Per inserire proprietà nell'equazione, seleziona Proprietà, quindi seleziona una proprietà. È possibile creare equazioni personalizzate solo utilizzando le proprietà dello stesso oggetto per cui si sta creando la proprietà.
10. Se l'equazione contiene errori, clicca su [x] problemi sopra l'editor per visualizzare i motivi degli errori. Non sarà possibile creare la proprietà se l'equazione contiene errori irrisolti. Scopri di più su come formattare le equazioni.
11. Per visualizzare in anteprima il risultato della formula, fai clic su Prova formula.
12. Fai clic su Crea. Una volta creata, il tipo di campo visualizzato della proprietà sarà Calcolo.

Nota: è possibile nidificare fino a 70 parentesi aperte all'interno della formula di calcolo (ad esempio, (((1+2)+3)+4) risulta in un conteggio di nidificazione pari a 4).

Creare proprietà di calcolo personalizzate con l'IA

1. Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.

2. Nel menu della barra laterale sinistra, vai su Proprietà.

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

4. Inserisci i dettagli di base della tua proprietà, quindi clicca sulla scheda Tipo di campo.
5. Fai clic sul menu a discesa Tipo di campo e seleziona Calcolo.
6. Sotto il campo di testo della formula, clicca su Genera formula.
7. Nella finestra pop-up:
   • Passa con il mouse sul link Esempi per visualizzare i suggerimenti consigliati.
   • Nel campo di testo Cosa desideri che questa proprietà calcoli per te?, inserisci un suggerimento.
   • Fai clic su Genera.
8. Rivedi la formula generata e apporta le modifiche necessarie.
9. Fai clic sul menu a discesa Tipo di output e seleziona il tipo che corrisponde al valore visualizzato nel campo di testo della formula (ad esempio, stringa).
10. Per visualizzare l'anteprima dell'output della formula, clicca su Prova formula.
11. Fai clic su Crea.

Sintassi delle equazioni personalizzate

• Sintassi letterale: utilizzando dati letterali, puoi aggiungere stringhe di testo, numeri e valori vero o falso alle tue equazioni. Puoi formattare stringhe, numeri, costanti booleane e date nei seguenti modi:

  • Letterale stringa: testo racchiuso tra virgolette. Queste possono essere rappresentate con virgolette singole ('constant') o doppie ("constant").

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

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

  • Letterale di data: una data in millisecondi. Ad esempio, 1698508800000.
• Sintassi delle 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à Punteggio test, che ha un valore interno pari a Test_score, è necessario digitarla nell'editor come [properties.Test_score].
  • Quando si utilizzano proprietà di enumerazione in un'equazione (ad esempio, menu a discesa, pulsanti di opzione), i valori sono considerati stringhe, quindi devono essere racchiusi tra virgolette doppie ("ad esempio, "subscriber") ed è necessarioutilizzare anche il nome interno delle opzioni della proprietà (ad esempio, "appointmentscheduled").
  • Quando si utilizzano proprietà di data in un'equazione, i valori vengono memorizzati come mezzanotte UTC in millisecondi.
  • Quando si utilizzano proprietà di data e ora in un'equazione, i valori vengono memorizzati come epoca UTC in millisecondi. Questo valore viene visualizzato in base al fuso orario dell'utente. Ciò significa che gli utenti in fusi orari diversi vedranno valori diversi.

Operatori

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

Funzioni

È possibile utilizzare funzioni all'interno di 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.

Esempi di equazioni personalizzate

Di seguito sono riportati alcuni esempi di formule basate su casi d'uso comuni.

Utilizza le istruzioni if else

È possibile impostare istruzioni if else, comprese istruzioni con più condizioni e all'interno di funzioni.

Ad esempio, è possibile creare un calcolo per etichettare le trattative attive. Quanto segue restituirà True solo se lo stato di una trattativa è attivo e l'importo è maggiore di zero.

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

Eseguire calcoli con valori nulli

Quando si utilizzano proprietà numeriche in una formula personalizzata, è possibile includere le funzioni if e is_known per impostare il valore su 0 quando la proprietà numerica è vuota. In questo modo il calcolo viene eseguito indipendentemente dal fatto che la proprietà contenga un valore nullo. Ad esempio:

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

Aggiungere il tasso di cambio a un calcolo valutario

Quando si utilizza una valuta di registrazione 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').

Creare un calcolo a tempo fisso

È possibile impostare un calcolo per ottenere il tempo fisso tra due date. Per impostazione predefinita, il valore grezzo viene restituito in millisecondi. È possibile utilizzare la divisione e la funzione round_nearest per formattare in ore, giorni, ecc. ed eliminare i decimali nel valore finale. Ad esempio, il seguente codice restituirà un valore di giorni fissi:

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

Nota: si consiglia di essere precisi quando si inseriscono il nome e la descrizione della proprietà. In questo modo gli utenti sono consapevoli del tempo che viene calcolato (ad esempio, ore o giorni).

Calcolare gli sconti sulle transazioni in percentuale

Quando si utilizzano le voci di linea nelle transazioni, è possibile utilizzare una proprietà di rollup e una proprietà di calcolo per tenere traccia dello sconto totale in percentuale. La proprietà di rollup somma la proprietà della voce di linea Sconto totale calcolato per tutte le voci di linea associate. La proprietà di calcolo divide la proprietà di rollup per se stessa più la proprietà predefinita Importo della transazione.

Per creare la proprietà rollup:

1. Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.

2. Nel menu della barra laterale sinistra, vai su Proprietà.

3. Fai clic sul menu a discesa Seleziona un oggetto e seleziona Proprietà dell'offerta.

4. Fare clic su Crea proprietà e selezionare Crea manualmente.

5. Nel campo di testo Etichetta proprietà, inserisci Importo sconto calcolato.
6. Inserisci gli altri dettagli di base relativi alla tua proprietà.
7. Fai clic sulla scheda Tipo di campo.
8. Fai clic sul menu a discesa Tipo di campo e seleziona Rollup.
9. Fai clic sul menu a discesa Tipo di rollup e seleziona Somma.
10. Fare clic sul menu a discesa Formato numero e selezionare Valuta.
11. Fai clic sul menu a discesa Scegli il tipo di record associato e seleziona Voce.
12. Fai clic sul menu a discesa Scegli la proprietà del record associato e seleziona Sconto totale calcolato.
13. In alto a destra, clicca su Crea.

Per creare la proprietà di calcolo:

1. Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.

2. Nel menu laterale sinistro, vai su Proprietà.

3. Fai clic sul menu a discesa Seleziona un oggetto e seleziona Proprietà dell'offerta.

4. Fare clic su Crea proprietà e selezionare Crea manualmente.

5. Nel campo di testo " Etichetta proprietà ", inserisci " Percentuale di sconto calcolata".
6. Inserisci gli altri dettagli di base relativi alla tua proprietà.
7. Fai clic sulla scheda Tipo di campo.
8. Fai clic sul menu a discesa Tipo di campo e seleziona Calcolo.
9. Fai clic sul menu a discesa Formato numero e seleziona Percentuale.
10. Nel campo di testo della formula di calcolo , inserisci (Calculated discount amount / (Calculated discount amount + Amount)). Puoi anche fare clic su Genera formula per utilizzare Breeze per generarla.
11. In alto a destra, clicca su Crea.