На этой странице описаны файлы данных, которые RBM создает для помощи операторам связи в выставлении счетов и аудите.
| Файл | Описание | У кого есть доступ |
|---|---|---|
| Отчет о платежных событиях | Совокупный отчет об оплачиваемых событиях между запущенными агентами и пользователями. | Все перевозчики с подписанным RBM MDA. |
| Журнал активности | Журнал необработанных данных о деятельности RBM, включая оплачиваемые события. | Операторы связи с подписанным RBM MDA, которые используют Службу Google RCS в соответствии со своими Условиями обслуживания (ToS). |
Генерация файлов
Каждый файл данных представляет один день использования RBM во всемирном координированном времени (UTC). Файлы генерируются ежедневно с 10:00 до 12:00 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 мая.
Причина задержки заключается в том, что активность RBM для диалоговых агентов связана с разговорами , завершение которых может занять до 48 часов. Эта задержка позволяет RBM перехватывать все сообщения в ходе разговора перед расчетом события выставления счета. Дополнительную информацию о диалоговых агентах см. в разделе Категории выставления счетов агентам .
Ключевые моменты:
Нет активности : если в определенный день на платформе нет активности, файл не создается.
Именование : дата в имени файла — это дата создания файла, а не дата содержащихся в нем данных.
Хранение : файлы хранятся максимум 30 дней, прежде чем будут удалены.
Вы можете использовать эти файлы для обновления своего хранилища данных с учетом последних показателей использования платформы.
Хранение файлов и доступ к ним
Файлы данных шифруются при хранении и передаче.
Чтобы получить файлы данных по 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 .
Отчеты о платежных событиях
Отчеты о событиях выставления счетов — это записи событий выставления счетов , которые рассчитываются на основе категории выставления счетов агента и типа отправляемых им сообщений. Отчеты о событиях выставления счетов доступны всем операторам связи, у которых есть RBM MDA.
Отчеты о событиях выставления счетов содержат конфиденциальную информацию, но не содержат личной информации пользователя (PII), такой как MSISDN, хешированный MSISDN или какой-либо уникальный идентификатор пользователя.
Категории выставления счетов агентам
При создании агента владелец задает ему категорию биллинга в зависимости от того, как агент будет взаимодействовать с пользователями. Категория выставления счетов не ограничивает количество или тип сообщений, которые может отправлять агент. Но он определяет, как агенту будут выставляться счета за сообщения. Две основные категории выставления счетов описаны в следующей таблице.
| Категория биллинга | Тип агента | Примеры использования | Способ оплаты |
|---|---|---|---|
Неразговорный (Включает категории «Основное сообщение» и «Одно сообщение». Примечание . Между этими двумя категориями больше нет никакой разницы. Оператору в любой категории будет выставлен счет как неразговаривающему агенту.) | Агенты, которые в основном отправляют односторонние сообщения. |
| Оплата производится за каждое сообщение, доставленное пользователю. |
| Разговорный | Агенты, предназначенные для взаимного обмена данными с пользователями. |
| Оплата за разговор : если одна сторона (агент или пользователь) отвечает на сообщение другой стороны в течение 24 часов, начинается разговор. В течение окна разговора (24 часа после первого ответа) агент и пользователь могут обмениваться любым количеством сообщений, и агенту будет выставлен счет по фиксированной ставке за разговор. Оплата за сообщение . Если агент доставляет сообщение, на которое пользователь не отвечает в течение 24 часов, агенту будет выставлен счет за отдельное сообщение, аналогично неразговорному агенту. |
Разговорные и неразговорные агенты
Существует две основные категории биллинга: разговорная и неразговорная. Недиалоговая категория включает категории «Основное сообщение» и «Одно сообщение», которые функционально идентичны. Агент в любой из этих категорий считается неразговорным агентом.
Ключевое различие в категориях выставления счетов заключается между разговорными и неразговорными агентами:
Неразговорным агентам выставляется счет за каждое сообщение, которое они доставляют пользователю.
- Эта категория лучше всего подходит для агентов, которые не ожидают частых ответов.
Диалоговым агентам взимается фиксированная ставка за разговоры , которые включают в себя все сообщения, которыми обменялись в течение 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, которое непосредственно предшествовало сообщению P2A. Это сообщение 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.Категории биллинга «Базовое сообщение» и «Одно сообщение» используются для классификации неразговорных агентов. Агенты в этих категориях выставления счетов не генерируют события разговорного выставления счетов (
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, округленное до ближайшего часа.
| 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 |
Образец отчета о платежных событиях
Образец отчета о платежах доступен для скачивания .
Типичный размер файла
Ежедневный отчет от активного партнера RBM может содержать около 53 000 записей и иметь размер около 8 МБ.
Журналы активности
Журналы активности предоставляют необработанные данные об активности на платформе RBM. Вы можете использовать эти журналы для аудита событий выставления счетов и создания пользовательских событий.
Поскольку журналы активности содержат личную информацию (PII), такую как подробная информация о транзакциях и MSISDN подписчика, они доступны только в том случае, если оператор связи использует RCS в соответствии со своими собственными Условиями обслуживания. Если в ваших сетях есть трафик RBM и вы включили активность RCS с Google RCS Cloud в соответствии с Условиями обслуживания 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 | ГГГГ-мм-ддТЧЧ:ММ:СС.СССЗ | Дата и время отправки события на платформу RBM в формате UTC. См . Временные метки . | 2019-07-25T00:29:07.033Z |
type | нить | Вид деятельности:
| text_message |
size_bytes | нить | Размер файлов, прикрепленных к действию, в байтах. | 912 |
Временные метки
Временные метки в журналах активности фиксируют, когда событие было отправлено на платформу RBM. События, которые доставляют контент пользователю, не будут записываться в журнал активности до тех пор, пока сообщение не будет доставлено.
Например, если сообщение RBM отправлено пользователю в среду в 13:00, а получатель находится в автономном режиме до 9:00 воскресенья, событие появится в журнале активности, созданном для воскресенья, но временная метка будет Среда, 13. :00.
Часто задаваемые вопросы
Что такое разговор?
В RBM диалог — это серия сообщений, которыми обмениваются пользователь и диалоговый агент в течение 24 часов. Только агенты с категорией выставления счетов «Разговор» могут создавать разговоры и взимать плату за следующие события выставления счетов:
- Диалог A2P : разговор, инициированный брендом.
- Разговор P2A : Разговор, инициированный пользователем.
Как работают разговоры
Начало : разговор начинается, когда одна сторона (агент или пользователь) отвечает на сообщение от другой стороны в течение 24 часов с момента его получения, вне какого-либо существующего разговора.
- Диалог A2P : начинается, когда пользователь отвечает на сообщение агента.
- Диалог P2A : начинается, когда агент отвечает на сообщение пользователя.
Окно разговора : разговор остается активным в течение 24 часов после его начала. Разговор включает в себя все сообщения в течение этого 24-часового периода, а также самое первое сообщение, на которое изначально был дан ответ.
Выставление счетов : вместо выставления счетов за каждое отдельное сообщение, разговорные агенты выставляют счет на основе всего разговора. Это означает, что стоимость связана с цепочкой разговоров, а не с количеством сообщений в ней.
Важный :
Разговоры не применяются к неразговорным агентам. Агентам с категориями оплаты «Базовое сообщение» или «Одно сообщение» оплата взимается за каждое сообщение, независимо от того, отвечает ли пользователь.
Для диалоговых агентов создание отчетов о платежных событиях и журналов активности может быть отложено на срок до двух дней. Эта задержка позволяет RBM перехватывать все сообщения в ходе разговора перед расчетом события выставления счета.
На этой странице описаны файлы данных, которые RBM создает для помощи операторам связи в выставлении счетов и аудите.
| Файл | Описание | У кого есть доступ |
|---|---|---|
| Отчет о платежных событиях | Совокупный отчет об оплачиваемых событиях между запущенными агентами и пользователями. | Все перевозчики с подписанным RBM MDA. |
| Журнал активности | Журнал необработанных данных о деятельности RBM, включая оплачиваемые события. | Операторы связи с подписанным RBM MDA, которые используют Службу Google RCS в соответствии со своими Условиями обслуживания (ToS). |
Генерация файлов
Каждый файл данных представляет один день использования RBM во всемирном координированном времени (UTC). Файлы генерируются ежедневно с 10:00 до 12:00 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 мая.
Причина задержки заключается в том, что активность RBM для диалоговых агентов связана с разговорами , завершение которых может занять до 48 часов. Эта задержка позволяет RBM перехватывать все сообщения в ходе разговора перед расчетом события выставления счета. Дополнительную информацию о диалоговых агентах см. в разделе Категории выставления счетов агентам .
Ключевые моменты:
Нет активности : если в определенный день на платформе нет активности, файл не создается.
Именование : дата в имени файла — это дата создания файла, а не дата данных внутри него.
Хранение : файлы хранятся максимум 30 дней, прежде чем будут удалены.
Вы можете использовать эти файлы для обновления своего хранилища данных с учетом последних показателей использования платформы.
Хранение файлов и доступ к ним
Файлы данных шифруются при хранении и передаче.
Чтобы получить файлы данных по 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 .
Отчеты о платежных событиях
Отчеты о событиях выставления счетов — это записи событий выставления счетов , которые рассчитываются на основе категории выставления счетов агента и типа отправляемых им сообщений. Отчеты о событиях выставления счетов доступны всем операторам связи, у которых есть RBM MDA.
Отчеты о событиях выставления счетов содержат конфиденциальную информацию, но не содержат личной информации пользователя (PII), такой как MSISDN, хешированный MSISDN или какой-либо уникальный идентификатор пользователя.
Категории выставления счетов агентам
При создании агента владелец задает ему категорию биллинга в зависимости от того, как агент будет взаимодействовать с пользователями. Категория выставления счетов не ограничивает количество или тип сообщений, которые может отправлять агент. Но он определяет, как агенту будут выставляться счета за сообщения. Две основные категории выставления счетов описаны в следующей таблице.
| Категория биллинга | Тип агента | Примеры использования | Способ оплаты |
|---|---|---|---|
Неразговорный (Включает категории «Основное сообщение» и «Одно сообщение». Примечание . Между этими двумя категориями больше нет никакой разницы. Оператору в любой категории будет выставлен счет как неразговаривающему агенту.) | Агенты, которые в основном отправляют односторонние сообщения. |
| Оплата производится за каждое сообщение, доставленное пользователю. |
| Разговорный | Агенты, предназначенные для взаимного обмена данными с пользователями. |
| Оплата за разговор : если одна сторона (агент или пользователь) отвечает на сообщение другой стороны в течение 24 часов, начинается разговор. В течение окна разговора (24 часа после первого ответа) агент и пользователь могут обмениваться любым количеством сообщений, и агенту будет выставлен счет по фиксированной ставке за разговор. Оплата за сообщение . Если агент доставляет сообщение, на которое пользователь не отвечает в течение 24 часов, агенту будет выставлен счет за отдельное сообщение, аналогично неразговорному агенту. |
Разговорные и неразговорные агенты
Существует две основные категории биллинга: разговорная и неразговорная. Недиалоговая категория включает категории «Основное сообщение» и «Одно сообщение», которые функционально идентичны. Агент в любой из этих категорий считается неразговорным агентом.
Ключевое различие в категориях выставления счетов заключается между разговорными и неразговорными агентами:
Неразговорным агентам выставляется счет за каждое сообщение, которое они доставляют пользователю.
- Эта категория лучше всего подходит для агентов, которые не ожидают частых ответов.
Диалоговым агентам взимается фиксированная ставка за разговоры , которые включают в себя все сообщения, которыми обменялись в течение 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, которое непосредственно предшествовало сообщению P2A. Это сообщение 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.Категории биллинга «Базовое сообщение» и «Одно сообщение» используются для классификации неразговорных агентов. Агенты в этих категориях выставления счетов не генерируют события разговорного выставления счетов (
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, округленное до ближайшего часа.
| 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 |
Образец отчета о платежных событиях
Образец отчета о платежах доступен для скачивания .
Типичный размер файла
Ежедневный отчет от активного партнера RBM может содержать около 53 000 записей и иметь размер около 8 МБ.
Журналы активности
Журналы активности предоставляют необработанные данные об активности на платформе RBM. Вы можете использовать эти журналы для аудита событий выставления счетов и создания пользовательских событий.
Поскольку журналы активности содержат личную информацию (PII), такую как подробная информация о транзакциях и MSISDN подписчика, они доступны только в том случае, если оператор связи использует RCS в соответствии со своими собственными Условиями обслуживания. Если в ваших сетях есть трафик RBM и вы включили активность RCS с Google RCS Cloud в соответствии с Условиями обслуживания 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 | ГГГГ-мм-ддТЧЧ:ММ:СС.СССЗ | Дата и время отправки события на платформу RBM в формате UTC. См . Временные метки . | 2019-07-25T00:29:07.033Z |
type | нить | Вид деятельности:
| text_message |
size_bytes | нить | Размер файлов, прикрепленных к действию, в байтах. | 912 |
Временные метки
Временные метки в журналах активности фиксируют, когда событие было отправлено на платформу RBM. События, которые доставляют контент пользователю, не будут записываться в журнал активности до тех пор, пока сообщение не будет доставлено.
Например, если сообщение RBM отправлено пользователю в среду в 13:00, а получатель находится в автономном режиме до 9:00 воскресенья, событие появится в журнале активности, созданном для воскресенья, но временная метка будет Среда, 13. :00.
Часто задаваемые вопросы
Что такое разговор?
В RBM диалог — это серия сообщений, которыми обмениваются пользователь и диалоговый агент в течение 24 часов. Только агенты с категорией выставления счетов «Разговор» могут создавать разговоры и взимать плату за следующие события выставления счетов:
- Диалог A2P : разговор, инициированный брендом.
- Разговор P2A : разговор, инициированный пользователем.
Как работают разговоры
Начало : разговор начинается, когда одна сторона (агент или пользователь) отвечает на сообщение от другой стороны в течение 24 часов с момента его получения, вне какого-либо существующего разговора.
- Диалог A2P : начинается, когда пользователь отвечает на сообщение агента.
- Диалог P2A : начинается, когда агент отвечает на сообщение пользователя.
Окно разговора : разговор остается активным в течение 24 часов после его начала. Разговор включает в себя все сообщения в течение этого 24-часового периода, а также самое первое сообщение, на которое изначально был дан ответ.
Выставление счетов : вместо выставления счетов за каждое отдельное сообщение, разговорные агенты выставляют счет на основе всего разговора. Это означает, что стоимость связана с цепочкой разговоров, а не с количеством сообщений в ней.
Важный :
Разговоры не применяются к неразговорным агентам. Агентам с категориями оплаты «Базовое сообщение» или «Одно сообщение» оплата взимается за каждое сообщение, независимо от того, отвечает ли пользователь.
Для диалоговых агентов создание отчетов о платежных событиях и журналов активности может быть отложено на срок до двух дней. Эта задержка позволяет RBM перехватывать все сообщения в ходе разговора перед расчетом события выставления счета.