Cette page décrit les fichiers de données que RCS pour les entreprises crée pour aider les opérateurs à gérer la facturation et l'audit. Consultez les questions fréquentes sur la facturation pour obtenir des réponses aux questions courantes sur le modèle de facturation du RCS pour les entreprises.
| Fichier | Description | Qui a accès |
|---|---|---|
| Rapport sur les événements de facturation | Rapport agrégé des événements facturables entre les agents lancés et les utilisateurs. | Tous les opérateurs qui utilisent activement RCS pour les entreprises. |
| Journal d'activité | Journal de données brutes de l'activité RCS pour les entreprises, y compris les événements facturables. | Opérateurs qui utilisent activement le RCS pour les entreprises et qui exploitent le service Google RCS en vertu de leurs propres conditions d'utilisation. |
Génération de fichiers
Chaque fichier de données représente une journée d'utilisation de RCS pour les entreprises en temps universel coordonné (UTC). Les fichiers sont générés quotidiennement. 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 de la période de 24 heures qui a immédiatement précédé l'heure de génération du fichier. Par exemple, si un rapport sur les événements de facturation est généré le 5 mai à 11h00 UTC, il contiendra les données du 4 mai à 11h00 UTC au 5 mai à 11h00 UTC.
Pour les agents conversationnels, les fichiers contiennent des données de la période de 24 heures précédant de un à deux jours l'heure de génération du fichier. Par exemple, si un rapport sur les événements de facturation est généré le 5 mai à 11h00 UTC, il peut contenir des données allant du 3 mai à 11h00 UTC au 4 mai à 11h00 UTC.
Ce délai s'explique par le fait que l'activité RCS for Business des agents conversationnels est liée aux conversations, qui peuvent prendre jusqu'à 48 heures. Ce délai permet à RCS for Business de capturer tous les messages d'une conversation avant de calculer l'événement de facturation. Pour en savoir plus sur les agents conversationnels, consultez Catégories de facturation des agents.
Points essentiels :
Aucune activité : si aucune activité n'est enregistrée sur la plate-forme un jour donné, aucun fichier n'est généré.
Nommage : la date figurant dans le nom du fichier correspond à la date de génération du fichier, et non à la date des données qu'il contient.
Conservation : les fichiers sont stocké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 métriques d'utilisation de la plate-forme.
Stockage et accès aux fichiers
Les fichiers de données sont chiffrés au repos et en transit.
Pour récupérer des fichiers de données à l'aide du protocole SFTP (Secure File Transfer Protocol), fournissez votre clé publique SFTP. Pour générer des clés, consultez Générer une paire de clés Secure Shell (SSH) pour une boîte de dépôt SFTP.
Le serveur SFTP est partnerupload.google.com et la connexion s'effectue sur un numéro de port élevé (19321) pour plus de sécurité.
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 aux 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 fournis 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é, une erreur SFTP semblable à remote readdir("/"): No such file or directory s'affichera, ce qui est normal.
Aucun fichier ne sera généré s'il n'y a pas de trafic RCS pour les entreprises à signaler. Cela signifie qu'il peut arriver que des fichiers ne soient pas générés certains jours. Si vous avez besoin de fichiers vides pour simplifier votre processus, contactez rbm-support@google.com.
Rapports sur les événements de facturation
Les rapports sur les événements de facturation sont des enregistrements des événements de facturation, qui sont calculés en fonction de la catégorie de facturation de l'agent et du type de messages qu'il envoie. Les rapports sur les événements de facturation sont disponibles pour tous les opérateurs qui utilisent activement le RCS pour les entreprises.
Les rapports sur les événements de facturation contiennent des informations confidentielles, mais aucune information permettant d'identifier personnellement l'utilisateur (PII), comme 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 façon dont l'agent interagira avec les utilisateurs. La catégorie de facturation ne limite pas le nombre ni le type de messages qu'un agent peut envoyer. Toutefois, il détermine la façon dont l'agent sera facturé pour les 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 | Mode de facturation |
|---|---|---|---|
Non conversationnel (Inclut les catégories "Message de base" et "Message unique".) Remarque : Il n'y a plus de différence entre ces deux catégories. Un agent de l'une ou l'autre catégorie sera facturé en tant qu'agent non conversationnel.) |
Agents qui envoient principalement des messages unidirectionnels. |
|
Facturé pour chaque message envoyé à l'utilisateur. |
| Agent | Agents conçus pour les échanges aller-retour avec les utilisateurs. |
|
Facturation par conversation : une conversation démarre si l'une des parties (l'agent ou l'utilisateur) répond à un message de l'autre partie dans les 24 heures. Pendant la période de conversation (24 heures après la première réponse), l'agent et l'utilisateur peuvent échanger un nombre illimité de messages. L'agent sera facturé à un tarif fixe pour la 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 le message individuel, comme un agent non conversationnel. |
Le schéma suivant montre un exemple de session de facturation A2P pour les agents conversationnels :
Agents conversationnels et non conversationnels
Il existe deux principales catégories de facturation : conversationnelle et non conversationnelle. La catégorie "Non conversationnel" inclut les catégories "Message de base" et "Message unique", qui sont fonctionnellement identiques. Un agent appartenant à l'une de ces catégories est facturé en tant qu'agent non conversationnel.
La principale différence entre les catégories de facturation concerne les agents conversationnels et non conversationnels :
Les agents non conversationnels sont facturés pour chaque message qu'ils envoient à l'utilisateur.
- Cette catégorie convient aux agents qui ne s'attendent pas à recevoir de réponses fréquentes.
Les agents conversationnels sont facturés à un tarif fixe pour les conversations, qui incluent tous les messages échangés sur une période de 24 heures.
- Cette catégorie est idéale pour les agents qui engagent des conversations multitours avec les utilisateurs.
Événements de facturation
Cinq types différents d'événements de facturation sont enregistrés dans les rapports sur les événements de facturation. Ces événements incluent les messages A2P et P2A.
- A2P (Application-to-Person) : envoyé par l'entreprise.
- P2A (Person-to-Application) : envoyé par l'utilisateur.
Le tableau suivant décrit chaque événement de facturation tel qu'il s'applique aux agents conversationnels et non conversationnels.
| Événement | Description | Agents non conversationnels | Agents conversationnels |
|---|---|---|---|
basic_message
|
Message A2P qui ne contient que du texte et qui ne dépasse pas 160 caractères. Si le texte inclut l'URL d'un site Web avec des balises OpenGraph, un aperçu de l'image peut s'afficher dans le message, sans frais supplémentaires pour le partenaire. | Toujours traité comme un événement de facturation individuel, que l'utilisateur réponde ou non. | Elle est traitée comme un événement de facturation individuel, sauf si l'utilisateur répond dans les 24 heures. Dans ce cas, le message fait partie d'un a2p_conversation.
|
single_message
|
Message A2P contenant du contenu enrichi ou un message texte de plus de 160 caractères. | Toujours traité comme un événement de facturation individuel, que l'utilisateur réponde ou non. | Elle est traitée comme un événement de facturation individuel, sauf si l'utilisateur répond dans les 24 heures. Dans ce cas, le message fait partie d'un a2p_conversation.
|
a2p_conversation (initié par l'entreprise)
|
Déclenchée lorsqu'un utilisateur répond à un message A2P dans les 24 heures suivant sa réception, en dehors d'une conversation existante. | N/A. 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 précède immédiatement le message P2A est utilisé pour lancer la conversation. Ce message A2P et tous les messages envoyés dans les 24 heures suivantes font partie de la a2p_conversation.
|
p2a_conversation (initié par l'utilisateur)
|
Déclenchée lorsqu'un agent répond à un message P2A dans les 24 heures suivant sa réception, en dehors d'une conversation existante. | N/A. Les agents non conversationnels ne génèrent jamais ce type d'événement. | Si un message A2P est remis dans les 24 heures suivant plusieurs messages P2A, seul le message P2A qui précède immédiatement le message A2P est utilisé pour lancer la conversation. Ce message P2A et tous les messages envoyés dans les 24 heures suivantes font partie de la p2a_conversation.
|
p2a_message
|
Message P2A de n'importe quel type. | Toujours considéré comme un événement de facturation individuel, que l'agent réponde ou non. | Il est considéré comme un événement de facturation individuel, sauf si l'agent répond dans les 24 heures. |
Événements de facturation et catégories de facturation
Les événements de facturation basic_message et single_message ne doivent pas être confondus avec les catégories de facturation "Message de base" et "Message unique".
Tout agent (quelle que soit sa catégorie de facturation) peut générer des événements de facturation
basic_messageetsingle_message.Les catégories de facturation "Message de base" et "Message unique" permettent de classer les agents non conversationnels. Les agents de ces catégories de facturation ne génèrent pas d'événements de facturation conversationnels (
a2p_conversationsoup2a_conversations). Ils génèrent plutôt des événements de facturationbasic_message,single_messageetp2a_messageindividuels.
Génération de rapports sur la facturation
Seuls les agents avec un trafic non testeur génèrent des événements de facturation. L'activité des numéros de téléphone de test n'apparaît pas dans les rapports sur les événements de facturation.
Ces rapports partent du principe que les événements sont facturés lorsque les messages sont remis, et non lorsqu'ils sont envoyés. Un message non distribué ou annulé avant la distribution ne déclenche pas d'événement de facturation.
Format du rapport sur la facturation
Les rapports sur les événements 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 est un enregistrement représentant un seul événement de facturation. Les champs d'un enregistrement sont séparés par des tabulations. Par exemple, deux conversations A2P avec le même agent généreraient deux événements de facturation et deux enregistrements dans le rapport sur les événements de facturation.
Chaque enregistrement du rapport contient les informations suivantes pour chaque événement de facturation :
| Champ | Format | Description | Exemple |
|---|---|---|---|
billing_event_id
|
chaîne | Identifiant UUID. Nombre aléatoire généré pour chaque nouvel événement au moment de sa création. | 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 dans lequel l'agent a été créé. | name@aggregator.com
|
billing_party
|
chaîne | Partie qui facture les événements.
|
carrier
|
max_duration_single_message
|
Total | Durée maximale (en heures) autorisée pour qu'un utilisateur réponde à un message d'agent avant la fermeture de la fenêtre de lancement de la conversation et la classification du message comme événement single_message.
|
24
|
max_duration_a2p_conversation
|
Total | Durée maximale d'une conversation A2P, en heures. Mesurée à partir de la première réponse de l'utilisateur au message initial de l'agent. | 24
|
max_duration_p2a_conversation
|
Total | 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 de début de l'événement en UTC au format ISO 8601, arrondies à l'heure la plus proche.
Messages A2P
Messages P2A
|
2019-07-25T08:00:00Z
|
duration
|
Total | Durée de l'événement, arrondie à la minute la plus proche.
Lorsque le type d'événement est |
45
|
mt_messages
|
Total | Nombre de messages mobile-terminated (A2P) dans l'événement. | 11
|
mo_messages
|
Total | Nombre de messages envoyés depuis un mobile (P2A) dans l'événement. | 9
|
size_kilobytes
|
Total | Taille de tous les fichiers joints aux messages de l'événement, arrondie au kilobyte le plus proche (1 ko = 1 024 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 dans lequel l'agent a été créé. | XYZ Mobile
|
Exemple de rapport sur les événements de facturation
Vous pouvez télécharger un exemple de fichier de rapport de facturation.
Taille de fichier standard
La taille d'un rapport quotidien d'un partenaire RCS for Business actif dépend du volume d'activité qu'il a généré sur le réseau de l'opérateur. Par exemple, si le rapport contient 53 000 enregistrements, la taille du fichier sera d'environ 8 Mo.
Journaux d'activité
Les journaux d'activité fournissent des données brutes sur l'activité sur la plate-forme RCS pour les entreprises. Vous pouvez utiliser ces journaux pour auditer les événements de facturation et créer des événements personnalisés.
Remarque : Seul le trafic provenant de numéros de téléphone autres que ceux des testeurs est inclus dans les journaux d'activité.
Les journaux d'activité contiennent des informations permettant d'identifier personnellement les utilisateurs (PII, Personally Identifiable Information), comme des informations détaillées sur les transactions et les MSISDN des abonnés. Ils ne sont donc disponibles que lorsqu'un opérateur utilise le RCS selon ses propres conditions d'utilisation. Si vous avez du trafic RCS pour les entreprises sur vos réseaux et que vous 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é.
Format du journal d'activité
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 | Identifiant unique de l'activité. | b422e1d3-ac99-442a-853d-a875d5e61762
|
billing_event_id
|
chaîne | Identifiant unique de l'événement de facturation associé. Ce champ peut être vide si l'activité n'est pas associée à un événement de facturation, comme un text_message sans delivery_receipt_event correspondant.
|
91yeb201-7c3b-412b-98d2-b0a0f7abe536
|
agent_id
|
chaîne | Identifiant unique de l'agent. | welcome-bot@rbm.goog
|
user_id
|
chaîne | MSISDN de l'utilisateur. | 918369110173
|
direction
|
chaîne | Direction dans laquelle le message est envoyé :
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | Date et heure auxquelles l'événement a été envoyé à la plate-forme RCS pour les entreprises au format UTC. Consultez Codes temporels. | 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
|
Codes temporels
Les codes temporels des journaux d'activité indiquent le moment où un événement a été envoyé à la plate-forme RCS pour les entreprises. Pour les événements qui fournissent du contenu à un utilisateur, l'événement ne sera enregistré dans le journal d'activité qu'une fois le message remis.
Par exemple, si un message RCS pour les entreprises est envoyé à un utilisateur le mercredi à 13h00 et que le destinataire est hors connexion jusqu'au dimanche à 9h00, l'événement apparaîtra dans le journal d'activité généré pour le dimanche, mais l'heure sera celle du mercredi à 13h00.