Na tej stronie opisujemy pliki danych tworzone przez RCS dla firm, aby pomóc operatorom w Stanach Zjednoczonych w rozliczeniach i audytach w ramach amerykańskich zasad RBM. Więcej informacji o amerykańskiej platformie RBM znajdziesz też na stronie usrbm.org.
Raport rozliczeniowy to zbiorczy raport o zdarzeniach podlegających rozliczeniu między uruchomionymi agentami a użytkownikami. Zdarzenie podlegające rozliczeniu to po prostu zdarzenie, za które można naliczyć opłatę. Operatorzy decydują, czy i jak naliczać opłaty za zdarzenia podlegające rozliczeniu. Wszyscy operatorzy w Stanach Zjednoczonych, którzy aktywnie korzystają z RCS dla firm, mają dostęp do raportów rozliczeniowych.
Szczegółowe informacje o modelu klasyfikacji rozliczeń w Stanach Zjednoczonych znajdziesz w odpowiedziach na najczęstsze pytania dotyczące rozliczeń w Stanach Zjednoczonych. US Billing FAQ.
Generowanie pliku
Więcej informacji znajdziesz w artykule Generowanie pliku.
Przechowywanie plików i dostęp do nich
Więcej informacji znajdziesz w artykule Przechowywanie plików i dostęp do nich.
Dostępność pliku
Więcej informacji znajdziesz w artykule Dostępność pliku.
Raporty rozliczeniowe
Raporty rozliczeniowe to zapisy zdarzeń podlegających rozliczeniu, które są obliczane na podstawie kategorii rozliczeń agenta i typu wysyłanych przez niego wiadomości. Raporty rozliczeniowe są dostępne dla wszystkich operatorów, którzy aktywnie korzystają z RCS dla firm.
Raporty rozliczeniowe zawierają informacje poufne, ale nie informacje umożliwiające identyfikację użytkowników (PII), takie jak numer MSISDN, zahaszowany numer MSISDN ani żaden unikalny identyfikator użytkownika.
Kategorie rozliczeń a zdarzenia podlegające rozliczeniu
Rozróżnienie między kategoriami rozliczeń agenta a zdarzeniami podlegającymi rozliczeniu jest kluczowe, aby zrozumieć, jak rozliczany jest Twój agent.
- Kategoria rozliczeń to stała klasyfikacja, którą wybierasz podczas tworzenia agenta. Określa ona sposób rozliczania agenta: za wiadomość (agenty inne niż rozmowy) lub za sesję (agenty rozmowy).
- Zdarzenia podlegające rozliczeniu to interakcje między agentem RCS dla firm a użytkownikiem, które są śledzone na potrzeby rozliczeń (np.
rich_message).
Kategorie rozliczeń agentów w Stanach Zjednoczonych
Podczas tworzenia agenta właściciel ustawia jego kategorię rozliczeń na podstawie tego, jak agent będzie wchodzić w interakcje z użytkownikami. Kategoria rozliczeń nie ogranicza liczby ani typu wiadomości, które agent może wysyłać. Określa jednak, jak agent będzie rozliczany za wiadomości. Dwie główne kategorie rozliczeń opisano w tabeli poniżej.
| Kategoria rozliczeń | Typ agenta | Przykłady użycia | Forma płatności |
|---|---|---|---|
| Usługi inne niż rozmowy | Agenty, które wysyłają głównie wiadomości jednokierunkowe. |
|
Opłata za każdą wiadomość dostarczoną do użytkownika. |
| Rozmowy | Agenty, które są przeznaczone do wymiany wiadomości z użytkownikami niezależnie od tego, kto rozpocznie rozmowę. |
|
Opłata za sesję: jeśli zostaną spełnione kryteria sesji, wszystkie wiadomości z elementami interaktywnymi i multimediami w 24-godzinnym oknie sesji podlegają opłacie ryczałtowej niezależnie od długości i liczby segmentów. Opłata za wiadomość: jeśli kryteria sesji nie zostaną spełnione lub wiadomość wykracza poza 24-godzinne okno sesji, wiadomość jest rozliczana indywidualnie według stawki za wiadomość z elementami interaktywnymi lub multimediami zgodnie z cennikiem danego operatora. |
Agenty rozmowy a agenty inne niż rozmowy
Istnieją 2 kategorie rozliczeń agentów: rozmowy i usługi inne niż rozmowy.
Agenty inne niż rozmowy są rozliczane za każdą wiadomość dostarczoną do użytkownika.
- Ta kategoria jest najlepsza w przypadku agentów, którzy nie oczekują częstych odpowiedzi.
Agenty rozmowy są rozliczane ryczałtowo za sesję lub sesje pod warunkiem że sesja zostanie zainicjowana, a następnie będzie obejmować wszystkie wiadomości wymienione w ciągu 24 godzin, w tym wiadomości, które zainicjowały sesję. Agenci rozmowy mogą nadal ponosić opłaty za wiadomości, które nie są częścią 24-godzinnej sesji.
- Ta kategoria jest najlepsza w przypadku agentów, którzy prowadzą z użytkownikami rozmowy wieloetapowe.
Zasady rozliczania sesji
Zgodnie z modelem rozliczeń w Stanach Zjednoczonych sesja jest wywoływana przez sekwencję 4 wiadomości rich media (w tym co najmniej 2 wiadomości MO i co najmniej 1 wiadomość MT) wymienionych w ciągu 24 godzin od pierwszej wiadomości w sekwencji wyzwalającej. Po osiągnięciu tego progu wszystkie wiadomości w tym 24-godzinnym oknie podlegają opłacie jako jedna sesja. Wszystkie wiadomości, które wykraczają poza sesję lub nie wywołują sesji, podlegają standardowej opłacie za wiadomość za rich media zgodnie z cennikiem danego operatora.
Na diagramie poniżej przedstawiono przykład sesji rozliczeniowej A2P w przypadku agentów rozmowy.
- MT (Mobile Terminated) to wiadomość wysłana przez firmę.
- MO (Mobile Originated) to wiadomość lub działanie zainicjowane przez użytkownika.
Zdarzenia podlegające rozliczeniu
Schematy wysyłania wiadomości są podzielone według źródła i kierunku. Aby opisać kierunek ruchu wiadomości, operatorzy w Stanach Zjednoczonych używają zwykle terminologii MT/MO. Te terminy odpowiadają terminologii A2P/P2A używanej w całej dokumentacji RCS dla firm. Oto krótkie podsumowanie, jak te terminy są powiązane:
- A2P (Application-to-Person) to MT (Mobile Terminated): wiadomość wysłana przez firmę.
- P2A (Person-to-Application) to MO (Mobile Originated): wiadomość lub działanie zainicjowane przez użytkownika.
| Zdarzenie | Opis | Agenty inne niż rozmowy | Agenty rozmowy |
|---|---|---|---|
a2p_rich_message |
Wiadomość wysłana przez agenta zawierająca tylko tekst, sugerowane odpowiedzi lub konkretne sugerowane działania (wybierz numer, otwórz adres URL w przeglądarce). | Zawsze traktowana jako pojedyncze zdarzenie podlegające rozliczeniu. Rozliczana za wiadomość na podstawie segmentów (1 segment to 160 bajtów UTF-8). |
Traktowana jako pojedyncze zdarzenie podlegające rozliczeniu, chyba że stanie się częścią sesji. |
p2a_rich_message |
Wiadomość wysłana przez użytkownika zawierająca tylko tekst w dowolnej formie lub tekst po kliknięciu sugerowanej odpowiedzi. | Zawsze traktowana jako pojedyncze zdarzenie podlegające rozliczeniu. Rozliczana za wiadomość na podstawie segmentów. |
Traktowana jako pojedyncze zdarzenie podlegające rozliczeniu, chyba że stanie się częścią sesji. |
a2p_rich_media_message |
Wiadomość wysłana przez agenta zawierająca multimedia (obraz, film, dźwięk), karty z elementami interaktywnymi, karuzele lub złożone działania, takie jak „Wyświetl lokalizację”. | Zawsze traktowana jako pojedyncze zdarzenie podlegające rozliczeniu. Rozliczana jako pojedyncze zdarzenie ryczałtowe niezależnie od rozmiaru i treści. |
Traktowana 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, film, dźwięk). | Zawsze traktowana jako pojedyncze zdarzenie podlegające rozliczeniu. Rozliczana jako pojedyncze zdarzenie ryczałtowe. |
Traktowana jako pojedyncze zdarzenie podlegające rozliczeniu, chyba że stanie się częścią sesji. |
p2a_suggested_action |
Użytkownik klika dowolne sugerowane działanie (np. „Wyświetl lokalizację”), które nie jest sugerowaną odpowiedzią. | Zawsze traktowana jako pojedyncze zdarzenie podlegające rozliczeniu. Generuje jedno zdarzenie podlegające rozliczeniu na kliknięcie. |
Traktowana jako pojedyncze zdarzenie podlegające rozliczeniu i generuje jedno zdarzenie podlegające rozliczeniu na kliknięcie, chyba że stanie się częścią sesji. |
a2p_session |
24-godzinne okno interakcji, które rozpoczyna się po zainicjowaniu wyzwalacza sesji i wysłaniu pierwszej wiadomości MT. Więcej informacji znajdziesz w artykule Co to jest sesja i jak działa. | Nie dotyczy. Sesje nie dotyczą agentów innych niż rozmowy. | Po wywołaniu wszystkie wiadomości w 24-godzinnym oknie są objęte jedną opłatą za sesję. Każde zdarzenie podlegające rozliczeniu w 24-godzinnej sesji zostanie przypisane do identyfikatora zdarzenia podlegającego rozliczeniu w sesji. |
p2a_session |
24-godzinne okno interakcji, które rozpoczyna się po zainicjowaniu wyzwalacza sesji i wysłaniu pierwszej wiadomości MO. Więcej informacji znajdziesz w artykule Co to jest sesja i jak działa. | Nie dotyczy. Sesje nie dotyczą agentów innych niż rozmowy. | Po wywołaniu wszystkie wiadomości w 24-godzinnym oknie są objęte jedną opłatą za sesję. Każde zdarzenie podlegające rozliczeniu w 24-godzinnej sesji zostanie przypisane do identyfikatora zdarzenia podlegającego rozliczeniu w sesji. |
Generowanie raportu rozliczeniowego
Tylko agenty z ruchem innym niż testowy generują zdarzenia podlegające rozliczeniu. Aktywność z testowych numerów telefonów nie pojawia się w raportach rozliczeniowych.
Te raporty zakładają, że zdarzenia podlegają rozliczeniu, gdy wiadomości A2P zostaną dostarczone, a nie gdy zostaną wysłane. Niedostarczona wiadomość lub wiadomość anulowana przed dostarczeniem nie wywołuje zdarzenia podlegającego rozliczeniu.
Format raportu rozliczeniowego
Raporty rozliczeniowe używają formatu nazwy pliku rbm_billable_events_YYYY-MM-DD.csv.
Data w nazwie pliku to data wygenerowania pliku.
Każdy wiersz w raporcie to rekord reprezentujący pojedyncze zdarzenie podlegające rozliczeniu.
Sesje A2P/P2A są reprezentowane przez wiele wierszy – po jednym na każdą wymienioną wiadomość. Każdy wiersz powiązany z sesją (mający ten sam billing_event_id) będzie zawierać łączną liczbę wiadomości MT i MO w całym 24-godzinnym oknie sesji w kolumnach mt_messages i mo_messages.
Każdy rekord w raporcie zawiera te informacje o każdym zdarzeniu podlegającym rozliczeniu.
| Pole | Format | Opis | Przykład |
|---|---|---|---|
billing_event_id |
tekst | Wygenerowany identyfikator, który odróżnia zdarzenie podlegające rozliczeniu. Wszystkie wiadomości, które są częścią sesji, będą miały ten sam |
63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type |
tekst | Typ zdarzenia:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action |
p2a_rich_message |
agent_id |
tekst | Unikalny identyfikator agenta, który uczestniczył w zdarzeniu. | acme_342h23_agent@rbm.goog |
agent_owner |
tekst | Adres e-mail obecnego właściciela konta partnera, na którym utworzono agenta. | marketing@xyzaggregator.com |
billing_party |
tekst | Strona, która rozlicza zdarzenia. | operator |
max_duration_single_message |
liczba | Maksymalny czas (w godzinach), w którym użytkownik może odpowiedzieć na wiadomość agenta, zanim zamknie się okno rozpoczęcia rozmowy, a wiadomość zostanie sklasyfikowana jako zdarzenie single_message. Nie dotyczy modelu w Stanach Zjednoczonych w przypadku pojedynczych wiadomości z elementami interaktywnymi. |
24 |
max_duration_a2p_conversation |
liczba | W przypadku pilotażowych sesji 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 |
liczba | W przypadku pilotażowych sesji odzwierciedla to 24-godzinne okno sesji mierzone od pierwszej wiadomości w sekwencji wyzwalającej. | 24 |
start_time |
YYYY-mm-ddTHH:00:00Z | Data i godzina rozpoczęcia zdarzenia w UTC (ISO 8601). W przypadku sesji jest to sygnatura czasowa pierwszej wiadomości w sekwencji wyzwalającej. A2P a2p_rich_message i a2p_rich_media_message, jest to czas dostarczenia wiadomości do użytkownika.a2p_session jest to czas dostarczenia pierwszej wiadomości w rozmowie do użytkownika.P2A p2a_rich_message i p2a_rich_media_message, jest to czas wysłania wiadomości przez użytkownika.p2a_session jest to czas wysłania pierwszej wiadomości w rozmowie przez użytkownika. |
2025-05-20T08:00:00Z |
duration |
liczba | Czas trwania dotyczy tylko sesji i jest mierzony w minutach. Gdy zdarzenie nie jest sesją, wartość wynosi 0. | 45 |
mt_messages |
liczba | Liczba wiadomości MT (A2P) w zdarzeniu. W przypadku sesji każdy wiersz mający ten sam billing_event_id pokazuje łączną liczbę wiadomości MT w całej sesji. |
5 |
mo_messages |
liczba | Liczba wiadomości MO (P2A) w zdarzeniu. W przypadku sesji każdy wiersz mający ten sam billing_event_id pokazuje łączną liczbę wiadomości MO w całej sesji. |
3 |
size_kilobytes |
liczba | 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 |
tekst | Nazwa agenta, który uczestniczył w zdarzeniu. | ACME Brand |
owner_name |
tekst | Nazwa obecnego właściciela konta partnera, na którym utworzono agenta. | XYZ Aggregator |
segment_count |
liczba | Obliczona liczba segmentów w przypadku zdarzeń a2p_rich_message events i p2a_rich_message (1 segment to 160 bajtów UTF-8). Gdy zdarzenie nie jest jednym z wymienionych, wartość wynosi 0. |
5 |
session_type |
tekst | Typ sesji:a2p_sessionp2a_session |
a2p_session |
Przykładowy raport rozliczeniowy
Przykładowy raport można pobrać:
Typowy rozmiar pliku
Rozmiar dziennego raportu od aktywnego partnera RCS dla firm zależy od tego, ile aktywności wygenerował on w sieci operatora.