RBM создает файлы данных, в которых сообщается об активности пользователей и агентов на сводном и транзакционном уровнях. Данные разделены на несколько файлов:
| Файл | Описание | У кого есть доступ |
|---|---|---|
| Отчет о платежных событиях | Запись оплачиваемых событий между запущенными агентами и пользователями. | Все операторы связи, в сетях которых есть трафик RBM. |
| Журнал активности | Необработанные данные о деятельности платформы RBM | Операторы связи, которые имеют трафик RBM в своих сетях и разрешают активность RCS с Jibe Cloud в соответствии со своими Условиями обслуживания (ToS). |
Поколение
Отчеты о платежных событиях и журналы активности создаются с двухдневной задержкой.
Google сообщает о событии активности только после завершения платежного сеанса, к которому оно принадлежит. Завершение сеанса может занять до 24 часов, а наш конвейер выставления счетов выполняется один раз в день и сообщает только о сеансах выставления счетов, которые точно завершены (то есть, которым не менее 24 часов).
Например:
Сообщение отправляется в день d и инициирует сеанс выставления счетов, но оно пропустило выполнение конвейера на 1 час раньше. Таким образом, ни о каком событии активности не сообщается.
Когда конвейер снова запускается в день d+1 , сеанс, инициированный сообщением, длится всего 23 часа. Таким образом, в d+1 не сообщается о событии активности для этого сообщения.
Когда конвейер снова запускается в d+2 , сеанс завершается, поэтому о событии активности сообщается вместе с сеансом выставления счетов.
Хранение и доступ
Файлы данных шифруются при хранении и передаче.
Чтобы получить файлы данных по 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 . Это ожидаемо.
Файл не будет создан, если нет трафика RBM, о котором нужно сообщить. Это означает, что могут быть дни, когда файлы не генерируются. Если в этой ситуации вам необходимо создать пустые файлы, чтобы упростить обработку, свяжитесь с rbm-support@google.com .
Обновление и сохранение
Каждый файл данных представляет один день использования платформы по времени UTC. Записи за определенный день создаются один раз и завершаются в течение 2 дней (48 часов) после окончания дня. Если вы загрузите эти файлы в хранилище данных, вы сможете обновить показатели текущего месяца.
Файл не создается, если нет активности, которую нужно учитывать.
Дата в имени каждого файла — это дата создания файла. Записи в файле будут охватывать день UTC, который наступает за 2 дня до даты файла.
Процесс экспорта, генерирующий файлы, выполняется между 2 и 4 часами утра по тихоокеанскому стандартному времени.
Файлы данных хранятся максимум 30 дней, прежде чем будут удалены.
Отчеты о платежных событиях
Отчеты о событиях выставления счетов — это записи оплачиваемых событий, рассчитанные на основе базовых сообщений с использованием предлагаемых единиц выставления счетов. Оплачиваемые события содержат конфиденциальную информацию, но не содержат PII пользователя (например, MSISDN, хешированного MSISDN или любого уникального идентификатора пользователя).
Только запущенные агенты генерируют события биллинга. Действия еще не запущенных или не запущенных агентов не отображаются в отчетах о выставлении счетов.
В отчетах о выставлении счетов предполагается, что оплата за события взимается при доставке сообщений, а не при отправке сообщений. Недоставленное или отозванное сообщение до доставки не вызывает событие выставления счета.
У каждого агента RBM есть Категория биллинга , установленная разработчиком агента перед отправкой агента на запуск. Категория выставления счетов определяет, являются ли сообщения, отправляемые агентом, дискретными или их можно объединить в диалоговые события выставления счетов.
Существует пять типов оплачиваемых событий:
| Событие | Определение |
|---|---|
| Основное сообщение | Сообщение от приложения к человеку (A2P), которое
Только диалоговые агенты : если сообщение P2A доставляется в качестве ответа на сообщение A2P в течение следующих 24 часов, базовое сообщение становится частью диалога A2P; в противном случае сеанс завершается. Базовое сообщение всегда доставляется от агента пользователю. |
| Одно сообщение | Сообщение от приложения к человеку (A2P), которое
Только для диалоговых агентов : если сообщение P2A будет доставлено в течение следующих 24 часов, одиночное сообщение становится частью разговора A2P; в противном случае сеанс завершается. Одиночное сообщение всегда доставляется от агента пользователю. |
| A2P-разговор | Применяется только к диалоговым агентам : разговор A2P инициируется, когда сообщение P2A доставляется в течение 24 часов после одиночного сообщения A2P или базового сообщения A2P. Обратите внимание: если сообщение P2A доставлено в течение 24 часов после нескольких сообщений A2P, для создания сеанса разговора используется только сообщение A2P, которое непосредственно предшествовало сообщению P2A. Это сообщение A2P, а также любые сообщения, доставленные в течение следующих 24 часов, являются частью нового диалога A2P. |
| P2A-разговор | Применяется только к диалоговым агентам : разговор P2A инициируется, когда нет активного сеанса (одиночное сообщение A2P, разговор A2P или разговор P2A) и доставлено сообщение P2A, и компания отвечает в течение 24 часов. |
| P2A-сообщение | Недиалоговые агенты : сообщение P2A, отправленное пользователем агенту с биллинговой категорией «Одно сообщение» или «Базовое сообщение». Диалоговые агенты : сообщение P2A, отправленное пользователем агенту, при котором нет существующего диалога и агент не возвращает ответ. |
Доступность
Отчеты о событиях выставления счетов доступны всем операторам связи, в сетях которых есть трафик RBM.
Формат
В отчетах о событиях выставления счетов используется формат имени файла YYYY/MM/DD/rbm_billable_events_YYYY-MM-DD.csv .
Дата в имени файла — это дата создания файла. Записи в файле обычно охватывают активность за день, который был за 2 дня до этой даты.
Поля в записи разделены табуляцией, и в каждой строке содержится одна запись.
Для каждого события выставления счета будет одна запись, т. е. два разговора A2P с одним и тем же агентом создадут два события выставления счета и две записи в отчете о выставлении счетов.
Каждая запись в отчете об оплачиваемых событиях содержит следующую информацию для каждого события:
| Поле | Формат | Описание | Пример |
|---|---|---|---|
billing_event_id | нить | Идентификатор UUID — случайное число, генерируемое для каждого нового события в момент его создания. | |
type | нить | Тип мероприятия:
| single_message |
agent_id | нить | Идентификатор агента, участвовавшего в событии. | rbm-welcome-bot@rbm.goog |
agent_owner | нить | Электронная почта владельца агента, участвовавшего в мероприятии. Это сторона, зарегистрировавшая агента RBM, в большинстве случаев агрегатор, но в некоторых редких случаях это может быть бренд. Это значение берется из поля «Учетная запись RBM Google», предоставленного при регистрации разработчика для использования RBM . | name@aggregator.com |
billing_party | нить | Сторона, которая выставляет счета за мероприятия.
| carrier |
max_duration_single_message | число | Продолжительность в часах, в течение которой сообщение агента не получает ответа, чтобы определить одиночный сеанс сообщения. | 24 |
max_duration_a2p_conversation | число | Максимальная продолжительность сеанса A2P в часах. Измеряется по первому ответу пользователя на исходное сообщение агента. | 24 |
max_duration_p2a_conversation | число | Максимальная продолжительность сеанса P2A в часах. Измеряется по первому сообщению пользователя в беседе. | 24 |
start_time | ГГГГ-мм-ддTHH:00:00Z | Дата/время по всемирному координированному времени начала мероприятия в формате ISO 8601, округленное до ближайшего часа.
| 2019-07-25T08:00:00Z |
duration | число | Продолжительность события, округленная до ближайшей минуты. Если тип события — | 45 |
mt_messages | число | Количество сообщений, завершенных на мобильных устройствах, в событии. | 11 |
mo_messages | число | Количество сообщений, отправленных с мобильных устройств в событии. | 9 |
size_kilobytes | число | Размер всех файлов, прикрепленных к сообщению в событии, округленный до ближайшего килобайта (1 КБ = 1024 байта). | 912 |
agent_name | нить | Агент, принимавший участие в мероприятии. | XYZ Mobile USA |
owner_name | нить | Владелец агента, участвовавшего в мероприятии. Это сторона, зарегистрировавшая агента RBM. В большинстве случаев это агрегатор, но в некоторых редких случаях это может быть бренд. Это значение взято из «Предпочитаемого отображаемого имени для вашей партнерской учетной записи», указанного при регистрации разработчика для использования RBM . | XYZ Mobile |
Образец файла
Образец отчета о платежах доступен для скачивания .
Типичный размер файла
Файл ежедневного отчета от активного партнера может содержать около 53 000 записей и иметь размер около 8 МБ.
Журналы активности
Журналы активности — это журналы необработанных данных о деятельности на платформе RBM, предназначенные для аудита оплачиваемых событий и создания пользовательских событий.
Доступность
Журналы активности доступны только операторам связи, в сетях которых есть трафик RBM и которые разрешают активность RCS с Jibe Cloud в соответствии с собственными Условиями обслуживания (ToS). Если вы используете Jibe Cloud в соответствии с Условиями обслуживания Jibe, у вас не будет доступа к журналам активности.
Формат
Журналы активности используют формат имени файла YYYY/MM/DD/rbm_activity_YYYY-MM-DD.csv .
Дата в имени файла — это дата создания файла. Записи в файле обычно охватывают активность за день, который был за 2 дня до этой даты.
Поля в записи разделены табуляцией, и в каждой строке содержится одна запись.
Каждая запись в журнале активности содержит следующие поля для каждого события активности.
| Поле | Формат | Описание | Пример |
|---|---|---|---|
activity_id | нить | Идентификатор действия. | |
billing_event_id | нить | Идентификатор события выставления счета, в котором произошло действие. Может быть пустым, если действие не связано ни с каким сеансом, например text_message без соответствующего delivery_receipt_event . | |
agent_id | нить | Идентификатор агента. | welcome-bot@rbm.goog |
user_id | нить | MSISDN пользователя. | 918369110173 |
direction | нить | Направление отправки сообщения:
| MT |
time | ГГГГ-мм-ддТЧЧ:ММ:СС.СССЗ | Дата/время в формате UTC, когда событие было отправлено на платформу RBM. См. примечание ниже. | 2019-07-25T00:29:07.033Z |
type | нить | Вид деятельности:
| text_message |
size_bytes | нить | Размер файлов, прикрепленных к действию, в байтах. | 912 |
Примечание о временных метках
Временные метки в журналах активности фиксируют время отправки события на платформу RBM. Для событий, которые доставляют контент пользователю, событие не будет записываться в журнал действий до тех пор, пока сообщение не будет доставлено.
Например, если сообщение RBM отправлено пользователю в среду в 13:00, а получатель находится в автономном режиме до 09:00 воскресенья, это событие появится в журнале активности, созданном для воскресенья. Временной меткой события в журнале активности будет среда, 13:00.