Partnerabrechnungsberichte

Partner erhalten zusammenfassende Abrechnungsberichte mit aggregierten täglichen Zählungen abrechenbarer Ereignisse, gruppiert nach Agent, Ereignistyp und Mobilfunkanbieter. Diese Berichte dienen als allgemeine Zusammenfassung aller abrechenbaren Traffics und liefern Ihnen wertvolle Analysen und die erforderliche Transparenz in Bezug auf Ihre Traffic-Daten.

Dateierstellung und Zugriff

Berichte werden täglich im CSV-Format generiert und über den Google SFTP-Dienst bereitgestellt.

SFTP-Zugriff

Der Zugriff auf die Berichte ist durch öffentliche/private Schlüsselpaare geschützt. Die SFTP-Anmeldedaten sorgen für einen sicheren und isolierten Zugriff.

SFTP-Zugriff erhalten

Damit Sie Abrechnungsberichte erhalten können, müssen Sie zuerst Ihre SFTP-Anmeldedaten einrichten:

1. SSH-Schlüsselpaar generieren: Folgen Sie der Anleitung, um ein SSH-Schlüsselpaar (Secure Shell) für eine SFTP-Dropbox zu generieren.
2. Onboarding starten:Wenn Sie Partnerberichte erhalten möchten, wenden Sie sich an Ihren Google-Ansprechpartner oder Ihren primären Google-Ansprechpartner. Er unterstützt Sie bei der ersten Einrichtung und Registrierung Ihres Partnerkontos für die Abrechnungsberichterstellung.
3. Öffentlichen Schlüssel senden:Senden Sie Ihren öffentlichen Schlüssel (PUB-Datei) an Ihren Google-Ansprechpartner. Google stellt dann Ihr Konto bereit, weist ihm Ihre eindeutige <partner_id> zu und benachrichtigt Sie, sobald der Zugriff eingerichtet ist.

4. Auf den Server zugreifen:Sobald Sie benachrichtigt wurden, können Sie über Port 19321 auf Ihre Berichte auf dem SFTP-Server unter partnerupload.google.com zugreifen. Verwenden Sie den folgenden Befehl, um eine Verbindung herzustellen:

   sftp -i <path_to_private_key> -P 19321 rbmreports-partner-<partner_id>@partnerupload.google.com
   

Dateinamenskonvention

Alle Mobilfunkanbieterberichte werden nach Mobilfunkanbieter aufgeteilt.

Die Verzeichnis- und Dateinamenstrukturen sind wie folgt:

rbmreports-partner-<partner_id>/
  <YYYY>/<MM>/<DD>/
     summary_<short_carrier_id>/
        summary_<short_carrier_id>_<YYYY-MM-DD>.csv
     ...
     <prefix>_<short_carrier_id>/
        <prefix>_<short_carrier_id>_<YYYY-MM-DD>.csv

Das <prefix> gibt den spezifischen Berichtstyp an.

Zu den Standardpräfixen gehören:

Berichtstyp	Präfix für Dateinamen
Zusammenfassender Bericht	summary

Optional kann ein zusätzliches benutzerdefiniertes Präfix für Dateinamen hinzugefügt werden, wenn mehrere Berichte für denselben Mobilfunkanbieter und Partner vorhanden sind (z. B. bei Formatmigrationen). Sie sollten immer alle Dateien rekursiv im Verzeichnis mit dem Datum scannen.

CSV-Berichtsstruktur

In den folgenden Abschnitten werden die Felder, Datenformate und Spaltendefinitionen beschrieben, die in den Abrechnungsberichten für Partner verwendet werden.

Wenn Sie weitere Fragen haben, wenden Sie sich an Ihren Mobilfunkanbieter.

Format des zusammenfassenden Berichts

Feld	Format	Beschreibung	Beispiel
type	String	Typ des Abrechnungsvorgangs	a2p_session
agent_id	String	Eindeutige ID für den Agent	[e-mail]
agent_name	String	Name des Agent, der an dem Ereignis teilgenommen hat	ACME Brand
carrier_id	String	Mobilfunkanbieter-ID für den Traffic	super-carrier
carrier_name	String	Name des Mobilfunkanbieters	Super Carrier
carrier_country	String	ISO 3166-1 Alpha-2-Ländercode	US
start_date	String	Datum, an dem das Ereignis begonnen hat (Format JJJJ-MM-TT)	2026-05-07
billing_date	String	Datum, an dem der Abrechnungsbericht generiert wurde	2026-05-08
event_count	Zahl	Anzahl der aggregierten Ereignisse pro Typ (SUMME)	150
segment_count*	Zahl	Die berechnete Anzahl der Segmente für Ereignisse des US-Abrechnungsmodells (SUMME) *Nur USA	5