En esta página, se describen los archivos de datos que crea RCS para empresas para ayudar a los operadores con la facturación y la auditoría.
| Archivo | Descripción | Quién tiene acceso |
|---|---|---|
| Informe de facturación | Es un informe agregado de los eventos facturables entre los agentes lanzados y los usuarios. | Todos los operadores que operan activamente RCS para empresas |
| Registro de actividad | Registro de datos sin procesar de la actividad de RCS para empresas, incluidos los eventos facturables. | Operadores que operan activamente RCS para empresas y el Servicio de RCS de Google según sus propias Condiciones del Servicio (CdS). |
RCS para empresas usa dos modelos de facturación: el modelo de facturación estándar para el tráfico que no es de EE.UU. y el modelo de facturación de EE.UU. para el tráfico de EE.UU. Se indica explícitamente la información exclusiva del modelo estándar o del modelo de EE.UU. (por ejemplo, diferentes clasificaciones de eventos facturables o campos de informes).
- Para obtener detalles sobre el modelo de facturación estándar y un resumen de las diferencias entre los modelos de facturación, consulta las Preguntas frecuentes sobre la facturación.
- Para obtener detalles sobre las clasificaciones de facturación de EE.UU., consulta la guía del modelo de facturación de EE.UU..
Generación de archivos
Cada archivo de datos representa un día de uso de RCS para empresas en la hora estándar del Pacífico (PST). Los archivos se generan a diario y reflejan la actividad de las 24 horas anteriores (desde la medianoche hasta la medianoche). El proceso de generación puede tardar varias horas y el tiempo de finalización puede variar.
- En el caso de los agentes no conversacionales, los archivos contienen datos del período de las 24 horas que precedió inmediatamente al día en que se generó el archivo. Por ejemplo, un informe generado el 5 de mayo abarca los datos del 4 de mayo a las 0:00 h al 5 de mayo a las 0:00 h. La hora especificada está en la zona horaria PST.
En el caso de los agentes conversacionales, los archivos contienen datos de las 24 horas que se extienden de 1 a 2 días antes de la hora de generación del archivo. Por ejemplo, un informe generado el 5 de mayo abarca los datos del período de las 24 horas del 2 o el 3 de mayo. La hora especificada está en la zona horaria PST.
El motivo del retraso es que la actividad de RCS para empresas de los agentes conversacionales está vinculada a sesiones, que pueden tardar hasta 24 horas en completarse. Este retraso permite que RCS para empresas capture todos los mensajes de una conversación antes de calcular el evento facturable. Para obtener más información sobre los agentes conversacionales, consulta Categorías de facturación de agentes.
Puntos clave:
- Sin actividad: De forma predeterminada, no se genera ningún archivo si no hay actividad en la plataforma en un día determinado. Sin embargo, puedes habilitar la opción para recibir archivos vacíos si es necesario. Para habilitar la opción, comunícate con rbm-support@google.com.
- Nombres: La fecha que aparece en el nombre del archivo es la fecha de generación del archivo, no la fecha de los datos que contiene.
- Retención: Los archivos se almacenan durante un máximo de 63 días antes de que se borren.
Puedes usar estos archivos para actualizar tu almacén de datos con las métricas de uso de la plataforma más recientes.
Almacenamiento y acceso a archivos
Los archivos de datos se encriptan en reposo y durante la transferencia.
Para recuperar archivos de datos a través del protocolo de transferencia de archivos segura (SFTP), proporciona tu clave pública de SFTP. Para generar claves, consulta Cómo generar un par de claves Secure Shell (SSH) para un buzón SFTP.
El servidor SFTP es partnerupload.google.com, y la conexión se realiza 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 separada para cada tipo de informe.
Se proporcionan cuentas separadas para acceder a los diferentes tipos de informes.
Disponibilidad de archivos
Si aún no se generaron archivos de datos, verás un error de SFTP similar a remote readdir("/"): No such file or directory, lo que es normal.
No se generará un archivo si no hay tráfico de RCS para empresas para informar. Esto significa que es posible que no se generen archivos algunos días. Si necesitas archivos vacíos para optimizar tu proceso, comunícate con el equipo de asistencia de RCS para empresas.
Informes de facturación
Los informes de facturación son registros de los eventos facturables, que se calculan según la categoría de facturación del agente y el tipo de mensajes que envía. Los informes de facturación están disponibles para todos los operadores que operan activamente RCS para empresas.
Los informes de facturación contienen información confidencial, pero no información de identificación personal (PII) del usuario, como el MSISDN, el MSISDN con hash o cualquier identificador único del usuario.
Categorías de facturación de agentes
Cuando se crea un agente, el propietario establece su categoría de facturación según cómo interactuará el agente con los usuarios. La categoría de facturación no restringe la cantidad ni el tipo de mensajes que puede enviar un agente. Sin embargo, sí determina cómo se facturarán los mensajes al agente. En la siguiente tabla, se describen las dos categorías principales de facturación.
| Categoría de facturación | Tipo de agente | Ejemplos de casos de uso | Método de facturación |
|---|---|---|---|
| No conversacional | Agentes que principalmente envían mensajes unidireccionales. |
|
Se factura por cada mensaje que se entrega al usuario. |
| Conversacional | Agentes diseñados para intercambios con los usuarios. |
|
Se factura por conversación: Si una de las partes (el agente o el usuario) responde un mensaje de la otra parte en un plazo de 24 horas, se inicia una conversación. Durante la ventana de conversación (24 horas después de la primera respuesta), el agente y el usuario pueden intercambiar la cantidad de mensajes que deseen, y al agente se le facturará una tarifa fija por la conversación. Facturación por mensaje: Si el agente entrega un mensaje al que el usuario no responde en un plazo de 24 horas, se le facturará al agente por el mensaje individual, de manera similar a un agente no conversacional. |
En el siguiente diagrama, se muestra un ejemplo de una sesión de facturación de A2P para agentes conversacionales:
Agentes conversacionales frente a agentes no conversacionales
Existen dos categorías principales de facturación: conversacional y no conversacional.
La diferencia clave en las categorías de facturación se encuentra entre los agentes conversacionales y los no conversacionales:
A los agentes no conversacionales se les factura cada mensaje que entregan al usuario.
- Esta categoría es ideal para los agentes que no esperan respuestas frecuentes.
A los agentes conversacionales se les factura una tarifa plana por conversaciones, que incluyen todos los mensajes intercambiados en un período de las 24 horas.
- Esta categoría es la mejor para los agentes que participan en conversaciones de varios turnos con los usuarios.
Eventos facturables
En los informes de facturación, se registran cinco tipos de eventos facturables. Estos eventos incluyen eventos MT y MO, que se conocen como eventos A2P y P2A.
- A2P (de aplicación a persona) es MT (terminado en el dispositivo móvil): Es un mensaje que envía la empresa.
- P2A (de persona a aplicación) es MO (originado en el dispositivo móvil): Es un mensaje o una acción iniciados por el usuario.
En la siguiente tabla, se describe cada evento facturable tal como se aplica a los agentes conversacionales y no conversacionales.
| Evento | Descripción | Agentes no conversacionales | Agentes conversacionales |
|---|---|---|---|
basic_message
|
Mensaje de A2P que incluye solo texto con 160 caracteres o menos. Si el texto incluye una URL de un sitio web con etiquetas openGraph, es posible que el mensaje muestre una vista previa de la imagen sin cargo adicional para el socio. | Siempre se trata como un evento facturable individual, independientemente de si el usuario responde. | Se trata como un evento facturable individual, a menos que el usuario responda en un plazo de 24 horas. En ese caso, el mensaje pasa a formar parte de un a2p_conversation.
|
single_message
|
Mensaje de A2P que tiene contenido enriquecido o es un mensaje solo de texto de más de 160 caracteres. | Siempre se trata como un evento facturable individual, independientemente de si el usuario responde. | Se trata como un evento facturable individual, a menos que el usuario responda en un plazo de 24 horas. En ese caso, el mensaje pasa a formar parte de un a2p_conversation.
|
a2p_conversation (iniciada por la empresa)
|
Se inicia cuando un usuario responde un mensaje A2P dentro de las 24 horas posteriores a su recepción, fuera de una conversación existente. | N/A. Los agentes no conversacionales nunca generan este tipo de evento. | Si se entrega un mensaje P2A dentro de las 24 horas posteriores a varios mensajes A2P, solo se usará el mensaje A2P que precedió inmediatamente al mensaje P2A para iniciar la conversación. Este mensaje A2P y todos los mensajes que se entreguen en las próximas 24 horas forman parte del a2p_conversation.
|
p2a_conversation (iniciado por el usuario)
|
Se inicia cuando un agente responde un mensaje de P2A en un plazo de 24 horas después de recibirlo, fuera de una conversación existente. | N/A. Los agentes no conversacionales nunca generan este tipo de evento. | Si se entrega un mensaje A2P dentro de las 24 horas posteriores a varios mensajes P2A, solo se usará el mensaje P2A que precedió inmediatamente al mensaje A2P para iniciar la conversación. Este mensaje de P2A y todos los mensajes que se entreguen en las próximas 24 horas forman parte del p2a_conversation.
|
p2a_message
|
Mensaje P2A de cualquier tipo. | Siempre se trata como un evento facturable individual, independientemente de si el agente responde. | Se trata como un evento facturable individual, a menos que el agente responda en un plazo de 24 horas. |
Comparación entre categorías de facturación y eventos facturables
La distinción entre las categorías de facturación y los eventos facturables del agente es clave para comprender cómo se factura tu agente.
- La categoría de facturación es una clasificación fija que eliges cuando creas tu agente. Determina el método por el que se factura tu agente: por mensaje (agentes no conversacionales) o por conversación (agentes conversacionales).
- Los eventos facturables son interacciones entre un agente de RCS para empresas y un usuario que se registran para fines de facturación (por ejemplo,
basic_message,single_message,a2p_conversation).
Generación de informes de facturación
Solo los agentes con tráfico que no es de prueba generan eventos facturables. La actividad de los números de teléfono de prueba no aparece en los informes de facturación.
Estos informes suponen que los eventos se facturan cuando se entregan los mensajes, no cuando se envían. Un mensaje no entregado o un mensaje cancelado antes de la entrega no activan un evento facturable.
Formato del informe de facturación
Los informes de facturación usan el formato de nombre de archivo rbm_billable_events_YYYY-MM-DD.csv.
La fecha que aparece en el nombre del archivo es la fecha de generación del archivo.
Cada línea del informe es un registro que representa un solo evento facturable. Los campos dentro de un registro están separados por tabulaciones. Por ejemplo, dos conversaciones de A2P con el mismo agente generarían dos eventos facturables separados y dos registros en el informe de facturación.
Cada registro del informe contiene la siguiente información para cada evento facturable.
| Campo | Formato | Descripción | Ejemplo |
|---|---|---|---|
billing_event_id
|
string | Es el ID generado que distingue el evento facturable. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
|
type
|
string | Tipo de evento:
Modelo de facturación estándar Modelo de facturación de EE.UU. |
single_message
|
agent_id
|
string | Es el identificador único del agente que participó en el evento. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
string | Dirección de correo electrónico del propietario actual de la cuenta de socio en la que se creó el agente. | name@aggregator.com
|
billing_party
|
string | Es la parte que factura los eventos.
|
carrier
|
max_duration_single_message
|
número | Es el tiempo máximo (en horas) que se le permite a un usuario responder a un mensaje del agente antes de que se cierre la ventana de inicio de la conversación y el mensaje se clasifique como un evento single_message.
|
24
|
max_duration_a2p_conversation
|
número | Es la duración máxima de una conversación A2P, en horas. Se mide desde la primera respuesta del usuario al mensaje inicial del agente. | 24
|
max_duration_p2a_conversation
|
número | Es la duración máxima de una conversación de P2A, en horas. Se mide desde el primer mensaje del usuario en la conversación. | 24
|
start_time
|
YYYY-mm-ddTHH:00:00Z | Fecha y hora en UTC en que comenzó el evento, en formato ISO 8601 y redondeadas a la hora más cercana.
Mensajes de A2P
Mensajes P2A
|
2019-07-25T08:00:00Z
|
duration
|
número | Duración del evento, redondeada al minuto más cercano.
El valor es 0 para cualquier evento que no sea de conversación. |
45
|
mt_messages
|
número | Es la cantidad de mensajes terminados en dispositivos móviles (A2P) en el evento. | 11
|
mo_messages
|
número | Es la cantidad de mensajes originados en dispositivos móviles (P2A) en el evento. | 9
|
size_kilobytes
|
número | 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
|
string |
Es el nombre del agente que participó en el evento. |
XYZ Mobile USA
|
owner_name
|
string | Nombre del propietario actual de la cuenta de socio en la que se creó el agente. | XYZ Mobile
|
segment_count
|
número | Solo para el modelo de facturación de EE.UU.
Es el recuento de segmentos calculado para los eventos de |
5
|
Ejemplo de informe de facturación
Puedes descargar informes de muestra:
- Informe de facturación para el modelo de facturación estándar
- Informe de facturación para el modelo de facturación de EE.UU.
Tamaño de archivo habitual
El tamaño de un informe diario de un socio activo de RCS para empresas depende de la cantidad de actividad que haya generado en la red del operador. Por ejemplo, si hay 53,000 registros en el informe, el tamaño del archivo será de aproximadamente 8 MB.
Registros de actividad
Los registros de actividad proporcionan datos sin procesar sobre la actividad en la plataforma de RCS para empresas. Puedes usar estos registros para auditar los eventos facturables y crear eventos personalizados.
Dado que los registros de actividad contienen información de identificación personal (PII), como información detallada de transacciones y MSISDN de suscriptores, solo están disponibles cuando un operador ejecuta RCS según sus propias Condiciones del Servicio. Si tienes tráfico de RCS para empresas en tus redes y habilitas la actividad de RCS con el servicio RCS de Google según las C.S. de Google, no tendrás acceso a los registros de actividad.
Formato del registro de actividad
Los registros de actividad usan el formato de nombre de archivo rbm_activity_YYYY-MM-DD.csv. La fecha en el nombre del archivo es la fecha de generación del archivo.
Los campos de un registro están separados por tabulaciones, y hay un registro por línea.
Cada registro del registro de actividad contiene los siguientes campos para cada actividad:
| Campo | Formato | Descripción | Ejemplo |
|---|---|---|---|
activity_id
|
string | Es el identificador único de la actividad. | b422e1d3-ac99-442a-853d-a875d5e61762
|
billing_event_id
|
string | Es el identificador único del evento facturable asociado. Puede estar vacío si la actividad no está asociada a un evento facturable, como un text_message sin el delivery_receipt_event correspondiente.
|
91yeb201-7c3b-412b-98d2-b0a0f7abe536
|
agent_id
|
string | Es el identificador único del agente. | welcome-bot@rbm.goog
|
user_id
|
string | Es el MSISDN del usuario. | 918369110173
|
direction
|
string | Dirección en la que se envía el mensaje:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | Fecha y hora en que se envió el evento a la plataforma de RCS para empresas en formato UTC. Consulta Marcas de tiempo. | 2019-07-25T00:29:07.033Z
|
type
|
string | Tipo de actividad:
|
text_message
|
size_bytes
|
string | Tamaño de los archivos adjuntos a la actividad, en bytes. | 912
|
Marcas de tiempo
Las marcas de tiempo de los registros de actividad registran cuándo se envió un evento a la plataforma de RCS Business. En el caso de los eventos que entregan contenido a un usuario, el evento no se registrará en el registro de actividad hasta que se entregue el mensaje.
Por ejemplo, si se envía un mensaje de RCS para Empresas a un usuario el miércoles a las 13:00 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, pero la marca de tiempo será el miércoles a las 13:00.