Creare proprietà di calcolo e rollup

È possibile creare proprietà che popolano i dati in base ai calcoli di 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 sull'intervallo di tempo tra, fino a o dai valori delle proprietà, oppure creare equazioni personalizzate basate sulle proprietà di un oggetto.

Nota: l'account può utilizzare nomi personalizzati per ogni oggetto (ad esempio, account invece di azienda). Questo documento si riferisce agli oggetti con i loro nomi predefiniti di HubSpot.

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à contatto che calcola l'importo medio delle transazioni associate a un contatto.
• Una proprietà di un affare che calcola il tempo trascorso dall'apertura dell'affare.

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

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

È possibile creare proprietà per un oggetto che verranno calcolate in base a determinati valori delle 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 .

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

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

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

4. Inserire i dettagli di base della proprietà, quindi fare clic sulla scheda Tipo di campo.
5. Selezionare Rollup .
6. Fare clic sul menu a discesa Tipo di rollup e selezionare uno dei seguenti tipi:
   • Min: visualizza il valore minimo della proprietà number 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 selezionata su tutti i record associati dell'oggetto selezionato.
7. 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.
8. Se si seleziona Valuta come formato per una proprietà dell'affare, la proprietà utilizzerà per impostazione predefinita la valuta dell'azienda dell'account. 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.
9. Selezionare l'oggetto associato e la proprietà del record associato su cui calcolare la proprietà.
10. Per calcolare solo i record con un'etichetta specifica, fare clic su Seleziona etichette associazione, quindi selezionare le etichette da includere.
11. Per aggiungere ulteriori condizioni, fare clic su Aggiungi condizione. Quando si impostano condizioni aggiuntive, queste devono essere soddisfatte affinché la proprietà venga calcolata (ad esempio, calcolare la proprietà quando Importo affare recente > 1000 e Probabilità affare >= 80). È possibile configurare fino a 50 condizioni per ogni proprietà rollup.
    • Nel primo menu a tendina, 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, selezionate una proprietà o inserite un numero da confrontare con la prima proprietà.
    • Fare clic su Salva.
12. 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 calcolo della proprietà), potrebbe essere necessario utilizzare valori in millisecondi.

Creare proprietà di calcolo del tempo tra, del tempo dal o del tempo fino a quando

È possibile creare proprietà che calcolano l'intervallo di tempo tra due date o che tengono traccia del tempo trascorso da o fino a una data, determinata dai valori delle proprietà del selezionatore di data o di data e ora. Le proprietà di tempo tra due date sono supportate solo per le proprietà dello stesso oggetto.

Ad esempio:

• Creare una proprietà Tempo tra per calcolare l'intervallo di tempo tra l'assegnazione del proprietario di un ticket e la sua chiusura.
• Creare una proprietà Tempo dall'apertura per tenere traccia di quanto tempo è stata aperta una transazione.
• Creare una proprietà Tempo fino alla chiusura per calcolare quanto manca alla chiusura di un cliente.

Per creare una proprietà i cui valori visualizzano l'ora relativa in base alla data odierna piuttosto che al valore della proprietà, imparare a creare una proprietà di selezione data e ora relativa. È anche possibile creare una proprietà a tempo fisso utilizzando un'equazione personalizzata.

Per creare le proprietà di calcolo Tempo tra, Tempo dal o Tempo fino:

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

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

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

4. Inserire i dettagli di base della proprietà, quindi fare clic sulla scheda Tipo di campo .
5. Selezionare Calcolo come tipo di campo.
6. Fare clic sul menu a discesa Tipo di proprietà calcolata, quindi selezionare il tipo e impostare il calcolo:
   • Tempo tra: selezionare le proprietà Data inizio e Data fine .
   • Tempo dal: selezionare la proprietà del selezionatore di data e ora il cui valore sarà la data di inizio. La data finale sarà sempre la data odierna.
   • Tempo fino a: selezionare la proprietà del selezionatore di data e ora il cui valore sarà la data finale. La data di inizio sarà sempre la data odierna.
7. Solo per le proprietà Tempo tra, per aggiungere una condizione aggiuntiva, fare clic su Aggiungi condizione. Quando si impostano condizioni aggiuntive, queste devono essere soddisfatte affinché la proprietà venga calcolata (ad esempio, calcolare la proprietà quando Importo affare recente > 1000 e Probabilità affare >= 80).
   • Nel primo menu a tendina, selezionare una proprietà.
   • Nel secondo menu a tendina, 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 Salva.
8. Fare clic su Crea. Una volta creata, il tipo di campo visualizzato della proprietà sarà Calcolo. In seguito, non è possibile modificare se si tratta di Tempo tra, Tempo dal o Tempo fino, ma è possibile selezionare diverse proprietà di data iniziale o finale.

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

• Per le proprietà di data senza timestamp, l'ora predefinita utilizzata nel calcolo sarà le 12:00 UTC del giorno selezionato.
• Il valore visualizzato sarà 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ù vengono visualizzati in mesi.
  • 1 giorno o più viene visualizzato in giorni.
  • 2,5 ore o più verranno visualizzate in ore.
  • 2,5 minuti o più verranno visualizzati in minuti.
  • Meno di 2,5 minuti verranno visualizzati in secondi.

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.

Creare proprietà personalizzate per il calcolo delle equazioni

È 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 un'equazione personalizzata con operatori aritmetici, operatori di confronto, operatori logici, dichiarazioni condizionali e altre funzioni. Queste equazioni possono restituire valori numerici, booleani, stringhe, date o datetime. Per saperne di più sugli operatori e le funzioni disponibili e su come formattare le formule. È inoltre possibile esaminare esempi di formule comunemente utilizzate.

Per costruire una proprietà di calcolo 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, spostarsi su Proprietà.

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

4. Inserire i dettagli di base della proprietà, quindi fare clic sulla scheda Tipo di campo.
5. Selezionare Calcolo come tipo di campo.
6. Fare clic sul menu a discesa Tipo di proprietà calcolata, quindi selezionare 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 Ora.

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 uscita Numero o Data, che determina la modalità di visualizzazione dei valori (ad esempio, Numero visualizza la data in millisecondi, Data visualizza la data formattata).

8. Se è stato selezionato il tipo di output Numero:
   • Fare clic sul menu a discesa Formato numero, quindi selezionare il formato dei 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à 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.

9. 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 gli elementi della 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à.
10. Se l'equazione presenta degli 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.
11. Per visualizzare un'anteprima dell'output della formula, fare clic su Prova formula.
12. Fare clic su Crea. Una volta creata, il tipo di campo visualizzato della proprietà sarà Calcolo.

Sintassi delle equazioni personalizzate

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

  • Stringa letterale: testo circondato da virgolette. Possono essere rappresentati con apici singoli ('constant') o doppi ("constant").

  • Letterali numerici: 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.

  • 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à Test score, che ha un valore interno di Test_score, la si digita nell'editor come [properties.Test_score].
  • Quando si utilizzano proprietà di enumerazione in un'equazione (ad esempio, selezione a discesa, selezione radio), i valori sono considerati stringhe e devono essere racchiusi tra doppi apici ("ad esempio, "subscriber") e sideve anche utilizzare il nome interno delle opzioni della proprietà (ad esempio, "appointmentscheduled").
  • Quando si utilizzano le proprietà della data in un'equazione, i valori vengono memorizzati come mezzanotte UTC in millisecondi.
  • Quando si utilizzano le proprietà della data e dell'ora in un'equazione, i valori vengono memorizzati come epoca UTC in millisecondi. Questo valore viene visualizzato in base al fuso orario. Ciò significa che gli utenti con fusi orari diversi vedranno valori diversi.

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.

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 esempi di formule basate su casi d'uso comuni.

Utilizzare le istruzioni if else

È possibile impostare dichiarazioni if else, comprese le dichiarazioni con condizioni multiple e all'interno di funzioni.

Ad esempio, è possibile creare un calcolo per etichettare le operazioni attive. Il calcolo seguente restituirà Vero solo se lo stato di un affare è attivo e l'Importo è maggiore di zero.

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

Eseguire calcoli con valore nullo

Quando si utilizzano le proprietà numero in una formula personalizzata, è possibile includere le funzioni if e is_known per impostare il valore a 0 quando la proprietà numero è 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).
  
  

Aggiunta del tasso di cambio a un calcolo di valuta

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

Creare un calcolo a tempo fisso

È possibile impostare un calcolo per ottenere l'ora fissa 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 esempio restituirà un valore a giorni fissi:

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

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