Na tej stronie opisujemy pliki danych tworzone przez RCS dla firm, które pomagają operatorom w rozliczeniach i audytach. Odpowiedzi na najczęstsze pytania dotyczące modelu płatności za RCS dla firm znajdziesz w sekcji Najczęstsze pytania dotyczące płatności.
| Plik | Opis | Kto ma dostęp |
|---|---|---|
| Raport o zdarzeniach związanych z rozliczeniami | Raport zbiorczy dotyczący zdarzeń podlegających rozliczeniu między uruchomionymi agentami a użytkownikami. | Wszyscy operatorzy, którzy aktywnie obsługują RCS dla firm. |
| Dziennik aktywności | Dziennik danych pierwotnych aktywności RCS for Business, w tym zdarzeń podlegających opłacie. | Operatorzy, którzy aktywnie obsługują RCS Business Messaging i korzystają z usługi Google RCS na podstawie własnych Warunków korzystania z usługi. |
Generowanie pliku
Każdy plik danych zawiera informacje o korzystaniu z RCS dla firm w ciągu jednego dnia według uniwersalnego czasu koordynowanego (UTC). Pliki są generowane codziennie. Proces generowania może potrwać kilka godzin, a czas jego zakończenia może być różny.
W przypadku agentów nieprowadzących rozmów pliki zawierają dane z 24-godzinnego okresu bezpośrednio poprzedzającego czas wygenerowania pliku. Jeśli na przykład raport o zdarzeniach związanych z płatnościami zostanie wygenerowany 5 maja o godzinie 11:00 czasu UTC, będzie zawierać dane z okresu od 4 maja od godziny 11:00 czasu UTC do 5 maja do godziny 11:00 czasu UTC.
W przypadku agentów konwersacyjnych pliki zawierają dane z 24-godzinnego okresu 1–2 dni przed czasem wygenerowania pliku. Jeśli np. raport o zdarzeniach rozliczeniowych zostanie wygenerowany 5 maja o godzinie 11:00 czasu UTC, może zawierać dane z okresu od 3 maja, godz. 11:00 czasu UTC do 4 maja, godz. 11:00 czasu UTC.
Opóźnienie wynika z tego, że aktywność RCS Business Messaging w przypadku agentów rozmowy jest powiązana z rozmowami, które mogą trwać do 48 godzin. To opóźnienie pozwala RCS Business Messaging rejestrować wszystkie wiadomości w rozmowie przed obliczeniem zdarzenia rozliczeniowego. Więcej informacji o agentach konwersacyjnych znajdziesz w artykule Kategorie rozliczeń za agentów.
Najważniejsze kwestie:
Brak aktywności: jeśli w danym dniu nie wystąpi żadna aktywność na platformie, plik nie jest generowany.
Nazewnictwo: data w nazwie pliku to data wygenerowania pliku, a nie data danych w nim zawartych.
Przechowywanie: pliki są przechowywane przez maksymalnie 63 dni, a następnie usuwane.
Za pomocą tych plików możesz aktualizować hurtownię danych o najnowsze dane o korzystaniu z platformy.
Przechowywanie plików i dostęp do nich
Pliki danych są szyfrowane w spoczynku i podczas przesyłania.
Aby pobierać pliki danych za pomocą protokołu SFTP (Secure File Transfer Protocol), podaj swój klucz publiczny SFTP. Aby wygenerować klucze, przeczytaj artykuł Generowanie pary kluczy SSH do użycia ze skrzynką referencyjną SFTP.
Serwer SFTP to partnerupload.google.com, a połączenie odbywa się na porcie o wysokim numerze (19321), co zapewnia dodatkowe bezpieczeństwo.
Aby uzyskać dostęp do plików danych, możesz użyć tego polecenia:
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Google udostępnia nazwy użytkowników kont w tych formatach:
rbmreports-billableevents-<carrier name>rbmreports-activity-<carrier name>
Google określa <carrier name> i udostępnia osobne konto dla każdego typu raportu.
Dostęp do różnych rodzajów raportów jest możliwy za pomocą oddzielnych kont.
Dostępność pliku
Jeśli nie wygenerowano jeszcze żadnych plików danych, zobaczysz błąd SFTP podobny do remote readdir("/"): No such file or directory, co jest oczekiwane.
Jeśli nie ma ruchu RCS dla firm, nie zostanie wygenerowany żaden plik. Oznacza to, że w niektóre dni pliki mogą nie być generowane. Jeśli potrzebujesz pustych plików, aby usprawnić proces, napisz na adres rbm-support@google.com.
Raporty o zdarzeniach związanych z płatnościami
Raporty o zdarzeniach związanych z płatnościami to zapisy zdarzeń związanych z płatnościami, które są obliczane na podstawie kategorii płatności agenta i typu wysyłanych przez niego wiadomości. Raporty o zdarzeniach związanych z płatnościami są dostępne dla wszystkich operatorów, którzy aktywnie korzystają z RCS Business Messaging.
Raporty o zdarzeniach związanych z płatnościami zawierają informacje poufne, ale nie zawierają informacji umożliwiających identyfikację konkretnej osoby, takich jak MSISDN, zaszyfrowany MSISDN ani żaden unikalny identyfikator użytkownika.
Kategorie fakturowania agentów
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 rozliczeniowa nie ogranicza liczby ani rodzaju wiadomości, które może wysłać agent. Określa jednak, w jaki sposób agent będzie obciążany 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 |
|---|---|---|---|
Niekonwersacyjny (Obejmuje kategorie Wiadomość podstawowa i Wiadomość pojedyncza. Uwaga: nie ma już różnicy między tymi dwiema kategoriami. Agent z dowolnej kategorii będzie rozliczany jako agent nieprowadzący rozmowy). |
Agenci, którzy wysyłają głównie wiadomości jednokierunkowe. |
|
Opłaty są naliczane za każdą wiadomość dostarczoną do użytkownika. |
| Konwersacyjny | Agenty zaprojektowane do interakcji z użytkownikami. |
|
Płatność za rozmowę: jeśli jedna ze stron (agent lub użytkownik) odpowie na wiadomość od drugiej strony w ciągu 24 godzin, rozpocznie się rozmowa. W oknie rozmowy (24 godziny od pierwszej odpowiedzi) agent i użytkownik mogą wymieniać dowolną liczbę wiadomości, a agentowi zostanie naliczona stała opłata za rozmowę. Płatność za wiadomość: jeśli agent wyśle wiadomość, na którą użytkownik nie odpowie w ciągu 24 godzin, zostanie obciążony opłatą za tę wiadomość, podobnie jak w przypadku agenta nieprowadzącego rozmowy. |
Na diagramie poniżej przedstawiono przykład sesji rozliczeniowej A2P w przypadku agentów konwersacyjnych:
Agenty konwersacyjne i niekonwersacyjne
Istnieją 2 główne kategorie rozliczeń: konwersacyjne i niekonwersacyjne. Kategoria „Niekonwersacyjna” obejmuje kategorie „Wiadomość podstawowa” i „Pojedyncza wiadomość”, które są funkcjonalnie identyczne. Agenta z dowolnej z tych kategorii rozliczamy jako agenta niekonwersacyjnego.
Kluczowa różnica między kategoriami rozliczeniowymi dotyczy agentów konwersacyjnych i niekonwersacyjnych:
Za każdą wiadomość dostarczoną użytkownikowi przez agentów nieprowadzących rozmowy naliczana jest opłata.
- Ta kategoria jest najlepsza w przypadku agentów, którzy nie oczekują częstych odpowiedzi.
Za rozmowy z agentami konwersacyjnymi pobierana jest stała opłata. Obejmuje ona wszystkie wiadomości wymienione w ciągu 24 godzin.
- Ta kategoria jest najlepsza w przypadku agentów, którzy prowadzą z użytkownikami rozmowy wieloetapowe.
Zdarzenia rozliczeniowe
W raportach o zdarzeniach związanych z płatnościami rejestrowanych jest 5 rodzajów zdarzeń. Obejmują one wiadomości A2P i P2A.
- A2P (Application-to-Person): wysyłane przez firmę.
- P2A (Person-to-Application): wysyłane przez użytkownika.
W tabeli poniżej opisano każde zdarzenie rozliczeniowe w przypadku agentów niekonwersacyjnych i konwersacyjnych.
| Zdarzenie | Opis | Agenty niekonwersacyjne | Agenty konwersacyjne |
|---|---|---|---|
basic_message
|
Wiadomość A2P zawierająca tylko tekst o długości maksymalnie 160 znaków. Jeśli tekst zawiera adres URL witryny z tagami Open Graph, wiadomość może wyświetlać podgląd obrazu bez dodatkowych opłat dla partnera. | Zawsze traktowane jako osobne zdarzenie rozliczeniowe, niezależnie od tego, czy użytkownik odpowie. | Traktowane jako osobne zdarzenie rozliczeniowe, chyba że użytkownik odpowie w ciągu 24 godzin. W takim przypadku wiadomość staje się częścią a2p_conversation.
|
single_message
|
Wiadomość A2P, która zawiera treści multimedialne lub jest wiadomością tekstową o długości powyżej 160 znaków. | Zawsze traktowane jako osobne zdarzenie rozliczeniowe, niezależnie od tego, czy użytkownik odpowie. | Traktowane jako osobne zdarzenie rozliczeniowe, chyba że użytkownik odpowie w ciągu 24 godzin. W takim przypadku wiadomość staje się częścią a2p_conversation.
|
a2p_conversation (inicjowane przez firmę)
|
Rozpoczyna się, gdy użytkownik odpowie na wiadomość A2P w ciągu 24 godzin od jej otrzymania, poza istniejącą rozmową. | Nie dotyczy. Agenci niekonwersacyjni nigdy nie generują tego typu zdarzeń. | Jeśli wiadomość P2A zostanie dostarczona w ciągu 24 godzin od wysłania kilku wiadomości A2P, do rozpoczęcia rozmowy zostanie użyta tylko wiadomość A2P, która bezpośrednio poprzedza wiadomość P2A. Ta wiadomość A2P i wszystkie wiadomości dostarczone w ciągu następnych 24 godzin są częścią a2p_conversation.
|
p2a_conversation (zainicjowane przez użytkownika)
|
Rozpoczyna się, gdy agent odpowie na wiadomość P2A w ciągu 24 godzin od jej otrzymania, poza istniejącą rozmową. | Nie dotyczy. Agenci niekonwersacyjni nigdy nie generują tego typu zdarzeń. | Jeśli wiadomość A2P zostanie dostarczona w ciągu 24 godzin od wysłania kilku wiadomości P2A, do rozpoczęcia rozmowy zostanie użyta tylko wiadomość P2A, która bezpośrednio poprzedza wiadomość A2P. Ta wiadomość P2A i wszystkie wiadomości dostarczone w ciągu następnych 24 godzin są częścią p2a_conversation.
|
p2a_message
|
wiadomości P2A dowolnego typu; | Zawsze traktowane jako osobne zdarzenie rozliczeniowe, niezależnie od tego, czy agent odpowie. | Traktowane jako osobne zdarzenie rozliczeniowe, chyba że pracownik obsługi klienta odpowie w ciągu 24 godzin. |
Zdarzenia płatności a kategorie fakturowania
Zdarzeń rozliczeniowych basic_message i single_message nie należy mylić z kategoriami rozliczeniowymi Wiadomość podstawowa i Wiadomość pojedyncza.
Każdy agent (niezależnie od kategorii rozliczeniowej) może generować zdarzenia rozliczeniowe
basic_messageisingle_message.Kategorie rozliczeniowe Wiadomość podstawowa i Pojedyncza wiadomość służą do klasyfikowania agentów niekonwersacyjnych. Agenci w tych kategoriach rozliczeniowych nie generują zdarzeń rozliczeniowych związanych z rozmową (
a2p_conversationslubp2a_conversations). Zamiast tego generują poszczególne zdarzenia rozliczeniowebasic_message,single_messageip2a_message.
Generowanie raportu rozliczeniowego
Tylko agenty z ruchem niepochodzącym od testerów generują zdarzenia rozliczeniowe. Aktywność z testowych numerów telefonów nie pojawia się w raportach o zdarzeniach związanych z płatnościami.
W tych raportach zakłada się, że zdarzenia są rozliczane w momencie dostarczenia wiadomości, a nie w momencie ich wysłania. Niedostarczona wiadomość lub wiadomość anulowana przed dostarczeniem nie powoduje zdarzenia rozliczeniowego.
Format raportu rozliczeniowego
Raporty o zdarzeniach związanych z płatnościami mają format 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 rozliczeniowe. Pola w rekordzie są oddzielone tabulatorami. Na przykład 2 rozmowy A2P z tym samym agentem wygenerują 2 zdarzenia rozliczeniowe i 2 rekordy w raporcie zdarzeń rozliczeniowych.
Każdy rekord w raporcie zawiera te informacje o każdym zdarzeniu związanym z płatnościami:
| Pole | Format | Opis | Przykład |
|---|---|---|---|
billing_event_id
|
ciąg znaków | Identyfikator UUID. Losowa liczba generowana dla każdego nowego zdarzenia w momencie jego utworzenia. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
|
type
|
ciąg znaków | Typ wydarzenia:
|
single_message
|
agent_id
|
ciąg znaków | Niepowtarzalny identyfikator agenta, który brał udział w zdarzeniu. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
ciąg znaków | Adres e-mail obecnego właściciela konta partnera, na którym utworzono agenta. | name@aggregator.com
|
billing_party
|
ciąg znaków | Podmiot, który wystawia rachunki za wydarzenia.
|
carrier
|
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 i wiadomość zostanie zaklasyfikowana jako zdarzenie single_message.
|
24
|
max_duration_a2p_conversation
|
liczba | Maksymalny czas trwania rozmowy A2P w godzinach. Mierzony od pierwszej odpowiedzi użytkownika na początkową wiadomość agenta. | 24
|
max_duration_p2a_conversation
|
liczba | Maksymalny czas trwania rozmowy P2A w godzinach. Mierzony od pierwszej wiadomości użytkownika w rozmowie. | 24
|
start_time
|
YYYY-mm-ddTHH:00:00Z | Data i godzina rozpoczęcia wydarzenia w formacie ISO 8601 w strefie czasowej UTC zaokrąglone do najbliższej godziny.
Wiadomości A2P
Wiadomości P2A
|
2019-07-25T08:00:00Z
|
duration
|
liczba | Czas trwania wydarzenia zaokrąglony do najbliższej minuty.
Gdy typ zdarzenia to |
45
|
mt_messages
|
liczba | Liczba wiadomości wysłanych na urządzenia mobilne (A2P) w zdarzeniu. | 11
|
mo_messages
|
liczba | Liczba wiadomości wysłanych z urządzeń mobilnych (P2A) w zdarzeniu. | 9
|
size_kilobytes
|
liczba | Rozmiar wszystkich plików załączonych do wiadomości w zdarzeniu zaokrąglony do najbliższego kilobajta (1 KB = 1024 bajtów). | 912
|
agent_name
|
ciąg znaków |
Nazwa agenta, który uczestniczył w zdarzeniu. |
XYZ Mobile USA
|
owner_name
|
ciąg znaków | Nazwa obecnego właściciela konta partnera, na którym utworzono agenta. | XYZ Mobile
|
Przykładowy raport zdarzeń płatności
Przykładowy plik raportu dotyczącego rozliczeń jest dostępny do pobrania.
Typowy rozmiar pliku
Rozmiar dziennego raportu od aktywnego partnera RCS Business Messaging zależy od tego, ile aktywności wygenerował on w sieci operatora. Jeśli na przykład raport zawiera 53 tys. rekordów, plik będzie miał około 8 MB.
Historia aktywności
Dzienniki aktywności zawierają nieprzetworzone dane o aktywności na platformie RCS Business Messaging. Możesz używać tych dzienników do kontrolowania zdarzeń rozliczeniowych i tworzenia zdarzeń niestandardowych.
Uwaga: dzienniki aktywności zawierają tylko ruch z numerów telefonów innych niż numery testerów.
Dzienniki aktywności zawierają informacje umożliwiające identyfikację osoby, takie jak szczegółowe informacje o transakcjach i numery MSISDN subskrybentów, dlatego są dostępne tylko wtedy, gdy operator korzysta z RCS na podstawie własnych Warunków usługi. Jeśli w swoich sieciach masz ruch RCS dla Firm i włączysz aktywność RCS w Google RCS zgodnie z Warunkami korzystania z usługi Google, nie będziesz mieć dostępu do dzienników aktywności.
Format historii aktywności
Dzienniki aktywności mają format nazwy pliku rbm_activity_YYYY-MM-DD.csv. Data w nazwie pliku to data jego wygenerowania.
Pola w rekordzie są rozdzielone znakiem tabulacji, a każdy rekord znajduje się w osobnym wierszu.
Każdy rekord w dzienniku aktywności zawiera te pola w przypadku każdego działania:
| Pole | Format | Opis | Przykład |
|---|---|---|---|
activity_id
|
ciąg znaków | Unikalny identyfikator aktywności. | b422e1d3-ac99-442a-853d-a875d5e61762
|
billing_event_id
|
ciąg znaków | Unikalny identyfikator powiązanego zdarzenia związanego z płatnościami. Może być puste, jeśli aktywność nie jest powiązana z wydarzeniem rozliczeniowym, np. text_message bez odpowiadającego mu delivery_receipt_event.
|
91yeb201-7c3b-412b-98d2-b0a0f7abe536
|
agent_id
|
ciąg znaków | Unikalny identyfikator agenta. | welcome-bot@rbm.goog
|
user_id
|
ciąg znaków | Numer MSISDN użytkownika. | 918369110173
|
direction
|
ciąg znaków | Kierunek, w którym wysyłana jest wiadomość:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | Data i godzina przesłania zdarzenia do platformy RCS Business Messaging w formacie UTC. Zobacz Sygnatury czasowe. | 2019-07-25T00:29:07.033Z
|
type
|
ciąg znaków | Rodzaj aktywności:
|
text_message
|
size_bytes
|
ciąg znaków | Rozmiar plików załączonych do aktywności w bajtach. | 912
|
Sygnatury czasowe
Sygnatury czasowe w dziennikach aktywności rejestrują moment przesłania zdarzenia do platformy RCS for Business. W przypadku zdarzeń, które dostarczają treści użytkownikowi, zdarzenie nie zostanie zarejestrowane w dzienniku aktywności, dopóki wiadomość nie zostanie dostarczona.
Jeśli np. wiadomość RCS dla firm zostanie wysłana do użytkownika w środę o 13:00, a odbiorca będzie offline do niedzieli do 9:00, zdarzenie pojawi się w dzienniku aktywności wygenerowanym w niedzielę, ale sygnatura czasowa będzie wskazywać środę o 13:00.