Questa pagina descrive i file di dati creati da RCS for Business per aiutare gli operatori statunitensi con la fatturazione e l'audit ai sensi 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 agenti e utenti avviati. Fatturabile significa semplicemente che un evento è idoneo a 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 informazioni dettagliate sul modello di classificazione della fatturazione statunitense, consulta le domande frequenti sulla fatturazione statunitense.
Generazione di file
Per saperne di più, consulta Generazione di file.
Archiviazione e accesso ai file
Per saperne di più, vedi Archiviazione e accesso ai file.
Disponibilità dei file
Per maggiori informazioni, vedi Disponibilità dei file.
Report sulla fatturazione
I report sulla fatturazione sono registrazioni di eventi fatturabili, che vengono calcolati in base alla categoria di fatturazione dell'agente e al tipo di messaggi che invia. 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 categorie di fatturazione e eventi fatturabili dell'agente è fondamentale per capire come viene fatturato l'agente.
- La categoria di fatturazione è una classificazione fissa che scegli quando crei l'agente. Determina il metodo in base al quale 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. ma 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 inviato 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 durata o dai segmenti. Fatturabile per messaggio: se i criteri della sessione non vengono soddisfatti o 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 che inviano all'utente.
- Questa categoria è ideale per gli agenti che non si aspettano risposte frequenti.
Gli agenti conversazionali sono fatturabili a un costo fisso per sessione/i 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 multi-turn con gli utenti.
Logica di fatturazione della sessione
In base al 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 entro un periodo di 24 ore dal primo messaggio della sequenza di attivazione. Una volta raggiunto questo limite, tutti i messaggi all'interno di questo periodo di 24 ore sono fatturabili come singola sessione. 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 messaggistica sono classificati in base all'origine e alla direzione. Per descrivere la direzione del traffico di messaggistica, 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 rapida analisi di come si allineano questi termini:
- A2P (Application-to-Person) è MT (Mobile Terminated): un messaggio inviato dall'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 (componi 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). |
Trattato come un singolo evento fatturabile, a meno che non diventi parte di una sessione. |
p2a_rich_message |
Un messaggio inviato dall'utente contenente solo testo in formato libero o testo ottenuto toccando una risposta suggerita. | Sempre trattato come un singolo evento fatturabile. Fatturabile per messaggio in base ai segmenti. |
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 interattive, caroselli o azioni complesse come "Visualizza posizione". | Viene sempre trattato come un singolo evento fatturabile. Fatturabile come evento a tariffa fissa singolo, indipendentemente dalle dimensioni o dal contenuto. |
Trattato come un singolo evento fatturabile, a meno che non diventi parte di una sessione. |
p2a_rich_media_message |
Un messaggio inviato dall'utente contenente un file multimediale caricato (immagine, video, audio). | Viene sempre trattato come un singolo evento fatturabile. Fatturabile come evento singolo a tariffa fissa. |
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. | Sempre trattato come un singolo evento fatturabile. Genera un evento fatturabile per clic. |
Considerato 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 attivato un trigger di sessione e il primo messaggio è MT. Per saperne di più, consulta Che cos'è una sessione e come funziona. | N/D. Le sessioni non si applicano agli agenti non conversazionali. | Una volta attivato, tutti i messaggi nell'arco 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 attivato un trigger di sessione e il primo messaggio è MO. Per saperne di più, consulta Che cos'è una sessione e come funziona. | N/D. Le sessioni non si applicano agli agenti non conversazionali. | Una volta attivato, tutti i messaggi nell'arco 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 del 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 temporale della sessione di 24 ore nelle colonne mt_messages e mo_messages.
I file sono codificati in UTF-8 senza un indicatore di ordine dei byte e utilizzano avanzamenti riga per le interruzioni di riga. La prima riga di ogni file è una riga di intestazione con i nomi dei campi.
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 dell'attuale proprietario dell'account partner in cui è stato creato l'agente. | marketing@xyzaggregator.com |
billing_party |
stringa | La parte che fattura gli eventi. | operatore |
max_duration_single_message |
numero | Tempo massimo (in ore) consentito a un utente per rispondere al messaggio di un 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 messaggi avanzati individuali. |
24 |
max_duration_a2p_conversation |
numero | Per il progetto pilota sulle sessioni, questo valore riflette la finestra di sessione di 24 ore misurata a partire dal primo messaggio nella sequenza di trigger. La durata viene misurata in ore. | 24 |
max_duration_p2a_conversation |
numero | Per il progetto pilota sulle sessioni, questo valore riflette la finestra di sessione di 24 ore misurata a partire dal primo messaggio nella sequenza di trigger. | 24 |
start_time |
YYYY-mm-ddTHH:00:00Z | La data e l'ora UTC di inizio dell'evento (ISO 8601). Per le sessioni, questo è il timestamp del primo messaggio nella sequenza di trigger. 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 l'utente invia il messaggio.p2a_session, questo è il momento in cui l'utente invia il primo messaggio della conversazione. |
2025-05-20T08:00:00Z |
duration |
numero | La durata si riferisce solo alle sessioni ed è misurata in minuti. Quando l'evento non è un evento di sessione, il valore è 0. | 45 |
mt_messages |
numero | Numero di messaggi terminati sul dispositivo mobile (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 inviati da dispositivo mobile (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 | Il nome dell'agente che ha partecipato all'evento. | ACME Brand |
owner_name |
stringa | Il 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). Quando 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 del file
Le dimensioni di un report giornaliero di un partner RCS for Business attivo dipendono dalla quantità di attività generata sulla rete dell'operatore.