На этой странице описаны файлы данных, которые RCS for Business создает для оказания помощи американским операторам связи в выставлении счетов и проведении аудита в рамках американской системы управления рисками (RBM Framework). Для получения дополнительной информации об американской системе RBM Framework вы также можете обратиться к сайту usrbm.org .
Отчет о выставлении счетов — это сводный отчет о событиях, подлежащих оплате, между запущенными агентами и пользователями. Под «подлежащими оплате» понимается событие, за которое может быть произведена оплата. Операторы связи определяют, будут ли и как производиться платежи за события, подлежащие оплате. Все операторы связи США, активно использующие RCS for Business, имеют доступ к отчетам о выставлении счетов.
Подробную информацию о модели классификации счетов в США см. в разделе « Часто задаваемые вопросы о выставлении счетов в США» .
Генерация файлов
Для получения более подробной информации см. раздел «Генерация файлов» .
Хранение и доступ к файлам
Для получения дополнительной информации см. раздел «Хранение и доступ к файлам» .
Доступность файлов
Для получения более подробной информации см. раздел «Доступность файла» .
Отчеты по выставлению счетов
Отчеты по выставлению счетов представляют собой записи о событиях, подлежащих оплате , которые рассчитываются на основе категории выставления счетов агента и типа отправляемых им сообщений. Отчеты по выставлению счетов доступны всем операторам связи, активно использующим RCS for Business.
В платежных отчетах содержится конфиденциальная информация, но в них отсутствуют персональные данные пользователей, такие как MSISDN, хешированный MSISDN или любой другой уникальный идентификатор пользователя.
Категории выставления счетов против событий, подлежащих оплате
Различие между категориями выставления счетов агентам и оплачиваемыми событиями является ключевым моментом для понимания того, как оплачивается работа вашего агента.
- Категория оплаты — это фиксированная классификация, которую вы выбираете при создании своего агента. Она определяет способ оплаты услуг вашего агента: за сообщение (для не диалоговых агентов) или за сессию (для диалоговых агентов).
- Платежные события — это взаимодействия между агентом RCS for Business и пользователем, которые отслеживаются в целях выставления счетов (например,
rich_message).
Категории выставления счетов агентам в США
При создании агента владелец устанавливает категорию оплаты в зависимости от того, как агент будет взаимодействовать с пользователями. Категория оплаты не ограничивает количество или тип сообщений, которые может отправлять агент. Но она определяет, как агент будет оплачивать сообщения. Две основные категории оплаты описаны в следующей таблице.
| Категория выставления счетов | Тип агента | Примеры вариантов использования | Способ выставления счетов |
|---|---|---|---|
| Неразговорный | Агенты, которые в основном передают односторонние сообщения. |
| Плата взимается за каждое сообщение, доставленное пользователю. |
| Разговорный | Агенты, предназначенные для обмена сообщениями с пользователями в режиме реального времени, независимо от того, кто начинает разговор. |
| Оплата за сессию : Если критерии сессии соблюдены, все сообщения с расширенными возможностями воспроизведения и мультимедийный контент в течение 24-часового окна сессии оплачиваются по фиксированной ставке, независимо от их длины или сегментов. Оплата за сообщение : Если критерии сессии не соблюдены или сообщение выходит за рамки 24-часового окна сессии, оно оплачивается отдельно по тарифу за сообщение для мультимедийного контента в соответствии с тарифами конкретного оператора связи. |
Разговорные и неразговорные агенты
Существует две категории выставления счетов агентам: за разговорную и внеразговорную работу.
Операторы, не ведущие диалог, оплачивают каждое сообщение, доставленное пользователю.
- Эта категория лучше всего подходит для агентов, которые не ожидают частых ответов.
Для операторов чата действует фиксированная плата за сеанс(ы) при условии, что сеанс был инициирован, и эта плата включает все сообщения, которыми обменялись в течение 24 часов, включая сообщения, которые инициировали сеанс. Операторы чата могут также взимать плату за сообщения, не входящие в 24-часовой сеанс.
- Эта категория лучше всего подходит для агентов, ведущих многоэтапные диалоги с пользователями.
Логика выставления счетов за сессии
В соответствии с американской моделью выставления счетов, сессия запускается последовательностью из 4 сообщений с расширенными возможностями или мультимедийным контентом (включая как минимум 2 сообщения в формате MO и как минимум 1 сообщение в формате MT), обмененных в течение 24 часов с момента отправки первого сообщения в последовательности запуска. После достижения этого порога все сообщения в течение этого 24-часового окна оплачиваются как одна сессия . Любые сообщения, которые выходят за рамки или не запускают сессию, оплачиваются по стандартному тарифу за сообщение с расширенными возможностями или мультимедийным контентом в соответствии с тарифным планом конкретного оператора связи.
На следующей диаграмме показан пример сеанса выставления счетов A2P для диалоговых агентов.
- MT (Mobile Terminated) — это сообщение, отправленное компанией.
- MO (Mobile Originated) — это сообщение или действие, инициированное пользователем.
Платные мероприятия
Потоки сообщений классифицируются по источнику и направлению. Для описания направления трафика сообщений американские операторы связи обычно используют терминологию MT/MO . Эти термины соответствуют терминологии A2P/P2A, используемой в документации RCS for Business. Вот краткое сравнение этих терминов:
- A2P (приложение-к-человеку) — это MT (завершено мобильным устройством) : сообщение, отправленное компанией.
- P2A (Person-to-Application) — это MO (Mobile Originated) : сообщение или действие, инициированное пользователем.
| Событие | Описание | Неразговорные агенты | Разговорные агенты |
|---|---|---|---|
a2p_rich_message | Сообщение, отправленное агентом, содержащее только текст, предлагаемые ответы или конкретные предлагаемые действия (Набрать номер, Открыть URL в браузере). | Всегда рассматривается как отдельное оплачиваемое мероприятие. Оплата производится за каждое сообщение в зависимости от сегментов (1 сегмент равен 160 байтам в кодировке UTF-8). | Рассматривается как отдельное оплачиваемое мероприятие, если только оно не становится частью сеанса. |
p2a_rich_message | Сообщение, отправленное пользователем и содержащее только произвольный текст или текст, полученный при нажатии на предложенный вариант ответа. | Всегда рассматривается как отдельное оплачиваемое мероприятие. Оплата производится за каждое сообщение в зависимости от сегмента. | Рассматривается как отдельное оплачиваемое мероприятие, если только оно не становится частью сеанса. |
a2p_rich_media_message | Сообщение, отправленное агентом, содержащее медиафайлы (изображения, видео, аудио), расширенные карточки, карусели или сложные действия, такие как «Просмотреть местоположение». | Всегда рассматривается как отдельное оплачиваемое мероприятие. Оплата производится как за одно мероприятие по фиксированной ставке, независимо от его размера или содержания. | Рассматривается как отдельное оплачиваемое мероприятие, если только оно не становится частью сеанса. |
p2a_rich_media_message | Сообщение, отправленное пользователем и содержащее загруженный медиафайл (изображение, видео, аудио). | Всегда рассматривается как отдельное оплачиваемое мероприятие. Оплата производится как за одно мероприятие по фиксированной ставке. | Рассматривается как отдельное оплачиваемое мероприятие, если только оно не становится частью сеанса. |
p2a_suggested_action | Пользователь нажимает на любое предложенное действие (например, «Посмотреть местоположение»), которое не является предложенным ответом. | Всегда рассматривается как отдельное оплачиваемое мероприятие. Генерирует одно платное событие за каждый клик. | Рассматривается как отдельное платное событие и генерирует одно платное событие за клик, если только оно не становится частью сессии. |
a2p_session | Окно взаимодействия, составляющее 24 часа, начинается с момента срабатывания триггера сессии и получения первого сообщения в формате MT. Для получения дополнительной информации см. раздел «Что такое сессия и как она работает» . | Не применимо. Сессии не распространяются на агентов, не ведущих диалог. | После активации все сообщения в течение 24 часов оплачиваются единовременной абонентской платой. Любое платное событие в течение 24-часовой сессии будет привязано к идентификатору платного события этой сессии. |
p2a_session | Окно взаимодействия, составляющее 24 часа, начинается с момента срабатывания триггера сессии и получения первого сообщения в формате MO. Для получения дополнительной информации см. раздел «Что такое сессия и как она работает» . | Не применимо. Сессии не распространяются на агентов, не ведущих диалог. | После активации все сообщения в течение 24 часов оплачиваются единовременной абонентской платой. Любое платное событие в течение 24-часовой сессии будет привязано к идентификатору платного события этой сессии. |
Формирование отчетов по выставлению счетов
Платные события генерируются только агентами, трафик которых не относится к тестовой группе. Активность с тестовых телефонных номеров не отображается в отчетах по выставлению счетов.
В этих отчетах предполагается, что события подлежат оплате в момент доставки A2P-сообщений, а не в момент их отправки. Недоставленное сообщение или сообщение, отмененное до доставки, не является событием, подлежащим оплате.
Формат отчета о выставлении счетов
В отчетах по выставлению счетов используется формат имени файла rbm_billable_events_YYYY-MM-DD.csv . Дата в имени файла — это дата его создания.
Каждая строка в отчете представляет собой запись, отражающую отдельное событие, подлежащее оплате. Сессии A2P/P2A представлены несколькими строками — по одной для каждого обмененного сообщения. Каждая строка, связанная с сессией (имеющей один и тот же billing_event_id ), будет содержать общее количество сообщений MT и MO за весь 24-часовой период сессии в столбцах mt_messages и mo_messages .
Каждая запись в отчете содержит следующую информацию по каждому оплачиваемому событию.
| Поле | Формат | Описание | Пример |
|---|---|---|---|
billing_event_id | нить | Сгенерированный идентификатор, позволяющий отличить оплачиваемое событие. Все сообщения, входящие в сессию, будут иметь один и тот же | 63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type | нить | Тип мероприятия:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action | p2a_rich_message |
agent_id | нить | Уникальный идентификатор агента, принявшего участие в мероприятии. | acme_342h23_agent@rbm.goog |
agent_owner | нить | Адрес электронной почты текущего владельца партнерского аккаунта, в котором был создан агент. | marketing@xyzaggregator.com |
billing_party | нить | Сторона, выставляющая счета за мероприятия. | перевозчик |
max_duration_single_message | число | Максимальное время (в часах), отведенное пользователю для ответа на сообщение агента до закрытия окна начала разговора и классификации сообщения как события single_message . Не применяется к американской модели для отдельных расширенных сообщений. | 24 |
max_duration_a2p_conversation | число | В рамках пилотного проекта по наблюдению за сессиями это отражает 24-часовой интервал между сессиями, отсчитываемый с момента первого сообщения в последовательности запуска. Продолжительность измеряется в часах. | 24 |
max_duration_p2a_conversation | число | В рамках пилотного проекта по наблюдению за сессиями это отражает 24-часовой интервал между сессиями, отсчитываемый с момента первого сообщения в последовательности запуска. | 24 |
start_time | ГГГГ-мм-ддТГ:00:00З | Дата/время начала события в формате UTC (ISO 8601). Для сессий это метка времени первого сообщения в последовательности запуска. A2P a2p_rich_message и a2p_rich_media_message , это момент доставки сообщения пользователю.a2p_session это момент, когда пользователю доставляется первое сообщение в диалоге.П2А p2a_rich_message и p2a_rich_media_message , это момент отправки сообщения пользователем.p2a_session это момент, когда пользователь отправляет первое сообщение в диалоге. | 2025-05-20T08:00:00Z |
duration | число | Продолжительность относится только к сессиям и измеряется в минутах. Если событие не является событием сессии, значение равно 0. | 45 |
mt_messages | число | Количество сообщений, отправленных мобильным устройством (A2P), в событии. Для сессий каждая строка с одинаковым billing_event_id показывает общее количество сообщений MT за всю сессию. | 5 |
mo_messages | число | Количество сообщений, инициированных мобильными устройствами (P2A), в событии. Для сессий каждая строка с одинаковым billing_event_id показывает общее количество сообщений MO за всю сессию. | 3 |
size_kilobytes | число | Размер всех файлов, прикрепленных к сообщениям в событии, округленный до ближайшего килобайта (1 кБ равен 1024 байтам). | 912 |
agent_name | нить | Имя агента, принявшего участие в мероприятии. | ACME Brand |
owner_name | нить | Имя текущего владельца партнерского аккаунта, в котором был создан агент. | XYZ Aggregator |
segment_count | число | Вычисленное количество сегментов для a2p_rich_message events и p2a_rich_message (1 сегмент равен 160 байтам UTF-8). Если событие не относится к перечисленным, значение равно 0. | 5 |
session_type | нить | Тип сессии:a2p_sessionp2a_session | a2p_session |
Пример отчета о выставлении счетов
Образец отчета доступен для скачивания:
Типичный размер файла
Размер ежедневного отчета от активного партнера RCS for Business зависит от объема активности, которую он сгенерировал в сети оператора связи.