На этой странице описываются файлы данных, которые RCS for Business создает для операторов связи при выставлении счетов и проведении аудита. Ответы на часто задаваемые вопросы о модели выставления счетов RCS for Business см. в разделе « Часто задаваемые вопросы по выставлению счетов».
| Файл | Описание | У кого есть доступ |
|---|---|---|
| Отчет о событиях выставления счетов | Сводный отчет по тарифицируемым событиям между запущенными агентами и пользователями. | Все операторы, которые активно используют RCS для бизнеса. |
| Журнал активности | Журнал необработанных данных активности RCS for Business, включая тарифицируемые события. | Операторы, которые активно используют RCS для бизнеса и используют службу Google RCS в соответствии со своими собственными Условиями обслуживания (ToS). |
Генерация файла
Каждый файл данных представляет собой один день использования RCS for Business по всемирному координированному времени (UTC). Файлы генерируются ежедневно. Процесс генерации может занять несколько часов, а время завершения может варьироваться.
Для агентов , не ведущих диалог , файлы содержат данные за 24-часовой период, непосредственно предшествовавший времени создания файла. Например, если отчёт о событиях выставления счёта создан в 11:00 UTC 5 мая, он будет содержать данные с 11:00 UTC 4 мая по 11:00 UTC 5 мая.
Для агентов, работающих в режиме диалога , файлы содержат данные за 24-часовой период, за 1-2 дня до момента создания файла. Например, если отчёт о событиях выставления счёта создан в 11:00 UTC 5 мая, он может содержать данные с 11:00 UTC 3 мая по 11:00 UTC 4 мая.
Причина задержки заключается в том, что активность агентов, работающих в режиме разговора, в RCS for Business связана с разговорами , завершение которых может занять до 48 часов. Эта задержка позволяет RCS for Business фиксировать все сообщения в разговоре перед расчётом события выставления счёта. Подробнее об агентах, работающих в режиме разговора, см. в разделе «Категории выставления счёта агентам» .
Ключевые моменты:
Нет активности : если в определенный день на платформе нет активности, файл не создается.
Именование : Дата в имени файла — это дата его создания, а не дата хранения данных в нем.
Хранение : файлы хранятся не более 63 дней, после чего удаляются.
Вы можете использовать эти файлы для обновления своего хранилища данных с учетом последних показателей использования платформы.
Хранение файлов и доступ к ним
Файлы данных шифруются при хранении и передаче.
Чтобы получить файлы данных по протоколу SFTP, укажите свой открытый ключ SFTP. Чтобы сгенерировать ключи, см. статью «Генерация пары ключей Secure Shell (SSH) для SFTP-аккаунта» .
Сервер SFTP — partnerupload.google.com , а соединение осуществляется через порт с высоким номером (19321) для дополнительной безопасности.
Для доступа к файлам данных вы можете использовать следующую команду:
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Google предоставляет имена пользователей учетных записей в следующих форматах:
-
rbmreports-billableevents-<carrier name> -
rbmreports-activity-<carrier name>
Google указывает <carrier name> и предоставляет отдельную учетную запись для каждого типа отчета.
Для доступа к различным типам отчетов предусмотрены отдельные учетные записи.
Доступность файла
Если файлы данных еще не созданы, вы увидите ошибку SFTP, похожую на remote readdir("/"): No such file or directory , что и ожидалось.
Файл не будет создан, если нет трафика RCS for Business для отчёта. Это означает, что в некоторые дни файлы могут не создаваться. Если вам нужны пустые файлы для оптимизации процесса, свяжитесь с rbm-support@google.com .
Отчеты о событиях выставления счетов
Отчёты о событиях выставления счёта представляют собой записи о событиях выставления счёта , которые рассчитываются на основе категории выставления счёта агента и типа отправляемых им сообщений. Отчёты о событиях выставления счёта доступны всем операторам связи, использующим RCS for Business.
Отчеты о событиях выставления счетов содержат конфиденциальную информацию, но не содержат персональные идентификационные данные пользователя (PII), такие как MSISDN, хешированный MSISDN или какой-либо уникальный идентификатор пользователя.
Категории выставления счетов агентам
При создании агента владелец устанавливает его платежную категорию , исходя из того, как агент будет взаимодействовать с пользователями. Платежная категория не ограничивает количество или тип сообщений, которые может отправлять агент. Но она определяет, как агент будет оплачивать сообщения. Две основные платежные категории описаны в следующей таблице.
| Категория выставления счетов | Тип агента | Примеры использования | Метод выставления счетов |
|---|---|---|---|
Неразговорный (Включает категории «Базовое сообщение» и «Отдельное сообщение». Примечание : между этими двумя категориями больше нет разницы. Агент в любой из категорий будет выставлен счет как неразговорный агент.) | Агенты, которые в основном отправляют односторонние сообщения. |
| Плата взимается за каждое сообщение, доставленное пользователю. |
| Разговорный | Агенты, предназначенные для двустороннего обмена данными с пользователями. |
| Оплата за разговор : если одна из сторон (агент или пользователь) отвечает на сообщение другой стороны в течение 24 часов, начинается разговор. В течение окна разговора (24 часа после первого ответа) агент и пользователь могут обмениваться любым количеством сообщений, и с агента будет взиматься фиксированная плата за разговор. Оплата за сообщение : если агент доставляет сообщение, на которое пользователь не отвечает в течение 24 часов, с агента будет взиматься плата за отдельное сообщение, аналогично агенту, не ведущему диалог. |
На следующей диаграмме показан пример сеанса выставления счетов A2P для разговорных агентов:
Разговорные и неразговорные агенты
Существует две основные категории тарификации: разговорная и неразговорная. Категория «неразговорная» включает в себя категории «Базовое сообщение» и «Одиночное сообщение», которые функционально идентичны. Оператор, относящийся к любой из этих категорий, тарифицируется как неразговорный.
Основное различие в категориях выставления счетов существует между разговорными и неразговорными агентами:
Агенты, не умеющие общаться, платят за каждое сообщение, которое они доставляют пользователю.
- Эта категория лучше всего подходит для агентов, которые не ожидают частых ответов.
С агентов, ведущих разговор, взимается фиксированная плата за разговоры , которая включает в себя все сообщения, которыми они обмениваются в течение 24-часового периода.
- Эта категория лучше всего подходит для агентов, которые ведут многократные беседы с пользователями.
События выставления счетов
В отчётах о событиях биллинга регистрируются пять различных типов событий, включая сообщения A2P и P2A.
- A2P (Заявление физическому лицу) : отправляется предприятием.
- P2A (от человека к приложению) : отправляется пользователем.
В следующей таблице описывается каждое событие выставления счетов применительно к неразговорчивым и разговорным агентам.
| Событие | Описание | Неразговорные агенты | Разговорные агенты |
|---|---|---|---|
basic_message | Сообщение A2P, содержащее только текст длиной не более 160 символов. Если текст содержит URL-адрес веб-сайта с тегами OpenGraph , в сообщении может быть показано изображение для предварительного просмотра, при этом партнёру не взимается дополнительная плата. | Всегда рассматривается как индивидуальное событие выставления счета, независимо от того, отвечает ли пользователь. | Рассматривается как отдельное событие выставления счета, если пользователь не ответит в течение 24 часов. В этом случае сообщение становится частью a2p_conversation . |
single_message | Сообщение A2P, которое либо имеет расширенный контент, либо представляет собой текстовое сообщение длиной более 160 символов. | Всегда рассматривается как индивидуальное событие выставления счета, независимо от того, отвечает ли пользователь. | Рассматривается как отдельное событие выставления счета, если пользователь не ответит в течение 24 часов. В этом случае сообщение становится частью a2p_conversation . |
a2p_conversation (инициированный бизнесом) | Инициируется, когда пользователь отвечает на сообщение A2P в течение 24 часов с момента его получения, вне текущего диалога. | Н/Д. Неразговорные агенты никогда не генерируют этот тип событий. | Если сообщение P2A доставлено в течение 24 часов после нескольких сообщений A2P, для начала диалога используется только сообщение A2P, непосредственно предшествовавшее ему. Это сообщение A2P и все сообщения, доставленные в течение следующих 24 часов, являются частью a2p_conversation . |
p2a_conversation (инициировано пользователем) | Инициируется, когда агент отвечает на сообщение P2A в течение 24 часов с момента его получения, вне текущего разговора. | Н/Д. Неразговорные агенты никогда не генерируют этот тип событий. | Если сообщение A2P доставлено в течение 24 часов после нескольких сообщений P2A, для начала диалога используется только сообщение P2A, непосредственно предшествовавшее сообщению A2P. Это сообщение P2A и все сообщения, доставленные в течение следующих 24 часов, являются частью p2a_conversation . |
p2a_message | Сообщение P2A любого типа. | Всегда рассматривается как отдельное событие выставления счета, независимо от того, отвечает ли агент. | Рассматривается как отдельное событие выставления счета, если агент не ответит в течение 24 часов. |
События выставления счетов в сравнении с категориями выставления счетов
События биллинга basic_message и single_message не следует путать с категориями биллинга Basic Message и Single Message.
Любой агент (независимо от его категории выставления счетов ) может генерировать события выставления счетов
basic_messageиsingle_message.Категории биллинга «Базовое сообщение» и «Одиночное сообщение» используются для классификации агентов, не ведущих диалог. Агенты в этих категориях не генерируют события биллинга «Разговор» (
a2p_conversationsилиp2a_conversations). Вместо этого они генерируют отдельные события биллингаbasic_message,single_messageиp2a_message.
Генерация отчетов по выставлению счетов
События биллинга генерируются только агентами с нетестовым трафиком. Активность с тестовых телефонных номеров не отображается в отчётах о событиях биллинга.
В этих отчётах предполагается, что счета выставляются в момент доставки сообщений, а не в момент их отправки. Недоставленное сообщение или сообщение, отменённое до доставки, не приводит к выставлению счёта.
Формат отчета по выставлению счетов
Файлы отчётов о событиях выставления счёта имеют формат rbm_billable_events_YYYY-MM-DD.csv . Дата в имени файла соответствует дате его создания.
Каждая строка в отчёте представляет собой запись, представляющую одно событие выставления счёта. Поля внутри записи разделены табуляцией. Например, два A2P-диалога с одним и тем же агентом создадут два события выставления счёта и две записи в отчёте о событиях выставления счёта.
Каждая запись в отчете содержит следующую информацию для каждого события выставления счетов:
| Поле | Формат | Описание | Пример |
|---|---|---|---|
billing_event_id | нить | Идентификатор UUID. Случайное число, генерируемое для каждого нового события при его создании. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff |
type | нить | Тип мероприятия:
| single_message |
agent_id | нить | Уникальный идентификатор агента, участвовавшего в мероприятии. | rbm-welcome-bot@rbm.goog |
agent_owner | нить | Адрес электронной почты текущего владельца партнерской учетной записи, где был создан агент. | name@aggregator.com |
billing_party | нить | Сторона, которая выставляет счета за мероприятия.
| carrier |
max_duration_single_message | число | Максимальное время (в часах), в течение которого пользователь может ответить на сообщение агента, прежде чем окно начала разговора закроется, а сообщение будет классифицировано как событие single_message . | 24 |
max_duration_a2p_conversation | число | Максимальная продолжительность A2P-диалога (в часах). Измеряется с момента первого ответа пользователя на первое сообщение агента. | 24 |
max_duration_p2a_conversation | число | Максимальная продолжительность разговора P2A, в часах. Измеряется с момента первого сообщения пользователя в разговоре. | 24 |
start_time | ГГГГ-мм-ддTHH:00:00Z | Дата/время начала события по Гринвичу в формате ISO 8601, округленные до ближайшего часа. A2P-сообщения
Сообщения P2A
| 2019-07-25T08:00:00Z |
duration | число | Длительность события, округленная до ближайшей минуты. Если тип события — | 45 |
mt_messages | число | Количество сообщений, отправленных на мобильную связь (A2P), в событии. | 11 |
mo_messages | число | Количество сообщений, отправленных с мобильных устройств (P2A), в событии. | 9 |
size_kilobytes | число | Размер всех файлов, прикрепленных к сообщениям в событии, округленный до ближайшего килобайта (1 КБ = 1024 байта). | 912 |
agent_name | нить | Имя агента, участвовавшего в мероприятии. | XYZ Mobile USA |
owner_name | нить | Имя текущего владельца партнерского аккаунта, где был создан агент. | XYZ Mobile |
Пример отчета о событиях выставления счетов
Образец файла отчета по выставлению счетов доступен для загрузки .
Типичный размер файла
Размер ежедневного отчёта от активного партнёра RCS for Business зависит от уровня его активности в сети оператора. Например, если в отчёте 53 000 записей, размер файла составит около 8 МБ.
Журналы активности
Журналы активности предоставляют необработанные данные об активности на платформе RCS for Business. Вы можете использовать эти журналы для аудита событий выставления счетов и создания пользовательских событий.
Примечание : в журналы активности включается только трафик с телефонных номеров, не участвующих в тестировании.
Поскольку журналы активности содержат персональные идентификационные данные (PII), такие как подробная информация о транзакциях и MSISDN-номера абонентов, они доступны только в том случае, если оператор использует RCS в соответствии со своими Условиями обслуживания. Если в ваших сетях используется трафик RCS для бизнеса и вы включили RCS-активность с помощью Google RCS в соответствии с Условиями обслуживания Google, у вас не будет доступа к журналам активности.
Формат журнала активности
Журналы активности имеют формат имени файла rbm_activity_YYYY-MM-DD.csv . Дата в имени файла соответствует дате его создания.
Поля в записи разделяются табуляцией, в каждой строке находится одна запись.
Каждая запись в журнале действий содержит следующие поля для каждого действия:
| Поле | Формат | Описание | Пример |
|---|---|---|---|
activity_id | нить | Уникальный идентификатор активности. | b422e1d3-ac99-442a-853d-a875d5e61762 |
billing_event_id | нить | Уникальный идентификатор связанного события выставления счета. Может быть пустым, если действие не связано с событием выставления счета, например, text_message без соответствующего delivery_receipt_event . | 91yeb201-7c3b-412b-98d2-b0a0f7abe536 |
agent_id | нить | Уникальный идентификатор агента. | welcome-bot@rbm.goog |
user_id | нить | MSISDN пользователя. | 918369110173 |
direction | нить | Направление отправки сообщения:
| MT |
time | ГГГГ-мм-ддТЧЧ:ММ:СС.СССЗ | Дата и время отправки события на платформу RCS for Business в формате UTC. См. временные метки . | 2019-07-25T00:29:07.033Z |
type | нить | Вид деятельности:
| text_message |
size_bytes | нить | Размер файлов, прикрепленных к действию, в байтах. | 912 |
Временные метки
Временные метки в журналах активности фиксируют момент отправки события на платформу RCS for Business. События, связанные с доставкой контента пользователю, не будут зарегистрированы в журнале активности до тех пор, пока сообщение не будет доставлено.
Например, если сообщение RCS for Business было отправлено пользователю в среду в 13:00, а получатель был не в сети до воскресенья 9:00, событие появится в журнале активности, созданном для воскресенья, но меткой времени будет среда, 13:00.