Cette page décrit les fichiers de données créés par RCS for Business pour aider les opérateurs à gérer la facturation et l'audit.
| Fichier | Description | Qui a accès |
|---|---|---|
| Rapport sur la facturation | Rapport agrégé des événements facturables entre les agents lancés et les utilisateurs. | Tous les opérateurs qui utilisent activement RCS for Business. |
| Journal d'activité | Journal de données brutes de l'activité RCS for Business, y compris les événements facturables. | Opérateurs qui utilisent activement RCS for Business et qui exploitent le service Google RCS en vertu de leurs propres conditions d'utilisation. |
RCS for Business utilise deux modèles de facturation : le modèle de facturation standard pour le trafic hors États-Unis et le modèle de facturation aux États-Unis pour le trafic aux États-Unis. Les informations propres au modèle standard ou au modèle américain (par exemple, les différentes classifications d'événements facturables ou les différents champs de rapport) sont explicitement indiquées.
- Pour en savoir plus sur le modèle de facturation standard et obtenir un récapitulatif des différences entre les modèles de facturation, consultez les questions fréquentes sur la facturation.
- Pour en savoir plus sur les classifications de facturation aux États-Unis, consultez le guide Modèle de facturation aux États-Unis.
Génération de fichiers
Chaque fichier de données représente une journée d'utilisation de RCS for Business 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 temps nécessaire 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 la 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 la date de génération du fichier (un ou deux jours avant). Par exemple, si un rapport sur la 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.
Le délai est dû au 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 facturable. 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 la facturation
Les rapports sur la facturation sont des enregistrements des événements facturables, 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 la facturation sont disponibles pour tous les opérateurs qui utilisent activement RCS for Business.
Les rapports sur la 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 suivant.
| Catégorie de facturation | Type d'agent | Exemples de cas d'utilisation | Mode de facturation |
|---|---|---|---|
| Non conversationnel | Agents qui envoient principalement des messages unidirectionnels. |
|
Vous êtes 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 ce 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 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 facturables
Cinq types d'événements facturables sont enregistrés dans les rapports sur la facturation. Ces événements incluent les événements MT et MO, qui sont appelés événements A2P et P2A.
- A2P (Application-to-Person) est MT (Mobile Terminated) : message envoyé par l'entreprise.
- P2A (Person-to-Application) est MO (Mobile Originated) : message ou action initié par l'utilisateur.
Le tableau suivant décrit chaque événement facturable pour les agents non conversationnels et conversationnels.
| Événement | Description | Agents non conversationnels | Agents conversationnels |
|---|---|---|---|
basic_message
|
Message A2P qui ne contient que du texte (160 caractères maximum). 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 facturable individuel, que l'utilisateur réponde ou non. | Elle est traitée comme un événement facturable individuel, sauf si l'utilisateur répond sous 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 facturable individuel, que l'utilisateur réponde ou non. | Elle est traitée comme un événement facturable individuel, sauf si l'utilisateur répond sous 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, ainsi que 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 facturable individuel, que l'agent réponde ou non. | Il est considéré comme un événement facturable individuel, sauf si l'agent répond dans les 24 heures. |
Catégories de facturation et événements facturables
Il est essentiel de comprendre la différence entre les catégories de facturation et les événements facturables pour savoir comment votre agent est facturé.
- La catégorie de facturation est une classification fixe que vous choisissez lorsque vous créez votre agent. Il détermine la méthode 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 sur la facturation
Seuls les agents dont le trafic n'est pas celui d'un testeur génèrent des événements facturables. L'activité des numéros de téléphone de test n'apparaît pas dans les rapports sur la 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 facturable.
Format du rapport sur la facturation
Les rapports sur la 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 facturable. Les champs d'un enregistrement sont séparés par une tabulation. Par exemple, deux conversations A2P avec le même agent généreraient deux événements facturables distincts et deux enregistrements dans le rapport sur la facturation.
Chaque enregistrement du rapport contient les informations suivantes pour chaque événement facturable.
| 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 :
Modèle de facturation standard Modèle de facturation aux États-Unis |
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é à 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
|
segment_count
|
Total | Modèle de facturation aux États-Unis uniquement
Nombre de segments calculés pour les événements |
5
|
Exemple de rapport sur les événements de facturation
Vous pouvez télécharger des exemples de rapports :
- Rapport sur la facturation pour le modèle de facturation standard
- Rapport sur la facturation pour le modèle de facturation aux États-Unis
Taille de fichier type
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 for Business. 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é.
Étant donné que les journaux d'activité contiennent des informations permettant d'identifier personnellement les utilisateurs (par exemple, des informations détaillées sur les transactions et les MSISDN des abonnés), ils ne sont disponibles que lorsqu'un opérateur utilise le RCS selon ses propres conditions d'utilisation. Si vous avez du trafic RCS for Business 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 for Business 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é enregistrent le moment où un événement a été envoyé à la plate-forme RCS for Business. Pour les événements qui fournissent du contenu à un utilisateur, l'événement ne sera pas enregistré dans le journal d'activité tant que le message n'aura pas été 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.