Service design

Service design comprende i componenti essenziali configurabili in Monetization per riconoscere eventi di utilizzo, estrarre parametri, determinare conversioni di unità e calcolare la quantità da valutare.

Argomenti in questo documento:

Per accedere a questa sezione in Monetization, dal Menu, seleziona Business configuration e fai clic su Service design.

Campi servizio

Per accedere a questa sezione, fai clic su Service fields. Viene visualizzato un elenco impaginato di tutti i campi servizio in formato tabellare.

Un campo servizio è un parametro che può fare parte di un tipo servizio. Il parametro contiene informazioni su una sessione/evento in Monetization.

Esempio di campi servizio

Considera un’azienda di telecomunicazioni che consente ai clienti di effettuare chiamate. I campi servizio possono includere quanto segue:

  • start_time
  • origin
  • destination
  • duration
  • direction
  • quantity

Campi riservati

session identifier e identifier sono campi riservati che devono esistere tra i campi servizio. Vengono creati automaticamente quando viene creato un site in Monetization.

identifier rappresenta l’identificativo del servizio di un cliente, ad esempio un numero di cellulare per il servizio dati o voce. L’identificativo deve essere univoco per ogni site; può essere un numero intero, un dispositivo o qualsiasi valore utilizzabile per identificare univocamente un cliente.

session identifier deve essere incluso in ogni evento di utilizzo. Questo garantisce che lo stesso evento venga valutato una sola volta e non possa essere duplicato.


In questa sezione sono disponibili quattro azioni/sottopagine:

Creare un campo servizio

In campi servizio, per creare un campo servizio, fai clic su Create new. Inserisci nome e codice. Facoltativamente, aggiungi una descrizione.

Pagina dettagli del campo servizio

In campi servizio, per vedere tutti i dettagli di un campo servizio, fai clic su Details. Contiene quanto segue:

  • Name
  • Code
  • Descrizione

Aggiornare un campo servizio

In campi servizio, per aggiornare un campo servizio, fai prima clic su Details; vengono mostrati i dettagli del campo servizio. Quindi, per aggiornarlo, fai clic su Update.

Eliminare un campo servizio

In campi servizio, per eliminare un campo servizio, fai clic su Delete.

Tipi servizio

Per accedere a questa sezione, fai clic su Service types. Viene visualizzato un elenco impaginato di tutti i tipi servizio in formato tabellare.

Un tipo servizio descrive un servizio in Monetization, ad esempio un servizio voce o dati. Determina quali campi servizio devono fare parte di una sessione/evento per quel servizio specifico.

Inoltre, un tipo servizio definisce un servizio indicando i campi servizio facoltativi o obbligatori e i campi rating set di cui Monetization ha bisogno negli eventi di utilizzo per uno specifico servizio.


In questa sezione sono disponibili quattro azioni/sottopagine:

Creare un tipo servizio

In tipi servizio, per creare un tipo servizio, fai clic su Create new.

I campi obbligatori includono quanto segue:

  • name
  • code
  • mandatory service field(s)
  • authorization strategy

I campi facoltativi includono quanto segue:

  • description
  • optional service field(s)
  • rating set fields
  • Included on invoice
  • Impact balances

Per includere i dettagli del servizio nella fattura, usa l’interruttore Included on invoice per abilitare o disabilitare la funzione. L’abilitazione indica che Monetization includerà questi dati nell’oggetto JSON generato per una fattura.

Se l’interruttore Impact balances è abilitato, questo servizio impatterà, riserverà e userà i saldi in tempo reale. Se non è necessario, disabilitarlo migliora le prestazioni di rating.

Campi rating set

Un campo rating set è un campo che, invece di essere confrontato come stringa grezza, viene confrontato con un oggetto rating sets, che può avere più corrispondenze. È utile per il confronto dei prefissi.

Esempio di campo rating set

I rating set della Slovenia nel settore delle telecomunicazioni possono avere più corrispondenze: 003865, 003867, 003864, ecc., che rappresentano prefissi telefonici. Se un campo servizio origin è definito come campo rating set su un tipo servizio, il contenuto del campo verrà confrontato con tutti i prefissi della Slovenia quando Monetization cerca una corrispondenza. Quindi, se origin è 003865123123, verrà trovato il rating set Slovenia.

Pagina dettagli del tipo servizio

In tipi servizio, per vedere tutti i dettagli di un tipo servizio, fai clic su Details. Contiene quanto segue:

  • Name
  • Code
  • Descrizione
  • Mandatory fields
  • Optional fields
  • Rating set fields
  • Authorization strategy
  • Included on invoice
  • Impact balances

Aggiornare un tipo servizio

In tipi servizio, per aggiornare un tipo servizio, fai prima clic su Details; vengono mostrati i dettagli del tipo servizio. Quindi, per aggiornarlo, fai clic su Update.

Eliminare un tipo servizio

In tipi servizio, per eliminare un tipo servizio, fai clic su Delete.

Gruppi unità

Per accedere a questa sezione, fai clic su Unit groups. Viene visualizzato un elenco impaginato di tutti i gruppi unità in formato tabellare.

Un gruppo unità serve a creare unità correlate in Monetization. Deve essere fornito anche un fattore di conversione per consentire a Monetization di eseguire automaticamente le conversioni tra unità.

Esempio di gruppo unità

Considera un’azienda di telecomunicazioni che fornisce servizi dati ai clienti. Dopo aver configurato le unità in kilobyte (kB), megabyte (MB) e gigabyte (GB), l’evento di utilizzo può avere input in kB, mentre il pricing può funzionare in MB.


In questa sezione sono disponibili quattro azioni/sottopagine:

Creare un gruppo unità

In gruppi unità, per creare un gruppo unità, fai clic su Create new. Inserisci nome e codice. Facoltativamente, inserisci una descrizione e alcune unità.

Per aggiungere un’unità, in Units, fai clic su Add unit. Inserisci nome, simbolo e fattore. Per impostare una specifica unità come unità base, seleziona la casella Base unit.

Ad esempio, considera le seguenti unità in un gruppo unità:

Tabella 1: Esempio di gruppo unità

NameSymbolFactorBase unit
kilobytekB1
megabyteMB1024
gigabyteGB1048576

Per eliminare un’unità, in Units, fai clic su Delete.

Pagina dettagli del gruppo unità

In gruppi unità, per vedere tutti i dettagli di un gruppo unità, fai clic su Details. Contiene quanto segue:

  • Name
  • Code
  • Descrizione
  • Units - le unità in formato tabellare.

Aggiornare un gruppo unità

In gruppi unità, per aggiornare un gruppo unità, fai prima clic su Details; vengono mostrati i dettagli del gruppo unità. Quindi, per aggiornarlo, fai clic su Update.

Eliminare un gruppo unità

In gruppi unità, per eliminare un gruppo unità, fai clic su Delete.

Metriche di rating

Per accedere a questa sezione, fai clic su Rating metrics. Viene visualizzato un elenco impaginato di tutte le metriche di rating in formato tabellare.

Monetization usa una metrica di rating per determinare la quantità da valutare in base ai campi servizio della sessione/evento. In altre parole, una metrica di rating consente a Monetization di sapere come ricavare la quantità valutabile da un evento.


In questa sezione sono disponibili quattro azioni/sottopagine:

Creare una metrica di rating

In metriche di rating, per creare una metrica di rating, fai clic su Create new. Inserisci nome e codice. Facoltativamente, inserisci una descrizione e una o più espressioni metriche.

Per aggiungere un’espressione metrica, in Metric expressions, fai clic su Add metric expression. Inserisci priorità, espressione e unità. L’unità è configurata nei gruppi unità. Per ulteriori informazioni, vedi gruppi unità.

Ad esempio, se un campo servizio quantity viene inserito come espressione della metrica di rating, Monetization ricaverà la quantità valutabile dal campo servizio quantity.

In un’espressione metrica è possibile usare espressioni matematiche di base, come addizione, sottrazione e moltiplicazione, per determinare la quantità valutabile. Ad esempio, considera i campi servizio end_time e start_time; da questi può essere creata un’espressione di metrica di rating nella forma end_time - start_time.

Pagina dettagli della metrica di rating

In metriche di rating, per vedere tutti i dettagli di una metrica di rating, fai clic su Details. Contiene quanto segue:

  • Name
  • Code
  • Descrizione
  • Metric expressions - le espressioni metriche in formato tabellare.

Aggiornare una metrica di rating

In metriche di rating, per aggiornare una metrica di rating, fai prima clic su Details; vengono mostrati i dettagli della metrica di rating. Quindi, per aggiornarla, fai clic su Update.

Eliminare una metrica di rating

In metriche di rating, per eliminare una metrica di rating, fai clic su Delete.

Intervalli di addebito

Per accedere a questa sezione, fai clic su Charge intervals. Viene visualizzato un elenco impaginato di tutti gli intervalli di addebito in formato tabellare.

Un intervallo di addebito descrive come Monetization arrotonderà la quantità valutabile dalla metrica di rating. Dopo che la metrica di rating calcola la quantità grezza da valutare, l’intervallo di addebito può arrotondare per eccesso o per difetto in base alle configurazioni.


In questa sezione sono disponibili quattro azioni/sottopagine:

Creare un intervallo di addebito

In intervalli di addebito, per creare un intervallo di addebito, fai clic su Create new. Inserisci nome e codice. Facoltativamente, inserisci descrizione, passo minimo, passo, modalità di arrotondamento e unità.

Il passo minimo rappresenta la quantità più piccola che può essere valutata. Pertanto, se Monetization riceve un evento al di sotto di tale valore, verrà arrotondato al passo minimo. Ad esempio, considera una configurazione del passo minimo pari a zero: se Monetization riceve un evento inferiore a zero, l’evento verrà arrotondato a zero.

Il passo rappresenta come deve incrementare la quantità valutabile. Ad esempio, Monetization riceve un evento e calcola tramite la metrica di rating una quantità valutabile pari a 550; se il passo è configurato a 100, Monetization arrotonderà la quantità per eccesso o per difetto in base alla configurazione della modalità di arrotondamento.

Se la modalità di arrotondamento è configurata su Up, la nuova quantità valutabile sarà 600; se la modalità di arrotondamento è configurata su Down, il nuovo importo valutabile sarà 500.

Pagina dettagli dell’intervallo di addebito

In intervalli di addebito, per vedere tutti i dettagli di un intervallo di addebito, fai clic su Details. Contiene quanto segue:

  • Name
  • Code
  • Descrizione
  • Min step
  • Step
  • Rounding mode
  • Unit

Aggiornare un intervallo di addebito

In intervalli di addebito, per aggiornare l’intervallo di addebito, fai prima clic su Details; vengono mostrati i dettagli dell’intervallo di addebito. Quindi, per aggiornarlo, fai clic su Update.

Eliminare un intervallo di addebito

In intervalli di addebito, per eliminare un intervallo di addebito, fai clic su Delete.