Questa pagina descrive i file di dati creati da RCS for Business per aiutare gli operatori con la fatturazione e il controllo. Consulta le Domande frequenti sulla fatturazione per trovare le risposte alle domande più comuni sul modello di fatturazione di RCS for Business.
| File | Descrizione | Chi ha accesso |
|---|---|---|
| Report sugli eventi di fatturazione | Report aggregato degli eventi fatturabili tra gli agenti avviati e gli utenti. | 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. |
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 sugli eventi di 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 sull'evento 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 di fatturazione. Per ulteriori informazioni sugli agenti conversazionali, consulta Categorie di fatturazione degli agenti.
Punti chiave:
Nessuna attività: se non si verifica 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 degli 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 è presente 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 sugli eventi di fatturazione
I report sugli eventi di fatturazione sono record di eventi di fatturazione, che vengono calcolati in base alla categoria di fatturazione dell'agente e al tipo di messaggi che invia. I report sugli eventi di fatturazione sono disponibili per tutti gli operatori che utilizzano attivamente RCS Business Messaging.
I report sugli eventi di fatturazione contengono informazioni riservate, ma non informazioni personali (PII) dell'utente, come MSISDN, MSISDN con hash o qualsiasi identificatore univoco dell'utente.
Categorie di fatturazione dell'agente
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 (Include le categorie Messaggio base e Messaggio singolo. Nota: non esiste più alcuna differenza tra queste due categorie. Un agente di una delle due categorie verrà fatturato come agente non conversazionale.) |
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, come per 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 principali di fatturazione: conversazionale e non conversazionale. La categoria non conversazionale include le categorie Messaggio di base e Messaggio singolo, che sono funzionalmente identiche. Un agente in una di queste categorie viene fatturato come agente 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 di fatturazione
Nei report sugli eventi di fatturazione vengono registrati cinque diversi tipi di eventi di fatturazione. Questi eventi includono i messaggi A2P e P2A.
- A2P (Application-to-Person): inviato dall'attività.
- P2A (Person-to-Application): inviato dall'utente.
La tabella seguente descrive ogni evento di fatturazione in base all'applicazione ad 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 evento di fatturazione individuale, indipendentemente dal fatto che l'utente risponda. | Considerato come un singolo evento di fatturazione, a meno che l'utente non risponda entro 24 ore. In questo caso, il messaggio entra a far parte di un a2p_conversation.
|
single_message
|
Messaggio A2P con contenuti avanzati o messaggio di solo testo con più di 160 caratteri. | Viene sempre trattato come un evento di fatturazione individuale, indipendentemente dal fatto che l'utente risponda. | Considerato come un singolo evento di fatturazione, a meno che l'utente non risponda entro 24 ore. In questo caso, il messaggio entra a far 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. | Viene sempre trattato come un evento di fatturazione individuale, indipendentemente dal fatto che l'agente risponda. | Trattato come un evento di fatturazione individuale, a meno che l'agente non risponda entro 24 ore. |
Eventi di fatturazione e categorie di fatturazione
Gli eventi di fatturazione basic_message e single_message non devono essere confusi
con le categorie di fatturazione Messaggio di base e Messaggio singolo.
Qualsiasi agente (indipendentemente dalla categoria di fatturazione) può generare eventi di fatturazione
basic_messageesingle_message.Le categorie di fatturazione Messaggio di base e Messaggio singolo vengono utilizzate per classificare gli agenti non conversazionali. Gli agenti in queste categorie di fatturazione non generano eventi di fatturazione conversazionale (
a2p_conversationsop2a_conversations). Generano invece singoli eventi di fatturazionebasic_message,single_messageep2a_message.
Generazione del report sulla fatturazione
Solo gli agenti con traffico non di test generano eventi di fatturazione. L'attività dei numeri di telefono di test non viene visualizzata nei report sugli eventi di fatturazione.
Questi report presuppongono che gli eventi vengano fatturati al momento del recapito dei messaggi, non al momento dell'invio. Un messaggio non recapitato o annullato prima del recapito non attiva un evento di fatturazione.
Formato del report sulla fatturazione
I report sugli eventi di 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 di fatturazione. I campi all'interno di un record sono separati da tabulazioni. Ad esempio, due conversazioni A2P con lo stesso agente genererebbero due eventi di fatturazione e due record nel report sugli eventi di fatturazione.
Ogni record del report contiene le seguenti informazioni per ogni evento di fatturazione:
| 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:
|
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 a un messaggio dell'agente
prima che si chiuda la finestra di avvio della conversazione 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 | Il nome dell'attuale proprietario dell'account partner in cui è stato creato l'agente. | XYZ Mobile
|
Report di esempio sull'evento di fatturazione
È disponibile un file di esempio del report di fatturazione 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à che ha generato 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 tester.
Poiché i log attività contengono informazioni che consentono l'identificazione personale (PII), come 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.