Na tej stronie opisujemy pliki danych tworzone przez RCS dla firm, które pomagają operatorom w rozliczeniach i audytach.
| Plik | Opis | Kto ma dostęp |
|---|---|---|
| Raport rozliczeniowy | Raport zbiorczy dotyczący zdarzeń podlegających rozliczeniu między uruchomionymi agentami a użytkownikami. | Wszyscy operatorzy, którzy aktywnie korzystają z RCS dla firm. |
| Historia aktywności | Dziennik danych pierwotnych aktywności RCS dla firm, w tym zdarzeń podlegających opłacie. | Operatorzy, którzy aktywnie obsługują RCS dla firm i świadczą usługę RCS od Google na podstawie własnych Warunków korzystania z usługi. |
RCS dla firm korzysta ze standardowego modelu rozliczeń w przypadku ruchu spoza Stanów Zjednoczonych. Szczegółowe informacje znajdziesz w odpowiedziach na najczęstsze pytania dotyczące płatności.
Generowanie pliku
Każdy plik danych zawiera informacje o wykorzystaniu RCS dla firm w ciągu jednego dnia w czasie pacyficznym standardowym (PST). Pliki są generowane codziennie i odzwierciedlają aktywność z poprzednich 24 godzin (od północy do północy). Proces generowania może potrwać 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 zawiera dane z okresu od 4 maja od godziny 00:00 do 5 maja do godziny 00:00. Podana godzina jest w strefie czasowej PST.
W przypadku agentów konwersacyjnych pliki zawierają dane z 24-godzinnego okresu 1–2 dni przed czasem wygenerowania pliku. Na przykład raport wygenerowany 5 maja zawiera dane z 24-godzinnego okresu 2 lub 3 maja. Podana godzina jest w strefie czasowej PST.
Opóźnienie wynika z tego, że aktywność RCS dla firm w przypadku agentów rozmowy jest powiązana z sesjami, których ukończenie może zająć do 24 godzin. Ten czas oczekiwania pozwala RCS dla firm zarejestrować wszystkie wiadomości w rozmowie przed obliczeniem zdarzenia podlegającego opłacie. Więcej informacji o agentach konwersacyjnych znajdziesz w artykule Kategorie rozliczeń za agentów.
Najważniejsze kwestie:
- Brak aktywności: domyślnie, jeśli w danym dniu nie ma aktywności na platformie, nie jest generowany żaden plik. W razie potrzeby możesz jednak włączyć otrzymywanie pustych plików. Aby się zarejestrować, napisz na adres rbm-support@google.com.
- 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 podaje 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, który można by uwzględnić w raporcie, plik nie zostanie wygenerowany. Oznacza to, że w niektóre dni pliki mogą nie być generowane. Jeśli potrzebujesz pustych plików, aby usprawnić ten proces, skontaktuj się z zespołem pomocy RCS dla firm.
Raporty rozliczeniowe
Raporty rozliczeniowe to zapisy zdarzeń podlegających rozliczeniu, które są obliczane na podstawie kategorii rozliczeń agenta i rodzaju wysyłanych przez niego wiadomości. Raporty dotyczące płatności 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ę konkretnej osoby, takich jak MSISDN, zaszyfrowany MSISDN ani żaden unikalny identyfikator użytkownika.
Kategorie rozliczeń 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 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 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 |
|---|---|---|---|
| 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 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, agent 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 a agenty inne niż konwersacyjne
Istnieją 2 główne kategorie rozliczeń: konwersacyjne i niekonwersacyjne.
Główna różnica między kategoriami rozliczeniowymi dotyczy agentów konwersacyjnych i niekonwersacyjnych:
Za każdą wiadomość dostarczoną do użytkownika pobierana 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. Rozmowy obejmują wszystkie wiadomości wymienione w ciągu 24 godzin.
- Ta kategoria jest najlepsza w przypadku agentów, którzy prowadzą z użytkownikami wieloetapowe rozmowy.
Zdarzenia podlegające rozliczeniu
W raportach rozliczeniowych rejestrowanych jest 5 rodzajów zdarzeń podlegających opłacie. Te zdarzenia obejmują zdarzenia MT i MO, które są określane jako zdarzenia A2P i P2A.
- 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.
W tabeli poniżej znajdziesz opis każdego zdarzenia podlegającego opłacie w przypadku agentów nieprowadzących i prowadzących rozmowy.
| Zdarzenie | Opis | Agenty inne niż konwersacyjne | 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 podlegające opłacie, niezależnie od tego, czy użytkownik odpowie. | Traktowane jako osobne zdarzenie podlegające opłacie, 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 szczegółowe treści lub jest wiadomością tekstową o długości powyżej 160 znaków. | Zawsze traktowane jako osobne zdarzenie podlegające opłacie, niezależnie od tego, czy użytkownik odpowie. | Traktowane jako osobne zdarzenie podlegające opłacie, 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 nieprowadzący rozmów 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 nieprowadzący rozmów 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 należą do p2a_conversation.
|
p2a_message
|
wiadomości P2A dowolnego typu; | Zawsze traktowane jako osobne zdarzenie podlegające opłacie, niezależnie od tego, czy agent odpowie. | Traktowane jako osobne zdarzenie podlegające opłacie, chyba że pracownik obsługi klienta odpowie w ciągu 24 godzin. |
Kategorie rozliczeń a zdarzenia podlegające rozliczeniu
Rozróżnienie między kategoriami płatności za agenta a zdarzeniami podlegającymi opłacie ma kluczowe znaczenie dla zrozumienia, jak 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 nieprowadzący rozmów) lub za rozmowę (agenci prowadzący rozmowy).
- Zdarzenia podlegające rozliczeniu to interakcje między agentem RCS dla firm a użytkownikiem, które są śledzone na potrzeby rozliczeń (np.
basic_message,single_message,a2p_conversation).
Generowanie raportu rozliczeniowego
Tylko agenty z ruchem pochodzącym od osób niebędących testerami 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 w momencie ich wysłania. Nie dostarczona wiadomość lub wiadomość anulowana przed dostarczeniem nie powoduje zdarzenia podlegającego opłacie.
Format raportu rozliczeniowego
Raporty rozliczeniowe mają format 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. Pola w rekordzie są rozdzielone tabulatorami. Na przykład 2 rozmowy A2P z tym samym agentem wygenerują 2 osobne zdarzenia podlegające opłacie i 2 rekordy w raporcie rozliczeniowym.
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. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
|
type
|
tekst | Typ wydarzenia:
|
single_message
|
agent_id
|
tekst | Unikalny identyfikator agenta, który brał udział w zdarzeniu. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
tekst | Adres e-mail obecnego właściciela konta partnera, na którym utworzono agenta. | name@aggregator.com
|
billing_party
|
tekst | 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, a 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 wiadomość początkową 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.
W przypadku każdego zdarzenia niezwiązanego z konwersacją wartość wynosi 0. |
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 telefonu komórkowego (P2A) w zdarzeniu. | 9
|
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. |
XYZ Mobile USA
|
owner_name
|
tekst | Nazwa bieżącego właściciela konta partnera, na którym utworzono agenta. | XYZ Mobile
|
Przykładowy raport rozliczeniowy
Przykładowe raporty 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. 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 dla firm. Możesz używać tych dzienników do kontrolowania zdarzeń podlegających rozliczeniu i tworzenia zdarzeń niestandardowych.
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 RCS Google zgodnie z Warunkami korzystania z usług 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 wygenerowania pliku.
Pola w rekordzie są rozdzielone znakiem tabulacji, a każdy rekord znajduje się w osobnym wierszu.
Każdy rekord w historii aktywności zawiera te pola w przypadku każdej aktywności:
| Pole | Format | Opis | Przykład |
|---|---|---|---|
activity_id
|
tekst | Unikalny identyfikator aktywności. | b422e1d3-ac99-442a-853d-a875d5e61762
|
billing_event_id
|
tekst | Unikalny identyfikator powiązanego zdarzenia podlegającego rozliczeniu. Może być pusta, jeśli aktywność nie jest powiązana z wydarzeniem podlegającym rozliczeniu, np. text_message bez odpowiadającego mu delivery_receipt_event.
|
91yeb201-7c3b-412b-98d2-b0a0f7abe536
|
agent_id
|
tekst | Unikalny identyfikator agenta. | welcome-bot@rbm.goog
|
user_id
|
tekst | Numer MSISDN użytkownika. | 918369110173
|
direction
|
tekst | Kierunek, w którym wysyłana jest wiadomość:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | Data i godzina przesłania zdarzenia na platformę RCS dla firm w formacie UTC. Zobacz Sygnatury czasowe. | 2019-07-25T00:29:07.033Z
|
type
|
tekst | Rodzaj aktywności:
|
text_message
|
size_bytes
|
tekst | 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 dla firm. W przypadku zdarzeń, które dostarczają treści do użytkownika, 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.