Cette page décrit les fichiers de données créés par RCS for Business pour aider les opérateurs américains à gérer la facturation et l'audit conformément au cadre RBM américain. Pour en savoir plus sur le cadre RBM aux États-Unis, vous pouvez également consulter usrbm.org.
Le rapport sur la facturation est un rapport agrégé des événements facturables entre les agents lancés et les utilisateurs. "Facturable" signifie simplement qu'un événement peut être facturé. Les opérateurs déterminent si et comment les événements facturables sont facturés. Tous les opérateurs américains qui utilisent activement RCS for Business ont accès aux rapports sur la facturation.
Pour en savoir plus sur le modèle de classification de la facturation aux États-Unis, consultez les questions fréquentes sur la facturation aux États-Unis.
Génération de fichiers
Pour en savoir plus, consultez Génération de fichiers.
Stockage et accès aux fichiers
Pour en savoir plus, consultez Stockage et accès aux fichiers.
Disponibilité des fichiers
Pour en savoir plus, consultez Disponibilité des fichiers.
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 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 facturable.
- 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 session (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,
rich_message).
Catégories de facturation des agents aux États-Unis
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. |
|
Facturable pour chaque message envoyé à l'utilisateur. |
| Conversationnel | Agents conçus pour les échanges aller-retour avec les utilisateurs, quel que soit l'initiateur de la conversation. |
|
Facturation par session : si les critères de session sont remplis, tous les messages enrichis et multimédias enrichis envoyés pendant la fenêtre de session de 24 heures sont facturables à un taux fixe, quelle que soit leur longueur ou le nombre de segments. Facturation par message : si les critères de session ne sont pas remplis ou si un message est envoyé en dehors de la fenêtre de session de 24 heures, il est facturable individuellement à un tarif par message pour les messages enrichis ou multimédias enrichis, selon la grille tarifaire de l'opérateur concerné. |
Agents conversationnels et non conversationnels
Il existe deux catégories de facturation des agents : conversationnelle et non conversationnelle.
Les agents non conversationnels sont facturés pour chaque message qu'ils envoient à l'utilisateur.
- Cette catégorie convient aux agents qui n'attendent pas de réponses fréquentes.
Les agents conversationnels sont facturés à un tarif fixe par session, à condition qu'une session soit déclenchée. La facturation inclut tous les messages échangés sur une période de 24 heures, y compris ceux qui ont déclenché la session. Les agents conversationnels peuvent toujours entraîner des frais pour les messages qui ne font pas partie d'une session de 24 heures.
- Cette catégorie est idéale pour les agents qui engagent des conversations multitours avec les utilisateurs.
Logique de facturation des sessions
Dans le modèle de facturation aux États-Unis, une session est déclenchée par une séquence de quatre messages enrichis ou multimédias (dont au moins deux messages MO et au moins un message MT) échangés dans un délai de 24 heures à compter du premier message de la séquence de déclenchement. Une fois ce seuil atteint, tous les messages envoyés au cours de cette période de 24 heures sont facturables en tant que session unique. Tous les messages qui ne déclenchent pas de session ou qui ne sont pas inclus dans une session sont facturables au tarif standard par message pour les messages enrichis ou multimédias, conformément à la grille tarifaire de chaque opérateur.
Le schéma suivant montre un exemple de session de facturation A2P pour les agents conversationnels.
- MT (Mobile Terminated) : message envoyé par l'entreprise.
- MO (Mobile Originated) désigne un message ou une action initiés par l'utilisateur.
Événements facturables
Les flux de messages sont classés en fonction de leur origine et de leur direction. Pour décrire le sens du trafic de messages, les opérateurs américains utilisent généralement la terminologie MT/MO. Ces termes correspondent à la terminologie A2P/P2A utilisée dans la documentation RCS for Business. Voici un bref récapitulatif de la façon dont ces termes s'alignent :
- 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és par l'utilisateur.
| Événement | Description | Agents non conversationnels | Agents conversationnels |
|---|---|---|---|
a2p_rich_message |
Message envoyé par un agent et contenant uniquement du texte, des réponses suggérées ou des actions suggérées spécifiques (composer un numéro, ouvrir une URL dans le navigateur). | Toujours traité comme un événement facturable individuel. Facturation par message en fonction des segments (un segment équivaut à 160 octets UTF-8). |
Il est traité comme un événement facturable individuel, sauf s'il fait partie d'une session. |
p2a_rich_message |
Message envoyé par un utilisateur et contenant uniquement du texte libre ou du texte provenant d'une réponse suggérée. | Toujours traité comme un événement facturable individuel. Facturation par message en fonction des segments. |
Il est traité comme un événement facturable individuel, sauf s'il fait partie d'une session. |
a2p_rich_media_message |
Message envoyé par un agent et contenant des éléments multimédias (image, vidéo, audio), des cartes enrichies, des carrousels ou des actions complexes telles que "Afficher le lieu". | Toujours traité comme un événement facturable individuel. Facturable comme un événement unique à tarif fixe, quelle que soit la taille ou le contenu. |
Il est traité comme un événement facturable individuel, sauf s'il fait partie d'une session. |
p2a_rich_media_message |
Message envoyé par un utilisateur contenant un fichier multimédia importé (image, vidéo, audio). | Toujours traité comme un événement facturable individuel. Facturable en tant qu'événement unique à tarif fixe. |
Il est traité comme un événement facturable individuel, sauf s'il fait partie d'une session. |
p2a_suggested_action |
Un utilisateur appuie sur une action suggérée (par exemple, "Afficher le lieu") qui n'est pas une réponse suggérée. | Toujours traité comme un événement facturable individuel. Génère un événement facturable par clic. |
Il est traité comme un événement facturable individuel et génère un événement facturable par clic, sauf s'il fait partie d'une session. |
a2p_session |
Une fenêtre d'interaction de 24 heures qui commence lorsqu'un déclencheur de session est initié et que le premier message est MT. Pour en savoir plus, consultez Qu'est-ce qu'une session et comment fonctionne-t-elle ?. | N/A. Les sessions ne s'appliquent pas aux agents non conversationnels. | Une fois déclenchée, tous les messages de la période de 24 heures sont couverts par un seul forfait de session. Tout événement facturable au cours de la session de 24 heures sera associé à l'ID d'événement facturable de la session. |
p2a_session |
Une fenêtre d'interaction de 24 heures qui commence lorsqu'un déclencheur de session est initié et que le premier message est MO. Pour en savoir plus, consultez Qu'est-ce qu'une session et comment fonctionne-t-elle ?. | N/A. Les sessions ne s'appliquent pas aux agents non conversationnels. | Une fois déclenchée, tous les messages de la période de 24 heures sont couverts par un seul forfait de session. Tout événement facturable au cours de la session de 24 heures sera associé à l'ID d'événement facturable de la session. |
Génération de rapports sur la facturation
Seuls les agents dont le trafic n'est pas de test 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 facturables lorsque les messages A2P 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 sessions A2P/P2A sont représentées par plusieurs lignes, une pour chaque message échangé. Chaque ligne associée à une session (partageant le même billing_event_id) indiquera le nombre total de messages MT et MO pour l'ensemble de la période de 24 heures de la session dans les colonnes mt_messages et mo_messages.
Les fichiers sont encodés au format UTF-8 sans indicateur d'ordre des octets et utilisent des sauts de ligne pour les fins de ligne. La première ligne de chaque fichier est une ligne d'en-tête contenant les noms des champs.
Chaque enregistrement du rapport contient les informations suivantes pour chaque événement facturable.
| Champ | Format | Description | Exemple |
|---|---|---|---|
billing_event_id |
chaîne | ID généré qui distingue l'événement facturable. Tous les messages d'une même session auront le même |
63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type |
chaîne | Type d'événement :a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action |
p2a_rich_message |
agent_id |
chaîne | Identifiant unique de l'agent ayant participé à l'événement. | acme_342h23_agent@rbm.goog |
agent_owner |
chaîne | Adresse e-mail du propriétaire actuel du compte partenaire dans lequel l'agent a été créé. | marketing@xyzaggregator.com |
billing_party |
chaîne | Partie qui facture les événements. | opérateur |
max_duration_single_message |
nombre | 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. Non applicable au modèle américain pour les messages enrichis individuels. |
24 |
max_duration_a2p_conversation |
nombre | Pour le pilote des sessions, cela reflète la période de session de 24 heures mesurée à partir du premier message de la séquence de déclenchement. La durée est mesurée en heures. | 24 |
max_duration_p2a_conversation |
nombre | Pour le pilote des sessions, cela reflète la période de session de 24 heures mesurée à partir du premier message de la séquence de déclenchement. | 24 |
start_time |
YYYY-mm-ddTHH:00:00Z | Date et heure de début de l'événement en UTC (ISO 8601). Pour les sessions, il s'agit du code temporel du premier message de la séquence de déclenchement. A2P a2p_rich_message et a2p_rich_media_message, il s'agit de l'heure à laquelle le message est remis à l'utilisateur.a2p_session, il s'agit du moment où le premier message de la conversation est remis à l'utilisateur.P2A p2a_rich_message et p2a_rich_media_message, il s'agit de l'heure à laquelle l'utilisateur a envoyé le message.p2a_session, il s'agit du moment où l'utilisateur envoie le premier message de la conversation. |
2025-05-20T08:00:00Z |
duration |
nombre | La durée ne concerne que les sessions et est mesurée en minutes. Lorsque l'événement n'est pas un événement de session, la valeur est définie sur 0. | 45 |
mt_messages |
nombre | Nombre de messages mobile-terminated (A2P) dans l'événement. Pour les sessions, chaque ligne partageant le même billing_event_id indique le nombre total de messages MT dans l'ensemble de la session. |
5 |
mo_messages |
nombre | Nombre de messages envoyés depuis un mobile (P2A) dans l'événement. Pour les sessions, chaque ligne partageant le même billing_event_id indique le nombre total de messages MO dans l'ensemble de la session. |
3 |
size_kilobytes |
nombre | Taille de tous les fichiers joints aux messages de l'événement, arrondie au kilobyte le plus proche (1 Ko équivaut à 1 024 octets). | 912 |
agent_name |
chaîne | Nom de l'agent ayant participé à l'événement. | ACME Brand |
owner_name |
chaîne | Nom du propriétaire actuel du compte partenaire dans lequel l'agent a été créé. | XYZ Aggregator |
segment_count |
nombre | Nombre de segments calculé pour les événements a2p_rich_message events et p2a_rich_message (1 segment équivaut à 160 octets UTF-8). Lorsque l'événement n'est pas l'un de ceux mentionnés, la valeur est 0. |
5 |
session_type |
chaîne | Type de session :a2p_sessionp2a_session |
a2p_session |
Exemple de rapport sur la facturation
Vous pouvez télécharger un exemple de rapport :
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.