Raporty dotyczące płatności partnera

Partnerzy otrzymują zbiorcze raporty rozliczeniowe , które zawierają zagregowane dzienne liczby płatnych zdarzeń pogrupowane według agenta, typu zdarzenia i operatora. Jest to ogólne podsumowanie całego płatnego ruchu, które zawiera cenne analizy i niezbędne informacje o danych o ruchu.

Generowanie plików i dostęp do nich

Raporty są generowane codziennie w formacie CSV i dostarczane za pomocą usługi Google SFTP.

Dostęp do SFTP

Dostęp do raportów jest chroniony przez pary kluczy publicznych i prywatnych. Dane logowania SFTP zapewniają bezpieczny i izolowany dostęp.

Jak uzyskać dostęp do SFTP

Aby otrzymywać raporty rozliczeniowe, musisz najpierw skonfigurować dane logowania SFTP:

1. Wygeneruj parę kluczy SSH: postępuj zgodnie z instrukcjami, aby wygenerować parę kluczy SSH do użycia ze skrzynką referencyjną SFTP.
2. Rozpocznij proces wdrażania: jeśli chcesz otrzymywać raporty partnera, skontaktuj się z przedstawicielem Google lub główną osobą kontaktową w Google. Przeprowadzą Cię oni przez wstępną konfigurację i rejestrację konta partnera na potrzeby raportowania rozliczeń.
3. Prześlij klucz publiczny: prześlij klucz publiczny (plik PUB) do osoby kontaktowej w Google. Google utworzy Twoje konto, przypisze do niego unikalny <partner_id> i powiadomi Cię, gdy dostęp będzie gotowy.

4. Uzyskaj dostęp do serwera: po otrzymaniu powiadomienia możesz uzyskać dostęp do raportów na serwerze SFTP pod adresem partnerupload.google.com przy użyciu portu 19321. Aby się połączyć, użyj tego polecenia:

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

Konwencja nazewnictwa plików

Wszystkie raporty operatora są dzielone według operatora.

Struktury nazewnictwa katalogów i plików są takie:

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

Element <prefix> określa konkretny typ dostarczanego raportu.

Standardowe prefiksy to:

Typ raportu	Prefiks nazwy pliku
Raport zbiorczy	summary

Jeśli dla tego samego operatora i partnera istnieje kilka raportów (np. podczas migracji formatu), można opcjonalnie dodać dodatkowy niestandardowy prefiks nazwy pliku. Zawsze skanuj rekurencyjnie wszystkie pliki w katalogu z datą.

Struktura raportu CSV

W sekcjach poniżej znajdziesz definicje pól, formatów danych i kolumn używanych w raportach rozliczeniowych partnera.

Jeśli masz dodatkowe pytania, skontaktuj się z operatorem.

Format raportu zbiorczego

Pole	Format	Opis	Przykład
type	tekst	Typ zdarzenia rozliczeniowego	a2p_session
agent_id	tekst	Unikalny identyfikator agenta	[e-mail]
agent_name	tekst	Nazwa agenta, który uczestniczył w zdarzeniu	ACME Brand
carrier_id	tekst	Identyfikator operatora dla ruchu	super-carrier
carrier_name	tekst	Nazwa przewoźnika	Super Carrier
carrier_country	tekst	Kod kraju zgodny ze standardem ISO 3166-1 alpha-2	US
start_date	tekst	Data rozpoczęcia zdarzenia (format RRRR-MM-DD)	2026-05-07
billing_date	tekst	Data wygenerowania raportu rozliczeniowego	2026-05-08
event_count	liczba	Liczba zagregowanych zdarzeń według typu (SUMA)	150
segment_count*	liczba	Obliczona liczba segmentów dla zdarzeń modelu rozliczeniowego w Stanach Zjednoczonych (SUMA) *Tylko w Stanach Zjednoczonych	5