US-Abrechnungsberichte

Auf dieser Seite werden die Dateien beschrieben, die von RCS for Business erstellt werden, um US-Mobilfunkanbieter bei der Abrechnung und Prüfung gemäß dem 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. „Abrechnungsfähig“ bedeutet einfach, dass für ein Ereignis Kosten anfallen können. Die Abrechnung von abrechenbaren Ereignissen liegt im Ermessen der Mobilfunkanbieter. Alle US-Mobilfunkanbieter, die RCS for Business aktiv nutzen, haben Zugriff auf Abrechnungsberichte.

Hinweis :Weitere Informationen zum Standardabrechnungsmodell und eine Zusammenfassung der Unterschiede zwischen den Abrechnungsmodellen finden Sie in den FAQs zur Abrechnung.

Weitere Informationen zum US-Abrechnungsmodell finden Sie in den FAQs zur US-Abrechnung.

Dateigenerierung

Weitere Informationen finden Sie unter Dateigenerierung.

Dateispeicher und ‑zugriff

Weitere Informationen finden Sie unter Dateispeicher und ‑zugriff.

Dateiverfügbarkeit

Weitere Informationen finden Sie unter Dateiverfügbarkeit.

Abrechnungsberichte

Abrechnungsberichte sind Aufzeichnungen von abrechenbaren Ereignissen, die auf Grundlage der Abrechnungskategorie des Agenten und des Typs der von ihm gesendeten Nachrichten berechnet werden. Abrechnungsberichte sind für alle Mobilfunkanbieter verfügbar, die RCS for Business aktiv nutzen.

Abrechnungsberichte enthalten vertrauliche Informationen, aber keine personenidentifizierbaren Informationen (PII) von Nutzern wie MSISDN, gehashte MSISDN oder eine eindeutige Nutzer-ID.

Hinweis :Partner erhalten außerdem aggregierte tägliche Zusammenfassungsberichte, die ihnen helfen, den Traffic zu verwalten. Sie enthalten wertvolle Analysen und die erforderliche Transparenz in Bezug auf ihre Traffic-Daten. Weitere Informationen finden Sie unter Abrechnungsberichte für Partner.

Abrechnungskategorien im Vergleich zu abrechenbaren Ereignissen

Die Unterscheidung zwischen Abrechnungskategorien 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 KI-Agent abgerechnet wird: pro Nachricht (nicht konversationelle KI-Agenten) oder pro Sitzung (konversationelle KI-Agenten).
• Abrechnungsfähige 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-Agenten

Beim Erstellen eines Agents legt der Eigentümer die Abrechnungskategorie fest, je nachdem, wie der Agent mit Nutzern interagiert. Die Abrechnungskategorie schränkt die Anzahl oder Art der Nachrichten, die ein Agent senden kann, nicht ein. Es 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
Keine Unterhaltung	Agents, die hauptsächlich unidirektionale Nachrichten senden.	OTPs Benachrichtigungen Werbeangebote	Abrechenbar für jede Nachricht, die an den Nutzer gesendet wird.
Dialogorientiert	Agents, die für den Austausch mit Nutzern entwickelt wurden, unabhängig davon, wer die Unterhaltung beginnt.	Das richtige Produkt finden Ticket buchen Problembehebung	Abrechnung pro Sitzung: Wenn die Sitzungskriterien erfüllt sind, werden alle Rich- und Rich Media-Nachrichten innerhalb des 24-Stunden-Sitzungszeitraums pauschal abgerechnet, unabhängig von Länge oder Segmenten. Abrechnung pro Nachricht: Wenn die Sitzungskriterien nicht erfüllt sind oder eine Nachricht außerhalb des 24-Stunden-Sitzungszeitraums liegt, wird die Nachricht gemäß der Preisliste des jeweiligen Mobilfunkanbieters einzeln zu einem Preis pro Nachricht für Rich- oder Rich Media-Nachrichten abgerechnet.

Konversationelle und nicht konversationelle Agents

Es gibt zwei Abrechnungskategorien für Agenten: 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 Kundenservicemitarbeiter, die nicht mit häufigen Antworten rechnen.

• Konversationelle Agents werden pauschal für Sitzungen abgerechnet, sofern eine Sitzung ausgelöst wird. Die Abrechnung umfasst alle Nachrichten, die innerhalb eines Zeitraums von 24 Stunden ausgetauscht werden, einschließlich der Nachrichten, die die Sitzung ausgelöst haben. Für Nachrichten, die nicht Teil einer 24-Stunden-Sitzung sind, können weiterhin Gebühren für Conversational Agents anfallen.

  • Diese Kategorie eignet sich am besten für Agents, die mit Nutzern Multi-Turn-Unterhaltungen führen.

Abrechnungslogik für Sitzungen

Im Rahmen des US-Abrechnungsmodells wird eine Sitzung durch eine Sequenz 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 Triggersequenz ausgetauscht werden. Sobald dieser Grenzwert erreicht ist, werden alle Nachrichten innerhalb dieses 24-Stunden-Zeitraums 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 Media oder Rich Media gemäß der Preisliste des jeweiligen Mobilfunkanbieters abgerechnet.

Das folgende Diagramm zeigt ein Beispiel für eine A2P-Abrechnungssitzung für Conversational 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 Herkunft und Richtung kategorisiert. US-Mobilfunkanbieter verwenden in der Regel die Terminologie MT/MO, um die Richtung des Messaging-Traffics zu beschreiben. Diese Begriffe entsprechen der A2P/P2A-Terminologie, die in der gesamten RCS for Business-Dokumentation verwendet wird. Hier eine kurze Übersicht:

• A2P (Application-to-Person) ist MT (Mobile Terminated): Eine Nachricht, die vom Unternehmen gesendet wird.
• P2A (Person-to-Application) ist MO (Mobile Originated): Eine vom Nutzer initiierte Nachricht oder Aktion.

Ereignis	Beschreibung	Nicht konversationelle Agents	Konversations-Agenten
a2p_rich_message	Eine vom Agent gesendete Nachricht, die nur Text, Antwortvorschläge oder bestimmte vorgeschlagene Aktionen (eine Nummer wählen, URL im Browser öffnen) enthält.	Wird immer als einzelnes abrechenbares Ereignis behandelt. Abrechenbar pro Nachricht basierend auf Segmenten (1 Segment entspricht 160 UTF‑8-Bytes).	Wird als einzelnes abrechenbares Ereignis behandelt, sofern es nicht Teil einer Sitzung wird.
p2a_rich_message	Eine vom Nutzer gesendete Nachricht, die nur Freitext oder Text aus einem Antwortvorschlag enthält.	Wird immer als einzelnes abrechenbares Ereignis behandelt. Die Abrechnung erfolgt pro Nachricht auf Grundlage von Segmenten.	Wird als einzelnes abrechenbares Ereignis behandelt, sofern es nicht Teil einer Sitzung wird.
a2p_rich_media_message	Eine vom Agenten gesendete Nachricht mit Medien (Bild, Video, Audio), interaktiven Chat-Nachrichten, Karussells oder komplexen Aktionen wie „Standort ansehen“.	Wird immer als einzelnes abrechenbares Ereignis behandelt. Die Abrechnung erfolgt als einmaliges Pauschalereignis, unabhängig von Größe oder Inhalt.	Wird als einzelnes abrechenbares Ereignis behandelt, sofern es nicht Teil einer Sitzung wird.
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 Pauschalereignis abgerechnet.	Wird als einzelnes abrechenbares Ereignis behandelt, sofern es nicht Teil einer Sitzung wird.
p2a_suggested_action	Ein Nutzer tippt auf eine vorgeschlagene Aktion (z.B. „Standort ansehen“), die kein Antwortvorschlag ist.	Wird immer als einzelnes abrechenbares Ereignis behandelt. Pro Klick wird ein abrechenbares Ereignis generiert.	Wird als einzelner abrechenbarer Vorgang behandelt und generiert einen abrechenbaren Vorgang pro Klick, sofern er nicht Teil einer Sitzung wird.
a2p_session	Ein 24-stündiges Interaktionsfenster, das beginnt, wenn ein Sitzungstrigger ausgelöst wird und die erste Nachricht vom Typ „MT“ ist. Weitere Informationen finden Sie unter Was ist eine Sitzung und wie funktioniert sie?.	– Sitzungen gelten nicht für nicht konversationelle Agenten.	Nach der Auslösung werden alle Nachrichten im 24-Stunden-Zeitraum durch eine einzelne Sitzungsgebühr abgedeckt. Jedes abrechenbare Ereignis in der 24-Stunden-Sitzung wird der ID des abrechenbaren Ereignisses der Sitzung zugewiesen.
p2a_session	Ein 24-stündiges Interaktionsfenster, das beginnt, wenn ein Sitzungstrigger ausgelöst wird und die erste Nachricht MO ist. Weitere Informationen finden Sie unter Was ist eine Sitzung und wie funktioniert sie?.	– Sitzungen gelten nicht für nicht konversationelle Agenten.	Nach der Auslösung werden alle Nachrichten im 24-Stunden-Zeitraum durch eine einzelne Sitzungsgebühr abgedeckt. Jedes abrechenbare Ereignis in der 24-Stunden-Sitzung wird der ID des abrechenbaren Ereignisses der Sitzung zugewiesen.

Abrechnungsberichte erstellen

Nur bei KI-Agenten mit Traffic, der nicht von Testern stammt, werden abrechenbare Ereignisse generiert. 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 sie gesendet werden. Eine nicht zugestellte Nachricht oder eine Nachricht, die vor der Zustellung abgebrochen wurde, löst kein abrechenbares Ereignis aus.

Format des Abrechnungsberichts

Für Abrechnungsberichte wird das Dateinamenformat rbm_billable_events_YYYY-MM-DD.csv verwendet. Das Datum im Dateinamen ist das Datum der Dateigenerierung.

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 demselben billing_event_id), wird in den Spalten mt_messages und mo_messages die Gesamtzahl der MT- und MO-Nachrichten für den gesamten 24-Stunden-Sitzungszeitraum angegeben.

Dateien sind UTF-8-codiert, haben keine Bytereihenfolge-Marke und verwenden Zeilenumbrüche für Zeilenenden. Die erste Zeile jeder Datei ist eine Kopfzeile mit den Feldnamen.

Jeder Eintrag 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 kennzeichnet. Alle Nachrichten, die Teil einer Sitzung sind, haben dieselbe billing_event_id.	63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e
type	String	Art des Ereignisses: a2p_rich_message a2p_rich_media_message p2a_rich_message p2a_rich_media_message p2a_suggested_action	p2a_rich_message
agent_id	String	Eindeutige Kennung für den Agenten, der an dem Ereignis teilgenommen hat.	[e-mail]
agent_owner	String	E‑Mail-Adresse des aktuellen Inhabers des Partnerkontos, in dem der Agent erstellt wurde.	[e-mail]
billing_party	String	Die Partei, die Veranstaltungen in Rechnung stellt.	Mobilfunkanbieter
max_duration_single_message	Zahl	Maximale Zeit (in Stunden), die ein Nutzer hat, um auf eine Agentennachricht zu antworten, bevor das Zeitfenster für die Unterhaltung geschlossen wird und die Nachricht als single_message-Ereignis klassifiziert wird. Nicht zutreffend für das US-Modell für einzelne Rich-Messages.	24
max_duration_a2p_conversation	Zahl	Im Rahmen des Pilotprojekts für Sitzungen entspricht dies dem 24-Stunden-Sitzungszeitraum, der ab der ersten Nachricht in der Triggersequenz gemessen wird. Die Dauer wird in Stunden gemessen.	24
max_duration_p2a_conversation	Zahl	Im Rahmen des Pilotprojekts für Sitzungen entspricht dies dem 24-Stunden-Sitzungszeitraum, der ab der ersten Nachricht in der Triggersequenz gemessen wird.	24
start_time	YYYY-mm-ddTHH:00:00Z	Das UTC-Datum/die UTC-Uhrzeit, zu der das Ereignis begonnen hat (ISO 8601). Bei Sitzungen ist das der Zeitstempel der ersten Nachricht in der Triggersequenz. A2P Bei Ereignissen, die nicht mit Sitzungen zusammenhängen, z. B. a2p_rich_message und a2p_rich_media_message, ist dies der Zeitpunkt, zu dem die Nachricht an den Nutzer gesendet wird. Beim a2p_session-Ereignis ist das der Zeitpunkt, zu dem die erste Nachricht in der Unterhaltung an den Nutzer gesendet wird. P2A Bei Ereignissen, die nicht mit Sitzungen zusammenhängen, z. B. p2a_rich_message und p2a_rich_media_message, ist dies der Zeitpunkt, zu dem die Nachricht vom Nutzer gesendet wird. Beim p2a_session-Ereignis ist das der Zeitpunkt, zu dem 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 es sich beim Ereignis nicht um ein Sitzungsereignis handelt, ist der Wert 0.	45
mt_messages	Zahl	Anzahl der im Ereignis enthaltenen A2P-Nachrichten (Mobile-Terminated). Bei Sitzungen wird in jeder Zeile mit demselben billing_event_id die Gesamtzahl der MT-Nachrichten in der gesamten Sitzung angezeigt.	5
mo_messages	Zahl	Anzahl der vom Mobilgerät gesendeten (P2A) Nachrichten im Ereignis. Bei Sitzungen wird in jeder Zeile mit demselben billing_event_id die Gesamtzahl der MO-Nachrichten in der gesamten Sitzung angezeigt.	3
size_kilobytes	Zahl	Größe aller Dateien, die an Nachrichten im Ereignis angehängt sind, gerundet auf das nächste Kilobyte (1 KB entspricht 1.024 Byte).	912
agent_name	String	Name des Agents, der an dem Ereignis teilgenommen hat.	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 zu den genannten gehört, ist der Wert 0.	5
session_type	String	Art der Sitzung: a2p_session p2a_session Ist leer, wenn die Aktivität nicht als Sitzung gilt.	a2p_session

Beispiel für einen Abrechnungsbericht

Beispielbericht zum Herunterladen:

• Abrechnungsbericht für das US-Abrechnungsmodell

Typische Dateigröße

Die Größe eines täglichen Berichts eines aktiven RCS for Business-Partners hängt davon ab, wie viele Aktivitäten er im Netzwerk des Mobilfunkanbieters generiert hat.