RBM erstellt Datendateien, die die Nutzer- und Agent-Aktivitäten auf Zusammenfassungs- und Transaktionsebenen melden. Die Daten werden auf mehrere Dateien aufgeteilt:
| Datei | Beschreibung | Zugriffsberechtigt |
|---|---|---|
| Bericht zu Abrechnungsereignissen | Datensatz der abrechenbaren Ereignisse zwischen gestarteten Agents und Nutzern | Alle Mobilfunkanbieter mit RBM-Traffic in ihren Netzwerken |
| Aktivitätsprotokoll | Rohdaten zur RBM-Plattformaktivität | Mobilfunkanbieter mit RBM-Traffic in ihren Netzwerken, die RCS-Aktivitäten mit Jibe Cloud gemäß ihren eigenen Nutzungsbedingungen aktivieren |
Generierung
Berichte zu Abrechnungsereignissen und Aktivitätsprotokolle werden mit einer Verzögerung von zwei Tagen generiert.
Google meldet ein Aktivitätsereignis nur, wenn die Abrechnungssitzung, zu der es gehört, abgeschlossen ist. Eine Sitzung kann bis zu 24 Stunden dauern. Unsere Abrechnungspipeline wird einmal täglich ausgeführt und meldet nur Abrechnungssitzungen, die sicher abgeschlossen wurden (also mindestens 24 Stunden alt sind).
Beispiel:
Am d wird eine Nachricht gesendet, mit der eine Abrechnungssitzung initiiert wird, aber die Pipelineausführung eine Stunde früher verpasst wurde. Daher wird kein Aktivitätsereignis gemeldet.
Wenn die Pipeline am d+1 wieder ausgeführt wird, ist die durch die Nachricht initiierte Sitzung nur 23 Stunden alt. Daher wird für diese Nachricht kein Aktivitätsereignis für d+1 gemeldet.
Wenn die Pipeline am d+2 wieder ausgeführt wird, ist die Sitzung abgeschlossen, sodass das Aktivitätsereignis zusammen mit der Abrechnungssitzung gemeldet wird.
Speicher und Zugriff
Datendateien werden sowohl im Ruhezustand als auch bei der Übertragung verschlüsselt.
Um Datendateien über SFTP abzurufen, müssen Sie Ihren öffentlichen SFTP-Schlüssel angeben. Informationen zum Generieren von Schlüsseln findest du unter SSH-Schlüsselpaar (Secure Shell) für SFTP-Dropbox generieren.
Der SFTP-Server ist partnerupload.google.com und die Verbindung ist aus Sicherheitsgründen über eine Portnummer mit hohem Wert (19321) verbunden.
Mit dem folgenden Befehl können Sie auf Ihre Datendateien zugreifen:
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Google stellt Nutzernamen für Konten in den folgenden Formaten zur Verfügung:
rbmreports-billableevents-<carrier name>rbmreports-activity-<carrier name>
Google legt <carrier name> fest 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 Berichtsdateien erstellt wurden, wird ein SFTP-Fehler wie remote readdir("/"): No such file or directory ausgegeben. Dies ist zu erwarten.
Wenn kein RBM-Traffic gemeldet werden kann, wird keine Datei erstellt. Dies bedeutet, dass an einigen Tagen keine Dateien generiert werden. Wenden Sie sich an rbm-support@google.com, wenn in diesem Fall leere Dateien generiert werden müssen, um die Verarbeitung zu vereinfachen.
Aktualisierung und Aufbewahrung
Jede Datendatei stellt einen Tag der Plattformnutzung in UTC dar. Datensätze für einen bestimmten Tag werden einmal generiert und innerhalb von 2 Tagen (48 Stunden) nach Tagesende endgültig erstellt. Wenn Sie diese Dateien in ein Data Warehouse laden, können Sie die Messwerte des aktuellen Monats aktualisieren.
Wenn keine Aktivität zu berücksichtigen ist, wird keine Datei erstellt.
Das Datum im Namen jeder Datei ist das Datum, an dem die Datei erstellt wurde. Die Einträge in der Datei decken den UTC-Tag ab, der zwei Tage vor dem Dateidatum liegt.
Der Export, der die Dateien generiert, wird zwischen 2 und 4:00 Uhr PST (UTC-8) ausgeführt.
Datendateien werden maximal 30 Tage aufbewahrt, bevor sie gelöscht werden.
Berichte zu Abrechnungsereignissen
Berichte zu Abrechnungsereignissen sind Datensätze zu abrechenbaren Ereignissen, die anhand der vorgeschlagenen Abrechnungseinheiten aus zugrunde liegenden Nachrichten berechnet werden. Kostenpflichtige Ereignisse enthalten vertrauliche Informationen, aber keine personenidentifizierbaren Informationen (z.B. keine MSISDN, gehashten MSISDN oder eine eindeutige Nutzerkennung).
Nur gestartete Agents generieren Abrechnungsereignisse. Aktivitäten, die noch nicht gestartet wurden, oder nicht aktivierte Agents werden nicht in Abrechnungsberichten angezeigt.
In den Abrechnungsberichten wird davon ausgegangen, dass Ereignisse bei der Zustellung von Nachrichten und nicht nach dem Senden von Nachrichten in Rechnung gestellt werden. Eine nicht zugestellte oder widerrufene Nachricht vor der Zustellung löst kein Abrechnungsereignis aus.
Jeder RBM-Agent hat eine Abrechnungskategorie, die vom Agent-Entwickler festgelegt wird, bevor er zur Einführung eingereicht wird. Die Abrechnungskategorie bestimmt, ob die vom Agent gesendeten Nachrichten diskret sind oder in dialogorientierten Abrechnungsereignissen kombiniert werden können.
Es gibt fünf Arten von abrechenbaren Ereignissen:
| Veranstaltung | Definition |
|---|---|
| Einfache Nachricht | Eine A2P-Nachricht (Application-to-Person), die
Nur Konversations-Agents: Wenn eine P2A-Nachricht innerhalb der nächsten 24 Stunden als Antwort auf eine A2P-Nachricht zugestellt wird, wird die einfache Nachricht Teil einer A2P-Unterhaltung. Andernfalls wird die Sitzung beendet. Eine einfache Nachricht wird immer von einem Agent an einen Nutzer gesendet. |
| Einzelne Nachricht | Eine A2P-Nachricht (Application-to-Person), die
Nur Konversations-Agents: Wenn eine P2A-Nachricht innerhalb der nächsten 24 Stunden zugestellt wird, wird die einzelne Nachricht Teil einer A2P-Unterhaltung. Andernfalls wird die Sitzung beendet. Eine einzelne Nachricht wird immer von einem Agent an einen Nutzer zugestellt. |
| A2P-Unterhaltung | Gilt nur für Konversations-Agents: Eine A2P-Unterhaltung wird initiiert, wenn eine P2A-Nachricht innerhalb von 24 Stunden nach einer A2P-Einzelnachricht oder A2P-Basisnachricht zugestellt wird. Wenn eine P2A-Nachricht innerhalb von 24 Stunden nach mehreren A2P-Nachrichten zugestellt wird, wird nur die A2P-Nachricht unmittelbar vor der P2A-Nachricht zum Erstellen der Unterhaltungssitzung verwendet. Diese A2P-Nachricht sowie alle Nachrichten, die innerhalb der nächsten 24 Stunden zugestellt werden, sind Teil der neuen A2P-Unterhaltung. |
| P2A-Unterhaltung | Gilt nur für Konversations-Agents: Eine P2A-Unterhaltung wird initiiert, wenn keine aktive Sitzung (A2P-Einzelnachricht, A2P-Unterhaltung oder P2A-Unterhaltung) vorhanden ist, eine P2A-Nachricht zugestellt wird und das Unternehmen innerhalb von 24 Stunden antwortet. |
| P2A-Botschaft | Nicht dialogorientierte Agents: Eine P2A-Nachricht, die von einem Nutzer an einen Agent mit der Abrechnungskategorie „Einzelnachricht“ oder „Einfache Nachricht“ gesendet wird.
Unterhaltungs-Agents: Eine P2A-Nachricht, die von einem Nutzer an einen Agent gesendet wird und für die keine Unterhaltung vorhanden ist und der Agent keine Antwort zurückgibt. |
Verfügbarkeit
Berichte zu Abrechnungsereignissen sind für alle Mobilfunkanbieter mit RBM-Traffic in ihren Netzwerken verfügbar.
Format
Berichte zu Abrechnungsereignissen haben das Dateinamenformat YYYY/MM/DD/rbm_billable_events_YYYY-MM-DD.csv.
Das Datum im Dateinamen ist das Datum, an dem die Datei generiert wurde. Die Datensätze in der Datei decken in der Regel die Aktivität des Tages ab, der zwei Tage vor diesem Datum lag.
Die Felder in einem Datensatz sind durch Tabulatoren getrennt und es gibt einen Datensatz pro Zeile.
Für jedes Abrechnungsereignis gibt es einen Eintrag. Das heißt, dass zwei A2P-Unterhaltungen mit demselben Agent zwei Abrechnungsereignisse und zwei Datensätze im Abrechnungsbericht generieren.
Jeder Eintrag im Bericht zu abrechenbaren Ereignissen enthält die folgenden Informationen zu jedem Ereignis:
| Feld | Format | Beschreibung | Beispiel |
|---|---|---|---|
billing_event_id
|
String | Die UUID-Kennung, eine Zufallszahl, die für jedes neue Ereignis zum Zeitpunkt der Erstellung generiert wird. | |
type
|
String | Der Ereignistyp:
|
single_message
|
agent_id
|
String | Die Kennung des Agents, der an dem Ereignis teilgenommen hat. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
String | Die E-Mail-Adresse des Inhabers des Kundenservicemitarbeiters, der an der Veranstaltung teilgenommen hat. Das ist die Partei, die den RBM-Agent registriert hat, in den meisten Fällen der Aggregator, aber in einigen seltenen Fällen kann es sich auch um die Marke handeln. Dieser Wert stammt aus dem Feld „RBM-Google-Konto“, das angegeben wurde, als sich der Entwickler für die Nutzung von RBM registriert hat. | name@aggregator.com
|
billing_party
|
String | Die Partei, die Veranstaltungen in Rechnung stellt.
|
carrier
|
max_duration_single_message
|
Zahl | Die Dauer in Stunden, die für die Nachricht eines Agents benötigt wird, ohne eine Antwort zur Identifizierung einer einzelnen Nachrichtensitzung zu erhalten. | 24
|
max_duration_a2p_conversation
|
Zahl | Die maximale Dauer einer A2P-Sitzung in Stunden. Gemessen von der ersten Nutzerantwort auf die erste Nachricht des Agents. | 24
|
max_duration_p2a_conversation
|
Zahl | Die maximale Dauer einer P2A-Sitzung in Stunden. Gemessen ab der ersten Nutzernachricht in der Unterhaltung. | 24
|
start_time
|
YYYY-mm-ddTHH:00:00Z | Datum und Uhrzeit des Beginns des Ereignisses in UTC im ISO 8601-Format, gerundet auf die nächste Stunde.
|
2019-07-25T08:00:00Z
|
duration
|
Zahl | Die Dauer des Ereignisses, auf die nächste Minute gerundet.
Wenn der Ereignistyp |
45
|
mt_messages
|
Zahl | Die Anzahl der von Mobilgeräten beendeten Nachrichten bei diesem Ereignis. | 11
|
mo_messages
|
Zahl | Die Anzahl der von Mobilgeräten stammenden Nachrichten im Ereignis. | 9
|
size_kilobytes
|
Zahl | Die Größe aller Dateien, die im Ereignis an Nachrichten angehängt wurden, auf das nächste Kilobyte gerundet (1 KB = 1.024 Byte). | 912
|
agent_name
|
String |
Der Kundenservicemitarbeiter, der an der Veranstaltung teilgenommen hat. |
XYZ Mobile USA
|
owner_name
|
String | Der Inhaber des Kundenservicemitarbeiters, der an der Veranstaltung teilgenommen hat. Das ist die Partei, die den RBM-Agent registriert hat. In den meisten Fällen ist es der Aggregator, in seltenen Fällen aber auch die Marke. Dieser Wert wird aus dem „Bevorzugter Anzeigename für dein Partnerkonto“ übernommen, der angegeben wurde, als sich der Entwickler für die Verwendung von RBM registriert hat. | XYZ Mobile
|
Beispieldatei
Hier können Sie ein Beispiel für einen Abrechnungsbericht herunterladen.
Typische Dateigröße
Eine tägliche Berichtsdatei eines aktiven Partners kann etwa 53.000 Datensätze und ungefähr 8 MB groß sein.
Aktivitätslogs
Aktivitätslogs sind Rohdatenlogs von Aktivitäten auf der RBM-Plattform. Sie dienen dazu, kostenpflichtige Ereignisse zu prüfen und benutzerdefinierte Ereignisse zu erstellen.
Verfügbarkeit
Aktivitätsprotokolle sind nur für Mobilfunkanbieter mit RBM-Traffic in ihren Netzwerken verfügbar, die RCS-Aktivitäten mit Jibe Cloud gemäß ihren eigenen Nutzungsbedingungen aktivieren. Wenn Sie Jibe Cloud gemäß den Nutzungsbedingungen von Jibe verwenden, haben Sie keinen Zugriff auf Aktivitätslogs.
Format
Aktivitätslogs haben das Dateinamenformat YYYY/MM/DD/rbm_activity_YYYY-MM-DD.csv.
Das Datum im Dateinamen ist das Datum, an dem die Datei generiert wurde. Die Datensätze in der Datei decken in der Regel die Aktivität des Tages ab, der zwei Tage vor diesem Datum lag.
Die Felder in einem Datensatz sind durch Tabulatoren getrennt und es gibt einen Datensatz pro Zeile.
Jeder Eintrag im Aktivitätsprotokoll enthält die folgenden Felder für jedes Aktivitätsereignis.
| Feld | Format | Beschreibung | Beispiel |
|---|---|---|---|
activity_id
|
String | Die ID für die Aktivität. | |
billing_event_id
|
String | Die Kennung für das Abrechnungsereignis, in dem die Aktivität stattgefunden hat. Dieser Wert kann leer sein, wenn die Aktivität mit keiner Sitzung verknüpft ist, z. B. ein text_message ohne entsprechendes delivery_receipt_event.
| |
agent_id
|
String | Die ID des Agents. | welcome-bot@rbm.goog
|
user_id
|
String | Die MSISDN des Nutzers. | 918369110173
|
direction
|
String | Richtung, in die die Nachricht gesendet wurde:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | Datum und Uhrzeit (UTC), zu der das Ereignis an die RBM-Plattform gesendet wurde. Siehe Hinweis unten. | 2019-07-25T00:29:07.033Z
|
type
|
String | Art der Aktivität:
|
text_message
|
size_bytes
|
String | Die Größe der an die Aktivität angehängten Dateien in Byte. | 912
|
Hinweis zu Zeitstempeln
Die Zeitstempel in Aktivitätslogs zeichnen den Zeitpunkt auf, zu dem ein Ereignis an die RBM-Plattform gesendet wurde. Bei Ereignissen, durch die Inhalte an einen Nutzer gesendet werden, wird das Ereignis erst in das Aktivitätsprotokoll geschrieben, wenn die Nachricht zugestellt wurde.
Wenn beispielsweise am Mittwoch um 13:00 Uhr eine RBM-Nachricht an einen Nutzer gesendet wird und der Empfänger bis Sonntag um 09:00 Uhr offline ist, wird das Ereignis im für Sonntag generierten Aktivitätsprotokoll erfasst. Der Zeitstempel für das Ereignis im Aktivitätsprotokoll ist Mittwoch, 13:00 Uhr.