RBM crea archivos de datos que informan la actividad de usuarios y agentes en niveles de resumen y transacciones. Los datos se separan en varios archivos:
| Archivo | Descripción | Quién tiene acceso |
|---|---|---|
| Informe de eventos de facturación | Un registro de eventos facturables entre los usuarios y agentes lanzados | Todos los operadores que tienen tráfico de RBM en sus redes |
| Registro de actividad | Datos de actividad de la plataforma de RBM sin procesar | Operadores que tienen tráfico de RBM en sus redes y habilitan la actividad de RCS con Jibe Cloud según sus propias Condiciones del Servicio |
Generación
Los informes de eventos de facturación y los registros de actividad tienen una demora de dos días en la generación.
Google informa un evento de actividad solo cuando se completa la sesión de facturación a la que pertenece. Una sesión puede tardar hasta 24 horas en completarse y nuestra canalización de facturación se ejecuta una vez al día y solo informa las sesiones de facturación que seguramente se habrán completado (es decir, que tienen al menos 24 horas de antigüedad).
Por ejemplo:
Se envía un mensaje el día d y se inicia una sesión de facturación, pero perdió la ejecución de la canalización 1 hora antes. Por lo tanto, no se informa ningún evento de actividad.
Cuando la canalización se ejecuta nuevamente en d+1, la sesión en la que se inició el mensaje tiene solo 23 horas de antigüedad. Por lo tanto, no se informa ningún evento de actividad para este mensaje en d+1.
Cuando la canalización se vuelve a ejecutar en d+2, la sesión se completó, por lo que se informa el evento de la actividad junto con la sesión de facturación.
Almacenamiento y acceso
Los archivos de datos se encriptan en reposo y en transferencia.
Para recuperar archivos de datos a través de SFTP, debes proporcionar tu clave pública de SFTP. Para generar claves, consulta Genera un par de claves de Secure Shell (SSH) para un buzón de SFTP.
El servidor SFTP es partnerupload.google.com y la conexión se encuentra en un número de puerto alto (19321) para mayor seguridad.
Puedes usar el siguiente comando para acceder a tus archivos de datos:
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Google proporciona nombres de usuario de cuentas en los siguientes formatos:
rbmreports-billableevents-<carrier name>rbmreports-activity-<carrier name>
Google especifica <carrier name> y proporciona una cuenta independiente para cada tipo de informe.
Se proporcionan cuentas separadas para acceder a los diferentes tipos de informes.
Disponibilidad de archivos
Si todavía no se generaron archivos de informes, verás un error de SFTP similar a remote readdir("/"): No such file or directory. Esta situación es esperable.
No se generará un archivo si no hay tráfico de RBM para informar. Esto significa que puede haber algunos días en los que no se generen los archivos. Comunícate con rbm-support@google.com si necesitas que se generen archivos vacíos en esta situación para simplificar el procesamiento.
Actualización y retención
Cada archivo de datos representa un día de uso de la plataforma en hora UTC. Los registros de un día determinado se generan una vez y finalizan en un plazo de 2 días (48 horas) después de que termina el día. Si cargas estos archivos en un almacén de datos, puedes actualizar las métricas del mes actual.
No se generará un archivo si no hay ninguna actividad que deba tener en cuenta.
La fecha en el nombre de cada archivo es la fecha en la que se generó el archivo. Los registros del archivo cubrirán el día en formato UTC 2 días antes de la fecha del archivo.
El proceso de exportación que genera los archivos se ejecuta entre las 2 a.m. y las 4 a.m. (hora estándar del Pacífico).
Los archivos de datos se retienen durante un máximo de 30 días antes de borrarlos.
Informes de eventos de facturación
Los informes de eventos de facturación son registros de eventos facturables calculados a partir de mensajes subyacentes que usan las unidades de facturación sugeridas. Los eventos facturables contienen información confidencial, pero no PII del usuario (p.ej., no MSISDN, MSISDN con hash o cualquier identificador único de usuario).
Solo los agentes iniciados generan eventos de facturación. La actividad de los agentes que aún no se iniciaron o que aún no se lanzaron no aparece en los informes de facturación.
En los informes de facturación, se supone que los eventos se facturan en el momento de la entrega de los mensajes, no cuando se envían. Un mensaje revocado o no entregado antes de la entrega no activa un evento de facturación.
Cada agente de RBM tiene una Categoría de facturación (Billing Category) que establece el desarrollador del agente antes de enviar el agente para su lanzamiento. La categoría de facturación determina si los mensajes que envía el agente son discretos o si se pueden combinar en eventos de facturación conversacional.
Existen cinco tipos de eventos facturables:
| Evento | Definición |
|---|---|
| Mensaje básico | Un mensaje de aplicación a persona (A2P) que
Solo para agentes de conversación: Si se entrega un mensaje P2A como respuesta a un mensaje A2P en las próximas 24 horas, el mensaje básico pasa a formar parte de una conversación A2P; de lo contrario, la sesión finaliza. Un mensaje básico siempre se entrega desde un agente a un usuario. |
| Mensaje individual | Un mensaje de aplicación a persona (A2P) que
Solo agentes de conversación: Si se entrega un mensaje P2A en las siguientes 24 horas, el mensaje único pasa a formar parte de una conversación A2P; de lo contrario, la sesión finaliza. Un único mensaje siempre se entrega desde un agente a un usuario. |
| Conversación sobre A2P | Solo se aplica a los agentes conversacionales: Una conversación A2P se inicia cuando se entrega un mensaje P2A en un plazo de 24 horas después de un mensaje único A2P o un mensaje básico de A2P. Ten en cuenta que, si un mensaje P2A se entrega dentro de las 24 horas posteriores a varios mensajes A2P, solo el mensaje A2P que antecedió inmediatamente al mensaje P2A se utiliza para crear la sesión de conversación. Este mensaje y los mensajes enviados en las próximas 24 horas forman parte de la nueva conversación A2P. |
| Conversación P2A | Solo se aplica a los agentes de conversación: Una conversación P2A se inicia cuando no hay una sesión activa (mensaje único A2P, conversación A2P o conversación P2A) y se entrega un mensaje P2A, y la empresa responde en un plazo de 24 horas. |
| Mensaje P2A | Agentes no conversacionales: Es un mensaje P2A que se envía desde un usuario a un agente con una categoría de facturación de mensaje único o básico.
Agentes de conversación: Un mensaje P2A enviado desde un usuario a un agente en el que no hay una conversación existente y el agente no muestra una respuesta. |
Disponibilidad
Los informes de eventos de facturación están disponibles para todos los operadores que tienen tráfico de RBM en sus redes.
Formato
Los informes de eventos de facturación usan el formato de nombre de archivo YYYY/MM/DD/rbm_billable_events_YYYY-MM-DD.csv.
La fecha en el nombre del archivo es la fecha en que se genera el archivo. Por lo general, los registros del archivo cubrirán la actividad del día 2 días antes de esta fecha.
Los campos de un registro están separados por tabuladores y hay un registro por línea.
Habrá un registro para cada evento de facturación, es decir, dos conversaciones A2P con el mismo agente generarán dos eventos de facturación y dos registros en el informe de facturación.
Cada registro del informe de eventos facturables contiene la siguiente información para cada evento:
| Campo | Formato | Descripción | Ejemplo |
|---|---|---|---|
billing_event_id
|
cadena | Es el identificador de UUID, un número aleatorio, generado para cada evento nuevo en el momento en que se crea. | |
type
|
cadena | El tipo de evento:
|
single_message
|
agent_id
|
cadena | El identificador del agente que participó en el evento. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
cadena | El correo electrónico del propietario del agente que participó en el evento. Corresponde a la parte que registró al agente de RBM, en la mayoría de los casos, al agregador. Sin embargo, en algunos casos excepcionales, puede ser la marca. Este valor se toma del campo "Cuenta de Google de RBM" que se proporciona cuando el desarrollador se registró para usar RBM. | name@aggregator.com
|
billing_party
|
cadena | La fiesta que factura los eventos
|
carrier
|
max_duration_single_message
|
número | La duración, en horas, del mensaje de un agente que debe pasar sin recibir una respuesta para identificar una sola sesión de mensaje. | 24
|
max_duration_a2p_conversation
|
número | La duración máxima de una sesión de A2P, en horas. Se mide desde la primera respuesta del usuario hasta el mensaje inicial del agente. | 24
|
max_duration_p2a_conversation
|
número | La duración máxima de una sesión P2A, en horas. Se mide a partir del primer mensaje del usuario en la conversación. | 24
|
start_time
|
YYYY-mm-ddTHH:00:00Z | Indica la fecha y hora UTC en las que comenzó el evento, en formato ISO 8601, y se redondea a la hora más cercana.
|
2019-07-25T08:00:00Z
|
duration
|
número | La duración del evento, redondeada al minuto más cercano.
Cuando el tipo de evento es |
45
|
mt_messages
|
número | La cantidad de mensajes finalizados en dispositivos móviles del evento. | 11
|
mo_messages
|
número | La cantidad de mensajes originados en dispositivos móviles en el evento. | 9
|
size_kilobytes
|
número | El tamaño de todos los archivos adjuntos a los mensajes del evento, redondeado al kilobyte más cercano (1 KB = 1,024 bytes). | 912
|
agent_name
|
cadena |
Es el agente que participó en el evento. |
XYZ Mobile USA
|
owner_name
|
cadena | El propietario del agente que participó en el evento. Esta es la parte que registró al agente de RBM. En la mayoría de los casos, se trata del agregador, pero en algunos casos excepcionales puede ser la marca. Este valor se toma del "Nombre visible preferido para tu cuenta de socio" que se proporciona cuando el desarrollador se registró para usar RBM. | XYZ Mobile
|
Archivo de muestra
Hay un ejemplo de archivo de informe de facturación disponible para descargar.
Tamaño de archivo habitual
Un archivo de informe diario de un socio activo puede tener alrededor de 53,000 registros y un tamaño aproximado de 8 MB.
Registros de actividad
Los registros de actividad son el registro de datos sin procesar de la actividad en la plataforma de RBM para auditar eventos facturables y crear eventos personalizados.
Disponibilidad
Los registros de actividad solo están disponibles para los operadores que tienen tráfico de RBM en sus redes y habilitan la actividad de RCS con Jibe Cloud según sus propias Condiciones del Servicio. Si usas Jibe Cloud según las Condiciones del Servicio de Jibe, no tendrás acceso a los registros de actividad.
Formato
Los registros de actividad usan el formato de nombre de archivo YYYY/MM/DD/rbm_activity_YYYY-MM-DD.csv.
La fecha en el nombre del archivo es la fecha en que se genera el archivo. Por lo general, los registros del archivo cubrirán la actividad del día 2 días antes de esta fecha.
Los campos de un registro están separados por tabuladores y hay un registro por línea.
Cada registro de actividad contiene los siguientes campos para cada evento de actividad.
| Campo | Formato | Descripción | Ejemplo |
|---|---|---|---|
activity_id
|
cadena | Es el identificador de la actividad. | |
billing_event_id
|
cadena | El identificador del evento de facturación en el que se llevó a cabo la actividad. Puede estar vacío si la actividad no está asociada con ninguna sesión, como una text_message sin el delivery_receipt_event correspondiente.
| |
agent_id
|
cadena | El identificador del agente. | welcome-bot@rbm.goog
|
user_id
|
cadena | Es la MSISDN del usuario. | 918369110173
|
direction
|
cadena | La dirección en la que se envió el mensaje:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | Es la fecha y hora (UTC) en que el evento se envió a la plataforma de RBM. Consulta la nota que aparece más abajo. | 2019-07-25T00:29:07.033Z
|
type
|
cadena | El tipo de actividad:
|
text_message
|
size_bytes
|
cadena | El tamaño de los archivos adjuntos a la actividad, en bytes. | 912
|
Nota sobre las marcas de tiempo
Las marcas de tiempo en los registros de actividad registran la hora en la que se envió un evento a la plataforma de RBM. En el caso de los eventos que entregan contenido a un usuario, el evento no se escribirá en el Registro de actividad hasta que se entregue el mensaje.
Por ejemplo, si se envía un mensaje de RBM a un usuario el miércoles a las 1:00 p.m. y el destinatario está sin conexión hasta el domingo a las 9:00, el evento aparecerá en el registro de actividad generado para el domingo. La marca de tiempo del evento en el registro de actividad será el miércoles a las 13:00.