Cette page décrit les fichiers de données créés par RCS for Business pour aider les transporteurs dans leurs opérations de facturation et d'audit.
| Déposer | Description | Qui a accès |
|---|---|---|
| Billing report | Rapport agrégé des événements facturables entre les agents et les utilisateurs. | Tous les opérateurs qui exploitent activement RCS for Business. |
| Journal d'activité | Journal des données brutes de l'activité RCS for Business, y compris les événements facturables. | Les opérateurs qui exploitent activement le service RCS pour les entreprises et qui utilisent le service Google RCS selon leurs propres conditions d'utilisation (CGU). |
RCS for Business utilise un modèle de facturation standard pour le trafic hors États-Unis. Pour plus d'informations, consultez la FAQ sur la facturation .
génération de fichiers
Chaque fichier de données représente une journée d'utilisation de RCS for Business en heure du Pacifique (PST). Les fichiers sont générés quotidiennement et reflètent l'activité des dernières 24 heures (de minuit à minuit). Le processus de génération peut prendre plusieurs heures et le délai d'exécution peut varier.
- Pour les agents non conversationnels , les fichiers contiennent des données des 24 heures précédant immédiatement le jour de leur génération. Par exemple, un rapport généré le 5 mai couvre les données du 4 mai à minuit au 5 mai à minuit. L'heure indiquée est en heure du Pacifique (PST).
Pour les agents conversationnels , les fichiers contiennent des données des 24 heures précédant de 1 à 2 jours la date de génération du fichier. Par exemple, un rapport généré le 5 mai couvre les données des 24 heures du 2 ou du 3 mai. L'heure indiquée est en heure du Pacifique (PST).
Ce délai s'explique par le fait que l'activité RCS for Business pour les agents conversationnels est liée à des sessions, dont la finalisation peut prendre jusqu'à 24 heures. Ce délai permet à RCS for Business de capturer tous les messages d'une conversation avant de calculer l'événement facturable. Pour plus d'informations sur les agents conversationnels, consultez la section « Catégories de facturation des agents » .
Points clés :
- Absence d'activité : Par défaut, aucun fichier n'est généré en l'absence d'activité sur la plateforme au cours d'une journée donnée. Vous pouvez toutefois choisir de recevoir des fichiers vides si nécessaire. Pour ce faire, veuillez contacter rbm-support@google.com.
- Nommage : La date figurant dans le nom du fichier est la date de génération du fichier, et non la date des données qu'il contient.
- Durée de conservation : Les fichiers sont conservés pendant 63 jours maximum avant d'être supprimés.
Vous pouvez utiliser ces fichiers pour mettre à jour votre entrepôt de données avec les dernières statistiques d'utilisation de la plateforme.
Stockage et accès aux fichiers
Les fichiers de données sont chiffrés au repos et lors de leur transfert.
Pour récupérer des fichiers de données via le protocole SFTP (Secure File Transfer Protocol), veuillez fournir votre clé publique SFTP. Pour générer des clés, consultez la section « Générer une paire de clés SSH (Secure Shell) pour un compte de dépôt SFTP ».
Le serveur SFTP est partnerupload.google.com et la connexion se fait sur un numéro de port élevé (19321) pour une sécurité accrue.
Vous pouvez utiliser la commande suivante pour accéder à vos fichiers de données :
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Google fournit les noms d'utilisateur des comptes dans les formats suivants :
-
rbmreports-billableevents-<carrier name> -
rbmreports-activity-<carrier name>
Google spécifie <carrier name> et fournit un compte distinct pour chaque type de rapport.
Des comptes distincts sont prévus pour accéder aux différents types de rapports.
Disponibilité des fichiers
Si aucun fichier de données n'a encore été généré, vous verrez une erreur SFTP similaire à remote readdir("/"): No such file or directory , ce qui est normal.
Aucun fichier ne sera généré s'il n'y a pas de trafic RCS for Business à déclarer. Il est donc possible que certains jours, aucun fichier ne soit généré. Si vous avez besoin de fichiers vides pour optimiser votre processus, contactez l'équipe d'assistance RCS for Business .
Rapports de facturation
Les rapports de facturation répertorient les événements facturables , calculés en fonction de la catégorie de facturation de l'agent et du type de messages envoyés. Ces rapports sont accessibles à tous les opérateurs utilisant activement RCS for Business.
Les rapports de facturation contiennent des informations confidentielles, mais aucune information personnelle identifiable (IPI) de l'utilisateur, telle que le MSISDN, le MSISDN haché ou tout autre identifiant unique de l'utilisateur.
Catégories de facturation des agents
Lors de la création d'un agent, le propriétaire définit sa catégorie de facturation en fonction de la manière dont l'agent interagira avec les utilisateurs. Cette catégorie n'impose aucune limite au nombre ni au type de messages que l'agent peut envoyer, mais elle détermine le mode de facturation de ces messages. Les deux principales catégories de facturation sont décrites dans le tableau ci-dessous.
| Catégorie de facturation | Type d'agent | Exemples de cas d'utilisation | Méthode de facturation |
|---|---|---|---|
| Non conversationnel | Agents qui envoient principalement des messages à sens unique. |
| Billed for each message delivered to the user. |
| De la conversation | Des agents conçus pour des échanges bilatéraux avec les utilisateurs. |
| Facturation par conversation : Si l’une des parties (l’agent ou l’utilisateur) répond à un message de l’autre partie dans les 24 heures, une conversation est engagée. Pendant cette période (24 heures après la première réponse), l’agent et l’utilisateur peuvent échanger autant de messages qu’ils le souhaitent, et l’agent sera facturé à un tarif fixe pour chaque conversation. Facturation par message : Si l'agent envoie un message auquel l'utilisateur ne répond pas dans les 24 heures, l'agent sera facturé pour chaque message, comme pour un agent non conversationnel. |
Le diagramme suivant illustre un exemple de session de facturation A2P pour les agents conversationnels :
Conversational versus non-conversational agents
Il existe deux grandes catégories de facturation : conversationnelle et non conversationnelle.
La principale différence dans les catégories de facturation réside entre les agents conversationnels et les agents non conversationnels :
Les agents non conversationnels sont facturés pour chaque message qu'ils transmettent à l'utilisateur.
- Cette catégorie est idéale pour les agents qui ne s'attendent pas à des réponses fréquentes.
Les agents conversationnels sont facturés à un tarif forfaitaire pour les conversations , qui comprend tous les messages échangés sur une période de 24 heures.
- Cette catégorie est idéale pour les agents qui mènent des conversations à plusieurs tours avec les utilisateurs.
Événements facturables
Cinq types d'événements facturables sont enregistrés dans les rapports de facturation. Ces événements comprennent les événements MT et MO, désignés respectivement comme événements A2P et P2A.
- A2P (Application-to-Person) est MT (Mobile Terminated) : Un message envoyé par l'entreprise.
- P2A (Personne-à-Application) est MO (Mobile Originated) : Un message ou une action initiée par l'utilisateur.
Le tableau suivant décrit chaque événement facturable, tel qu'il s'applique aux agents non conversationnels et conversationnels.
| Événement | Description | Agents non conversationnels | Agents conversationnels |
|---|---|---|---|
basic_message | Message A2P ne contenant que du texte de 160 caractères maximum. Si ce texte inclut une URL vers un site web avec des balises openGraph , le message peut afficher un aperçu d'image, sans frais supplémentaires pour le partenaire. | Toujours considéré comme un événement facturable individuel, que l'utilisateur réponde ou non. | Considéré comme un événement facturable individuel, sauf si l'utilisateur répond dans les 24 heures. Dans ce cas, le message fait partie d'une a2p_conversation . |
single_message | Message A2P contenant soit un contenu enrichi, soit un message textuel de plus de 160 caractères. | Toujours considéré comme un événement facturable individuel, que l'utilisateur réponde ou non. | Considéré comme un événement facturable individuel, sauf si l'utilisateur répond dans les 24 heures. Dans ce cas, le message fait partie d'une a2p_conversation . |
a2p_conversation (initiée par l'entreprise) | Déclenché lorsqu'un utilisateur répond à un message A2P dans les 24 heures suivant sa réception, en dehors d'une conversation existante. | Sans objet. Les agents non conversationnels ne génèrent jamais ce type d'événement. | Si un message P2A est envoyé dans les 24 heures suivant plusieurs messages A2P, seul le message A2P qui le précède immédiatement est utilisé pour initier la conversation. Ce message A2P, ainsi que tous les messages envoyés dans les 24 heures suivantes, font partie de la a2p_conversation . |
p2a_conversation (user initiated) | Déclenché lorsqu'un agent répond à un message P2A dans les 24 heures suivant sa réception, en dehors d'une conversation existante. | Sans objet. Les agents non conversationnels ne génèrent jamais ce type d'événement. | Si un message A2P est envoyé dans les 24 heures suivant plusieurs messages P2A, seul le message P2A qui le précède immédiatement est utilisé pour initier la conversation. Ce message P2A, ainsi que tous les messages envoyés dans les 24 heures suivantes, font partie de la p2a_conversation . |
p2a_message | P2A message of any type. | Toujours considéré comme un événement facturable individuel, que l'agent réponde ou non. | Considéré comme un événement facturable individuel, sauf si l'agent répond dans les 24 heures. |
Catégories de facturation versus événements facturables
La distinction entre les catégories de facturation des agents et les événements facturables est essentielle pour comprendre comment votre agent est facturé.
- La catégorie de facturation est une classification fixe que vous choisissez lors de la création de votre agent. Elle détermine le mode de facturation de votre agent : par message (agents non conversationnels) ou par conversation (agents conversationnels).
- Les événements facturables sont des interactions entre un agent RCS for Business et un utilisateur qui sont suivies à des fins de facturation (par exemple,
basic_message,single_message,a2p_conversation).
Génération de rapports de facturation
Seuls les agents dont le trafic n'est pas celui des testeurs génèrent des événements facturables. L'activité provenant des numéros de téléphone de test n'apparaît pas dans les rapports de facturation.
Ces rapports partent du principe que les événements sont facturés lors de la livraison des messages, et non lors de leur envoi. Un message non livré ou annulé avant sa livraison ne donne pas lieu à une facturation.
Billing report format
Les rapports de facturation utilisent le format de nom de fichier rbm_billable_events_YYYY-MM-DD.csv . La date figurant dans le nom du fichier correspond à la date de génération du fichier.
Chaque ligne du rapport correspond à un enregistrement représentant un événement facturable. Les champs d'un enregistrement sont séparés par des tabulations. Par exemple, deux conversations A2P avec le même agent généreront deux événements facturables distincts et deux enregistrements dans le rapport de facturation.
Chaque enregistrement du rapport contient les informations suivantes pour chaque événement facturable.
| Champ | Format | Description | Exemple |
|---|---|---|---|
billing_event_id | chaîne | Identifiant généré permettant de distinguer l'événement facturable. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff |
type | chaîne | Type d'événement :
| single_message |
agent_id | chaîne | Identifiant unique de l'agent ayant participé à l'événement. | rbm-welcome-bot@rbm.goog |
agent_owner | chaîne | Adresse e-mail du propriétaire actuel du compte partenaire sur lequel l'agent a été créé. | name@aggregator.com |
billing_party | chaîne | Party who bills for events.
| carrier |
max_duration_single_message | nombre | Durée maximale (en heures) accordée à un utilisateur pour répondre à un message d'agent avant que la fenêtre d'initiation de la conversation ne se ferme et que le message ne soit classé comme un événement single_message . | 24 |
max_duration_a2p_conversation | nombre | Durée maximale d'une conversation A2P, en heures. Mesurée entre la première réponse de l'utilisateur et le message initial de l'agent. | 24 |
max_duration_p2a_conversation | nombre | Durée maximale d'une conversation P2A, en heures. Mesurée à partir du premier message de l'utilisateur dans la conversation. | 24 |
start_time | YYYY-mm-ddTHH:00:00Z | Date et heure UTC de début de l'événement, au format ISO 8601, arrondies à l'heure la plus proche. A2P messages
P2A messages
| 2019-07-25T08:00:00Z |
duration | nombre | Event duration, rounded to the nearest minute. The value is 0 for any non-conversational event. | 45 |
mt_messages | nombre | Nombre de messages à terminaison mobile (A2P) dans l'événement. | 11 |
mo_messages | nombre | Nombre de messages d'origine mobile (P2A) dans l'événement. | 9 |
size_kilobytes | nombre | Taille de tous les fichiers joints aux messages de l'événement, arrondie au kilooctet le plus proche (1 ko équivaut à 1024 octets). | 912 |
agent_name | chaîne | Nom de l'agent ayant participé à l'événement. | XYZ Mobile USA |
owner_name | chaîne | Nom du propriétaire actuel du compte partenaire sur lequel l'agent a été créé. | XYZ Mobile |
Sample billing report
Sample reports are available for download:
Taille typique des fichiers
La taille d'un rapport quotidien provenant d'un partenaire RCS for Business actif dépend de l'activité générée sur le réseau de l'opérateur. Par exemple, si le rapport contient 53 000 enregistrements, le fichier pèsera environ 8 Mo.
Journaux d'activité
Les journaux d'activité fournissent des données brutes sur l'activité de la plateforme RCS for Business. Vous pouvez utiliser ces journaux pour auditer les événements facturables et créer des événements personnalisés.
Les journaux d'activité contiennent des informations personnelles identifiables (IPI), telles que des données transactionnelles détaillées et les numéros MSISDN des abonnés. Par conséquent, ils ne sont accessibles que lorsqu'un opérateur exploite le service RCS conformément à ses propres conditions d'utilisation. Si vous utilisez le service RCS pour entreprises sur vos réseaux et activez l'activité RCS avec Google RCS conformément aux conditions d'utilisation de Google, vous n'aurez pas accès aux journaux d'activité.
Activity log format
Les journaux d'activité utilisent le format de nom de fichier rbm_activity_YYYY-MM-DD.csv . La date figurant dans le nom du fichier correspond à la date de génération du fichier.
Les champs d'un enregistrement sont séparés par des tabulations, et il y a un enregistrement par ligne.
Chaque enregistrement du journal d'activité contient les champs suivants pour chaque activité :
| Champ | Format | Description | Exemple |
|---|---|---|---|
activity_id | chaîne | Unique identifier for the activity. | b422e1d3-ac99-442a-853d-a875d5e61762 |
billing_event_id | chaîne | Identifiant unique de l'événement facturable associé. Peut être vide si l'activité n'est pas associée à un événement facturable, comme un text_message sans delivery_receipt_event correspondant. | 91yeb201-7c3b-412b-98d2-b0a0f7abe536 |
agent_id | chaîne | Unique identifier for the agent. | welcome-bot@rbm.goog |
user_id | chaîne | MSISDN of the user. | 918369110173 |
direction | chaîne | The direction where the message is sent:
| MT |
time | YYYY-mm-ddTHH:MM:SS.SSSZ | Date et heure de soumission de l'événement à la plateforme RCS for Business au format UTC. Voir Horodatage . | 2019-07-25T00:29:07.033Z |
type | chaîne | Type d'activité :
| text_message |
size_bytes | chaîne | Taille des fichiers joints à l'activité, en octets. | 912 |
Horodatage
Les horodatages des journaux d'activité indiquent la date et l'heure de soumission d'un événement à la plateforme RCS for Business. Pour les événements qui envoient du contenu à un utilisateur, l'événement n'est enregistré dans le journal d'activité qu'une fois le message distribué.
Par exemple, si un message RCS for Business est envoyé à un utilisateur le mercredi à 13h00 et que le destinataire est hors ligne jusqu'au dimanche 9h00, l'événement apparaîtra dans le journal d'activité généré pour le dimanche, mais l'horodatage sera le mercredi à 13h00.