Questa pagina descrive i file di dati creati da RBM per aiutare gli operatori con la fatturazione e la verifica. Consulta le Domande frequenti sulla fatturazione RBM per trovare le risposte alle domande più comuni sul modello di fatturazione RBM.
| File | Descrizione | Chi ha accesso |
|---|---|---|
| Report Eventi di fatturazione | Report aggregato degli eventi fatturabili tra agenti e utenti lanciati. | Tutti gli operatori che utilizzano attivamente la RBM (RCS Business Messaging). |
| Log delle attività | Log dei dati non elaborati dell'attività RBM, inclusi gli eventi fatturabili. | Operatori che gestiscono attivamente la Chat con le aziende RCS (RCS Business Messaging) e il servizio RCS di Google ai sensi dei propri Termini di servizio (TdS). |
Generazione di file
Ogni file di dati rappresenta un giorno di utilizzo di RBM nel fuso orario UTC (Coordinated Universal Time). I file vengono generati ogni giorno tra le ore 10:00 e le ore 12:00 UTC.
Per gli agenti non conversazionali, i file contengono i dati del periodo di 24 ore immediatamente precedente la data e 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à i dati dalle 11:00 UTC del 4 maggio alle 11:00 UTC del 5 maggio.
Per gli agenti conversazioniali, i file contengono i dati relativi al periodo di 24 ore precedente di 1-2 giorni rispetto alla data e all'ora di generazione del file. Ad esempio, se un report sugli eventi 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 motivo del ritardo è che l'attività RBM per gli agenti di conversazione è collegata alle conversazioni, il cui completamento può richiedere fino a 48 ore. Questo ritardo consente alla RBM di acquisire tutti i messaggi all'interno di una conversazione prima di calcolare l'evento di fatturazione. Per maggiori informazioni sugli agenti conversazionali, consulta la sezione Categorie di fatturazione degli agenti.
Punti chiave:
Nessuna attività: se in un determinato giorno non viene registrata alcuna attività sulla piattaforma, non viene generato alcun file.
Nomi: 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 30 giorni prima di essere eliminati.
Puoi utilizzare questi file per aggiornare il tuo data warehouse con le metriche di utilizzo della piattaforma più recenti.
Archiviazione e accesso ai file
I file di dati sono criptati quando sono at-rest e durante il trasferimento.
Per recuperare i file di dati tramite Secure File Transfer Protocol (SFTP), fornisci la tua chiave pubblica SFTP. Per generare le chiavi, consulta Generare una coppia di chiavi SSH (Secure Shell) per una casella personale SFTP.
Il server SFTP è partnerupload.google.com e la connessione utilizza un numero di porta 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 stati ancora generati file di dati, viene visualizzato un errore SFTP simile aremote readdir("/"): No such file or directory, come previsto.
Non verrà generato un file se non è presente traffico RBM da segnalare. Ciò significa che potrebbero esserci alcuni 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 inviati. I report sugli eventi di fatturazione sono disponibili per tutti gli operatori che utilizzano attivamente la Chat con le aziende RCS (RBM).
I report sugli eventi di fatturazione contengono informazioni riservate, ma nessuna informazione che consente l'identificazione personale (PII) dell'utente, come MSISDN, MSISDN sottoposta ad hashing o qualsiasi identificatore unico dell'utente.
Categorie di fatturazione dell'agente
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 come verranno fatturati all'agente i messaggi. Le due principali categorie di fatturazione sono descritte nella tabella seguente.
| Categoria di fatturazione | Tipo di agente | Esempi di casi d'uso | Metodo di fatturazione |
|---|---|---|---|
Non conversazionale Sono incluse le categorie Messaggio di base e Messaggio singolo. Nota: non esiste più alcuna differenza tra queste due categorie. Un agente in una delle due categorie verrà fatturato come agente non conversazionale. |
Agenti che inviano principalmente messaggi unidirezionali. |
|
Viene addebitato per ogni messaggio recapitato all'utente. |
| Conversazionale | Agenti progettati per scambi di informazioni con gli utenti. |
|
Fatturazione per conversazione: se una parte (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 illimitato 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 singolo messaggio, come per un agente non conversazionale. |
Agenti conversazionali e non conversazionali
Esistono due categorie di fatturazione principali: conversazionali e non conversazionali. 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 differenza principale nelle categorie di fatturazione è tra agenti conversazionali e agenti non conversazionali:
Per gli agenti non conversazionali viene addebitato un importo per ogni messaggio inviato all'utente.
- Questa categoria è ideale per gli agenti che non si aspettano risposte frequenti.
Per gli agenti conversazionali viene addebitata una tariffa fissa per le conversazioni, che includono tutti i messaggi scambiati in un periodo di 24 ore.
- Questa categoria è ideale per gli agenti che intrattengono conversazioni con più turni 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): inviati dall'attività.
- P2A (Persona a applicazione): inviata dall'utente.
La tabella seguente descrive ogni evento di fatturazione per agenti conversazionali e non conversazionali.
| Evento | Descrizione | Agenti non conversazionali | Agenti conversazionali |
|---|---|---|---|
basic_message
|
Messaggio A2P che include solo testo con massimo 160 caratteri. Se il testo include un URL di un sito web con tag openGraph, il messaggio potrebbe mostrare un'anteprima dell'immagine senza costi aggiuntivi per il partner. | Viene sempre considerato un singolo evento di fatturazione, indipendentemente dal fatto che l'utente risponda o meno. | Trattato come singolo evento di fatturazione, 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 che include contenuti multimediali e/o testo con più di 160 caratteri. | Viene sempre considerato un singolo evento di fatturazione, indipendentemente dal fatto che l'utente risponda o meno. | Trattato come singolo evento di fatturazione, a meno che l'utente non risponda entro 24 ore. In questo caso, il messaggio diventa parte di un a2p_conversation.
|
a2p_conversation (avviata dall'attività)
|
Viene 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 ha preceduto immediatamente il messaggio P2A. Questo messaggio A2P e tutti i messaggi inviati nelle prossime 24 ore fanno parte del a2p_conversation.
|
p2a_conversation (avviata dall'utente)
|
Viene 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 ha preceduto immediatamente il messaggio A2P. Questo messaggio P2A e tutti i messaggi inviati nelle prossime 24 ore fanno parte del p2a_conversation.
|
p2a_message
|
Messaggio P2A di qualsiasi tipo. | Viene sempre considerato un singolo evento di fatturazione, indipendentemente dal fatto che l'agente risponda o meno. | Trattato come singolo evento di fatturazione, 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 di queste categorie di fatturazione non generano eventi di fatturazione conversazionale (
a2p_conversationsop2a_conversations). Invece, generano singoli eventi di fatturazionebasic_message,single_messageep2a_message.
Generazione di report sulla fatturazione
Solo gli agenti con traffico non di tester generano eventi di fatturazione. L'attività dei numeri di telefono di prova 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 un messaggio 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 del 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 tabulazione. Ad esempio, due conversazioni A2P con lo stesso agente genereranno 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 sua 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 | Parte che fattura gli eventi.
|
carrier
|
max_duration_single_message
|
numero | Tempo massimo (in ore) consentito per consentire a un utente di 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.
|
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 dell'utente nella conversazione. | 24
|
start_time
|
YYYY-mm-ddTHH:00:00Z | La data/ora UTC di inizio dell'evento in formato ISO 8601 arrotondata 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 con terminazione 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 |
Nome dell'agente che ha partecipato all'evento. |
XYZ Mobile USA
|
owner_name
|
stringa | Nome dell'attuale proprietario dell'account partner in cui è stato creato l'agente. | XYZ Mobile
|
Esempio di report sugli eventi di fatturazione
È disponibile un file di esempio del report di fatturazione da scaricare.
Dimensioni file tipiche
Un report giornaliero di un partner RBM attivo può contenere circa 53.000 record e avere dimensioni di circa 8 MB.
Log delle attività
I log delle attività forniscono dati non elaborati sull'attività sulla piattaforma RBM. Puoi utilizzare questi log per controllare gli eventi di fatturazione e creare eventi personalizzati.
Poiché i log delle attività contengono informazioni che consentono l'identificazione personale (PII), come informazioni dettagliate sulle transazioni e MSISDN degli abbonati, sono disponibili solo quando un operatore gestisce RCS ai sensi dei propri Termini di servizio. Se hai traffico RBM sulle tue reti e attivi l'attività RCS con Google RCS ai sensi dei TdS di Google, non avrai accesso ai log delle 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 del file è la data di generazione del file.
I campi di un record sono separati da tabulazione 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 per l'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 RBM 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à, espresse in byte. | 912
|
Timestamp
I timestamp nei log delle attività registrano il momento in cui un evento è stato inviato alla piattaforma RBM. Per gli eventi che inviano contenuti a un utente, l'evento non verrà registrato nel log delle attività finché il messaggio non viene recapitato.
Ad esempio, se un messaggio RBM viene inviato a un utente alle 13:00 di mercoledì e il destinatario è offline fino alle 09:00 di domenica, l'evento verrà visualizzato nel log delle attività generato per domenica, ma il timestamp sarà mercoledì alle 13:00.