RBM crea file di dati che segnalano l'attività di utenti e agenti a livello di riepilogo e di transazione. I dati sono suddivisi in più file:
| File | Descrizione | Chi ha accesso |
|---|---|---|
| Report sugli eventi di fatturazione | Un record di eventi fatturabili tra agenti e utenti avviati. | Tutti gli operatori che hanno traffico RBM sulle loro reti |
| Log delle attività | Dati non elaborati sull'attività della piattaforma RBM | Operatori che hanno il traffico RBM sulle proprie reti e attivano l'attività RCS con Jibe Cloud in base ai propri Termini di servizio (TdS) |
Generazione
La generazione dei report sugli eventi di fatturazione e dei log delle attività subisce un ritardo di due giorni.
Google segnala un evento attività solo quando la sessione di fatturazione a cui appartiene è stata completata. Il completamento di una sessione può richiedere fino a 24 ore. La nostra pipeline di fatturazione viene eseguita una volta al giorno e segnala solo le sessioni di fatturazione che sono state sicuramente completate (che risalgono ad almeno 24 ore prima).
Ad esempio:
Un messaggio viene inviato il giorno d e avvia una sessione di fatturazione, ma ha perso l'esecuzione della pipeline un'ora prima. Pertanto, non viene segnalato alcun evento di attività.
Quando la pipeline viene eseguita di nuovo su d+1, la sessione avviata dal messaggio risale a sole 23 ore prima. Pertanto, nessun evento di attività per questo messaggio viene registrato su d+1.
Quando la pipeline viene eseguita di nuovo il giorno d+2, la sessione è stata completata, pertanto l'evento di attività viene registrato insieme alla sessione di fatturazione.
Archiviazione e accesso
I file di dati vengono criptati at-rest e in fase di trasferimento.
Per recuperare i file di dati tramite SFTP, devi fornire la tua chiave pubblica SFTP. Per generare le chiavi, consulta Generare una coppia di chiavi Secure Shell (SSH) per una casella personale SFTP.
Il server SFTP è partnerupload.google.com e la connessione avviene su un
numero di porta alto (19321) per 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 nomi utente per gli 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.
Sono disponibili account separati per accedere ai diversi tipi di report.
Disponibilità dei file
Se non è stato ancora generato alcun file di report, verrà visualizzato un errore SFTP
simile a remote readdir("/"): No such file or directory. È previsto.
Non verrà generato un file se non c'è traffico RBM da includere nel report. Ciò significa che in alcuni giorni i file potrebbero non essere generati. Contatta rbm-support@google.com se in questo caso richiedi la generazione di file vuoti, per semplificare l'elaborazione.
Aggiornamento e conservazione
Ogni file di dati rappresenta un giorno di utilizzo della piattaforma nel fuso orario UTC. I record relativi a un determinato giorno vengono generati una sola volta e finalizzati entro 2 giorni (48 ore) dalla fine del giorno. Se carichi questi file in un data warehouse, puoi aggiornare le metriche del mese corrente.
Il file non viene generato se non c'è alcuna attività da tenere in considerazione.
La data indicata nel nome di ciascun file corrisponde alla data di generazione del file. I record nel file copriranno il giorno UTC che si verifica 2 giorni prima della data del file.
Il processo di esportazione che genera i file viene eseguito tra le 02:00 e le 04:00 PST.
I file di dati vengono conservati per un massimo di 30 giorni prima di essere eliminati.
Report sugli eventi di fatturazione
I report sugli eventi di fatturazione sono record di eventi fatturabili calcolati dai messaggi sottostanti utilizzando le unità di fatturazione suggerite. Gli eventi fatturabili contengono informazioni riservate, ma non PII dell'utente (ad es. nessun MSISDN, MSISDN con hash o qualsiasi identificatore univoco dell'utente).
Solo gli agenti avviati generano eventi di fatturazione. Le attività da avviare o gli agenti non ancora lanciati non appaiono nei report di fatturazione.
I report di fatturazione presuppongono che gli eventi vengano fatturati al momento della consegna dei messaggi, non quando i messaggi vengono inviati. Un messaggio non recapitato o revocato prima della consegna non attiva un evento di fatturazione.
Ogni agente RBM ha una categoria di fatturazione, impostata dallo sviluppatore dell'agente prima di inviare l'agente per il lancio. La categoria di fatturazione determina se i messaggi inviati dall'agente sono discreti o se possono essere combinati in eventi di fatturazione conversazionali.
Esistono cinque tipi di eventi fatturabili:
| Evento | Definizione |
|---|---|
| Messaggio di base | Un messaggio applicazione a persona (A2P) che
Solo agenti conversazionali: se un messaggio P2A viene recapitato come risposta a un messaggio A2P entro le successive 24 ore, il messaggio di base diventa parte di una conversazione A2P; in caso contrario, la sessione viene terminata. Un messaggio di base viene sempre recapitato da un agente a un utente. |
| Messaggio singolo | Un messaggio applicazione a persona (A2P) che
Solo agenti di conversazione: se un messaggio P2A viene recapitato nelle successive 24 ore, il messaggio singolo diventa parte di una conversazione A2P; altrimenti, la sessione termina. Un messaggio singolo viene sempre recapitato da un agente a un utente. |
| Conversazione A2P | Si applica solo agli agenti conversazionali: una conversazione A2P viene avviata quando un messaggio P2A viene consegnato entro 24 ore da un messaggio singolo A2P o da un messaggio di base A2P. Tieni presente che se un messaggio P2A viene consegnato entro 24 ore da più messaggi A2P, per creare la sessione di conversazione viene utilizzato solo il messaggio A2P che ha preceduto il messaggio P2A. Questo messaggio A2P, insieme a tutti i messaggi recapitati entro le 24 ore successive, fa parte della nuova conversazione A2P. |
| Conversazione P2A | Si applica solo agli agenti conversazionali: una conversazione P2A viene avviata quando non sono presenti sessioni attive (A2P Single Message, A2P Conversation o P2A Conversation) e viene consegnato un messaggio P2A e l'attività risponde entro 24 ore. |
| Messaggio P2A | Agenti non conversazionali: un messaggio P2A inviato da un utente a un agente con una categoria di fatturazione pari a messaggio singolo o messaggio di base.
Agenti di conversazione: un messaggio P2A inviato da un utente a un agente se non esiste alcuna conversazione e l'agente non restituisce una risposta. |
Disponibilità
I report sugli eventi di fatturazione sono disponibili per tutti gli operatori che hanno traffico RBM sulle proprie reti.
Formato
I report sugli eventi di fatturazione utilizzano il formato del nome file YYYY/MM/DD/rbm_billable_events_YYYY-MM-DD.csv.
La data indicata nel nome file corrisponde alla data di generazione del file. I record nel file riguardano in genere l'attività relativa al giorno dei due giorni precedenti a questa data.
I campi di un record sono separati da tabulazioni e esiste un record per riga.
Ci sarà un record per ogni evento di fatturazione, ovvero due conversazioni A2P con lo stesso agente genereranno due eventi di fatturazione e due record nel report di fatturazione.
Ogni record del report sugli eventi fatturabili contiene le seguenti informazioni per ogni evento:
| Campo | Formato | Descrizione | Esempio |
|---|---|---|---|
billing_event_id
|
stringa | L'identificatore UUID, un numero casuale, generato per ogni nuovo evento al momento della creazione. | |
type
|
stringa | Il tipo di evento:
|
single_message
|
agent_id
|
stringa | L'identificatore dell'agente che ha partecipato all'evento. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
stringa | L'email del proprietario dell'agente che ha partecipato all'evento. Si tratta della parte che ha registrato l'agente RBM, nella maggior parte dei casi l'aggregatore, ma in alcuni rari casi potrebbe essere il brand. Questo valore viene recuperato dal campo "Account Google RBM" fornito quando lo sviluppatore si è registrato per utilizzare RBM. | name@aggregator.com
|
billing_party
|
stringa | La parte che fattura gli eventi.
|
carrier
|
max_duration_single_message
|
numero | La durata, in ore, della scadenza del messaggio di un agente senza ricevere una risposta per identificare una singola sessione di messaggio. | 24
|
max_duration_a2p_conversation
|
numero | La durata massima di una sessione A2P espressa in ore. Misurato dalla prima risposta dell'utente al messaggio iniziale dell'agente. | 24
|
max_duration_p2a_conversation
|
numero | La durata massima di una sessione P2A, espressa in ore. Misurato a partire dal primo messaggio dell'utente nella conversazione. | 24
|
start_time
|
YYYY-mm-ddTHH:00:00Z | La data e l'ora UTC in cui è iniziato l'evento, in formato ISO 8601, arrotondata all'ora più vicina.
|
2019-07-25T08:00:00Z
|
duration
|
numero | La durata dell'evento, arrotondata al minuto più vicino.
Se il tipo di evento è |
45
|
mt_messages
|
numero | Il numero di messaggi terminati per dispositivi mobili nell'evento. | 11
|
mo_messages
|
numero | Il numero di messaggi provenienti da dispositivo mobile nell'evento. | 9
|
size_kilobytes
|
numero | Le dimensioni di tutti i file allegati ai messaggi nell'evento, arrotondate al kilobyte più vicino (1 kB = 1024 byte). | 912
|
agent_name
|
stringa |
L'agente che ha partecipato all'evento. |
XYZ Mobile USA
|
owner_name
|
stringa | Il proprietario dell'agente che ha partecipato all'evento. Questa è la parte che ha registrato l'agente RBM. Nella maggior parte dei casi si tratta dell'aggregatore, ma in alcuni rari casi potrebbe trattarsi del brand. Questo valore viene recuperato dal "Nome visualizzato preferito per l'account partner" fornito quando lo sviluppatore si è registrato per utilizzare RBM. | XYZ Mobile
|
File di esempio
Un file di esempio del report di fatturazione è disponibile per il download.
Dimensioni tipiche dei file
Un file di report giornaliero di un partner attivo può contenere circa 53.000 record e una dimensione di circa 8 MB.
Log delle attività
I log delle attività sono i log con dati non elaborati delle attività sulla piattaforma RBM allo scopo di controllare gli eventi fatturabili e creare eventi personalizzati.
Disponibilità
I log delle attività sono disponibili solo per gli operatori che hanno traffico RBM sulle loro reti e attivano l'attività RCS con Jibe Cloud in base ai propri Termini di servizio (TdS). Se utilizzi Jibe Cloud nei TdS di Jibe, non avrai accesso ai log delle attività.
Formato
I log delle attività utilizzano il formato di nome file YYYY/MM/DD/rbm_activity_YYYY-MM-DD.csv.
La data indicata nel nome file corrisponde alla data di generazione del file. I record nel file riguardano in genere l'attività relativa al giorno dei due giorni precedenti a questa data.
I campi di un record sono separati da tabulazioni e esiste un record per riga.
Ogni record nel log delle attività contiene i seguenti campi per ogni evento di attività.
| Campo | Formato | Descrizione | Esempio |
|---|---|---|---|
activity_id
|
stringa | L'identificatore dell'attività. | |
billing_event_id
|
stringa | L'identificatore dell'evento di fatturazione in cui si è svolta l'attività. Può essere vuoto se l'attività non è associata a nessuna sessione, ad esempio text_message senza delivery_receipt_event corrispondente.
| |
agent_id
|
stringa | L'identificatore dell'agente. | welcome-bot@rbm.goog
|
user_id
|
stringa | Il file MSISDN dell'utente. | 918369110173
|
direction
|
stringa | La direzione in cui è stato inviato il messaggio:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | La data e l'ora nel fuso orario UTC in cui l'evento è stato inviato alla piattaforma RBM. Vedi la nota riportata di seguito. | 2019-07-25T00:29:07.033Z
|
type
|
stringa | Il tipo di attività:
|
text_message
|
size_bytes
|
stringa | Le dimensioni in byte dei file allegati all'attività. | 912
|
Nota sui timestamp
I timestamp nei log delle attività registrano l'ora in cui un evento è stato inviato alla piattaforma RBM. Nel caso di eventi che consegnano contenuti a un utente, l'evento non verrà scritto nel log delle attività fino a quando il messaggio non sarà stato recapitato.
Ad esempio, se un messaggio RBM viene inviato a un utente mercoledì alle 13:00 e il destinatario è offline fino alle 09:00 di domenica, l'evento viene visualizzato nel Log delle attività generato per domenica. Il timestamp dell'evento nel Log delle attività sarà mercoledì alle 13:00.