Diese Seite beschreibt die Datendateien, die RCS for Business erstellt, um US-amerikanische Mobilfunkanbieter bei der Abrechnung und Prüfung gemäß dem US-amerikanischen RBM-Framework zu unterstützen. Weitere Informationen zum US-amerikanischen RBM-Framework finden Sie unter usrbm.org .
Der Abrechnungsbericht ist eine Zusammenfassung aller abrechnungsfähigen Ereignisse zwischen aktivierten Agenten und Nutzern. Abrechnungsfähig bedeutet, dass ein Ereignis kostenpflichtig ist. Die Netzbetreiber legen fest, ob und wie abrechnungsfähige Ereignisse in Rechnung gestellt werden. Alle US-Netzbetreiber, die RCS for Business aktiv nutzen, haben Zugriff auf die Abrechnungsberichte.
Für nähere Informationen zum US-amerikanischen Abrechnungsklassifizierungsmodell verweisen wir auf die US-amerikanischen Abrechnungs-FAQ .
Dateigenerierung
Weitere Informationen finden Sie unter Dateigenerierung .
Dateispeicherung und -zugriff
Weitere Informationen finden Sie unter Dateispeicherung und -zugriff .
Dateiverfügbarkeit
Weitere Informationen finden Sie unter Dateiverfügbarkeit .
Abrechnungsberichte
Abrechnungsberichte sind Aufzeichnungen abrechnungsfähiger Ereignisse , die anhand der Abrechnungskategorie des Agenten und der Art der versendeten Nachrichten berechnet werden. Abrechnungsberichte stehen allen Anbietern zur Verfügung, die RCS for Business aktiv nutzen.
Die Abrechnungsberichte enthalten vertrauliche Informationen, jedoch keine personenbezogenen Daten (PII) des Benutzers, wie z. B. MSISDN, gehashte MSISDN oder eine eindeutige Kennung des Benutzers.
Abrechnungskategorien versus abrechnungsfähige Ereignisse
Die Unterscheidung zwischen Agenten -Abrechnungskategorien und abrechnungsfähigen Ereignissen ist der Schlüssel zum Verständnis dafür, wie Ihr Agent abrechnungsfähig ist.
- Die Abrechnungskategorie ist eine feste Klassifizierung, die Sie bei der Erstellung Ihres Agenten auswählen. Sie bestimmt die Abrechnungsmethode Ihres Agenten: pro Nachricht (nicht-konversationelle Agenten) oder pro Sitzung (konversationelle Agenten).
- Abrechnungsfähige Ereignisse sind Interaktionen zwischen einem RCS for Business-Agenten und einem Benutzer, die zu Abrechnungszwecken erfasst werden (z. B.
rich_message).
US-Agenten-Abrechnungskategorien
Beim Anlegen eines Agenten legt der Inhaber dessen Abrechnungskategorie fest, basierend darauf, wie der Agent mit Nutzern interagiert. Die Abrechnungskategorie beschränkt weder die Anzahl noch die Art der Nachrichten, die ein Agent senden kann. Sie bestimmt jedoch, wie die Nachrichten des Agenten abgerechnet werden. Die beiden Hauptabrechnungskategorien werden in der folgenden Tabelle beschrieben.
| Abrechnungskategorie | Agententyp | Anwendungsbeispiele | Abrechnungsmethode |
|---|---|---|---|
| Nicht-konversationell | Agenten, die hauptsächlich Einwegnachrichten versenden. |
| Kostenpflichtig für jede an den Nutzer zugestellte Nachricht. |
| Konversationell | Agenten, die für den wechselseitigen Austausch mit Nutzern konzipiert sind, unabhängig davon, wer das Gespräch beginnt. |
| Abrechnung pro Sitzung : Wenn die Sitzungskriterien erfüllt sind, werden alle Rich- und Rich-Media-Nachrichten innerhalb des 24-Stunden-Sitzungsfensters zu einem Pauschalpreis abgerechnet, unabhängig von Länge oder Segmenten. Abrechnung pro Nachricht : Werden die Sitzungskriterien nicht erfüllt oder fällt eine Nachricht außerhalb des 24-Stunden-Sitzungsfensters, wird die Nachricht einzeln zu einem Preis pro Nachricht für Rich Media gemäß der Preisliste des jeweiligen Anbieters abgerechnet. |
Konversationelle versus nicht-konversationelle Agenten
Es gibt zwei Abrechnungskategorien für Agenten: dialogbasierte und nicht-dialogbasierte.
Nicht-konversationelle Agenten werden für jede Nachricht, die sie dem Benutzer übermitteln, in Rechnung gestellt.
- Diese Kategorie eignet sich am besten für Agenten, die keine häufigen Antworten erwarten.
Chatbots berechnen eine Pauschale pro Sitzung, sofern eine Sitzung ausgelöst wurde. Die Gebühr umfasst dann alle innerhalb von 24 Stunden ausgetauschten Nachrichten, einschließlich derjenigen, die die Sitzung ausgelöst haben. Auch für Nachrichten, die nicht Teil einer 24-Stunden-Sitzung sind, können Gebühren anfallen.
- Diese Kategorie eignet sich am besten für Agenten, die mehrstufige Gespräche mit Nutzern führen.
Logik der Sitzungsabrechnung
Nach dem US-Abrechnungsmodell wird eine Sitzung durch eine Sequenz von vier Rich- oder Rich-Media-Nachrichten (darunter mindestens zwei MO- und mindestens eine MT-Nachricht) ausgelöst, die innerhalb von 24 Stunden ab der ersten Nachricht der Auslösesequenz ausgetauscht werden. Sobald diese Schwelle erreicht ist, werden alle Nachrichten innerhalb dieses 24-Stunden-Zeitraums als eine einzige Sitzung abgerechnet. Nachrichten, die keine Sitzung auslösen oder außerhalb dieser Schwelle liegen, werden gemäß der Preisliste des jeweiligen Anbieters zum Standardpreis pro Nachricht für Rich- oder Rich-Media-Nachrichten abgerechnet.
Das folgende Diagramm zeigt ein Beispiel für eine A2P-Abrechnungssitzung für Dialogsysteme.
- MT (Mobile Terminated) ist eine Nachricht, die vom Unternehmen gesendet wird.
- MO (Mobile Originated) ist eine Nachricht oder Aktion, die vom Benutzer initiiert wird.
Abrechnungsfähige Ereignisse
Nachrichtenflüsse werden nach Ursprung und Richtung kategorisiert. Zur Beschreibung der Richtung des Nachrichtenverkehrs verwenden US-amerikanische Mobilfunkanbieter üblicherweise die Begriffe MT/MO . Diese Begriffe entsprechen den in der RCS for Business-Dokumentation verwendeten Begriffen A2P/P2A . Im Folgenden finden Sie eine kurze Übersicht über die Entsprechungen dieser Begriffe:
- A2P (Application-to-Person) ist MT (Mobile Terminated) : Eine vom Unternehmen gesendete Nachricht.
- P2A (Person-to-Application) ist MO (Mobile Originated) : Eine vom Benutzer initiierte Nachricht oder Aktion.
| Ereignis | Beschreibung | Nicht-konversationelle Agenten | Konversationsagenten |
|---|---|---|---|
a2p_rich_message | Eine vom Agenten gesendete Nachricht, die nur Text, Antwortvorschläge oder konkrete Handlungsvorschläge enthält (Wählen Sie eine Nummer, Öffnen Sie eine URL im Browser). | Wird stets als einzeln abrechnungsfähiges Ereignis behandelt. Abrechnung pro Nachricht basierend auf Segmenten (1 Segment entspricht 160 UTF-8 Bytes). | Wird als einzelnes, abrechnungsfähiges Ereignis behandelt, es sei denn, es wird Teil einer Sitzung. |
p2a_rich_message | Eine vom Nutzer gesendete Nachricht, die entweder nur Freitext oder Text aus einer vorgeschlagenen Antwort enthält. | Wird stets als einzeln abrechnungsfähiges Ereignis behandelt. Abrechnung pro Nachricht basierend auf Segmenten. | Wird als einzelnes, abrechnungsfähiges Ereignis behandelt, es sei denn, es wird Teil einer Sitzung. |
a2p_rich_media_message | Eine vom Agenten gesendete Nachricht, die Medien (Bild, Video, Audio), Rich Cards, Karussells oder komplexe Aktionen wie „Standort anzeigen“ enthält. | Wird stets als einzeln abrechnungsfähiges Ereignis behandelt. Abrechnung als einmaliges, pauschaliertes Ereignis unabhängig von Größe oder Inhalt. | Wird als einzelnes, abrechnungsfähiges Ereignis behandelt, es sei denn, es wird Teil einer Sitzung. |
p2a_rich_media_message | Eine vom Benutzer gesendete Nachricht, die eine hochgeladene Mediendatei (Bild, Video, Audio) enthält. | Wird stets als einzeln abrechnungsfähiges Ereignis behandelt. Abrechnung als einzelnes, pauschaliertes Ereignis. | Wird als einzelnes, abrechnungsfähiges Ereignis behandelt, es sei denn, es wird Teil einer Sitzung. |
p2a_suggested_action | Ein Benutzer tippt auf eine beliebige vorgeschlagene Aktion (z. B. „Standort anzeigen“), die keine vorgeschlagene Antwort ist. | Wird stets als einzeln abrechnungsfähiges Ereignis behandelt. Erzeugt pro Klick ein abrechnungsfähiges Ereignis. | Wird als einzelnes abrechnungsfähiges Ereignis behandelt und generiert pro Klick ein abrechnungsfähiges Ereignis, es sei denn, es wird Teil einer Sitzung. |
a2p_session | Ein 24-Stunden-Interaktionsfenster, das mit dem Auslösen eines Sitzungs-Triggers und der ersten Nachricht (MT) beginnt. Weitere Informationen finden Sie unter Was ist eine Sitzung und wie funktioniert sie ? | Nicht zutreffend. Sitzungen gelten nicht für nicht-konversationelle Agenten. | Nach Auslösung sind alle Nachrichten innerhalb des 24-Stunden-Fensters durch eine einzige Sitzungsgebühr abgedeckt. Jedes abrechnungspflichtige Ereignis innerhalb dieser 24 Stunden wird der entsprechenden Ereignis-ID der Sitzung zugeordnet. |
p2a_session | Ein 24-Stunden-Interaktionsfenster, das mit dem Auslösen eines Sitzungs-Triggers und der ersten Nachricht „MO“ beginnt. Weitere Informationen finden Sie unter Was ist eine Sitzung und wie funktioniert sie ? | Nicht zutreffend. Sitzungen gelten nicht für nicht-konversationelle Agenten. | Nach Auslösung sind alle Nachrichten innerhalb des 24-Stunden-Fensters durch eine einzige Sitzungsgebühr abgedeckt. Jedes abrechnungspflichtige Ereignis innerhalb dieser 24 Stunden wird der entsprechenden Ereignis-ID der Sitzung zugeordnet. |
Erstellung von Abrechnungsberichten
Nur Agenten, deren Anrufe nicht von Testern stammen, generieren abrechnungsfähige Ereignisse. Aktivitäten von Testtelefonnummern werden in den Abrechnungsberichten nicht angezeigt.
Diese Berichte gehen davon aus, dass Ereignisse erst dann abgerechnet werden, wenn A2P-Nachrichten zugestellt werden, nicht bereits beim Versand. Eine nicht zugestellte oder vor der Zustellung stornierte Nachricht löst kein abrechnungspflichtiges Ereignis aus.
Format des Abrechnungsberichts
Abrechnungsberichte verwenden das Dateinamensformat rbm_billable_events_YYYY-MM-DD.csv . Das Datum im Dateinamen ist das Datum der Dateierstellung.
Jede Zeile im Bericht repräsentiert einen einzelnen abrechnungsfähigen Vorgang. A2P/P2A-Sitzungen werden durch mehrere Zeilen dargestellt – eine für jede ausgetauschte Nachricht. Jede Zeile, die einer Sitzung zugeordnet ist (mit derselben billing_event_id ), gibt die Gesamtzahl der MT- und MO-Nachrichten für das gesamte 24-Stunden-Sitzungsfenster in den Spalten mt_messages und mo_messages an.
Jeder Datensatz im Bericht enthält die folgenden Informationen für jedes abrechnungsfähige Ereignis.
| Feld | Format | Beschreibung | Beispiel |
|---|---|---|---|
billing_event_id | Zeichenkette | Generierte ID zur Identifizierung des abrechnungsfähigen Ereignisses. Alle Nachrichten, die Teil einer Sitzung sind, haben dieselbe | 63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type | Zeichenkette | Art des Ereignisses:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action | p2a_rich_message |
agent_id | Zeichenkette | Eindeutige Kennung für den Agenten, der an der Veranstaltung teilgenommen hat. | acme_342h23_agent@rbm.goog |
agent_owner | Zeichenkette | E-Mail-Adresse des aktuellen Inhabers des Partnerkontos, auf dem der Agent erstellt wurde. | marketing@xyzaggregator.com |
billing_party | Zeichenkette | Die Partei, die die Kosten für Veranstaltungen in Rechnung stellt. | Träger |
max_duration_single_message | Nummer | Maximale Antwortzeit (in Stunden) für einen Nutzer auf eine Agentennachricht, bevor das Gesprächsfenster geschlossen wird und die Nachricht als single_message klassifiziert wird. Gilt nicht für das US-Modell für individuelle Rich Messages. | 24 |
max_duration_a2p_conversation | Nummer | Für die Pilotphase der Sitzungen entspricht dies dem 24-Stunden-Sitzungsfenster, gemessen ab der ersten Nachricht in der Auslösesequenz. Die Dauer wird in Stunden gemessen. | 24 |
max_duration_p2a_conversation | Nummer | Für die Pilotphase der Sitzungen entspricht dies dem 24-Stunden-Sitzungsfenster, gemessen ab der ersten Nachricht in der Auslösesequenz. | 24 |
start_time | YYYY-MM-TTTHH:00:00Z | Datum und Uhrzeit des Ereignisbeginns in UTC (ISO 8601). Bei Sitzungen entspricht dies dem Zeitstempel der ersten Nachricht in der Auslösesequenz. A2P a2p_rich_message und a2p_rich_media_message , ist dies der Zeitpunkt, zu dem die Nachricht an den Benutzer zugestellt wird.a2p_session Ereignis ist dies der Zeitpunkt, an dem die erste Nachricht der Konversation an den Benutzer zugestellt wird.P2A p2a_rich_message und p2a_rich_media_message , ist dies der Zeitpunkt, zu dem die Nachricht vom Benutzer gesendet wird.p2a_session handelt es sich um den Zeitpunkt, an dem der Benutzer die erste Nachricht in der Konversation sendet. | 2025-05-20T08:00:00Z |
duration | Nummer | Die Dauer bezieht sich nur auf Sitzungen und wird in Minuten gemessen. Handelt es sich um ein Ereignis außerhalb einer Sitzung, ist der Wert 0. | 45 |
mt_messages | Nummer | Anzahl der mobil terminierten (A2P) Nachrichten im jeweiligen Ereignis. Für Sitzungen zeigt jede Zeile mit derselben billing_event_id die Gesamtzahl der MT-Nachrichten in der gesamten Sitzung an. | 5 |
mo_messages | Nummer | Anzahl der per Mobilgerät ausgelösten Nachrichten (P2A) im jeweiligen Ereignis. Für Sitzungen zeigt jede Zeile mit derselben billing_event_id die Gesamtzahl der per Mobilgerät ausgelösten Nachrichten in der gesamten Sitzung an. | 3 |
size_kilobytes | Nummer | Größe aller an die Nachrichten angehängten Dateien im Rahmen des Ereignisses, gerundet auf das nächste Kilobyte (1 kB entspricht 1024 Byte). | 912 |
agent_name | Zeichenkette | Name des Agenten, der an der Veranstaltung teilgenommen hat. | ACME Brand |
owner_name | Zeichenkette | Name des aktuellen Inhabers des Partnerkontos, auf dem der Agent erstellt wurde. | XYZ Aggregator |
segment_count | Nummer | Die berechnete Segmentanzahl für a2p_rich_message events und p2a_rich_message Ereignisse (1 Segment entspricht 160 UTF-8-Bytes). Wenn es sich nicht um eines der genannten Ereignisse handelt, ist der Wert 0. | 5 |
session_type | Zeichenkette | Sitzungstyp:a2p_sessionp2a_session | a2p_session |
Beispielhafter Abrechnungsbericht
Ein Beispielbericht steht zum Download bereit:
Typische Dateigröße
Der Umfang eines täglichen Berichts eines aktiven RCS for Business-Partners hängt davon ab, wie viel Aktivität dieser im Netzwerk des Anbieters generiert hat.