Questa pagina descrive i file di dati creati da RCS for Business per aiutare gli operatori statunitensi con la fatturazione e l'audit nell'ambito del framework RBM statunitense. Per saperne di più sul framework RBM statunitense, puoi anche consultare usrbm.org.
Il report sulla fatturazione è un report aggregato degli eventi fatturabili tra gli agenti lanciati e gli utenti. Fatturabile significa semplicemente che un evento è idoneo per un addebito. Gli operatori determinano se e come vengono addebitati gli eventi fatturabili. Tutti gli operatori statunitensi che utilizzano attivamente RCS for Business hanno accesso ai report sulla fatturazione.
Per i dettagli sul modello di classificazione della fatturazione statunitense, consulta le domande frequenti sulla fatturazione statunitense.
Generazione di file
Per ulteriori informazioni, consulta la sezione sulla generazione di file .
Archiviazione e accesso ai file
Per ulteriori informazioni, consulta la sezione sull' archiviazione e l'accesso ai file.
Disponibilità dei file
Per ulteriori informazioni, consulta la sezione sulla disponibilità dei file.
Report sulla fatturazione
I report sulla fatturazione sono record di eventi fatturabili, calcolati in base alla categoria di fatturazione dell'agente e al tipo di messaggi inviati. I report sulla fatturazione sono disponibili per tutti gli operatori che utilizzano attivamente RCS for Business.
I report sulla fatturazione contengono informazioni riservate, ma non informazioni che consentono l'identificazione personale (PII) dell'utente, come MSISDN, MSISDN con hash o qualsiasi identificatore univoco dell'utente.
Categorie di fatturazione ed eventi fatturabili
La distinzione tra le categorie di fatturazione degli agenti e gli eventi fatturabili è fondamentale per capire come viene fatturato il tuo agente.
- La categoria di fatturazione è una classificazione fissa che scegli quando crei l'agente. Determina il metodo con cui l'agente è fatturabile: per messaggio (agenti non conversazionali) o per sessione (agenti conversazionali).
- Gli eventi fatturabili sono interazioni tra un agente RCS for Business e un utente che vengono monitorate a fini di fatturazione (ad esempio,
rich_message).
Categorie di fatturazione degli agenti statunitensi
Quando crea un agente, il proprietario ne imposta la categoria di fatturazione in base al modo in cui l'agente interagirà con gli utenti. La categoria di fatturazione non limita il numero o il tipo di messaggi che un agente può inviare. Tuttavia, determina in che modo l'agente verrà fatturato per i messaggi. Le due categorie di fatturazione principali sono descritte nella tabella seguente.
| Categoria di fatturazione | Tipo di agente | Esempi di casi d'uso | Metodo di fatturazione |
|---|---|---|---|
| Non conversazionale | Agenti che inviano principalmente messaggi unidirezionali. |
|
Fatturabile per ogni messaggio recapitato all'utente. |
| Conversazionale | Agenti progettati per scambi bidirezionali con gli utenti, indipendentemente da chi avvia la conversazione. |
|
Fatturabile per sessione: se i criteri della sessione vengono soddisfatti, tutti i messaggi rich e rich media all'interno della finestra di sessione di 24 ore sono fatturabili a un costo fisso, indipendentemente dalla lunghezza o dai segmenti. Fatturabile per messaggio: se i criteri della sessione non vengono soddisfatti o se un messaggio non rientra nella finestra di sessione di 24 ore, il messaggio viene fatturato singolarmente a una tariffa per messaggio per i messaggi rich o rich media in base al tariffario del singolo operatore. |
Agenti conversazionali e non conversazionali
Esistono due categorie di fatturazione degli agenti: conversazionale e non conversazionale.
Gli agenti non conversazionali sono fatturabili per ogni messaggio recapitato all'utente.
- Questa categoria è ideale per gli agenti che non prevedono risposte frequenti.
Gli agenticonversazionali sono fatturabili a una tariffa fissa per le sessioni a condizione che venga attivata una sessione, che includerà tutti i messaggi scambiati in un periodo di 24 ore, inclusi i messaggi che hanno attivato la sessione. Gli agenti conversazionali possono comunque addebitare i messaggi che non fanno parte di una sessione di 24 ore.
- Questa categoria è ideale per gli agenti che partecipano a conversazioni a più turni con gli utenti.
Logica di fatturazione delle sessioni
Nell'ambito del modello di fatturazione statunitense, una sessione viene attivata da una sequenza di 4 messaggi rich o rich media (inclusi almeno 2 messaggi MO e almeno 1 messaggio MT) scambiati in una finestra di 24 ore dal primo messaggio della sequenza di attivazione. Una volta raggiunta questa soglia, tutti i messaggi all'interno della finestra di 24 ore sono fatturabili come singola sessione. Tutti i messaggi che non rientrano in una sessione o non la attivano sono fatturabili alla tariffa per messaggio standard per i messaggi rich o rich media in base al listino prezzi del singolo operatore.
Il seguente diagramma mostra un esempio di sessione di fatturazione A2P per gli agenti conversazionali.
- MT (Mobile Terminated) è un messaggio inviato dall'attività.
- MO (Mobile Originated) è un messaggio o un'azione avviata dall'utente.
Eventi fatturabili
I flussi di messaggi sono classificati in base all'origine e alla direzione. Per descrivere la direzione del traffico di messaggi, gli operatori statunitensi utilizzano in genere la terminologia MT/MO. Questi termini corrispondono alla terminologia A2P/P2A utilizzata nella documentazione di RCS for Business. Ecco una breve suddivisione di come questi termini si allineano:
- A2P (Application-to-Person) è MT (Mobile Terminated): un messaggio inviato da l'attività.
- P2A (Person-to-Application) è MO (Mobile Originated): un messaggio o un'azione avviata dall'utente.
| Evento | Descrizione | Agenti non conversazionali | Agenti conversazionali |
|---|---|---|---|
a2p_rich_message |
Un messaggio inviato da un agente contenente solo testo, risposte suggerite o azioni suggerite specifiche (chiama un numero, apri l'URL nel browser). | Viene sempre trattato come un singolo evento fatturabile. Fatturabile per messaggio in base ai segmenti (1 segmento equivale a 160 byte UTF-8). |
Viene trattato come un singolo evento fatturabile, a meno che non diventi parte di una sessione. |
p2a_rich_message |
Un messaggio inviato da un utente contenente solo testo in formato libero o testo ottenuto toccando una risposta suggerita. | Viene sempre trattato come un singolo evento fatturabile. Fatturabile per messaggio in base ai segmenti. |
Viene trattato come un singolo evento fatturabile, a meno che non diventi parte di una sessione. |
a2p_rich_media_message |
Un messaggio inviato da un agente contenente contenuti multimediali (immagine, video, audio), schede rich, caroselli o azioni complesse come "Visualizza posizione". | Viene sempre trattato come un singolo evento fatturabile. Fatturabile come un singolo evento a tariffa fissa, indipendentemente dalle dimensioni o dai contenuti. |
Viene trattato come un singolo evento fatturabile, a meno che non diventi parte di una sessione. |
p2a_rich_media_message |
Un messaggio inviato da un utente contenente un file multimediale caricato (immagine, video, audio). | Viene sempre trattato come un singolo evento fatturabile. Fatturabile come un singolo evento a tariffa fissa. |
Viene trattato come un singolo evento fatturabile, a meno che non diventi parte di una sessione. |
p2a_suggested_action |
Un utente tocca un'azione suggerita (ad es. "Visualizza posizione") che non è una risposta suggerita. | Viene sempre trattato come un singolo evento fatturabile. Genera un evento fatturabile per clic. |
Viene trattato come un singolo evento fatturabile e genera un evento fatturabile per clic, a meno che non diventi parte di una sessione. |
a2p_session |
Una finestra di interazione di 24 ore che inizia quando viene avviato un trigger di sessione e il primo messaggio è MT. Per ulteriori informazioni, consulta la sezione Che cos'è una sessione e come funziona. | N/D. Le sessioni non si applicano agli agenti non conversazionali. | Una volta attivata, tutti i messaggi nella finestra di 24 ore sono coperti da una singola tariffa di sessione. A qualsiasi evento fatturabile nella sessione di 24 ore verrà assegnato l'ID evento fatturabile della sessione. |
p2a_session |
Una finestra di interazione di 24 ore che inizia quando viene avviato un trigger di sessione e il primo messaggio è MO. Per ulteriori informazioni, consulta la sezione Che cos'è una sessione e come funziona. | N/D. Le sessioni non si applicano agli agenti non conversazionali. | Una volta attivata, tutti i messaggi nella finestra di 24 ore sono coperti da una singola tariffa di sessione. A qualsiasi evento fatturabile nella sessione di 24 ore verrà assegnato l'ID evento fatturabile della sessione. |
Generazione di report sulla fatturazione
Solo gli agenti con traffico non di test generano eventi fatturabili. L'attività dei numeri di telefono di test non viene visualizzata nei report sulla fatturazione.
Questi report presuppongono che gli eventi siano fatturabili quando vengono recapitati i messaggi A2P, non quando vengono inviati. Un messaggio non recapitato o annullato prima del recapito non attiva un evento fatturabile.
Formato dei report sulla fatturazione
I report sulla fatturazione utilizzano il formato del nome file rbm_billable_events_YYYY-MM-DD.csv.
La data nel nome file è la data di generazione del file.
Ogni riga del report è un record che rappresenta un singolo evento fatturabile.
Le sessioni A2P/P2A sono rappresentate da più righe, una per ogni messaggio scambiato. Ogni riga associata a una sessione (che condivide lo stesso billing_event_id) riporta il numero totale di messaggi MT e MO per l'intera finestra di sessione di 24 ore nelle colonne mt_messages e mo_messages.
Ogni record del report contiene le seguenti informazioni per ogni evento fatturabile.
| Campo | Formato | Descrizione | Esempio |
|---|---|---|---|
billing_event_id |
stringa | ID generato che distingue l'evento fatturabile. Tutti i messaggi che fanno parte di una sessione avranno lo stesso |
63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type |
stringa | Tipo di evento:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action |
p2a_rich_message |
agent_id |
stringa | Identificatore univoco dell'agente che ha partecipato all'evento. | acme_342h23_agent@rbm.goog |
agent_owner |
stringa | Indirizzo email del proprietario attuale dell'account partner in cui è stato creato l'agente. | marketing@xyzaggregator.com |
billing_party |
stringa | Parte che fattura gli eventi. | operatore |
max_duration_single_message |
numero | Tempo massimo (in ore) consentito a un utente per rispondere a un messaggio dell'agente prima che la finestra di avvio della conversazione si chiuda e il messaggio venga classificato come evento single_message. Non applicabile al modello statunitense per i singoli messaggi rich. |
24 |
max_duration_a2p_conversation |
numero | Per il progetto pilota delle sessioni, questo valore riflette la finestra di sessione di 24 ore misurata dal primo messaggio della sequenza di attivazione. La durata è misurata in ore. | 24 |
max_duration_p2a_conversation |
numero | Per il progetto pilota delle sessioni, questo valore riflette la finestra di sessione di 24 ore misurata dal primo messaggio della sequenza di attivazione. | 24 |
start_time |
YYYY-mm-ddTHH:00:00Z | La data/ora di inizio dell'evento in formato UTC (ISO 8601). Per le sessioni, questo è il timestamp del primo messaggio della sequenza di attivazione. A2P a2p_rich_message e a2p_rich_media_message, questo è il momento in cui il messaggio viene recapitato all'utente.a2p_session, questo è il momento in cui il primo messaggio della conversazione viene recapitato all'utente.P2A p2a_rich_message e p2a_rich_media_message, questo è il momento in cui il messaggio viene inviato dall'utente.p2a_session, questo è il momento in cui il primo messaggio della conversazione viene inviato dall'utente. |
2025-05-20T08:00:00Z |
duration |
numero | La durata si riferisce solo alle sessioni ed è misurata in minuti. Quando l'evento non è di sessione, il valore è 0. | 45 |
mt_messages |
numero | Numero di messaggi mobile-terminated (A2P) nell'evento. Per le sessioni, ogni riga che condivide lo stesso billing_event_id mostra il numero totale di messaggi MT nell'intera sessione. |
5 |
mo_messages |
numero | Numero di messaggi mobile-originated (P2A) nell'evento. Per le sessioni, ogni riga che condivide lo stesso billing_event_id mostra il numero totale di messaggi MO nell'intera sessione. |
3 |
size_kilobytes |
numero | Dimensioni di tutti i file allegati ai messaggi nell'evento, arrotondate al kilobyte più vicino (1 kB equivale a 1024 byte). | 912 |
agent_name |
stringa | Nome dell'agente che ha partecipato all'evento. | ACME Brand |
owner_name |
stringa | Nome del proprietario attuale dell'account partner in cui è stato creato l'agente. | XYZ Aggregator |
segment_count |
numero | Il conteggio dei segmenti calcolato per gli eventi a2p_rich_message events e p2a_rich_message (1 segmento equivale a 160 byte UTF-8). Se l'evento non è uno di quelli menzionati, il valore è 0. |
5 |
session_type |
stringa | Tipo di sessione:a2p_sessionp2a_session |
a2p_session |
Esempio di report sulla fatturazione
Il report di esempio è disponibile per il download:
Dimensioni tipiche dei file
Le dimensioni di un report giornaliero di un partner RCS for Business attivo dipendono dalla quantità di attività generata sulla rete dell'operatore.