Auf dieser Seite werden die Datendateien beschrieben, die von RCS for Business erstellt werden, um US-Mobilfunkanbieter bei der Abrechnung und Prüfung im Rahmen des US RBM Framework zu unterstützen. Weitere Informationen zum US RBM Framework finden Sie unter usrbm.org.
Der Abrechnungsbericht ist ein aggregierter Bericht zu abrechenbaren Ereignissen zwischen gestarteten Agents und Nutzern. „Abrechenbar“ bedeutet einfach, dass für ein Ereignis eine Gebühr anfällt. Mobilfunkanbieter legen fest, ob und wie abrechenbare Ereignisse in Rechnung gestellt werden. Alle US-Mobilfunkanbieter, die RCS for Business aktiv nutzen, haben Zugriff auf Abrechnungsberichte.
Weitere Informationen zum US-Modell für Abrechnungsklassifizierungen finden Sie in den FAQs zur US-Abrechnung.
Dateierstellung
Weitere Informationen finden Sie unter Dateierstellung.
Dateispeicherung und -zugriff
Weitere Informationen finden Sie unter Dateispeicherung und -zugriff.
Dateiverfügbarkeit
Weitere Informationen finden Sie unter Dateiverfügbarkeit.
Abrechnungsberichte
Abrechnungsberichte sind Aufzeichnungen von abrechenbaren Ereignissen, die auf der Abrechnungskategorie des Agents und dem Typ der von ihm gesendeten Nachrichten basieren. Abrechnungsberichte sind für alle Mobilfunkanbieter verfügbar, die RCS for Business aktiv nutzen.
Abrechnungsberichte enthalten vertrauliche Informationen, aber keine personenbezogenen Daten von Nutzern (personenidentifizierbare Informationen), wie MSISDN, gehashte MSISDN oder eine eindeutige Nutzer-ID.
Abrechnungskategorien im Vergleich zu abrechenbaren Ereignissen
Die Unterscheidung zwischen Abrechnungskategorien für Agents und abrechenbaren Ereignissen ist entscheidend, um zu verstehen, wie Ihr Agent abgerechnet wird.
- Die Abrechnungskategorie ist eine feste Klassifizierung, die Sie beim Erstellen Ihres Agents auswählen. Sie bestimmt die Methode , mit der Ihr Agent abgerechnet wird: pro Nachricht (nicht konversationelle Agents) oder pro Sitzung (konversationelle Agents).
- Abrechenbare Ereignisse sind Interaktionen zwischen einem RCS for Business-Agent und einem Nutzer, die zu Abrechnungszwecken erfasst werden (z. B.
rich_message).
Abrechnungskategorien für US-Agents
Beim Erstellen eines Agents legt der Inhaber die Abrechnungskategorie basierend darauf fest, wie der Agent mit Nutzern interagiert. Die Abrechnungskategorie beschränkt nicht die Anzahl oder den Typ der Nachrichten, die ein Agent senden kann. Sie bestimmt jedoch, wie der Agent für Nachrichten abgerechnet wird. Die beiden Hauptabrechnungskategorien werden in der folgenden Tabelle beschrieben.
| Abrechnungskategorie | Agent-Typ | Beispielanwendungsfälle | Abrechnungsmethode |
|---|---|---|---|
| Nicht konversationell | Agents, die hauptsächlich unidirektionale Nachrichten senden. |
|
Abrechenbar für jede Nachricht, die an den Nutzer gesendet wird. |
| Konversationell | Agents, die für den bidirektionalen Austausch mit Nutzern entwickelt wurden, unabhängig davon, wer die Unterhaltung beginnt. |
|
Abrechenbar pro Sitzung: Wenn die Sitzungskriterien erfüllt sind, werden alle Rich- und Rich-Media-Nachrichten innerhalb des 24-Stunden-Sitzungsfensters zu einem Pauschaltarif abgerechnet, unabhängig von Länge oder Segmenten. Abrechenbar pro Nachricht: Wenn die Sitzungskriterien nicht erfüllt sind oder eine Nachricht außerhalb des 24-Stunden-Sitzungsfensters liegt, wird die Nachricht einzeln zu einem Preis pro Nachricht für Rich- oder Rich-Media-Nachrichten gemäß der Preisliste des jeweiligen Mobilfunkanbieters abgerechnet. |
Konversationelle versus nicht konversationelle Agents
Es gibt zwei Abrechnungskategorien für Agents: konversationell und nicht konversationell.
Nicht konversationelle Agents werden für jede Nachricht abgerechnet, die sie an den Nutzer senden.
- Diese Kategorie eignet sich am besten für Agents, bei denen keine häufigen Antworten erwartet werden.
Konversationelle Agents werden zu einem Pauschaltarif für Sitzungen abgerechnet, sofern eine Sitzung ausgelöst wird. Dieser Tarif umfasst alle Nachrichten, die innerhalb von 24 Stunden ausgetauscht werden, einschließlich der Nachrichten, die die Sitzung ausgelöst haben. Für konversationelle Agents können weiterhin Gebühren für Nachrichten anfallen, die nicht Teil einer 24-Stunden-Sitzung sind.
- Diese Kategorie eignet sich am besten für Agents, die Mehrfachdialoge mit Nutzern führen.
Logik für die Abrechnung von Sitzungen
Gemäß dem US-Abrechnungsmodell wird eine Sitzung durch eine Folge von 4 Rich- oder Rich-Media-Nachrichten (darunter mindestens 2 MO- und mindestens 1 MT-Nachricht) ausgelöst, die innerhalb von 24 Stunden ab der ersten Nachricht in der Auslösersequenz ausgetauscht werden. Sobald dieser Schwellenwert erreicht ist, werden alle Nachrichten innerhalb dieses 24-Stunden-Fensters als eine einzelne Sitzung abgerechnet. Alle Nachrichten, die außerhalb einer Sitzung liegen oder keine Sitzung auslösen, werden zum Standardpreis pro Nachricht für Rich- oder Rich-Media-Nachrichten gemäß der Preisliste des jeweiligen Mobilfunkanbieters abgerechnet.
Das folgende Diagramm zeigt ein Beispiel für eine A2P-Abrechnungssitzung für konversationelle Agents.
- MT (Mobile Terminated) ist eine Nachricht, die vom Unternehmen gesendet wird.
- MO (Mobile Originated) ist eine Nachricht oder Aktion, die vom Nutzer initiiert wird.
Abrechenbare Ereignisse
Messaging-Abläufe werden nach Ursprung und Richtung kategorisiert. Um die Richtung des Messaging-Traffics zu beschreiben, verwenden US-Mobilfunkanbieter in der Regel die Terminologie MT/MO. Diese Begriffe entsprechen der Terminologie A2P/P2A , die in der gesamten RCS for Business-Dokumentation verwendet wird. Hier eine kurze Übersicht, wie diese Begriffe zueinander passen:
- A2P (Application-to-Person) ist MT (Mobile Terminated): Eine Nachricht, die von Unternehmen gesendet wird.
- P2A (Person-to-Application) ist MO (Mobile Originated): Eine Nachricht oder Aktion, die vom Nutzer initiiert wird.
| Ereignis | Beschreibung | Nicht konversationelle Agents | Konversationelle Agents |
|---|---|---|---|
a2p_rich_message |
Eine vom Agent gesendete Nachricht, die nur Text, vorgeschlagene Antworten oder bestimmte vorgeschlagene Aktionen enthält (z. B. eine Nummer wählen oder eine URL im Browser öffnen). | Wird immer als einzelnes abrechenbares Ereignis behandelt. Abrechenbar pro Nachricht basierend auf Segmenten (1 Segment entspricht 160 UTF-8-Byte). |
Wird als einzelnes abrechenbares Ereignis behandelt, es sei denn, es wird Teil einer Sitzung. |
p2a_rich_message |
Eine vom Nutzer gesendete Nachricht, die nur Freitext oder Text aus einer vorgeschlagenen Antwort enthält. | Wird immer als einzelnes abrechenbares Ereignis behandelt. Abrechenbar pro Nachricht basierend auf Segmenten. |
Wird als einzelnes abrechenbares Ereignis behandelt, es sei denn, es wird Teil einer Sitzung. |
a2p_rich_media_message |
Eine vom Agent gesendete Nachricht, die Medien (Bild, Video, Audio), Rich Cards, Karussells oder komplexe Aktionen wie „Standort ansehen“ enthält. | Wird immer als einzelnes abrechenbares Ereignis behandelt. Wird als einzelnes Ereignis mit Pauschaltarif abgerechnet, unabhängig von Größe oder Inhalt. |
Wird als einzelnes abrechenbares Ereignis behandelt, es sei denn, es wird Teil einer Sitzung. |
p2a_rich_media_message |
Eine vom Nutzer gesendete Nachricht, die eine hochgeladene Mediendatei (Bild, Video, Audio) enthält. | Wird immer als einzelnes abrechenbares Ereignis behandelt. Wird als einzelnes Ereignis mit Pauschaltarif abgerechnet. |
Wird als einzelnes abrechenbares Ereignis behandelt, es sei denn, es wird Teil einer Sitzung. |
p2a_suggested_action |
Ein Nutzer tippt auf eine vorgeschlagene Aktion (z.B. „Standort ansehen“), die keine vorgeschlagene Antwort ist. | Wird immer als einzelnes abrechenbares Ereignis behandelt. Generiert ein abrechenbares Ereignis pro Klick. |
Wird als einzelnes abrechenbares Ereignis behandelt und generiert ein abrechenbares Ereignis pro Klick, es sei denn, es wird Teil einer Sitzung. |
a2p_session |
Ein 24-Stunden-Interaktionsfenster, das beginnt, wenn ein Sitzungsauslöser initiiert wird und die erste Nachricht MT ist. Weitere Informationen finden Sie unter Was ist eine Sitzung und wie funktioniert sie. | Nicht zutreffend. Sitzungen gelten nicht für nicht konversationelle Agents. | Nach dem Auslösen werden alle Nachrichten im 24-Stunden-Fenster mit einer einzigen Sitzungsgebühr abgedeckt. Jedes abrechenbare Ereignis in der 24-Stunden-Sitzung wird der abrechenbaren Ereignis-ID der Sitzung zugewiesen. |
p2a_session |
Ein 24-Stunden-Interaktionsfenster, das beginnt, wenn ein Sitzungsauslöser initiiert wird und die erste Nachricht MO ist. Weitere Informationen finden Sie unter Was ist eine Sitzung und wie funktioniert sie. | Nicht zutreffend. Sitzungen gelten nicht für nicht konversationelle Agents. | Nach dem Auslösen werden alle Nachrichten im 24-Stunden-Fenster mit einer einzigen Sitzungsgebühr abgedeckt. Jedes abrechenbare Ereignis in der 24-Stunden-Sitzung wird der abrechenbaren Ereignis-ID der Sitzung zugewiesen. |
Abrechnungsbericht erstellen
Nur Agents mit Traffic von Nicht-Testern generieren abrechenbare Ereignisse. Aktivitäten von Testtelefonnummern werden nicht in Abrechnungsberichten angezeigt.
In diesen Berichten wird davon ausgegangen, dass Ereignisse abrechenbar sind, wenn A2P-Nachrichten zugestellt werden, nicht wenn Nachrichten gesendet werden. Eine nicht zugestellte Nachricht oder eine Nachricht, die vor der Zustellung storniert wurde, löst kein abrechenbares Ereignis aus.
Format des Abrechnungsberichts
Abrechnungsberichte verwenden das Dateinamenformat rbm_billable_events_YYYY-MM-DD.csv.
Das Datum im Dateinamen ist das Datum der Dateierstellung.
Jede Zeile im Bericht ist ein Datensatz, der ein einzelnes abrechenbares Ereignis darstellt.
A2P/P2A-Sitzungen werden durch mehrere Zeilen dargestellt, eine für jede ausgetauschte Nachricht. In jeder Zeile, die einer Sitzung zugeordnet ist (mit derselben billing_event_id), wird in den Spalten mt_messages und mo_messages die Gesamtzahl der MT- und MO-Nachrichten für das gesamte 24-Stunden-Sitzungsfenster angegeben.
Jeder Datensatz im Bericht enthält die folgenden Informationen für jedes abrechenbare Ereignis.
| Feld | Format | Beschreibung | Beispiel |
|---|---|---|---|
billing_event_id |
String | Generierte ID, die das abrechenbare Ereignis unterscheidet. Alle Nachrichten, die Teil einer Sitzung sind, haben dieselbe |
63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type |
String | Ereignistyp:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action |
p2a_rich_message |
agent_id |
String | Eindeutige Kennung für den Agent, der an dem Ereignis beteiligt war. | acme_342h23_agent@rbm.goog |
agent_owner |
String | E-Mail-Adresse des aktuellen Inhabers des Partnerkontos, in dem der Agent erstellt wurde. | marketing@xyzaggregator.com |
billing_party |
String | Partei, die Ereignisse in Rechnung stellt. | Mobilfunkanbieter |
max_duration_single_message |
Zahl | Maximale Zeit (in Stunden), die ein Nutzer hat, um auf eine Agent-Nachricht zu antworten, bevor das Fenster für die Unterhaltungsschließung geschlossen wird und die Nachricht als single_message-Ereignis klassifiziert wird. Gilt nicht für das US-Modell für einzelne Rich-Nachrichten. |
24 |
max_duration_a2p_conversation |
Zahl | Für den Sitzungstest spiegelt dies das 24-Stunden-Sitzungsfenster wider, das ab der ersten Nachricht in der Auslösersequenz gemessen wird. Die Dauer wird in Stunden gemessen. | 24 |
max_duration_p2a_conversation |
Zahl | Für den Sitzungstest spiegelt dies das 24-Stunden-Sitzungsfenster wider, das ab der ersten Nachricht in der Auslösersequenz gemessen wird. | 24 |
start_time |
YYYY-mm-ddTHH:00:00Z | Datum/Uhrzeit (UTC), zu der das Ereignis begonnen hat (ISO 8601). Bei Sitzungen ist dies der Zeitstempel der ersten Nachricht in der Auslösersequenz. A2P a2p_rich_message und a2p_rich_media_message, ist dies die Zeit, zu der die Nachricht an den Nutzer gesendet wird.a2p_session ist dies die Zeit, zu der die erste Nachricht in der Unterhaltung an den Nutzer gesendet wird.P2A p2a_rich_message und p2a_rich_media_message, ist dies die Zeit, zu der die Nachricht vom Nutzer gesendet wird.p2a_session ist dies die Zeit, zu der die erste Nachricht in der Unterhaltung vom Nutzer gesendet wird. |
2025-05-20T08:00:00Z |
duration |
Zahl | Die Dauer bezieht sich nur auf Sitzungen und wird in Minuten gemessen. Wenn das Ereignis keine Sitzung ist, ist der Wert 0. | 45 |
mt_messages |
Zahl | Anzahl der Mobile-Terminated-Nachrichten (A2P) im Ereignis. Bei Sitzungen zeigt jede Zeile mit derselben billing_event_id die Gesamtzahl der MT-Nachrichten in der gesamten Sitzung. |
5 |
mo_messages |
Zahl | Anzahl der Mobile-Originated-Nachrichten (P2A) im Ereignis. Bei Sitzungen zeigt jede Zeile mit derselben billing_event_id die Gesamtzahl der MO-Nachrichten in der gesamten Sitzung. |
3 |
size_kilobytes |
Zahl | Größe aller Dateien, die an Nachrichten im Ereignis angehängt sind, auf das nächste Kilobyte gerundet (1 KB entspricht 1024 Byte). | 912 |
agent_name |
String | Name des Agents, der an dem Ereignis beteiligt war. | ACME Brand |
owner_name |
String | Name des aktuellen Inhabers des Partnerkontos, in dem der Agent erstellt wurde. | XYZ Aggregator |
segment_count |
Zahl | Die berechnete Anzahl der Segmente für a2p_rich_message events und p2a_rich_message Ereignisse (1 Segment entspricht 160 UTF-8-Byte). Wenn das Ereignis nicht eines der genannten ist, ist der Wert 0. |
5 |
session_type |
String | Sitzungstyp:a2p_sessionp2a_session |
a2p_session |
Beispiel für einen Abrechnungsbericht
Ein Beispielbericht kann heruntergeladen werden:
Typische Dateigröße
Die Größe eines täglichen Berichts von einem aktiven RCS for Business-Partner hängt davon ab, wie viel Aktivität er im Netzwerk des Mobilfunkanbieters generiert hat.