Questa pagina descrive i file di dati creati da RCS for Business per aiutare gli operatori con la fatturazione e il controllo.
| File | Descrizione | Chi ha accesso |
|---|---|---|
| Report di fatturazione | Report aggregato degli eventi fatturabili tra agenti e utenti avviati. | Tutti gli operatori che utilizzano attivamente RCS for Business. |
| Log delle attività | Log dei dati non elaborati dell'attività RCS for Business, inclusi gli eventi fatturabili. | Operatori che utilizzano attivamente RCS for Business e gestiscono il servizio Google RCS in base ai propri Termini di servizio. |
RCS for Business utilizza due modelli di fatturazione: il modello di fatturazione standard per il traffico non statunitense e il modello di fatturazione statunitense per il traffico statunitense. Le informazioni uniche per il modello standard o per il modello statunitense (ad esempio, classificazioni di eventi fatturabili o campi dei report diversi) sono indicate esplicitamente.
- Per informazioni dettagliate sul modello di fatturazione standard e un riepilogo delle differenze tra i modelli di fatturazione, consulta le domande frequenti sulla fatturazione.
- Per informazioni dettagliate sulle classificazioni di fatturazione negli Stati Uniti, consulta la guida al modello di fatturazione per gli Stati Uniti.
Generazione di file
Ogni file di dati rappresenta un giorno di utilizzo di RCS for Business nel fuso orario UTC (Coordinated Universal Time). I file vengono generati ogni giorno. Il processo di generazione può richiedere diverse ore e il tempo di completamento può variare.
Per gli agenti non conversazionali, i file contengono dati del periodo di 24 ore che precede immediatamente l'ora di generazione del file. Ad esempio, se un report sulla fatturazione viene generato alle 11:00 UTC del 5 maggio, conterrà dati dalle 11:00 UTC del 4 maggio alle 11:00 UTC del 5 maggio.
Per gli agenti conversazionali, i file contengono dati del periodo di 24 ore 1-2 giorni prima dell'ora di generazione del file. Ad esempio, se un report di fatturazione viene generato alle 11:00 UTC del 5 maggio, potrebbe contenere dati dalle 11:00 UTC del 3 maggio alle 11:00 UTC del 4 maggio.
Il ritardo è dovuto al fatto che l'attività RCS for Business per gli agenti conversazionali è collegata alle conversazioni, che possono richiedere fino a 48 ore. Questo ritardo consente a RCS for Business di acquisire tutti i messaggi all'interno di una conversazione prima di calcolare l'evento fatturabile. Per ulteriori informazioni sugli agenti conversazionali, consulta Categorie di fatturazione degli agenti.
Punti chiave:
Nessuna attività: se non viene rilevata alcuna attività sulla piattaforma in un determinato giorno, non viene generato alcun file.
Denominazione: la data nel nome file è la data di generazione del file, non la data dei dati al suo interno.
Conservazione: i file vengono archiviati per un massimo di 63 giorni prima di essere eliminati.
Puoi utilizzare questi file per aggiornare il data warehouse con le metriche di utilizzo della piattaforma più recenti.
Archiviazione e accesso ai file
I file di dati sono criptati at-rest e durante il trasferimento.
Per recuperare i file di dati tramite SFTP (Secure File Transfer Protocol), fornisci la chiave pubblica SFTP. Per generare le chiavi, vedi Generare una coppia di chiavi SSH (Secure Shell) per una casella personale SFTP.
Il server SFTP è partnerupload.google.com e la connessione avviene su una porta
numero elevato (19321) per una maggiore sicurezza.
Puoi utilizzare il seguente comando per accedere ai file di dati:
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Google fornisce i nomi utente dell'account nei seguenti formati:
rbmreports-billableevents-<carrier name>rbmreports-activity-<carrier name>
Google specifica <carrier name> e fornisce un account separato per ogni tipo di report.
Vengono forniti account separati per accedere ai diversi tipi di report.
Disponibilità dei file
Se non sono ancora stati generati file di dati, verrà visualizzato un errore SFTP simile a
remote readdir("/"): No such file or directory, il che è normale.
Se non ci sono dati sul traffico RCS for Business da segnalare, non verrà generato alcun file. Ciò significa che potrebbero esserci giorni in cui non vengono generati file. Se hai bisogno di file vuoti per semplificare la procedura, contatta rbm-support@google.com.
Report sulla fatturazione
I report di fatturazione sono record 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 di fatturazione contengono informazioni riservate, ma non informazioni che consentono l'identificazione personale (PII) dell'utente, come MSISDN, MSISDN sottoposto ad hashing o qualsiasi identificatore univoco dell'utente.
Categorie di fatturazione degli agenti
Quando crei 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 come verranno fatturati i messaggi all'agente. 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 |
|---|---|---|---|
| Addebiti non relativi a conversazioni | Agenti che inviano principalmente messaggi unidirezionali. |
|
Addebito per ogni messaggio recapitato all'utente. |
| Conversazionale | Agenti progettati per scambi di messaggi con gli utenti. |
|
Fatturazione per conversazione: se una delle parti (l'agente o l'utente) risponde a un messaggio dell'altra parte entro 24 ore, viene avviata una conversazione. Durante la finestra di conversazione (24 ore dopo la prima risposta), l'agente e l'utente possono scambiarsi un numero qualsiasi di messaggi e all'agente verrà addebitata una tariffa fissa per la conversazione. Fatturazione per messaggio: Se l'agente invia un messaggio a cui l'utente non risponde entro 24 ore, all'agente verrà addebitato il costo del singolo messaggio, in modo simile a un agente non conversazionale. |
Il seguente diagramma mostra un esempio di sessione di fatturazione A2P per gli agenti conversazionali:
Agenti conversazionali e non conversazionali
Esistono due categorie di fatturazione principali: conversazionale e non conversazionale.
La principale differenza tra le categorie di fatturazione riguarda gli agenti conversazionali e non conversazionali:
Gli agenti non conversazionali vengono fatturati per ogni messaggio che inviano all'utente.
- Questa categoria è ideale per gli agenti che non si aspettano risposte frequenti.
Gli agenti conversazionali vengono fatturati a una tariffa fissa per le conversazioni, che includono tutti i messaggi scambiati nell'arco di 24 ore.
- Questa categoria è ideale per gli agenti che partecipano a conversazioni multi-turn con gli utenti.
Eventi fatturabili
Nei report di fatturazione vengono registrati cinque tipi di eventi fatturabili. Questi eventi includono gli eventi MT e MO, che vengono definiti eventi A2P e P2A.
- 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.
La seguente tabella descrive ogni evento fatturabile in base all'applicazione agli agenti non conversazionali e conversazionali.
| Evento | Descrizione | Agenti non conversazionali | Agenti conversazionali |
|---|---|---|---|
basic_message
|
Messaggio A2P che include solo testo con un massimo di 160 caratteri. Se il testo include un URL per un sito web con tag Open Graph, il messaggio potrebbe mostrare un'anteprima dell'immagine, senza costi aggiuntivi per il partner. | Viene sempre trattato come un singolo evento fatturabile, indipendentemente dal fatto che l'utente risponda. | Trattato come un singolo evento fatturabile, a meno che l'utente non risponda entro 24 ore. In questo caso, il messaggio diventa parte di un a2p_conversation.
|
single_message
|
Messaggio A2P con contenuti rich media o messaggio di solo testo con più di 160 caratteri. | Viene sempre trattato come un singolo evento fatturabile, indipendentemente dal fatto che l'utente risponda. | Trattato come un singolo evento fatturabile, a meno che l'utente non risponda entro 24 ore. In questo caso, il messaggio diventa parte di un a2p_conversation.
|
a2p_conversation (avviato dall'attività)
|
Avviata quando un utente risponde a un messaggio A2P entro 24 ore dalla ricezione, al di fuori di una conversazione esistente. | N/D. Gli agenti non conversazionali non generano mai questo tipo di evento. | Se un messaggio P2A viene recapitato entro 24 ore da più messaggi A2P, per avviare la conversazione viene utilizzato solo il messaggio A2P che precede immediatamente il messaggio P2A. Questo messaggio A2P e tutti i messaggi inviati nelle 24 ore successive fanno parte di a2p_conversation.
|
p2a_conversation (avviato dall'utente)
|
Avviata quando un agente risponde a un messaggio P2A entro 24 ore dalla ricezione, al di fuori di una conversazione esistente. | N/D. Gli agenti non conversazionali non generano mai questo tipo di evento. | Se un messaggio A2P viene recapitato entro 24 ore da più messaggi P2A, per avviare la conversazione viene utilizzato solo il messaggio P2A che precede immediatamente il messaggio A2P. Questo messaggio P2A e tutti i messaggi inviati nelle 24 ore successive fanno parte di p2a_conversation.
|
p2a_message
|
Messaggio P2A di qualsiasi tipo. | Sempre trattato come evento fatturabile individuale, indipendentemente dal fatto che l'agente risponda. | Trattata come un evento fatturabile individuale, a meno che l'agente non risponda entro 24 ore. |
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 di fatturazione dell'agente: per messaggio (agenti non conversazionali) o per conversazione (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,
basic_message,single_message,a2p_conversation).
Generazione del 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 di fatturazione.
Questi report presuppongono che gli eventi vengano fatturati quando i messaggi vengono recapitati, 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. I campi all'interno di un record sono separati da tabulazioni. Ad esempio, due conversazioni A2P con lo stesso agente genererebbero due eventi fatturabili separati e due record nel report di fatturazione.
Ogni record del report contiene le seguenti informazioni per ogni evento fatturabile.
| Campo | Formato | Descrizione | Esempio |
|---|---|---|---|
billing_event_id
|
stringa | Identificatore UUID. Un numero casuale generato per ogni nuovo evento al momento della creazione. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
|
type
|
stringa | Tipo di evento:
Modello di fatturazione standard Modello di fatturazione per gli Stati Uniti |
single_message
|
agent_id
|
stringa | Identificatore univoco dell'agente che ha partecipato all'evento. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
stringa | Indirizzo email dell'attuale proprietario dell'account partner in cui è stato creato l'agente. | name@aggregator.com
|
billing_party
|
stringa | La parte che fattura gli eventi.
|
carrier
|
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.
|
24
|
max_duration_a2p_conversation
|
numero | Durata massima di una conversazione A2P, in ore. Misurato dalla prima risposta dell'utente al messaggio iniziale dell'agente. | 24
|
max_duration_p2a_conversation
|
numero | Durata massima di una conversazione P2A, in ore. Misurato dal primo messaggio utente nella conversazione. | 24
|
start_time
|
YYYY-mm-ddTHH:00:00Z | La data e l'ora UTC di inizio dell'evento nel formato ISO 8601 arrotondate all'ora più vicina.
Messaggi A2P
Messaggi P2A
|
2019-07-25T08:00:00Z
|
duration
|
numero | Durata dell'evento, arrotondata al minuto più vicino.
Quando il tipo di evento è |
45
|
mt_messages
|
numero | Numero di messaggi terminati su dispositivo mobile (A2P) nell'evento. | 11
|
mo_messages
|
numero | Numero di messaggi inviati da dispositivo mobile (P2A) nell'evento. | 9
|
size_kilobytes
|
numero | Dimensioni di tutti i file allegati ai messaggi nell'evento, arrotondate al kilobyte più vicino (1 kB = 1024 byte). | 912
|
agent_name
|
stringa |
Il nome dell'agente che ha partecipato all'evento. |
XYZ Mobile USA
|
owner_name
|
stringa | Nome del proprietario attuale dell'account partner in cui è stato creato l'agente. | XYZ Mobile
|
segment_count
|
numero | Solo modello di fatturazione statunitense
Il conteggio dei segmenti calcolato per gli eventi |
5
|
Report di esempio sugli eventi di fatturazione
I report di esempio sono disponibili per il download:
- Report sulla fatturazione per il modello di fatturazione standard
- Report di fatturazione per il modello di fatturazione statunitense
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. Ad esempio, se il report contiene 53.000 record, le dimensioni del file saranno di circa 8 MB.
Log delle attività
I log delle attività forniscono dati non elaborati sull'attività sulla piattaforma RCS for Business. Puoi utilizzare questi log per controllare gli eventi di fatturazione e creare eventi personalizzati.
Nota: nei log attività è incluso solo il traffico proveniente da numeri di telefono non di test.
Poiché i log attività contengono informazioni che consentono l'identificazione personale (PII), ad esempio informazioni dettagliate sulle transazioni e MSISDN degli abbonati, sono disponibili solo quando un operatore utilizza RCS in base ai propri Termini di servizio. Se hai traffico RCS for Business sulle tue reti e attivi l'attività RCS con Google RCS ai sensi dei Termini di servizio di Google, non avrai accesso ai log attività.
Formato del log delle attività
I log delle attività utilizzano il formato del nome file rbm_activity_YYYY-MM-DD.csv. La data nel
nome file è la data di generazione del file.
I campi di un record sono separati da tabulazioni e c'è un record per riga.
Ogni record nel log delle attività contiene i seguenti campi per ogni attività:
| Campo | Formato | Descrizione | Esempio |
|---|---|---|---|
activity_id
|
stringa | Identificatore univoco dell'attività. | b422e1d3-ac99-442a-853d-a875d5e61762
|
billing_event_id
|
stringa | Identificatore univoco dell'evento di fatturazione associato. Può essere vuoto se l'attività non è associata a un evento di fatturazione, ad esempio un text_message senza delivery_receipt_event corrispondente.
|
91yeb201-7c3b-412b-98d2-b0a0f7abe536
|
agent_id
|
stringa | Identificatore univoco dell'agente. | welcome-bot@rbm.goog
|
user_id
|
stringa | MSISDN dell'utente. | 918369110173
|
direction
|
stringa | La direzione in cui viene inviato il messaggio:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | Data e ora in cui l'evento è stato inviato alla piattaforma RCS for Business in formato UTC. Consulta la sezione Timestamp. | 2019-07-25T00:29:07.033Z
|
type
|
stringa | Tipo di attività:
|
text_message
|
size_bytes
|
stringa | Dimensioni dei file allegati all'attività, in byte. | 912
|
Timestamp
I timestamp nei log attività registrano il momento in cui un evento è stato inviato alla piattaforma RCS for Business. Per gli eventi che forniscono contenuti a un utente, l'evento non verrà registrato nel log attività finché il messaggio non viene recapitato.
Ad esempio, se un messaggio RCS for Business viene inviato a un utente mercoledì alle 13:00 e il destinatario è offline fino a domenica alle 9:00, l'evento verrà visualizzato nel log attività generato per domenica, ma il timestamp sarà mercoledì, ore 13:00.