Crea proprietà di calcolo e di rollup

Crea proprietà che popolano i dati in base a calcoli effettuati su altre proprietà. Con le proprietà di riepilogo, puoi calcolare automaticamente i valori minimi, massimi, il conteggio, la somma, la data più antica, la data più recente o la media delle proprietà presenti nei record associati. Con le proprietà di calcolo, puoi impostare equazioni basate sui valori delle proprietà "intervallo", "fino a" o "da", oppure creare equazioni personalizzate basate sulle proprietà di un oggetto. 

Nota: il tuo account potrebbe utilizzare nomi personalizzati per ciascun oggetto (ad esempio, "account" anziché "azienda"). Questo articolo fa riferimento agli oggetti utilizzando i nomi predefiniti di HubSpot.

Prima di iniziare

Ad esempio, puoi creare:

• Una proprietà "azienda" che calcoli il costo di acquisizione di un nuovo cliente in base a un'equazione personalizzata.
• Una proprietà del contatto che calcola l’ importo medio delle trattative associate a un contatto. 
• Una proprietà dell’opportunità che calcola il tempo trascorso dall’apertura dell’opportunità.
• Una proprietà relativa a fattura, abbonamento o pagamento che calcoli l’importo del profitto al netto di eventuali sconti applicati.

A seconda del tuo abbonamento HubSpot, esiste un limite al numero di proprietà di calcolo che puoi creare.

Crea proprietà di riepilogo 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 specifiche etichette di associazione, comprese le associazioni con lo stesso oggetto.

Ad esempio, puoi creare una proprietà dell’opportunità che conti 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 icona delle impostazioni nella barra di navigazione principale.

2. Nel menu della barra laterale sinistra, accedere a“Proprietà”.

3. Fare clic sul menua discesa Seleziona un oggettoe selezionare Proprietà [Oggetto] percreare una proprietà per quell’oggetto.

4. Fare clic suCrea proprietà.
5. Inserisci i dettagli di base della tua proprietà.
6. Fare clic sul menu a discesa Tipo di campo e selezionare Rollup.
7. Fare clic sul menu a discesa Tipo di rollup, quindi selezionare uno dei seguenti tipi:
   • Min: visualizza il valore minimo della proprietà numerica selezionata nei record associati all'oggetto selezionato.
   • Max: visualizza il valore massimo della proprietà numerica selezionata su tutti i record associati all'oggetto selezionato.
   • Conteggio: conta il numero totale di record associati dell'oggetto selezionato che presentano un valore per la proprietà numerica selezionata.
   • Somma: somma i valori della proprietà numerica selezionata su tutti i record associati all'oggetto selezionato.
   • Media: calcola la media dei valori della proprietà numerica selezionata su tutti i record associati all'oggetto selezionato.
   • Data più antica: restituisce la data più antica relativa alla proprietà selezionata per l’oggetto selezionato (ad esempio, la data di creazione più antica per le trattative associate).
   • Data più recente: restituisce la data più recente relativa alla proprietà selezionata per l’oggetto selezionato (ad esempio, la data dell’attività successiva più recente per le trattative associate).
8. Fare clic sul menu a discesa Formato numero, quindi selezionare uno dei seguenti formati: Numero formattato, Numero non formattato, Valuta, Percentuale o Durata. In questo modo si configura il formato dei valori della proprietà.
   • Se si seleziona " Valuta " come formato per una proprietà di un'opportunità, la proprietà utilizzerà per impostazione predefinita la valuta aziendale del proprio account.
   • Per utilizzare la valuta di ciascun record di trattativa, seleziona la casella di controllo "Usa la valuta del record invece della valuta aziendale ". L'utilizzo della valuta del record influisce solo sulla visualizzazione del valore e non applica automaticamente un tasso di cambio.
9. Selezionare l’oggetto associato e la proprietà del record associato su cui basare il calcolo della proprietà. 
10. Fare clic su “Seleziona etichette di associazione”, quindi selezionare le etichette che si desidera includere per effettuare il calcolo solo sui record con un’etichetta specifica.
11. Fare clic su "Aggiungi condizione" per aggiungere criteri opzionali che il record deve soddisfare affinché la proprietà venga calcolata (ad esempio, calcolare la proprietà quando "Importo dell’affare recente " > 1000 e " Probabilità dell’affare " >= 80). È possibile configurare fino a 50 condizioni di tipo numerico e di campo enumerato per ogni proprietà di rollup.
    • Nel primo menu a tendina, selezionare una proprietà.
    • Nel secondo menu a tendina, 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, selezionare una proprietà o inserire un numero che verrà confrontato con la prima proprietà.
    • Fare clic suSalva.
12. Fai clic su Crea. Una volta creata, il tipo di campo visualizzato per la proprietà sarà Rollup.

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

Crea proprietà di calcolo "Tempo tra", "Tempo

trascorso da

" o "Tempo

fino a

"

Puoi creare proprietà che calcolano il tempo tra due date o che tengono traccia del 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à "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 titolare di un ticket e la chiusura del ticket.
• Creare una proprietà " Tempo trascorso dall’apertura " per monitorare da quanto tempo un’opportunità è aperta.
• Creare una proprietà " Tempo fino alla chiusura " per monitorare quanto manca alla chiusura prevista per un cliente rispetto alla data odierna.

Per creare una proprietà i cui valori mostrino un tempo relativo basato sulla data odierna anziché su un valore della proprietà, scopri come creare una proprietà "Tempo relativo" con selettore di data o data e ora. Puoi anche creare una proprietà "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 icona delle impostazioni nella barra di navigazione principale.

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

3. Fare clic sul menua discesa "Seleziona un oggetto", quindi selezionare "Proprietà [Oggetto]" percreare una proprietà per quell’oggetto.

4. Inserisci i dettagli di base della tua proprietà.
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 configura il calcolo:
   • Intervallo di tempo: 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à " Selettore 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à "Intervallo di tempo ", configura le opzioni aggiuntive:
   • Criteri condizionali: fare clic su " Aggiungi condizione " per aggiungere criteri opzionali che devono essere soddisfatti per il calcolo.
   • Calcola solo i giorni feriali: seleziona la casella di controllo Escludi i fine settimana per calcolare solo i giorni feriali compresi tra la data di inizio e quella di fine. I fine settimana sono definiti come il periodo compreso tra le 00:00 di sabato e le 23:59 di domenica, in base al fuso orario del tuo account.
8. Fare clic su " Crea proprietà". 

Durante la visualizzazione dei valori di durata è previsto il seguente comportamento:

• Per le proprietà di data prive di timestamp, l'ora predefinita utilizzata nel calcolo sarà le 12:00 am UTC del 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ù verranno visualizzati in anni.
  • 3 mesi o più verranno visualizzati in mesi.
  • 1 giorno o più verrà visualizzato in giorni.
  • 2,5 ore o più verranno visualizzate in ore.
  • 2,5 minuti o più verranno visualizzati in minuti.
  • Se inferiore a 2,5 minuti, verrà visualizzato in secondi.

Nota: all’interno di HubSpot, i valori grezzi dei tipi di proprietà“Intervallo di tempo” e“Media” sono memorizzati in millisecondi. Se un’equazione con questi valori produce un risultato superiore a quello previsto, utilizza un convertitore di millisecondi per convertire il valore nell’unità di tempo desiderata.

Creazione di

proprietà

di calcolo con equazioni personalizzate

È inoltre possibile creare proprietà che calcolano i valori in base a criteri personalizzati. Le equazioni personalizzate possono essere configurate 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 dell’affare più recente di un’azienda ("Importo dell’affare più recente") rispetto al numerodi volte in cui la propria azienda ha contattato l’azienda in questione ("Numero di contatti").

È possibile costruire un’equazione personalizzata utilizzando operatori aritmetici, operatori di confronto, operatori logici, istruzioni condizionali e altre funzioni. Queste equazioni possono restituire valori numerici, booleani, stringhe, date o date e ore. Scopri di più sugli operatori e sulle funzioni disponibili e su come formattare le formule. È inoltre possibile consultare esempi di formule comunemente utilizzate.

Per creare una proprietà di calcolo con equazione personalizzata:

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

2. Nel menu della barra laterale sinistra, vai suProprietà.

3. Fare clic sul menua discesa Seleziona un oggetto, quindi selezionare Proprietà [Oggetto] percreare una proprietà per quell’oggetto.

4. Inserisci i dettagli di base della tua proprietà.
5. Fare clic sul menu a discesa Tipo di campo e selezionare Calcolo.
6. Fai clic sul menu a discesa Tipo di proprietà calcolata, quindi seleziona Equazione personalizzata.
7. Fare clic sul menu a discesa Tipo di output, quindi selezionare il tipo di output che il calcolo restituirà. È possibile 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 visualizzato 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 "Numero" o "Data", che determina la modalità di visualizzazione dei valori (ad esempio, "Numero" visualizza la data in millisecondi, mentre "Data" 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 scegliere una delle seguenti opzioni: "Numero formattato", "Numero non formattato", "Valuta", "Percentuale" o "Durata".
   • Se si seleziona "Valuta " come formato numerico 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 la valuta del record invece di quella aziendale ".

9. Nell’editor, inserisci, digita o incolla funzioni e proprietà per creare la tua equazione personalizzata . Scopri di più sulla sintassi delle equazioni di calcolo personalizzate. Per inserire elementi della formula:
   
   • Fare clic sul menu a discesa "Inserisci".
   • Per inserire funzioni nell’equazione, selezionare Funzioni, quindi scegliere una funzione.
   • Per inserire proprietà nell’equazione, seleziona "Proprietà", quindi scegli una proprietà. È possibile creare equazioni personalizzate solo utilizzando le proprietà dello stesso oggetto per il quale si sta creando l’equazione.
10. Se l’equazione presenta degli errori, fare clic su [x] problemi sopra l’editor per visualizzare i motivi degli errori. Non sarà possibile creare la proprietà se l’equazione presenta errori non risolti. Scopri di più su come formattare le equazioni.
11. Per visualizzare in anteprima il risultato della formula, fare clic su " Prova formula".
12. Fare clic suCrea proprietà.

Nota: puoi annidare fino a 70 parentesi aperte all’interno della tua formula di calcolo (ad esempio, (((1+2)+3)+4) comporta un conteggio di annidamento pari a 4).

Crea proprietà di calcolo personalizzate con l’IA

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

2. Nel menu della barra laterale sinistra, vai suProprietà.

3. Fare clic sul menua discesa «Seleziona un oggetto», quindi selezionare «Proprietà [Oggetto]» percreare una proprietà per quell’oggetto.

4. Fare clic suCrea proprietà.
5. Inserisci i dettagli di base della tua proprietà.
6. Fai clic sul menu a discesa Tipo di campo e seleziona Calcolo.
7. Sotto il campo di testo della formula, clicca su Genera formula.
8. Nella finestra a comparsa:
   • Passa il mouse sul link Esempi per visualizzare i suggerimenti consigliati.
   • Nel campo di testo " Cosa desideri che questa proprietà calcoli per te? ", inserisci unarichiesta.
   • Fai clic su " Genera".
9. Controlla la formula generata e apporta le modifiche necessarie.
10. Fai clic sul menu a discesa "Tipo di output " e seleziona il tipo corrispondente al valore visualizzato nelcampo di testo della formula (ad esempio, stringa).
11. Per visualizzare l'anteprima dell'output della formula, fare clic su " Prova formula".
12. Fare clic suCrea proprietà.

Sintassi delle equazioni personalizzate

• Sintassi letterale: utilizzando dati letterali, è possibile aggiungere stringhe di testo, numeri e valori veri o falsi alle equazioni. È possibile formattare stringhe, numeri, valori booleani e costanti di data 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, sia1005che1.5589sono numeri costanti validi.

  • Letterale booleano: i valori booleani costanti possono esseretrue" o "false.

  • Letterale di data: una data espressa 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 dell’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 del test, che ha un valore interno pari a Test_score, occorre digitarla nell’editor come [properties.Test_score].
  • Quando si utilizzano proprietà di enumerazione in un'equazione (ad es. menu a tendina, pulsanti di opzione), i valori sono considerati stringhe, pertanto devono essere racchiusi tra virgolette doppie ("ad es., "subscriber") e occorreinoltre utilizzare il nome interno delle opzioni della proprietà (ad es., "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 proprio fuso orario. Ciò significa che gli utenti in fusi orari diversi vedranno valori diversi.

Operatori

È possibile utilizzare gli operatori nelle equazioni 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 le funzioni all’interno di formule personalizzate per calcolare valori ed eseguire operazioni sui dati. A seconda del tipo di dati utilizzati, è possibile includere le seguenti funzioni nelle equazioni personalizzate.

Esempi di equazioni personalizzate

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

Utilizzo delle istruzioni if else

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

Ad esempio, è possibile creare un calcolo per contrassegnare le trattative attive. Il codice seguente 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 in valuta

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

Creare un

calcolo

a

intervallo

fisso

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

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

Nota: si raccomanda di essere precisi nell’inserimento del nome e della descrizione della proprietà. In questo modo gli utenti sono consapevoli dell’unità di tempo che viene calcolata (ad esempio, ore o giorni).

Calcolo degli sconti delle trattative in percentuale

Quando si utilizzano le voci di riga nelle trattative, è possibile utilizzare una proprietà di rollup e una di calcolo per monitorare lo sconto totale in percentuale. La proprietà di rollup somma la proprietà«Sconto totale calcolato» di tutte le voci di riga associate. La proprietà di calcolo divide la proprietà di rollup per se stessa più la proprietà«Importo» predefinita della trattativa.

Per creare la proprietà di rollup:

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

2. Nel menu della barra laterale sinistra, accedere a“Proprietà”.

3. Fare clic sulmenu a discesa “Seleziona un oggetto” e selezionare “Proprietà dell’affare”.

4. Fare clic suCrea proprietà.

5. Nel campo di testoEtichetta proprietà, inserisci "Importo dello sconto calcolato".
6. Fare clic sul menu a discesa Tipo di campo e selezionare Rollup.
7. Fare clic sul menu a discesaTipo di rollup e selezionareSomma.
8. Fare clic sul menua discesa "Formato numero" e selezionare "Valuta".
9. Fare clic sul menu a discesaScegli il tipo di record associato e selezionareVoce di riga.
10. Fare clic sul menu a discesa"Scegli la proprietà del record associato " e selezionare "Sconto totale calcolato".
11. Fare clic su Crea proprietà.

Per creare la proprietà di calcolo:

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

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

3. Fai clic sulmenu a discesa "Seleziona un oggetto" e seleziona " Proprietà dell'affare".

4. Fare clic suCrea proprietà.

5. Nel campo di testoEtichetta proprietà, inserisciPercentuale di sconto calcolata. 
6. Fare clic sul menu a discesa Tipo di campo e selezionare Calcolo.
7. Fai clic sul menu a discesa "Formato numero " e seleziona "Percentuale".
8. Nel campodi testo "Formula di calcolo", inserisci (Calculated discount amount / (Calculated discount amount + Amount)). Puoi anche fare clic su"Genera formula " per generarla con l'agente dati.
9. Fare clic su Crea proprietà.