Esta página describe los archivos de datos que crea RCS for Business para ayudar a los operadores con la facturación y la auditoría.
| Archivo | Descripción | ¿Quién tiene acceso? |
|---|---|---|
| Informe de facturación | Informe agregado de eventos facturables entre agentes activados y usuarios. | Todas las compañías de transporte que operan activamente RCS para empresas. |
| Registro de actividad | Registro de datos sin procesar de la actividad de RCS for Business, incluidos los eventos facturables. | Operadores que utilizan activamente RCS para empresas y que operan el Servicio RCS de Google bajo sus propios Términos de Servicio (ToS). |
RCS for Business utiliza un modelo de facturación estándar para el tráfico fuera de EE. UU. Para obtener más información, consulte las preguntas frecuentes sobre facturación .
Generación de archivos
Cada archivo de datos representa un día de uso de RCS for Business en horario del Pacífico (PST). Los archivos se generan diariamente y reflejan la actividad de las 24 horas anteriores (de medianoche a medianoche). El proceso de generación puede tardar varias horas y el tiempo de finalización puede variar.
- Para los agentes no conversacionales , los archivos contienen datos del período de 24 horas inmediatamente anterior al día en que se generaron. Por ejemplo, un informe generado el 5 de mayo abarca datos desde las 00:00 del 4 de mayo hasta las 00:00 del 5 de mayo. La hora especificada corresponde a la zona horaria PST.
Para los agentes conversacionales , los archivos contienen datos del período de 24 horas comprendido entre uno y dos días antes de su generación. Por ejemplo, un informe generado el 5 de mayo incluye datos del período de 24 horas del 2 o 3 de mayo. La hora especificada corresponde a la zona horaria PST.
El motivo de la demora es que la actividad de RCS for Business para los agentes conversacionales está vinculada a sesiones, que pueden tardar hasta 24 horas en completarse. Esta demora permite a RCS for Business capturar todos los mensajes de una conversación antes de calcular el evento facturable. Para obtener más información sobre los agentes conversacionales, consulte las categorías de facturación de agentes .
Puntos clave:
- Sin actividad : Por defecto, no se genera ningún archivo si no hay actividad en la plataforma durante un día determinado. Sin embargo, puede optar por recibir archivos vacíos si lo necesita. Para ello, póngase en contacto con rbm-support@google.com.
- Nomenclatura : La fecha que aparece en el nombre del archivo es la fecha de creació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 ser eliminados.
Puedes utilizar estos archivos para actualizar tu almacén de datos con las métricas de uso más recientes de la plataforma.
Almacenamiento y acceso a archivos
Los archivos de datos están cifrados tanto en reposo como durante la transferencia.
Para recuperar archivos de datos mediante el Protocolo de Transferencia Segura de Archivos (SFTP), proporcione su clave pública SFTP. Para generar claves, consulte 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 a través de un puerto de alta prioridad (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 cuenta 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 aún no se han generado archivos de datos, verá un error SFTP similar a remote readdir("/"): No such file or directory , lo cual es lo esperado.
No se generará ningún archivo si no hay tráfico de RCS for Business que reportar. Esto significa que puede haber días en los que no se generen archivos. Si necesita archivos vacíos para optimizar su proceso, comuníquese con el equipo de soporte de RCS for Business .
Informes de facturación
Los informes de facturación son registros de eventos facturables , que se calculan en función de la categoría de facturación del agente y el tipo de mensajes que envía. Estos informes están disponibles para todos los operadores que utilizan activamente RCS for Business.
Los informes de facturación contienen información confidencial, pero no información personal identificable (PII) del usuario, como MSISDN, MSISDN cifrado o cualquier identificador único del usuario.
Categorías de facturación de agentes
Al crear un agente, el propietario define su categoría de facturación según cómo interactuará con los usuarios. Esta categoría no limita la cantidad ni el tipo de mensajes que puede enviar, pero sí determina cómo se le facturarán. Las dos categorías principales de facturación se describen en la siguiente tabla.
| 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 entregado al usuario. |
| Conversacional | Agentes diseñados para el intercambio bidireccional con los usuarios. |
| Facturación por conversación : Si una de las partes (el agente o el usuario) responde a un mensaje de la otra en un plazo de 24 horas, se inicia una conversación. Durante este periodo (24 horas después de la primera respuesta), el agente y el usuario pueden intercambiar cualquier número de mensajes, 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 cada mensaje individual, de forma similar a un agente que no ofrece conversación. |
El siguiente diagrama muestra un ejemplo de una sesión de facturación A2P para agentes conversacionales:
Agentes conversacionales versus agentes no conversacionales
Existen dos categorías principales de facturación: conversacional y no conversacional.
La principal diferencia en las categorías de facturación radica en la distinción entre agentes conversacionales y no conversacionales:
Los agentes no conversacionales pagan por cada mensaje que entregan al usuario.
- Esta categoría es la más adecuada para agentes que no esperan respuestas frecuentes.
Los agentes conversacionales pagan una tarifa fija por las conversaciones , que incluye todos los mensajes intercambiados en un período de 24 horas.
- Esta categoría es la más adecuada para 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 los eventos MT y MO, denominados eventos A2P y P2A.
- A2P (Application-to-Person) es MT (Mobile Terminated) : un mensaje enviado por la empresa.
- P2A (de persona a aplicación) es MO (originado desde el móvil) : un mensaje o acción iniciada por el usuario.
La siguiente tabla describe cada evento facturable en lo que respecta a los agentes conversacionales y no conversacionales.
| Evento | Descripción | Agentes no conversacionales | Agentes conversacionales |
|---|---|---|---|
basic_message | Mensaje A2P que incluye únicamente texto de 160 caracteres o menos. Si el texto incluye la URL de un sitio web con etiquetas OpenGraph , el mensaje puede mostrar una vista previa de la imagen, sin coste adicional para el socio. | Siempre se considera un evento facturable individual, independientemente de si el usuario responde o no. | 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 una a2p_conversation . |
single_message | Mensaje A2P que contiene contenido enriquecido o que es un mensaje de solo texto de más de 160 caracteres. | Siempre se considera un evento facturable individual, independientemente de si el usuario responde o no. | 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 una a2p_conversation . |
a2p_conversation (iniciada por la empresa) | Se inicia cuando un usuario responde a un mensaje A2P dentro de las 24 horas posteriores a su recepción, fuera de una conversación existente. | No aplica. Los agentes no conversacionales nunca generan este tipo de evento. | Si se entrega un mensaje P2A dentro de las 24 horas posteriores a la entrega de varios mensajes A2P, solo se utiliza el mensaje A2P que precedió inmediatamente al mensaje P2A para iniciar la conversación. Este mensaje A2P, y cualquier mensaje entregado dentro de las siguientes 24 horas, forman parte de la a2p_conversation . |
p2a_conversation (iniciada por el usuario) | Se inicia cuando un agente responde a un mensaje P2A dentro de las 24 horas posteriores a su recepción, fuera de una conversación existente. | No aplica. Los agentes no conversacionales nunca generan este tipo de evento. | Si se entrega un mensaje A2P dentro de las 24 horas posteriores a la entrega de varios mensajes P2A, solo se utiliza el mensaje P2A que precedió inmediatamente al mensaje A2P para iniciar la conversación. Este mensaje P2A, y cualquier mensaje entregado dentro de las siguientes 24 horas, forman parte de la p2a_conversation . |
p2a_message | Mensaje P2A de cualquier tipo. | Siempre se considera un evento facturable individual, independientemente de si el agente responde o no. | Se considera un evento facturable individual, a menos que el agente responda en un plazo de 24 horas. |
Categorías de facturación frente a eventos facturables
La distinción entre las categorías de facturación de los agentes y los eventos facturables es clave para comprender cómo se factura a su agente.
- La categoría de facturación es una clasificación fija que usted elige al crear su agente. Determina el método de facturación de su agente: por mensaje (agentes no conversacionales) o por conversación (agentes conversacionales).
- Los eventos facturables son interacciones entre un agente de RCS for Business y un usuario que se registran con 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 sea 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 parten de la base de que los eventos se facturan cuando se entregan los mensajes, no cuando se envían. Un mensaje no entregado o cancelado antes de su entrega no genera un evento facturable.
Formato del informe de facturación
Billing reports use the filename format rbm_billable_events_YYYY-MM-DD.csv . The date in the filename is the file generation date.
Cada línea del informe representa un evento facturable. Los campos dentro de cada registro están separados por tabulaciones. Por ejemplo, dos conversaciones A2P con el mismo agente generarían dos eventos facturables distintos 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 | cadena | Identificador generado que distingue el evento facturable. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff |
type | cadena | Tipo de evento:
| single_message |
agent_id | cadena | Identificador único del agente que participó en el evento. | rbm-welcome-bot@rbm.goog |
agent_owner | cadena | Dirección de correo electrónico del propietario actual de la cuenta de socio donde se creó el agente. | name@aggregator.com |
billing_party | cadena | Partido que factura los eventos.
| carrier |
max_duration_single_message | número | Tiempo máximo (en horas) permitido para que un usuario responda a un mensaje de un 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 | 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 | Duración máxima de una conversación P2A, en horas. Se mide desde el primer mensaje del usuario en la conversación. | 24 |
start_time | AAAA-mm-ddTHH:00:00Z | La fecha y hora UTC en que comenzó el evento en formato ISO 8601 redondeada a la hora más cercana. Mensajes 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 conversacional. | 45 |
mt_messages | número | Número de mensajes terminados en dispositivos móviles (A2P) en el evento. | 11 |
mo_messages | número | Número de mensajes originados desde 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 equivale a 1024 bytes). | 912 |
agent_name | cadena | Nombre del agente que participó en el evento. | XYZ Mobile USA |
owner_name | cadena | Nombre del propietario actual de la cuenta de socio donde se creó el agente. | XYZ Mobile |
Informe de facturación de muestra
Puede descargar informes de muestra:
Tamaño típico del archivo
El tamaño de un informe diario de un socio activo de RCS for Business depende de la actividad que haya generado en la red del operador. Por ejemplo, si el informe contiene 53 000 registros, el archivo tendrá un tamaño aproximado de 8 MB.
Registros de actividad
Los registros de actividad proporcionan datos sin procesar sobre la actividad en la plataforma RCS for Business. Puede utilizar estos registros para auditar 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 los números MSISDN de los suscriptores, solo están disponibles cuando un operador utiliza RCS bajo sus propios Términos de Servicio. Si tiene tráfico RCS para empresas en sus redes y habilita la actividad RCS con Google RCS bajo los Términos de Servicio de Google, no tendrá acceso a los registros de actividad.
Formato de registro de actividad
Los registros de actividad utilizan el formato de nombre de archivo rbm_activity_YYYY-MM-DD.csv . La fecha que aparece 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 en el registro de actividad contiene los siguientes campos para cada actividad:
| Campo | Formato | Descripción | Ejemplo |
|---|---|---|---|
activity_id | cadena | Identificador único de la actividad. | b422e1d3-ac99-442a-853d-a875d5e61762 |
billing_event_id | cadena | Identificador único para el evento facturable asociado. Puede estar vacío si la actividad no está asociada con un evento facturable, como un text_message sin delivery_receipt_event correspondiente. | 91yeb201-7c3b-412b-98d2-b0a0f7abe536 |
agent_id | cadena | Identificador único para el agente. | welcome-bot@rbm.goog |
user_id | cadena | MSISDN del usuario. | 918369110173 |
direction | cadena | La dirección a la que se envía el mensaje:
| MT |
time | AAAA-mm-ddTHH:MM:SS.SSSZ | Fecha y hora en que el evento se envió a la plataforma RCS for Business en formato UTC. Consulte Marcas de tiempo . | 2019-07-25T00:29:07.033Z |
type | cadena | Tipo de actividad:
| text_message |
size_bytes | cadena | Tamaño de los archivos adjuntos a la actividad, en bytes. | 912 |
Marcas de tiempo
Las marcas de tiempo en los registros de actividad indican cuándo se envió un evento a la plataforma RCS for Business. En el caso de 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 RCS for Business a un usuario el miércoles a las 13:00 y el destinatario está desconectado 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á miércoles, 13:00.