Na tej stronie opisano pliki danych tworzone przez RCS for Business, aby pomóc amerykańskim przewoźnikom w wystawianiu faktur i przeprowadzaniu audytów w ramach amerykańskich ram RBM. Aby dowiedzieć się więcej o amerykańskich ramach RBM, można również odwiedzić stronę usrbm.org .
Raport rozliczeniowy to zagregowany raport dotyczący zdarzeń podlegających rozliczeniu między uruchomionymi agentami a użytkownikami. „Rozliczalny” oznacza po prostu, że zdarzenie kwalifikuje się do naliczenia opłaty. Operatorzy decydują, czy i w jaki sposób rozliczane są zdarzenia podlegające rozliczeniu. Wszyscy operatorzy w USA, którzy aktywnie korzystają z RCS for Business, mają dostęp do raportów rozliczeniowych.
Aby uzyskać szczegółowe informacje na temat modelu klasyfikacji rozliczeń w USA, zapoznaj się z często zadawanymi pytaniami dotyczącymi rozliczeń w USA .
Generowanie plików
Więcej informacji znajdziesz w artykule Generowanie plików .
Przechowywanie i dostęp do plików
Więcej informacji znajdziesz w artykule Przechowywanie i dostęp do plików .
Dostępność plików
Więcej informacji znajdziesz w sekcji Dostępność plików .
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 rozliczeniowe a zdarzenia podlegające rozliczeniu
Rozróżnienie między kategoriami rozliczeń agentów i zdarzeniami podlegającymi rozliczeniu jest kluczowe dla zrozumienia zasad 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 sesję (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
rich_message).
Kategorie rozliczeń agentów w USA
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. |
| Płatność jest naliczana za każdą wiadomość dostarczoną użytkownikowi. |
| Konwersacyjny | Agenci, których zadaniem jest bezpośrednia wymiana zdań z użytkownikami, niezależnie od tego, kto rozpoczyna rozmowę. |
| Rozliczanie za sesję : Jeżeli spełnione są kryteria sesji, wszystkie bogate i multimedialne wiadomości w ciągu 24-godzinnego okna sesji są rozliczane według stałej stawki, niezależnie od długości lub segmentów. Rozliczanie za wiadomość : Jeśli kryteria sesji nie zostaną spełnione lub wiadomość nie mieści się w 24-godzinnym oknie sesji, wiadomość zostanie rozliczona indywidualnie według stawki za wiadomość z obsługą multimediów lub treści multimedialnych zgodnie z indywidualnym cennikiem operatora. |
Agenci konwersacyjni i niekonwersacyjni
Rozliczenia agentów dzielą się na dwie kategorie: konwersacyjne i niekonwersacyjne.
Agenci nieprowadzący rozmów telefonicznych są rozliczani za każdą wiadomość dostarczoną użytkownikowi.
- Ta kategoria jest najlepsza dla agentów, którzy nie spodziewają się częstych odpowiedzi.
Agenci konwersacyjni są rozliczani według stałej stawki za sesję (sesje) , pod warunkiem, że sesja zostanie zainicjowana. Wówczas będzie ona obejmować wszystkie wiadomości wymienione w ciągu 24 godzin, w tym te, które ją zainicjowały. Agenci konwersacyjni mogą nadal naliczać opłaty za wiadomości, które nie są częścią 24-godzinnej sesji.
- Ta kategoria jest najlepsza dla agentów prowadzących z użytkownikami wieloetapowe rozmowy.
Logika rozliczania sesji
W modelu rozliczeń w USA sesja jest aktywowana sekwencją 4 wiadomości multimedialnych (w tym co najmniej 2 wiadomości MO i co najmniej 1 wiadomości MT) wymienionych w ciągu 24 godzin od wysłania pierwszej wiadomości w sekwencji. Po osiągnięciu tego progu wszystkie wiadomości w tym 24-godzinnym oknie są rozliczane jako pojedyncza sesja . Wiadomości, które nie wchodzą w zakres sesji lub nie uruchamiają jej, są rozliczane według standardowej stawki za wiadomość multimedialną, zgodnie z cennikiem danego operatora.
Poniższy diagram przedstawia przykład sesji rozliczeniowej A2P dla agentów konwersacyjnych.
- MT (Mobile Terminated) to wiadomość wysyłana przez firmę.
- MO (Mobile Originated) to wiadomość lub działanie inicjowane przez użytkownika.
Wydarzenia podlegające rozliczeniu
Przepływy komunikatów są kategoryzowane według ich źródła i kierunku. Aby opisać kierunek ruchu komunikatów, operatorzy amerykańscy zazwyczaj używają terminologii MT/MO . Terminy te odpowiadają terminologii A2P/P2A używanej w dokumentacji RCS for Business. Oto krótkie zestawienie tych terminów:
- 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.
| Wydarzenie | Opis | Agenci nieprowadzący rozmów | Agenci konwersacyjni |
|---|---|---|---|
a2p_rich_message | Wiadomość wysłana przez agenta zawierająca wyłącznie tekst, sugerowane odpowiedzi lub określone sugerowane działania (Wybierz numer, Otwórz adres URL w przeglądarce). | Zawsze traktowane jako pojedyncze zdarzenie podlegające rozliczeniu. Rozliczanie za każdą wiadomość na podstawie segmentów (1 segment to 160 bajtów UTF-8). | Traktowane jako pojedyncze zdarzenie podlegające rozliczeniu, chyba że stanie się częścią sesji. |
p2a_rich_message | Wiadomość wysłana przez użytkownika zawierająca wyłącznie tekst dowolny lub tekst po kliknięciu sugerowanej odpowiedzi. | Zawsze traktowane jako pojedyncze zdarzenie podlegające rozliczeniu. Rozliczanie za każdą wiadomość na podstawie segmentów. | Traktowane jako pojedyncze zdarzenie podlegające rozliczeniu, chyba że stanie się częścią sesji. |
a2p_rich_media_message | Wiadomość wysłana przez agenta zawierająca materiały multimedialne (obrazy, wideo, dźwięk), karty rozszerzone, karuzele lub złożone działania, takie jak „Wyświetl lokalizację”. | Zawsze traktowane jako pojedyncze zdarzenie podlegające rozliczeniu. Można je rozliczać jako pojedyncze wydarzenie o stałej stawce, bez względu na rozmiar lub treść. | Traktowane jako pojedyncze zdarzenie podlegające rozliczeniu, chyba że stanie się częścią sesji. |
p2a_rich_media_message | Wiadomość wysłana przez użytkownika zawierająca przesłany plik multimedialny (obraz, wideo, dźwięk). | Zawsze traktowane jako pojedyncze zdarzenie podlegające rozliczeniu. Rozliczane jako pojedyncze zdarzenie o stałej stawce. | Traktowane jako pojedyncze zdarzenie podlegające rozliczeniu, chyba że stanie się częścią sesji. |
p2a_suggested_action | Użytkownik klika dowolną sugerowaną akcję (np. „Wyświetl lokalizację”), która nie jest sugerowaną odpowiedzią. | Zawsze traktowane jako pojedyncze zdarzenie podlegające rozliczeniu. Generuje jedno zdarzenie płatne za każde kliknięcie. | Traktowane jako pojedyncze zdarzenie podlegające rozliczeniu i generujące jedno zdarzenie podlegające rozliczeniu za każde kliknięcie, chyba że stanie się ono częścią sesji. |
a2p_session | 24-godzinne okno interakcji, które rozpoczyna się w momencie zainicjowania wyzwalacza sesji, a pierwszą wiadomością jest MT. Więcej informacji można znaleźć w artykule Czym jest sesja i jak działa . | Nie dotyczy. Sesje nie dotyczą agentów nieprowadzących rozmów. | Po uruchomieniu wszystkie wiadomości w ciągu 24 godzin są objęte jedną opłatą za sesję. Każde zdarzenie podlegające rozliczeniu w ciągu 24 godzin zostanie przypisane do identyfikatora zdarzenia podlegającego rozliczeniu w ramach sesji. |
p2a_session | 24-godzinne okno interakcji, które rozpoczyna się po zainicjowaniu wyzwalacza sesji, a pierwsza wiadomość to MO. Więcej informacji można znaleźć w artykule Czym jest sesja i jak działa . | Nie dotyczy. Sesje nie dotyczą agentów nieprowadzących rozmów. | Po uruchomieniu wszystkie wiadomości w ciągu 24 godzin są objęte jedną opłatą za sesję. Każde zdarzenie podlegające rozliczeniu w ciągu 24 godzin zostanie przypisane do identyfikatora zdarzenia podlegającego rozliczeniu w ramach sesji. |
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 A2P, a nie wysłania. Niedostarczona wiadomość lub wiadomość anulowana przed dostarczeniem nie powoduje wygenerowania zdarzenia rozliczanego.
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. Sesje A2P/P2A są reprezentowane przez wiele wierszy – po jednym dla każdej wymienionej wiadomości. Każdy wiersz powiązany z sesją (o tym samym billing_event_id ) będzie zawierał w kolumnach mt_messages i mo_messages łączną liczbę wiadomości MT i MO dla całego 24-godzinnego okna sesji.
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. Wszystkie wiadomości będące częścią sesji będą miały ten sam | 63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type | smyczkowy | Rodzaj wydarzenia:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action | p2a_rich_message |
agent_id | smyczkowy | Unikalny identyfikator agenta, który uczestniczył w zdarzeniu. | acme_342h23_agent@rbm.goog |
agent_owner | smyczkowy | Adres e-mail aktualnego właściciela konta partnerskiego, na którym utworzono agenta. | marketing@xyzaggregator.com |
billing_party | smyczkowy | Podmiot wystawiający rachunki za imprezy. | przewoźnik |
max_duration_single_message | numer | Maksymalny czas (w godzinach) dozwolony użytkownikowi na odpowiedź na wiadomość agenta przed zamknięciem okna inicjowania konwersacji i zaklasyfikowaniem wiadomości jako zdarzenia single_message . Nie dotyczy modelu amerykańskiego dla pojedynczych wiadomości wzbogaconych. | 24 |
max_duration_a2p_conversation | numer | W przypadku sesji pilotażowych odzwierciedla to 24-godzinne okno sesji mierzone od pierwszej wiadomości w sekwencji wyzwalającej. Czas trwania jest mierzony w godzinach. | 24 |
max_duration_p2a_conversation | numer | W przypadku sesji pilotażowych odnosi się to do 24-godzinnego okna sesji mierzonego od pierwszej wiadomości w sekwencji wyzwalającej. | 24 |
start_time | RRRR-mm-ddTHH:00:00Z | Data/godzina UTC rozpoczęcia zdarzenia (ISO 8601). W przypadku sesji jest to znacznik czasu pierwszej wiadomości w sekwencji wyzwalacza. A2P a2p_rich_message i a2p_rich_media_message , jest to moment, w którym wiadomość zostaje dostarczona do użytkownika.a2p_session jest to moment, w którym pierwsza wiadomość z konwersacji zostaje dostarczona użytkownikowi.P2A p2a_rich_message i p2a_rich_media_message , jest to moment, w którym użytkownik wysyła wiadomość.p2a_session jest to moment, w którym użytkownik wysyła pierwszą wiadomość w konwersacji. | 2025-05-20T08:00:00Z |
duration | numer | Czas trwania dotyczy tylko sesji i jest mierzony w minutach. Jeśli zdarzenie nie jest zdarzeniem sesji, wartość wynosi 0. | 45 |
mt_messages | numer | Liczba wiadomości zakończonych połączeniem mobilnym (A2P) w zdarzeniu. W przypadku sesji, każdy wiersz o tym samym billing_event_id pokazuje całkowitą liczbę wiadomości MT w całej sesji. | 5 |
mo_messages | numer | Liczba wiadomości wysłanych z urządzenia mobilnego (P2A) w zdarzeniu. W przypadku sesji, każdy wiersz o tym samym billing_event_id pokazuje całkowitą liczbę wiadomości MO w całej sesji. | 3 |
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. | ACME Brand |
owner_name | smyczkowy | Nazwa aktualnego właściciela konta partnerskiego, na którym utworzono agenta. | XYZ Aggregator |
segment_count | numer | Obliczona liczba segmentów dla a2p_rich_message events i p2a_rich_message (1 segment to 160 bajtów UTF-8). Jeśli zdarzenie nie jest jednym z wymienionych, wartość wynosi 0. | 5 |
session_type | smyczkowy | Rodzaj sesji:a2p_sessionp2a_session | a2p_session |
Przykładowy raport rozliczeniowy
Przykładowy raport jest dostępny do pobrania:
Typowy rozmiar pliku
Rozmiar raportu dziennego od aktywnego partnera RCS for Business zależy od ilości aktywności, jaką wygenerował on w sieci operatora.