Diese Seite beschreibt die Datendateien, die RCS for Business erstellt, um Netzbetreiber bei der Abrechnung und Prüfung zu unterstützen.
| Datei | Beschreibung | Wer hat Zugriff? |
|---|---|---|
| Abrechnungsbericht | Zusammengefasster Bericht über abrechnungsfähige Ereignisse zwischen gestarteten Agenten und Benutzern. | Alle Carrier, die RCS for Business aktiv betreiben. |
| Aktivitätsprotokoll | Rohdatenprotokoll der RCS for Business-Aktivitäten, einschließlich abrechnungsfähiger Ereignisse. | Netzbetreiber, die RCS for Business aktiv betreiben und den Google RCS-Dienst gemäß ihren eigenen Nutzungsbedingungen (Terms of Service, ToS) betreiben. |
RCS for Business verwendet für Datenverkehr außerhalb der USA ein Standardabrechnungsmodell. Weitere Informationen finden Sie in den FAQ zur Abrechnung .
Dateigenerierung
Jede Datendatei repräsentiert einen Tag der Nutzung von RCS for Business in pazifischer Standardzeit (PST). Die Dateien werden täglich neu erstellt und spiegeln die Aktivitäten der vorangegangenen 24 Stunden (Mitternacht bis Mitternacht) wider. Die Erstellung kann mehrere Stunden dauern, die genaue Dauer kann variieren.
- Bei nicht-konversationellen Agenten enthalten die Dateien Daten aus dem 24-Stunden-Zeitraum unmittelbar vor dem Tag, an dem die Datei erstellt wurde. Beispielsweise umfasst ein am 5. Mai erstellter Bericht Daten vom 4. Mai, 0:00 Uhr, bis zum 5. Mai, 0:00 Uhr. Die angegebene Zeitangabe bezieht sich auf die PST-Zeitzone.
Bei Chatbots enthalten die Dateien Daten aus dem 24-Stunden-Zeitraum ein bis zwei Tage vor der Dateierstellung. Beispielsweise umfasst ein am 5. Mai erstellter Bericht Daten aus dem 24-Stunden-Fenster vom 2. oder 3. Mai. Die angegebene Zeitangabe bezieht sich auf die PST-Zeitzone.
Die Verzögerung entsteht dadurch, dass die Aktivitäten von RCS for Business für Chatbots an Sitzungen gekoppelt sind, deren Abschluss bis zu 24 Stunden dauern kann. Diese Verzögerung ermöglicht es RCS for Business, alle Nachrichten innerhalb einer Konversation zu erfassen, bevor das abrechnungsfähige Ereignis berechnet wird. Weitere Informationen zu Chatbots finden Sie unter Abrechnungskategorien für Agenten .
Wichtigste Punkte:
- Keine Aktivität : Standardmäßig wird keine Datei generiert, wenn an einem Tag keine Plattformaktivität stattfindet. Sie können jedoch bei Bedarf leere Dateien anfordern. Wenden Sie sich dazu bitte an rbm-support@google.com.
- Benennung : Das Datum im Dateinamen ist das Datum der Dateierstellung, nicht das Datum der darin enthaltenen Daten.
- Aufbewahrung : Dateien werden maximal 63 Tage lang gespeichert, bevor sie gelöscht werden.
Sie können diese Dateien verwenden, um Ihr Data Warehouse mit den neuesten Plattformnutzungsmetriken zu aktualisieren.
Dateispeicherung und -zugriff
Datendateien werden sowohl im Ruhezustand als auch während der Übertragung verschlüsselt.
Um Datendateien per Secure File Transfer Protocol (SFTP) abzurufen, geben Sie Ihren öffentlichen SFTP-Schlüssel an. Informationen zum Generieren von Schlüsseln finden Sie unter Generieren eines Secure Shell (SSH)-Schlüsselpaars für eine SFTP-Dropbox .
Der SFTP-Server ist partnerupload.google.com , und die Verbindung erfolgt über eine hohe Portnummer (19321) aus Sicherheitsgründen.
Sie können folgenden Befehl verwenden, um auf Ihre Datendateien zuzugreifen:
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Google stellt Kontobenutzernamen in folgenden Formaten bereit:
-
rbmreports-billableevents-<carrier name> -
rbmreports-activity-<carrier name>
Google gibt <carrier name> an und stellt für jeden Berichtstyp ein separates Konto bereit.
Für den Zugriff auf die verschiedenen Berichtstypen werden separate Konten bereitgestellt.
Dateiverfügbarkeit
Wenn noch keine Datendateien generiert wurden, wird ein SFTP-Fehler ähnlich wie remote readdir("/"): No such file or directory angezeigt, was zu erwarten ist.
Es wird keine Datei generiert, wenn kein RCS for Business-Datenverkehr gemeldet wird. Daher kann es vorkommen, dass an manchen Tagen keine Dateien erstellt werden. Falls Sie leere Dateien benötigen, um Ihren Prozess zu optimieren, wenden Sie sich bitte an das RCS for Business-Supportteam .
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.
Agentenabrechnungskategorien
Beim Anlegen eines Agenten legt der Inhaber dessen Abrechnungskategorie fest, basierend darauf, wie der Agent mit den 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 dem Agenten in Rechnung gestellt werden. Die beiden Hauptabrechnungskategorien werden in der folgenden Tabelle beschrieben.
| Abrechnungskategorie | Agententyp | Anwendungsbeispiele | Abrechnungsmethode |
|---|---|---|---|
| Nicht-konversationell | Agenten, die hauptsächlich Einwegnachrichten versenden. |
| Abrechnung erfolgt pro an den Nutzer zugestellter Nachricht. |
| Konversationell | Agenten, die für den wechselseitigen Austausch mit Benutzern konzipiert sind. |
| Abrechnung pro Konversation : Wenn eine Partei (der Agent oder der Nutzer) innerhalb von 24 Stunden auf eine Nachricht der anderen Partei antwortet, beginnt eine Konversation. Während des Konversationszeitraums (24 Stunden nach der ersten Antwort) können Agent und Nutzer beliebig viele Nachrichten austauschen. Dem Agenten wird für die Konversation ein fester Preis in Rechnung gestellt. Abrechnung pro Nachricht : Wenn der Agent eine Nachricht übermittelt, auf die der Benutzer nicht innerhalb von 24 Stunden antwortet, wird dem Agenten die einzelne Nachricht in Rechnung gestellt, ähnlich wie bei einem nicht-konversationellen Agenten. |
Das folgende Diagramm zeigt ein Beispiel für eine A2P-Abrechnungssitzung für Dialogsysteme:
Konversationelle versus nicht-konversationelle Agenten
Es gibt zwei Hauptkategorien für die Abrechnung: Gesprächsbasierte und nicht-gesprächsbasierte Abrechnung.
Der Hauptunterschied bei den Abrechnungskategorien besteht zwischen dialogbasierten und nicht-dialogbasierten Agenten:
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.
Den Chatagenten wird eine Pauschalgebühr für Gespräche in Rechnung gestellt, die alle innerhalb eines 24-Stunden-Zeitraums ausgetauschten Nachrichten umfasst.
- Diese Kategorie eignet sich am besten für Agenten, die mehrstufige Gespräche mit Nutzern führen.
Abrechnungsfähige Ereignisse
In den Abrechnungsberichten werden fünf Arten von abrechnungsfähigen Ereignissen erfasst. Zu diesen Ereignissen gehören MT- und MO-Ereignisse, die auch als A2P- und P2A-Ereignisse bezeichnet werden.
- 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.
Die nachfolgende Tabelle beschreibt jedes abrechnungsfähige Ereignis in Bezug auf nicht-konversationelle und konversationelle Agenten.
| Ereignis | Beschreibung | Nicht-konversationelle Agenten | Konversationsagenten |
|---|---|---|---|
basic_message | Eine A2P-Nachricht, die ausschließlich Text mit maximal 160 Zeichen enthält. Enthält der Text eine URL zu einer Website mit OpenGraph-Tags , kann die Nachricht eine Bildvorschau anzeigen, ohne dass dem Partner zusätzliche Kosten entstehen. | Wird stets als einzelnes, abrechnungsfähiges Ereignis behandelt, unabhängig davon, ob der Nutzer antwortet. | Wird als einzelnes abrechnungsfähiges Ereignis behandelt, es sei denn, der Nutzer antwortet innerhalb von 24 Stunden. In diesem Fall wird die Nachricht Teil einer a2p_conversation . |
single_message | Eine A2P-Nachricht, die entweder Rich Content enthält oder eine reine Textnachricht mit mehr als 160 Zeichen ist. | Wird stets als einzelnes, abrechnungsfähiges Ereignis behandelt, unabhängig davon, ob der Nutzer antwortet. | Wird als einzelnes abrechnungsfähiges Ereignis behandelt, es sei denn, der Nutzer antwortet innerhalb von 24 Stunden. In diesem Fall wird die Nachricht Teil einer a2p_conversation . |
a2p_conversation (vom Unternehmen initiiert) | Wird ausgelöst, wenn ein Nutzer innerhalb von 24 Stunden nach Erhalt einer A2P-Nachricht darauf antwortet, und zwar außerhalb einer bestehenden Konversation. | Nicht zutreffend. Nicht-konversationelle Agenten erzeugen dieses Ereignis nie. | Wird eine P2A-Nachricht innerhalb von 24 Stunden nach mehreren A2P-Nachrichten zugestellt, wird nur die unmittelbar vorhergehende A2P-Nachricht zur Initiierung der Konversation verwendet. Diese A2P-Nachricht sowie alle innerhalb der nächsten 24 Stunden zugestellten Nachrichten sind Teil der a2p_conversation . |
p2a_conversation (vom Benutzer initiiert) | Wird ausgelöst, wenn ein Agent innerhalb von 24 Stunden nach Erhalt einer P2A-Nachricht darauf antwortet, und zwar außerhalb einer bestehenden Konversation. | Nicht zutreffend. Nicht-konversationelle Agenten erzeugen dieses Ereignis nie. | Wird eine A2P-Nachricht innerhalb von 24 Stunden nach mehreren P2A-Nachrichten zugestellt, wird nur die unmittelbar vorhergehende P2A-Nachricht zur Initiierung der Konversation verwendet. Diese P2A-Nachricht sowie alle innerhalb der nächsten 24 Stunden zugestellten Nachrichten sind Teil der p2a_conversation . |
p2a_message | P2A-Nachricht beliebigen Typs. | Wird stets als einzelnes, abrechnungsfähiges Ereignis behandelt, unabhängig davon, ob der Agent antwortet. | Wird als einzelnes, abrechnungsfähiges Ereignis behandelt, es sei denn, der Agent antwortet innerhalb von 24 Stunden. |
Abrechnungskategorien versus abrechnungsfähige Ereignisse
Die Unterscheidung zwischen Agentenabrechnungskategorien und abrechnungsfähigen Ereignissen ist der Schlüssel zum Verständnis der Abrechnung Ihres Agenten.
- 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 Konversation (konversationelle Agenten).
- Abrechnungsfähige Ereignisse sind Interaktionen zwischen einem RCS for Business-Agenten und einem Benutzer, die zu Abrechnungszwecken erfasst werden (z. B.
basic_message,single_message,a2p_conversation).
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 bei Zustellung der Nachrichten abgerechnet 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 stellt einen Datensatz dar, der ein einzelnes abrechnungsfähiges Ereignis repräsentiert. Die Felder innerhalb eines Datensatzes sind durch Tabulatoren getrennt. Beispielsweise würden zwei A2P-Konversationen mit demselben Agenten zwei separate abrechnungsfähige Ereignisse und zwei Datensätze im Abrechnungsbericht erzeugen.
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. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff |
type | Zeichenkette | Art des Ereignisses:
| single_message |
agent_id | Zeichenkette | Eindeutige Kennung für den Agenten, der an der Veranstaltung teilgenommen hat. | rbm-welcome-bot@rbm.goog |
agent_owner | Zeichenkette | E-Mail-Adresse des aktuellen Inhabers des Partnerkontos, auf dem der Agent erstellt wurde. | name@aggregator.com |
billing_party | Zeichenkette | Die Partei, die die Kosten für Veranstaltungen in Rechnung stellt.
| carrier |
max_duration_single_message | Nummer | Maximale Zeit (in Stunden), die einem Benutzer zur Verfügung steht, um auf eine Agentennachricht zu antworten, bevor das Gesprächsinitiierungsfenster geschlossen wird und die Nachricht als single_message Ereignis klassifiziert wird. | 24 |
max_duration_a2p_conversation | Nummer | Maximale Dauer einer A2P-Konversation in Stunden. Gemessen von der ersten Nutzerantwort bis zur ersten Nachricht des Agenten. | 24 |
max_duration_p2a_conversation | Nummer | Maximale Dauer einer P2A-Konversation in Stunden. Gemessen ab der ersten Nachricht des Nutzers in der Konversation. | 24 |
start_time | YYYY-MM-TTTHH:00:00Z | Datum/Uhrzeit des Ereignisses in UTC im ISO 8601-Format, gerundet auf die nächste volle Stunde. A2P-Nachrichten
P2A-Nachrichten
| 2019-07-25T08:00:00Z |
duration | Nummer | Ereignisdauer, gerundet auf die nächste Minute. Der Wert ist 0 für jedes Ereignis, das kein Gespräch ist. | 45 |
mt_messages | Nummer | Anzahl der an Mobilgeräte gesendeten Nachrichten (A2P) im Rahmen des Ereignisses. | 11 |
mo_messages | Nummer | Anzahl der von Mobilgeräten ausgehenden Nachrichten (P2A) im Rahmen des Ereignisses. | 9 |
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. | XYZ Mobile USA |
owner_name | Zeichenkette | Name des aktuellen Inhabers des Partnerkontos, auf dem der Agent erstellt wurde. | XYZ Mobile |
Beispielhafter Abrechnungsbericht
Beispielberichte stehen zum Download bereit:
Typische Dateigröße
Die Größe eines Tagesberichts eines aktiven RCS for Business-Partners hängt davon ab, wie viel Aktivität dieser im Netzwerk des Anbieters generiert hat. Enthält der Bericht beispielsweise 53.000 Datensätze, ist die Datei etwa 8 MB groß.
Aktivitätsprotokolle
Aktivitätsprotokolle liefern Rohdaten über die Aktivitäten auf der RCS for Business-Plattform. Sie können diese Protokolle verwenden, um abrechnungsfähige Ereignisse zu prüfen und benutzerdefinierte Ereignisse zu erstellen.
Da Aktivitätsprotokolle personenbezogene Daten (PII) wie detaillierte Transaktionsinformationen und Teilnehmer-MSISDNs enthalten, sind sie nur verfügbar, wenn ein Netzbetreiber RCS gemäß seinen eigenen Nutzungsbedingungen betreibt. Wenn Sie RCS-for-Business-Datenverkehr in Ihren Netzwerken nutzen und die RCS-Aktivität mit Google RCS gemäß den Google-Nutzungsbedingungen aktivieren, haben Sie keinen Zugriff auf die Aktivitätsprotokolle.
Aktivitätsprotokollformat
Aktivitätsprotokolle verwenden das Dateinamensformat rbm_activity_YYYY-MM-DD.csv . Das Datum im Dateinamen ist das Datum der Dateierstellung.
Die Felder in einem Datensatz sind durch Tabulatoren getrennt, und es befindet sich ein Datensatz pro Zeile.
Jeder Eintrag im Aktivitätsprotokoll enthält für jede Aktivität die folgenden Felder:
| Feld | Format | Beschreibung | Beispiel |
|---|---|---|---|
activity_id | Zeichenkette | Eindeutige Kennung für die Aktivität. | b422e1d3-ac99-442a-853d-a875d5e61762 |
billing_event_id | Zeichenkette | Eindeutige Kennung für das zugehörige abrechnungsfähige Ereignis. Kann leer sein, wenn die Aktivität keinem abrechnungsfähigen Ereignis zugeordnet ist, z. B. eine text_message ohne entsprechende delivery_receipt_event . | 91yeb201-7c3b-412b-98d2-b0a0f7abe536 |
agent_id | Zeichenkette | Eindeutige Kennung für den Agenten. | welcome-bot@rbm.goog |
user_id | Zeichenkette | MSISDN des Benutzers. | 918369110173 |
direction | Zeichenkette | Die Richtung, in die die Nachricht gesendet wird:
| MT |
time | YYYY-MM-TTTHH:MM:SS.SSSZ | Datum und Uhrzeit der Übermittlung des Ereignisses an die RCS for Business-Plattform im UTC-Format. Siehe Zeitstempel . | 2019-07-25T00:29:07.033Z |
type | Zeichenkette | Art der Aktivität:
| text_message |
size_bytes | Zeichenkette | Größe der der Aktivität zugeordneten Dateien in Bytes. | 912 |
Zeitstempel
Die Zeitstempel in den Aktivitätsprotokollen erfassen, wann ein Ereignis an die RCS for Business-Plattform übermittelt wurde. Bei Ereignissen, die Inhalte an einen Benutzer liefern, wird das Ereignis erst nach Zustellung der Nachricht im Aktivitätsprotokoll aufgezeichnet.
Wenn beispielsweise am Mittwoch um 13:00 Uhr eine RCS for Business-Nachricht an einen Benutzer gesendet wird und der Empfänger bis Sonntag um 9:00 Uhr offline ist, erscheint das Ereignis im Aktivitätsprotokoll, das für Sonntag generiert wird, jedoch mit dem Zeitstempel Mittwoch, 13:00 Uhr.