Questa pagina descrive i file di dati che RCS for Business crea per assistere i corrieri nelle attività di fatturazione e verifica.
| File | Descrizione | Chi ha accesso |
|---|---|---|
| Rapporto di fatturazione | Report aggregato degli eventi fatturabili tra agenti e utenti avviati. | Tutti i vettori che utilizzano attivamente RCS for Business. |
| Registro delle attività | Registro dei dati grezzi dell'attività RCS for Business, inclusi gli eventi fatturabili. | Operatori che gestiscono attivamente RCS for Business e utilizzano il servizio Google RCS in base ai propri Termini di servizio (ToS). |
RCS for Business utilizza un modello di fatturazione standard per il traffico al di fuori degli Stati Uniti. Per maggiori dettagli, consultare le FAQ sulla fatturazione .
Generazione file
Ogni file di dati rappresenta un giorno di utilizzo di RCS for Business nell'ora standard del Pacifico (PST). I file vengono generati quotidianamente e riflettono l'attività delle 24 ore precedenti (da mezzanotte a mezzanotte). Il processo di generazione può richiedere diverse ore e il tempo di completamento può variare.
- Per gli agenti non conversazionali , i file contengono i dati relativi alle 24 ore immediatamente precedenti al giorno in cui il file è stato generato. Ad esempio, un report generato il 5 maggio include i dati dal 00:00 del 4 maggio al 00:00 del 5 maggio. L'orario specificato è nel fuso orario PST.
Per gli agenti conversazionali , i file contengono dati relativi alle 24 ore precedenti di 1-2 giorni alla data di generazione del file. Ad esempio, un report generato il 5 maggio include i dati relativi alle 24 ore del 2 o 3 maggio. L'orario specificato è nel fuso orario PST (Pacific Standard Time).
Il motivo del ritardo è che l'attività di RCS for Business per gli agenti conversazionali è collegata alle sessioni, che possono richiedere fino a 24 ore per essere completate. 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, consultare le categorie di fatturazione degli agenti .
Punti chiave:
- Nessuna attività : per impostazione predefinita, non viene generato alcun file se non viene rilevata alcuna attività sulla piattaforma in un determinato giorno. Tuttavia, è possibile scegliere di ricevere file vuoti, se necessario. Per attivare questa opzione, contattare rbm-support@google.com.
- Denominazione : La data nel nome del file è la data di creazione del file, non la data dei dati al suo interno.
- Conservazione : i file vengono conservati per un massimo di 63 giorni prima di essere eliminati.
È possibile 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 vengono crittografati sia a riposo che durante il trasferimento.
Per recuperare i file di dati tramite Secure File Transfer Protocol (SFTP), è necessario fornire la propria chiave pubblica SFTP. Per generare le chiavi, consultare la sezione Generare una coppia di chiavi Secure Shell (SSH) per una cartella di consegna SFTP .
Il server SFTP è partnerupload.google.com e la connessione avviene su una porta elevata (19321) per una maggiore sicurezza.
È possibile 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.
Sono disponibili account separati per accedere alle diverse tipologie 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.
Non verrà generato alcun file se non è presente traffico RCS for Business da segnalare. Ciò significa che potrebbero esserci dei giorni in cui non vengono generati file. Se hai bisogno di file vuoti per semplificare il tuo processo, contatta il team di supporto di RCS for Business .
Rapporti di fatturazione
I report di fatturazione sono registrazioni di eventi fatturabili , calcolati in base alla categoria di fatturazione dell'agente e al tipo di messaggi inviati. I report di fatturazione sono disponibili per tutti gli operatori che utilizzano attivamente RCS for Business.
I report di fatturazione contengono informazioni riservate, ma nessuna informazione personale identificabile (PII) dell'utente, come MSISDN, MSISDN crittografato o qualsiasi altro identificativo univoco dell'utente.
Categorie di fatturazione dell'agente
Quando si crea un agente, il proprietario ne imposta la categoria di fatturazione in base a come 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 la modalità di fatturazione dei 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 | Agenti che inviano principalmente messaggi unidirezionali. |
| Il costo viene addebitato per ogni messaggio consegnato all'utente. |
| Conversazionale | Agenti progettati per scambi bidirezionali con gli utenti. |
| Fatturazione per conversazione : se una delle parti (l'agente o l'utente) risponde a un messaggio dell'altra entro 24 ore, si avvia una conversazione. Durante la finestra temporale della 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 costo del singolo messaggio, in modo simile a un agente non conversazionale. |
Il diagramma seguente mostra un esempio di sessione di fatturazione A2P per agenti conversazionali:
Agenti conversazionali contro agenti non conversazionali
Esistono due categorie principali di fatturazione: conversazionale e non conversazionale.
La differenza fondamentale nelle categorie di fatturazione risiede nella distinzione tra agenti conversazionali e agenti non conversazionali:
Gli agenti non conversazionali vengono fatturati per ogni messaggio che consegnano all'utente.
- Questa categoria è ideale per gli agenti che non si aspettano risposte frequenti.
Gli operatori delle chat vengono fatturati con una tariffa fissa per le conversazioni , che include tutti i messaggi scambiati nell'arco di 24 ore.
- Questa categoria è ideale per gli agenti che intrattengono conversazioni a più turni con gli utenti.
Eventi fatturabili
Nei report di fatturazione vengono registrati cinque tipi di eventi fatturabili. Questi eventi includono gli eventi MT e MO, denominati rispettivamente eventi A2P e P2A.
- A2P (Application-to-Person) è MT (Mobile Terminated) : un messaggio inviato dall'azienda.
- P2A (Person-to-Application) è MO (Mobile Originated) : un messaggio o un'azione avviata dall'utente.
La tabella seguente descrive ciascun evento fatturabile in relazione 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 di un sito web con tag openGraph , il messaggio può mostrare un'anteprima dell'immagine, senza costi aggiuntivi per il partner. | Viene sempre trattato come un evento fatturabile individuale, indipendentemente dal fatto che l'utente risponda o meno. | Trattata come un evento fatturabile individuale, a meno che l'utente non risponda entro 24 ore. In tal caso, il messaggio diventa parte di una a2p_conversation . |
single_message | Messaggio A2P che contiene contenuti multimediali oppure è un messaggio di solo testo di oltre 160 caratteri. | Viene sempre trattato come un evento fatturabile individuale, indipendentemente dal fatto che l'utente risponda o meno. | Trattata come un evento fatturabile individuale, a meno che l'utente non risponda entro 24 ore. In tal caso, il messaggio diventa parte di una a2p_conversation . |
a2p_conversation (avviata dall'azienda) | Si attiva quando un utente risponde a un messaggio A2P entro 24 ore dalla ricezione, al di fuori di una conversazione esistente. | Non applicabile. Gli agenti non conversazionali non generano mai questo tipo di evento. | Se un messaggio P2A viene recapitato entro 24 ore da più messaggi A2P, solo il messaggio A2P che ha preceduto immediatamente il messaggio P2A viene utilizzato per avviare la conversazione. Questo messaggio A2P, e tutti i messaggi recapitati nelle successive 24 ore, fanno parte della a2p_conversation . |
p2a_conversation (avviata dall'utente) | Si attiva quando un agente risponde a un messaggio P2A entro 24 ore dalla ricezione, al di fuori di una conversazione in corso. | Non applicabile. Gli agenti non conversazionali non generano mai questo tipo di evento. | Se un messaggio A2P viene recapitato entro 24 ore da più messaggi P2A, solo il messaggio P2A che ha preceduto immediatamente il messaggio A2P viene utilizzato per avviare la conversazione. Questo messaggio P2A, e tutti i messaggi recapitati nelle successive 24 ore, fanno parte della p2a_conversation . |
p2a_message | Messaggio P2A di qualsiasi tipo. | Viene sempre trattato come un evento fatturabile individuale, indipendentemente dal fatto che l'agente risponda o meno. | Trattata come un evento fatturabile individuale, a meno che l'agente non risponda entro 24 ore. |
Categorie di fatturazione rispetto agli eventi fatturabili
La distinzione tra categorie di fatturazione dell'agente ed eventi fatturabili è fondamentale per comprendere come viene fatturato il tuo agente.
- La categoria di fatturazione è una classificazione fissa che si sceglie al momento della creazione dell'agente. Determina la modalità 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 tracciate a fini di fatturazione (ad esempio,
basic_message,single_message,a2p_conversation).
Generazione di report di fatturazione
Solo gli agenti con traffico non di test generano eventi fatturabili. L'attività proveniente da numeri di telefono di test non viene visualizzata nei report di fatturazione.
Questi report presuppongono che gli eventi vengano fatturati al momento della consegna dei messaggi, non al momento dell'invio. Un messaggio non consegnato o annullato prima della consegna non genera un evento fatturabile.
Formato del report di fatturazione
I report di fatturazione utilizzano il formato del nome file rbm_billable_events_YYYY-MM-DD.csv . La data nel nome del file corrisponde alla data di generazione del file.
Ogni riga del report 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 nel report contiene le seguenti informazioni per ogni evento fatturabile.
| Campo | Formato | Descrizione | Esempio |
|---|---|---|---|
billing_event_id | corda | ID generato che identifica l'evento fatturabile. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff |
type | corda | Tipo di evento:
| single_message |
agent_id | corda | Identificativo univoco dell'agente che ha partecipato all'evento. | rbm-welcome-bot@rbm.goog |
agent_owner | corda | Indirizzo email dell'attuale titolare dell'account partner in cui è stato creato l'agente. | name@aggregator.com |
billing_party | corda | Parte che emette la fattura per gli eventi.
| carrier |
max_duration_single_message | numero | Tempo massimo (in ore) consentito a un utente per rispondere a un 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. Misurata dalla prima risposta dell'utente al messaggio iniziale dell'agente. | 24 |
max_duration_p2a_conversation | numero | Durata massima di una conversazione P2A, in ore. Calcolata a partire dal primo messaggio dell'utente nella conversazione. | 24 |
start_time | AAAA-mm-ggTHH: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. Il valore è 0 per qualsiasi evento non conversazionale. | 45 |
mt_messages | numero | Numero di messaggi A2P (Attachment-to-Planet) inviati tramite dispositivo mobile nell'ambito dell'evento. | 11 |
mo_messages | numero | Numero di messaggi provenienti da dispositivi mobili (P2A) nell'evento. | 9 |
size_kilobytes | numero | Dimensione di tutti i file allegati ai messaggi nell'evento, arrotondata al kilobyte più vicino (1 kB equivale a 1024 byte). | 912 |
agent_name | corda | Nome dell'agente che ha partecipato all'evento. | XYZ Mobile USA |
owner_name | corda | Nome del titolare attuale dell'account partner in cui è stato creato l'agente. | XYZ Mobile |
Esempio di report di fatturazione
È possibile scaricare dei report di esempio:
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, il file avrà una dimensione di circa 8 MB.
Registri delle attività
I registri delle attività forniscono dati grezzi sull'attività svolta sulla piattaforma RCS for Business. È possibile utilizzare questi registri per verificare gli eventi fatturabili e creare eventi personalizzati.
Poiché i registri delle attività contengono informazioni di identificazione personale (PII), come informazioni dettagliate sulle transazioni e MSISDN degli abbonati, sono disponibili solo quando un operatore gestisce RCS in base ai propri Termini di servizio. Se si utilizza RCS for Business sulle proprie reti e si abilita l'attività RCS con Google RCS in base ai Termini di servizio di Google, non si avrà accesso ai registri delle attività.
Formato del registro attività
I registri delle attività utilizzano il formato di nome file rbm_activity_YYYY-MM-DD.csv . La data nel nome del file corrisponde alla data di generazione del file.
I campi di un record sono separati da tabulazioni e c'è un record per riga.
Ogni record nel registro delle attività contiene i seguenti campi per ciascuna attività:
| Campo | Formato | Descrizione | Esempio |
|---|---|---|---|
activity_id | corda | Identificativo univoco per l'attività. | b422e1d3-ac99-442a-853d-a875d5e61762 |
billing_event_id | corda | Identificativo univoco per l'evento fatturabile associato. Può essere vuoto se l'attività non è associata a un evento fatturabile, come ad esempio un text_message senza un corrispondente delivery_receipt_event . | 91yeb201-7c3b-412b-98d2-b0a0f7abe536 |
agent_id | corda | Identificativo univoco per l'agente. | welcome-bot@rbm.goog |
user_id | corda | MSISDN dell'utente. | 918369110173 |
direction | corda | La direzione verso cui viene inviato il messaggio:
| MT |
time | AAAA-mm-ggAA:MM:SS.SSSZ | Data e ora di invio dell'evento alla piattaforma RCS for Business in formato UTC. Vedi Timestamp . | 2019-07-25T00:29:07.033Z |
type | corda | Tipo di attività:
| text_message |
size_bytes | corda | Dimensione dei file allegati all'attività, in byte. | 912 |
Indicazioni temporali
I timestamp nei registri delle attività indicano quando un evento è stato inviato alla piattaforma RCS for Business. Per gli eventi che inviano contenuti a un utente, l'evento non verrà registrato nel registro delle attività finché il messaggio non sarà 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 registro attività generato per domenica, ma il timestamp sarà mercoledì alle 13:00.