Na tej stronie opisujemy pliki danych tworzone przez RCS dla firm, aby pomagać amerykańskim operatorom w rozliczeniach i audytach w ramach amerykańskich zasad RBM. Więcej informacji o ramach RBM w Stanach Zjednoczonych znajdziesz na stronie usrbm.org.
Raport rozliczeniowy to zbiorczy raport o zdarzeniach podlegających opłacie, które wystąpiły między uruchomionymi agentami a użytkownikami. Zdarzenie naliczane do rachunku to takie, za które można pobrać opłatę. Operatorzy określają, czy i w jaki sposób naliczane są opłaty za zdarzenia podlegające rozliczeniu. Wszyscy operatorzy w Stanach Zjednoczonych, którzy aktywnie obsługują RCS dla firm, mają dostęp do raportów rozliczeniowych.
Szczegółowe informacje o modelu klasyfikacji płatności w Stanach Zjednoczonych znajdziesz w odpowiedziach na najczęstsze pytania dotyczące płatności w Stanach Zjednoczonych.
Generowanie plików
Więcej informacji znajdziesz w sekcji Generowanie plików.
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 sekcji Dostępność plików.
Raporty rozliczeniowe
Raporty rozliczeniowe to zapisy zdarzeń podlegających opłacie, które są obliczane na podstawie kategorii rozliczeniowej 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 zawierają informacji umożliwiających identyfikację użytkownika, takich jak MSISDN, zaszyfrowany MSISDN ani żaden unikalny identyfikator użytkownika.
Kategorie rozliczeń a zdarzenia podlegające rozliczeniu
Rozróżnienie między kategoriami płatności a zdarzeniami podlegającymi opłacie jest kluczowe, aby zrozumieć, w jaki sposób naliczane są opłaty za agenta.
- Kategoria płatności to stała klasyfikacja, którą wybierasz podczas tworzenia agenta. Określa metodę rozliczania agenta: za wiadomość (agenci niekonwersacyjni) lub za sesję (agenci konwersacyjni).
- Zdarzenia naliczane do rachunku 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 określa jego kategorię rozliczeniową na podstawie tego, jak agent będzie wchodzić w interakcje z użytkownikami. Kategoria rozliczeń nie ogranicza liczby ani rodzaju wiadomości, które może wysyłać agent. Określa jednak, w jaki sposób agent będzie rozliczany za wiadomości. Dwie główne kategorie rozliczeń zostały opisane w tej tabeli.
| Kategoria fakturowania | Typ agenta | Przykłady użycia | Forma płatności |
|---|---|---|---|
| Usługi inne niż rozmowy | Agenci, którzy wysyłają głównie wiadomości w jedną stronę. |
|
Opłaty są naliczane za każdą wiadomość dostarczoną do użytkownika. |
| Konwersacyjny | Agenty przeznaczone do prowadzenia rozmów z użytkownikami niezależnie od tego, kto je rozpoczyna. |
|
Płatność za sesję: jeśli kryteria sesji zostaną spełnione, wszystkie wiadomości z elementami multimedialnymi i wzbogacone w 24-godzinnym oknie sesji są rozliczane według stałej stawki, niezależnie od długości i segmentów. Płatność za wiadomość: jeśli kryteria sesji nie zostaną spełnione lub wiadomość wykracza poza 24-godzinne okno sesji, jest ona rozliczana indywidualnie według stawki za wiadomość z elementami multimedialnymi lub wzbogaconą zgodnie z cennikiem danego operatora. |
Agenci konwersacyjni a agenci niekonwersacyjni
Istnieją 2 kategorie fakturowania agentów: konwersacyjni i niekonwersacyjni.
Agenci nieprowadzący rozmów są rozliczani za każdą wiadomość, którą dostarczają użytkownikowi.
- Ta kategoria jest najlepsza w przypadku agentów, którzy nie oczekują częstych odpowiedzi.
Za agentów konwersacyjnych pobierana jest stała opłata za sesję, jeśli sesja zostanie wywołana. Obejmuje ona wszystkie wiadomości wymienione w ciągu 24 godzin, w tym wiadomości, które wywołały sesję. Agenty konwersacyjne mogą nadal naliczać 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.
Logika rozliczeń sesji
W modelu rozliczeniowym 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 wywołującej. Gdy ten próg zostanie osiągnięty, wszystkie wiadomości w tym 24-godzinnym okresie będą rozliczane jako jedna sesja. Wiadomości, które nie mieszczą się w sesji lub nie powodują jej rozpoczęcia, są rozliczane według standardowej stawki za wiadomość w przypadku wiadomości multimedialnych lub rich media zgodnie z tabelą stawek poszczególnych operatorów.
Na diagramie poniżej przedstawiono przykład sesji rozliczeniowej A2P w przypadku agentów konwersacyjnych.
- 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
Przepływy wiadomości są kategoryzowane według pochodzenia i kierunku. Aby opisać kierunek ruchu wiadomości, amerykańscy operatorzy zwykle używają terminologii MT/MO. Te terminy odpowiadają terminologii A2P/P2A używanej w dokumentacji RCS dla firm. Oto krótkie podsumowanie, jak te terminy są ze sobą 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ż konwersacyjne | Agenty konwersacyjne |
|---|---|---|---|
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 traktowane jako osobne zdarzenie podlegające opłacie. Opłata za wiadomość jest naliczana na podstawie segmentów (1 segment to 160 bajtów UTF-8). |
Traktowane jako osobne zdarzenie podlegające opłacie, chyba że stanie się częścią sesji. |
p2a_rich_message |
Wiadomość wysłana przez użytkownika zawierająca tylko tekst wpisany ręcznie lub tekst uzyskany po kliknięciu sugerowanej odpowiedzi. | Zawsze traktowane jako osobne zdarzenie podlegające opłacie. Opłata za wiadomość na podstawie segmentów. |
Traktowane jako osobne zdarzenie podlegające opłacie, 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 informacyjne, karuzele lub złożone działania, takie jak „Wyświetl lokalizację”. | Zawsze traktowane jako osobne zdarzenie podlegające opłacie. Rozliczane jako pojedyncze zdarzenie o stałej stawce niezależnie od rozmiaru i treści. |
Traktowane jako osobne zdarzenie podlegające opłacie, 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 traktowane jako osobne zdarzenie podlegające opłacie. Rozliczane jako pojedyncze zdarzenie o stałej stawce. |
Traktowane jako osobne zdarzenie podlegające opłacie, chyba że stanie się częścią sesji. |
p2a_suggested_action |
Użytkownik kliknie dowolne sugerowane działanie (np. „Wyświetl lokalizację”), które nie jest sugerowaną odpowiedzią. | Zawsze traktowane jako osobne zdarzenie podlegające opłacie. Generuje 1 zdarzenie podlegające rozliczeniu na kliknięcie. |
Jest traktowane jako osobne zdarzenie podlegające opłacie i generuje 1 zdarzenie podlegające opłacie 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 przez MT. Więcej informacji znajdziesz w artykule Czym jest sesja i jak działa. | Nie dotyczy. Sesje nie mają zastosowania do agentów niekonwersacyjnych. | Po uruchomieniu wszystkie wiadomości w 24-godzinnym okresie są objęte jedną opłatą za sesję. Każde zdarzenie, które stanowi podstawę do naliczenia przychodu w 24-godzinnej sesji, zostanie przypisane do identyfikatora zdarzenia, które stanowi podstawę do naliczenia przychodu w sesji. |
p2a_session |
24-godzinne okno interakcji, które rozpoczyna się w momencie zainicjowania wyzwalacza sesji i wysłania pierwszej wiadomości MO. Więcej informacji znajdziesz w artykule Czym jest sesja i jak działa. | Nie dotyczy. Sesje nie mają zastosowania do agentów niekonwersacyjnych. | Po uruchomieniu wszystkie wiadomości w 24-godzinnym okresie są objęte jedną opłatą za sesję. Każde zdarzenie, które stanowi podstawę do naliczenia przychodu w 24-godzinnej sesji, zostanie przypisane do identyfikatora zdarzenia, które stanowi podstawę do naliczenia przychodu w sesji. |
Generowanie raportu rozliczeniowego
Tylko agenty z ruchem pochodzącym od osób niebędących testerami generują zdarzenia podlegające rozliczeniu. Aktywność z numerów telefonów testowych nie pojawia się w raportach rozliczeniowych.
W tych raportach zakłada się, że zdarzenia są płatne, gdy wiadomości A2P są dostarczane, a nie gdy są wysyłane. Nie dostarczona wiadomość lub wiadomość anulowana przed dostarczeniem nie powoduje zdarzenia podlegającego opłacie.
Format raportu rozliczeniowego
Raporty rozliczeniowe używają formatu nazwy pliku rbm_billable_events_YYYY-MM-DD.csv.
Data w nazwie pliku to data 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 na każdą wymienioną wiadomość. Każdy wiersz powiązany z sesją (mający ten sam identyfikator 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.
Pliki są kodowane w UTF-8 bez znacznika kolejności bajtów i używają znaków końca linii. Pierwszy wiersz każdego pliku to wiersz nagłówka z nazwami pól.
Każdy rekord w raporcie zawiera te informacje o każdym zdarzeniu podlegającym opłacie.
| Pole | Format | Opis | Przykład |
|---|---|---|---|
billing_event_id |
tekst | Wygenerowany identyfikator, który odróżnia zdarzenie podlegające opłacie. Wszystkie wiadomości w sesji będą miały ten sam parametr |
63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type |
tekst | Typ wydarzenia:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action |
p2a_rich_message |
agent_id |
tekst | Unikalny identyfikator agenta, który brał udział 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 | Podmiot, który wystawia rachunki za wydarzenia. | operator |
max_duration_single_message |
liczba | Maksymalny czas (w godzinach), w którym użytkownik może odpowiedzieć na wiadomość agenta, zanim okno rozpoczęcia rozmowy zostanie zamknięte, a wiadomość zostanie zaklasyfikowana jako zdarzenie single_message. Nie dotyczy modelu w Stanach Zjednoczonych w przypadku pojedynczych wiadomości z elementami multimedialnymi. |
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 wydarzenia w formacie 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, w którym pierwsza wiadomość w rozmowie została dostarczona 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, w którym użytkownik wysyła pierwszą wiadomość w rozmowie. |
2025-05-20T08:00:00Z |
duration |
liczba | Czas trwania dotyczy tylko sesji i jest mierzony w minutach. Gdy zdarzenie nie jest zdarzeniem sesji, wartość wynosi 0. | 45 |
mt_messages |
liczba | Liczba wiadomości wysłanych na urządzenia mobilne (A2P) w zdarzeniu. W przypadku sesji każdy wiersz z tym samym symbolem billing_event_id pokazuje łączną liczbę wiadomości MT w całej sesji. |
5 |
mo_messages |
liczba | Liczba wiadomości wysłanych z telefonu komórkowego (P2A) w zdarzeniu. W przypadku sesji każdy wiersz z tym samym symbolem billing_event_id pokazuje łączną liczbę wiadomości MO w całej sesji. |
3 |
size_kilobytes |
liczba | Rozmiar wszystkich plików załączonych do wiadomości w wydarzeniu, 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 bieżącego właściciela konta partnera, na którym utworzono agenta. | XYZ Aggregator |
segment_count |
liczba | Obliczona liczba segmentów dla zdarzeń 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 |
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.