На этой странице описаны файлы данных, которые RCS for Business создает для оказания помощи операторам связи в выставлении счетов и проведении аудита.
| Файл | Описание | Кто имеет доступ? |
|---|---|---|
| Отчет о выставлении счетов | Сводный отчет о событиях, подлежащих оплате, между запущенными агентами и пользователями. | Все операторы связи, которые активно используют RCS для бизнеса. |
| Журнал активности | Журнал необработанных данных активности RCS for Business, включая события, подлежащие оплате. | Операторы связи, которые активно используют RCS для бизнеса и предоставляют услуги Google RCS в соответствии со своими собственными Условиями обслуживания (ToS). |
RCS for Business использует две модели выставления счетов: стандартную модель для трафика за пределами США и модель для трафика из США. Информация, уникальная для стандартной или американской модели (например, различные классификации событий, подлежащих оплате, или поля отчетов), явно указывается.
- Подробную информацию о стандартной модели выставления счетов и краткое описание различий между ними см. в разделе «Часто задаваемые вопросы по выставлению счетов» .
- Подробную информацию о классификации счетов в США см. в руководстве по модели выставления счетов в США .
Генерация файлов
Каждый файл данных представляет собой данные за один день использования RCS для бизнеса в скоординированном универсальном времени (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 дня, после чего удаляются.
Эти файлы можно использовать для обновления хранилища данных с учетом последних показателей использования платформы.
Хранение и доступ к файлам
Файлы данных шифруются как в состоянии покоя, так и при передаче.
Для получения файлов данных по протоколу Secure File Transfer Protocol (SFTP) предоставьте свой открытый ключ SFTP. Инструкции по генерации ключей см. в разделе «Генерация пары ключей Secure Shell (SSH) для Dropbox 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 для бизнеса, о котором нужно сообщать. Это означает, что в некоторые дни файлы могут не создаваться. Если вам нужны пустые файлы для оптимизации процесса, свяжитесь с нами по адресу rbm-support@google.com .
Отчеты по выставлению счетов
Отчеты по выставлению счетов представляют собой записи о событиях, подлежащих оплате , которые рассчитываются на основе категории выставления счетов агента и типа отправляемых им сообщений. Отчеты по выставлению счетов доступны всем операторам связи, активно использующим RCS for Business.
В платежных отчетах содержится конфиденциальная информация, но в них отсутствуют персональные данные пользователей, такие как MSISDN, хешированный MSISDN или любой другой уникальный идентификатор пользователя.
Категории выставления счетов агентам
При создании агента владелец устанавливает категорию оплаты в зависимости от того, как агент будет взаимодействовать с пользователями. Категория оплаты не ограничивает количество или тип сообщений, которые может отправлять агент. Но она определяет, как агент будет оплачивать сообщения. Две основные категории оплаты описаны в следующей таблице.
| Категория выставления счетов | Тип агента | Примеры вариантов использования | Способ выставления счетов |
|---|---|---|---|
| Неразговорный | Агенты, которые в основном передают односторонние сообщения. |
| Оплата взимается за каждое сообщение, доставленное пользователю. |
| Разговорный | Агенты, предназначенные для обмена информацией с пользователями. |
| Оплата за разговор : Если одна из сторон (агент или пользователь) отвечает на сообщение другой стороны в течение 24 часов, начинается разговор. В течение этого периода (24 часа после первого ответа) агент и пользователь могут обменяться любым количеством сообщений, и с агента будет взиматься фиксированная плата за разговор. Оплата за сообщение : Если оператор отправляет сообщение, на которое пользователь не отвечает в течение 24 часов, с оператора будет взиматься плата за каждое сообщение отдельно, аналогично оператору, не ведущему диалог. |
На следующей диаграмме показан пример сеанса выставления счетов A2P для диалоговых агентов:
Разговорные и неразговорные агенты
Существует две основные категории оплаты: за разговоры и за неразговоры.
Ключевое различие в категориях оплаты заключается в разнице между агентами, ведущими диалог, и агентами, не ведущими диалог:
Операторы, не участвующие в диалогах, оплачивают каждое сообщение, доставленное пользователю.
- Эта категория лучше всего подходит для агентов, которые не ожидают частых ответов.
Операторам, работающим в режиме онлайн, взимается фиксированная плата за общение , включая все сообщения, которыми они обмениваются в течение 24 часов.
- Эта категория лучше всего подходит для агентов, ведущих многоэтапные диалоги с пользователями.
Платные мероприятия
В отчетах по выставлению счетов регистрируются пять типов событий, подлежащих оплате. К этим событиям относятся события MT и MO, которые обозначаются как события A2P и P2A.
- A2P (приложение-к-человеку) — это MT (завершено мобильным устройством) : сообщение, отправленное компанией.
- P2A (Person-to-Application) — это MO (Mobile Originated) : сообщение или действие, инициированное пользователем.
В таблице ниже описано каждое оплачиваемое событие применительно к агентам, работающим в недиалоговом режиме и в диалоговом режиме.
| Событие | Описание | Неразговорные агенты | Разговорные агенты |
|---|---|---|---|
basic_message | A2P-сообщение, содержащее только текст длиной не более 160 символов. Если текст включает URL-адрес веб-сайта с тегами openGraph , в сообщении может отображаться предварительный просмотр изображения без дополнительной платы для партнера. | Всегда рассматривается как отдельное оплачиваемое событие, независимо от того, ответил ли пользователь. | Сообщение рассматривается как отдельное платное событие, если пользователь не ответит в течение 24 часов. В этом случае сообщение становится частью диалога a2p_conversation . |
single_message | A2P-сообщение, содержащее либо расширенный контент, либо текстовое сообщение длиной более 160 символов. | Всегда рассматривается как отдельное оплачиваемое событие, независимо от того, ответил ли пользователь. | Сообщение рассматривается как отдельное платное событие, если пользователь не ответит в течение 24 часов. В этом случае сообщение становится частью диалога a2p_conversation . |
a2p_conversation (инициировано бизнесом) | Инициируется, когда пользователь отвечает на A2P-сообщение в течение 24 часов после его получения, вне рамок существующей переписки. | Неприменимо. Неразговорные агенты никогда не генерируют события такого типа. | Если сообщение P2A доставлено в течение 24 часов после нескольких сообщений A2P, для начала разговора используется только то сообщение A2P, которое непосредственно предшествовало сообщению P2A. Это сообщение A2P, а также любые сообщения, доставленные в течение следующих 24 часов, являются частью разговора a2p_conversation . |
p2a_conversation (инициировано пользователем) | Инициируется, когда агент отвечает на сообщение P2A в течение 24 часов после его получения, вне рамок существующего диалога. | Неприменимо. Неразговорные агенты никогда не генерируют события такого типа. | Если сообщение A2P доставлено в течение 24 часов после нескольких сообщений P2A, для начала разговора используется только то сообщение P2A, которое непосредственно предшествовало сообщению A2P. Это сообщение P2A, а также любые сообщения, доставленные в течение следующих 24 часов, являются частью разговора p2a_conversation . |
p2a_message | P2A-сообщения любого типа. | Всегда рассматривается как отдельное оплачиваемое событие, независимо от того, ответил ли агент. | Рассматривается как отдельное оплачиваемое событие, если агент не ответит в течение 24 часов. |
Категории выставления счетов против событий, подлежащих оплате
Различие между категориями выставления счетов агентам и оплачиваемыми событиями является ключевым моментом для понимания того, как выставляется счет вашему агенту.
- Категория выставления счетов — это фиксированная классификация, которую вы выбираете при создании своего агента. Она определяет способ выставления счетов вашему агенту: за сообщение (для агентов, не ведущих диалоги) или за диалог (для агентов, ведущих диалоги).
- Платные события — это взаимодействия между агентом RCS for Business и пользователем, которые отслеживаются в целях выставления счетов (например,
basic_message,single_message,a2p_conversation).
Формирование отчетов по выставлению счетов
Платные события генерируются только агентами, трафик которых не относится к тестовой группе. Активность с тестовых телефонных номеров не отображается в отчетах по выставлению счетов.
В этих отчетах предполагается, что оплата за события производится в момент доставки сообщений, а не в момент их отправки. Недоставленное сообщение или сообщение, отмененное до доставки, не является событием, подлежащим оплате.
Формат отчета о выставлении счетов
В отчетах по выставлению счетов используется формат имени файла 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 | ГГГГ-мм-ддТГ:00:00З | Дата/время начала события в формате UTC (стандарт 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 |
segment_count | число | Только для модели выставления счетов в США Вычисленное количество сегментов для событий | 5 |
Пример отчета о выставлении счетов
Образцы отчетов доступны для скачивания:
- Отчет по выставлению счетов для стандартной модели выставления счетов
- Отчет по выставлению счетов для модели выставления счетов США
Типичный размер файла
Размер ежедневного отчета от активного партнера 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 (среда).