Na tej stronie opisano pliki danych tworzone przez RCS for Business w celu ułatwienia przewoźnikom wystawiania faktur i przeprowadzania audytów.
| Plik | Opis | Kto ma dostęp |
|---|---|---|
| Raport rozliczeniowy | Zbiorczy raport zdarzeń podlegających rozliczeniu pomiędzy uruchomionymi agentami i użytkownikami. | Wszyscy przewoźnicy aktywnie korzystający z usługi RCS for Business. |
| Dziennik aktywności | Surowy rejestr danych RCS dla aktywności biznesowej, obejmujący zdarzenia podlegające rozliczeniu. | Operatorzy aktywnie korzystający z usługi RCS for Business i obsługujący usługę Google RCS na podstawie własnych Warunków korzystania z usługi (ToS). |
RCS for Business korzysta ze standardowego modelu rozliczeń dla ruchu spoza USA. Szczegółowe informacje można znaleźć w sekcji FAQ dotyczącej rozliczeń .
Generowanie plików
Każdy plik danych reprezentuje jeden dzień wykorzystania RCS for Business w czasie pacyficznym (PST). Pliki są generowane codziennie i odzwierciedlają aktywność z ostatnich 24 godzin (od północy do północy). Proces generowania może trwać kilka godzin, a czas jego ukończenia może się różnić.
- W przypadku agentów nieprowadzących rozmów , pliki zawierają dane z 24-godzinnego okresu bezpośrednio poprzedzającego dzień wygenerowania pliku. Na przykład raport wygenerowany 5 maja obejmuje dane z okresu od 00:00 4 maja do 00:00 5 maja. Podany czas jest zgodny ze strefą czasową PST.
W przypadku agentów konwersacyjnych pliki zawierają dane z 24-godzinnego okresu 1-2 dni poprzedzających moment wygenerowania pliku. Na przykład raport wygenerowany 5 maja obejmuje dane z 24-godzinnego okresu 2 lub 3 maja. Podany czas jest zgodny ze strefą czasową PST.
Przyczyną opóźnienia jest powiązanie aktywności w RCS for Business dla agentów konwersacyjnych z sesjami, których ukończenie może zająć do 24 godzin. To opóźnienie pozwala RCS for Business na przechwycenie wszystkich wiadomości w konwersacji przed obliczeniem zdarzenia podlegającego rozliczeniu. Więcej informacji na temat agentów konwersacyjnych można znaleźć w sekcji Kategorie rozliczeń agentów .
Najważniejsze punkty:
- Brak aktywności : Domyślnie żaden plik nie jest generowany, jeśli w danym dniu nie ma aktywności na platformie. Możesz jednak w razie potrzeby wyrazić zgodę na otrzymywanie pustych plików. Aby to zrobić, skontaktuj się z nami pod adresem rbm-support@google.com.
- Nazwa : Data w nazwie pliku jest datą utworzenia pliku, a nie datą danych w nim zawartych.
- Przechowywanie : Pliki są przechowywane maksymalnie przez 63 dni, po czym zostają usunięte.
Pliki te można wykorzystać do aktualizacji magazynu danych o najnowsze wskaźniki wykorzystania platformy.
Przechowywanie i dostęp do plików
Pliki danych są szyfrowane zarówno w stanie spoczynku, jak i podczas transferu.
Aby pobrać pliki danych za pomocą protokołu Secure File Transfer Protocol (SFTP), podaj swój klucz publiczny SFTP. Aby wygenerować klucze, zobacz Generowanie pary kluczy Secure Shell (SSH) dla skrzynki odbiorczej SFTP .
Serwer SFTP to partnerupload.google.com , a połączenie jest realizowane na wyższym numerze portu (19321) w celu zapewnienia dodatkowego bezpieczeństwa.
Aby uzyskać dostęp do plików danych, możesz użyć następującego polecenia:
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Google udostępnia nazwy użytkowników kont w następujących formatach:
-
rbmreports-billableevents-<carrier name> -
rbmreports-activity-<carrier name>
Google określa <carrier name> i udostępnia osobne konto dla każdego typu raportu.
Do dostępu do różnych typów raportów przeznaczone są oddzielne konta.
Dostępność plików
Jeśli nie wygenerowano jeszcze żadnych plików danych, zobaczysz błąd SFTP podobny do remote readdir("/"): No such file or directory , co jest zgodne z oczekiwaniami.
Plik nie zostanie wygenerowany, jeśli nie ma ruchu w RCS for Business do zgłoszenia. Oznacza to, że mogą zdarzyć się dni, w których pliki nie zostaną wygenerowane. Jeśli potrzebujesz pustych plików, aby usprawnić proces, skontaktuj się z zespołem wsparcia RCS for Business .
Raporty rozliczeniowe
Raporty rozliczeniowe to rejestry zdarzeń podlegających rozliczeniu , które są obliczane na podstawie kategorii rozliczeniowej agenta i rodzaju wysyłanych przez niego wiadomości. Raporty rozliczeniowe są dostępne dla wszystkich operatorów aktywnie korzystających z usługi RCS for Business.
Raporty rozliczeniowe zawierają poufne informacje, ale nie zawierają danych osobowych identyfikujących użytkownika (PII), takich jak numer MSISDN, skrót numeru MSISDN ani żadnego unikalnego identyfikatora użytkownika.
Kategorie rozliczeń agentów
Podczas tworzenia agenta, właściciel ustala jego kategorię rozliczeniową na podstawie sposobu, w jaki agent będzie komunikował się z użytkownikami. Kategoria rozliczeniowa nie ogranicza liczby ani rodzaju wiadomości, jakie agent może wysłać. Określa jednak sposób rozliczania agenta za wiadomości. Dwie główne kategorie rozliczeniowe opisano w poniższej tabeli.
| Kategoria rozliczeniowa | Typ agenta | Przykładowe przypadki użycia | Metoda rozliczeń |
|---|---|---|---|
| Niekonwersacyjny | Agenci, którzy głównie wysyłają wiadomości jednokierunkowe. |
| Opłata naliczana jest za każdą wiadomość dostarczoną użytkownikowi. |
| Konwersacyjny | Agenci, których zadaniem jest dwustronna wymiana informacji z użytkownikami. |
| Rozliczanie za rozmowę : Jeśli jedna ze stron (agent lub użytkownik) odpowie na wiadomość od drugiej strony w ciągu 24 godzin, rozpoczyna się rozmowa. W trakcie rozmowy (24 godziny po pierwszej odpowiedzi) agent i użytkownik mogą wymienić dowolną liczbę wiadomości, a agent zostanie obciążony stałą stawką za rozmowę. Opłata za wiadomość : jeśli agent dostarczy wiadomość, na którą użytkownik nie odpowie w ciągu 24 godzin, agentowi zostanie naliczona opłata za każdą konkretną wiadomość, podobnie jak w przypadku agenta nieprowadzącego rozmowy. |
Poniższy diagram przedstawia przykład sesji rozliczeniowej A2P dla agentów konwersacyjnych:
Agenci konwersacyjni i niekonwersacyjni
Istnieją dwie główne kategorie rozliczeń: konwersacyjne i niekonwersacyjne.
Podstawowa różnica w kategoriach rozliczeń dotyczy agentów konwersacyjnych i niekonwersacyjnych:
Agenci nieprowadzący rozmów telefonicznych płacą za każdą wiadomość dostarczoną użytkownikowi.
- Ta kategoria jest najlepsza dla agentów, którzy nie spodziewają się częstych odpowiedzi.
Agenci konwersacyjni płacą stałą stawkę za rozmowy , które obejmują wszystkie wiadomości wymienione w ciągu 24 godzin.
- Ta kategoria jest najlepsza dla agentów prowadzących z użytkownikami wieloetapowe rozmowy.
Wydarzenia podlegające rozliczeniu
W raportach rozliczeniowych rejestrowanych jest pięć typów zdarzeń podlegających rozliczeniu. Należą do nich zdarzenia MT i MO, określane jako zdarzenia A2P i P2A.
- A2P (Application-to-Person) to MT (Mobile Terminated) : wiadomość wysyłana przez firmę.
- P2A (Person-to-Application) to MO (Mobile Originated) : wiadomość lub działanie inicjowane przez użytkownika.
W poniższej tabeli opisano każde zdarzenie podlegające rozliczeniu w odniesieniu do agentów konwersacyjnych i niekonwersacyjnych.
| Wydarzenie | Opis | Agenci nieprowadzący rozmów | Agenci konwersacyjni |
|---|---|---|---|
basic_message | Wiadomość A2P zawierająca wyłącznie tekst o długości 160 znaków lub mniej. Jeśli tekst zawiera adres URL witryny z tagami OpenGraph , wiadomość może zawierać podgląd obrazu bez dodatkowych opłat dla partnera. | Zawsze traktowane jako indywidualne zdarzenie podlegające rozliczeniu, niezależnie od tego, czy użytkownik odpowie. | Traktowane jako indywidualne zdarzenie podlegające rozliczeniu, chyba że użytkownik odpowie w ciągu 24 godzin. W takim przypadku wiadomość staje się częścią a2p_conversation . |
single_message | Wiadomość A2P zawierająca bogatą treść lub będąca wyłącznie wiadomością tekstową o długości ponad 160 znaków. | Zawsze traktowane jako indywidualne zdarzenie podlegające rozliczeniu, niezależnie od tego, czy użytkownik odpowie. | Traktowane jako indywidualne zdarzenie podlegające rozliczeniu, chyba że użytkownik odpowie w ciągu 24 godzin. W takim przypadku wiadomość staje się częścią a2p_conversation . |
a2p_conversation (inicjowana przez firmę) | Inicjowane, gdy użytkownik odpowie na wiadomość A2P w ciągu 24 godzin od jej otrzymania, poza trwającą konwersacją. | N/A. Agenci nieprowadzący konwersacji nigdy nie generują tego typu zdarzeń. | Jeśli wiadomość P2A zostanie dostarczona w ciągu 24 godzin od kilku wiadomości A2P, do zainicjowania rozmowy używana jest tylko wiadomość A2P bezpośrednio poprzedzająca wiadomość P2A. Ta wiadomość A2P oraz wszystkie wiadomości dostarczone w ciągu następnych 24 godzin są częścią a2p_conversation . |
p2a_conversation (inicjowane przez użytkownika) | Inicjowane, gdy agent odpowiada na wiadomość P2A w ciągu 24 godzin od jej otrzymania, poza trwającą konwersacją. | N/A. Agenci nieprowadzący konwersacji nigdy nie generują tego typu zdarzeń. | Jeśli wiadomość A2P zostanie dostarczona w ciągu 24 godzin od kilku wiadomości P2A, do zainicjowania konwersacji używana jest tylko wiadomość P2A bezpośrednio poprzedzająca wiadomość A2P. Ta wiadomość P2A oraz wszystkie wiadomości dostarczone w ciągu następnych 24 godzin są częścią p2a_conversation . |
p2a_message | Wiadomość P2A dowolnego typu. | Zawsze traktowane jako indywidualne zdarzenie podlegające rozliczeniu, niezależnie od tego, czy agent odpowie. | Jeśli agent nie odpowie w ciągu 24 godzin, zdarzenie to zostanie potraktowane jako indywidualne zdarzenie podlegające rozliczeniu. |
Kategorie rozliczeniowe a zdarzenia podlegające rozliczeniu
Rozróżnienie między kategoriami rozliczeń agentów i zdarzeniami podlegającymi rozliczeniu jest kluczowe dla zrozumienia sposobu rozliczania agenta.
- Kategoria rozliczeniowa to stała klasyfikacja, którą wybierasz podczas tworzenia agenta. Określa ona metodę rozliczania agenta: za wiadomość (agenci niekonwersacyjni) czy za rozmowę (agenci konwersacyjni).
- Wydarzenia podlegające rozliczeniu to interakcje między agentem RCS for Business a użytkownikiem, które są śledzone na potrzeby rozliczeń (na przykład
basic_message,single_message,a2p_conversation).
Generowanie raportu rozliczeniowego
Tylko agenci z ruchem innym niż testowy generują zdarzenia podlegające rozliczeniu. Aktywność z testowych numerów telefonów nie pojawia się w raportach rozliczeniowych.
W tych raportach zakłada się, że zdarzenia są rozliczane w momencie dostarczenia wiadomości, a nie jej wysłania. Niedostarczona wiadomość lub wiadomość anulowana przed dostarczeniem nie powoduje wygenerowania zdarzenia podlegającego rozliczeniu.
Format raportu rozliczeniowego
Raporty rozliczeniowe używają nazwy pliku w formacie rbm_billable_events_YYYY-MM-DD.csv . Data w nazwie pliku jest datą jego wygenerowania.
Każdy wiersz w raporcie to rekord reprezentujący pojedyncze zdarzenie podlegające rozliczeniu. Pola w rekordzie są rozdzielone tabulatorami. Na przykład, dwie rozmowy A2P z tym samym agentem wygenerują dwa oddzielne zdarzenia podlegające rozliczeniu i dwa rekordy w raporcie rozliczeniowym.
Każdy rekord w raporcie zawiera następujące informacje dla każdego zdarzenia podlegającego rozliczeniu.
| Pole | Format | Opis | Przykład |
|---|---|---|---|
billing_event_id | smyczkowy | Wygenerowany identyfikator, który wyróżnia zdarzenie podlegające rozliczeniu. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff |
type | smyczkowy | Rodzaj wydarzenia:
| single_message |
agent_id | smyczkowy | Unikalny identyfikator agenta, który uczestniczył w zdarzeniu. | rbm-welcome-bot@rbm.goog |
agent_owner | smyczkowy | Adres e-mail aktualnego właściciela konta partnerskiego, na którym utworzono agenta. | name@aggregator.com |
billing_party | smyczkowy | Podmiot wystawiający rachunki za imprezy.
| carrier |
max_duration_single_message | numer | Maksymalny czas (w godzinach) przeznaczony na odpowiedź użytkownika na wiadomość agenta przed zamknięciem okna inicjowania konwersacji i sklasyfikowaniem wiadomości jako zdarzenia single_message . | 24 |
max_duration_a2p_conversation | numer | Maksymalny czas trwania rozmowy A2P w godzinach. Mierzony od pierwszej odpowiedzi użytkownika na pierwszą wiadomość agenta. | 24 |
max_duration_p2a_conversation | numer | Maksymalny czas trwania rozmowy P2A w godzinach. Mierzony od pierwszej wiadomości użytkownika w rozmowie. | 24 |
start_time | RRRR-mm-ddTHH:00:00Z | Data/godzina UTC rozpoczęcia wydarzenia w formacie ISO 8601 zaokrąglona do najbliższej pełnej godziny. Wiadomości A2P
Wiadomości P2A
| 2019-07-25T08:00:00Z |
duration | numer | Czas trwania wydarzenia zaokrąglony do najbliższej minuty. Wartość wynosi 0 dla każdego zdarzenia niemającego charakteru konwersacji. | 45 |
mt_messages | numer | Liczba wiadomości wysłanych przez urządzenie mobilne (A2P) w ramach zdarzenia. | 11 |
mo_messages | numer | Liczba wiadomości wysłanych z urządzenia mobilnego (P2A) w ramach zdarzenia. | 9 |
size_kilobytes | numer | Rozmiar wszystkich plików dołączonych do wiadomości w zdarzeniu, zaokrąglony do najbliższego kilobajta (1 kB to 1024 bajty). | 912 |
agent_name | smyczkowy | Nazwa agenta, który brał udział w zdarzeniu. | XYZ Mobile USA |
owner_name | smyczkowy | Nazwa aktualnego właściciela konta partnerskiego, na którym utworzono agenta. | XYZ Mobile |
Przykładowy raport rozliczeniowy
Przykładowe raporty są dostępne do pobrania:
Typowy rozmiar pliku
Rozmiar raportu dziennego od aktywnego partnera RCS for Business zależy od aktywności wygenerowanej przez niego w sieci operatora. Na przykład, jeśli raport zawiera 53 000 rekordów, rozmiar pliku będzie wynosił około 8 MB.
Dzienniki aktywności
Rejestry aktywności dostarczają surowe dane o aktywności na platformie RCS for Business. Możesz ich używać do audytu zdarzeń podlegających rozliczeniu i tworzenia niestandardowych zdarzeń.
Ponieważ dzienniki aktywności zawierają dane osobowe (PII), takie jak szczegółowe informacje o transakcjach i numery MSISDN abonentów, są one dostępne tylko wtedy, gdy operator obsługuje RCS zgodnie z własnymi Warunkami korzystania z usług. Jeśli w swoich sieciach obsługujesz ruch RCS dla firm i włączysz aktywność RCS w Google RCS zgodnie z Warunkami korzystania z usług Google, nie będziesz mieć dostępu do dzienników aktywności.
Format dziennika aktywności
Dzienniki aktywności używają nazwy pliku w formacie rbm_activity_YYYY-MM-DD.csv . Data w nazwie pliku jest datą wygenerowania pliku.
Pola w rekordzie są rozdzielone tabulatorami. W każdym wierszu znajduje się jeden rekord.
Każdy rekord w dzienniku aktywności zawiera następujące pola dla każdej aktywności:
| Pole | Format | Opis | Przykład |
|---|---|---|---|
activity_id | smyczkowy | Unikalny identyfikator aktywności. | b422e1d3-ac99-442a-853d-a875d5e61762 |
billing_event_id | smyczkowy | Unikalny identyfikator powiązanego zdarzenia płatnego. Może być pusty, jeśli aktywność nie jest powiązana ze zdarzeniem płatnym, takim jak text_message bez odpowiadającego jej delivery_receipt_event . | 91yeb201-7c3b-412b-98d2-b0a0f7abe536 |
agent_id | smyczkowy | Unikalny identyfikator agenta. | welcome-bot@rbm.goog |
user_id | smyczkowy | Numer MSISDN użytkownika. | 918369110173 |
direction | smyczkowy | Kierunek, w którym wysyłana jest wiadomość:
| MT |
time | RRRR-mm-ddTHH:MM:SS.SSSZ | Data i godzina przesłania zdarzenia na platformę RCS for Business w formacie UTC. Zobacz Znaczniki czasu . | 2019-07-25T00:29:07.033Z |
type | smyczkowy | Rodzaj działalności:
| text_message |
size_bytes | smyczkowy | Rozmiar plików dołączonych do aktywności, w bajtach. | 912 |
Znaczniki czasu
Znaczniki czasu w dziennikach aktywności rejestrują moment przesłania zdarzenia na platformę RCS for Business. W przypadku zdarzeń, które dostarczają użytkownikowi treści, zdarzenie nie zostanie zarejestrowane w dzienniku aktywności do momentu dostarczenia wiadomości.
Na przykład, jeśli wiadomość RCS for Business zostanie wysłana do użytkownika w środę o godzinie 13:00, a odbiorca będzie niedostępny do niedzieli do godziny 9:00, zdarzenie pojawi się w dzienniku aktywności wygenerowanym dla niedzieli, ale znacznikiem czasu będzie środa, godzina 13:00.