RBM 会创建数据文件，以报告摘要和 事务层级数据会拆分到多个文件中：
| 文件 | 说明 | 有权访问的人 |
|---|---|---|
| 结算事件报告 | 启动的代理和用户之间的计费事件记录 | 在其网络上具有 RBM 流量的所有运营商 |
| 活动日志 | 原始 RBM 平台活动数据 | 在其网络上存在 RBM 流量并启用 RCS 活动的运营商 遵守 Jibe Cloud 自己的服务条款 (ToS) |
生成
结算事件报告和活动日志的生成会有两天的延迟。
只有当活动事件所属的结算会话所属的结算会话时，Google 才会报告该活动事件 。会话最长可能需要 24 小时才能完成，并且我们的账单 流水线每天执行一次，只报告确保 已完成（至少存在 24 小时）。
例如：
我们会在 d 日发送消息并启动结算会话，但 错过了 1 小时的流水线执行作业。因此，不会触发任何活动事件 被举报。
当流水线在 d+1 上再次运行时，启动的消息为 才发布 23 小时。因此，系统不会报告此消息的任何活动事件 。
当流水线在 d+2 上再次运行时，会话已完成， 活动事件会与结算会话一起报告。
存储和访问
数据文件无论是在静态存储时还是在传输过程中，都会受到加密保护。
要通过 SFTP 检索数据文件，您需要提供 SFTP 公钥。接收者 生成密钥，请参阅 为 SFTP 生成安全外壳 (SSH) 密钥对 Dropbox。
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 天的世界协调时间 (UTC) 日期。
生成文件的导出进程在太平洋标准时间凌晨 2 点到 4 点之间执行。
数据文件最多可保留 30 天，然后才会被删除。
结算事件报告
结算事件报告是根据 则使用建议的结算单位。计费事件包含 但不包含用户个人身份信息（例如，没有 MSISDN、经过哈希处理的 MSISDN 或任何 用户唯一标识符）。
只有已发布的代理才会生成结算事件。尚未发布的活动 或未发布的代理不会显示在结算报告中。
结算报告假定事件在传送邮件时进行计费，而不是 。邮件未递送，或邮件在递送前被撤消 不会触发结算事件。
每个 RBM 代理都有一个结算类别， 在提交代理以供发布之前由代理开发者设置。结算 类别决定了代理发送的消息是离散消息还是 它们是否可合并到对话式结算事件中
有五种类型的可计费事件：
| 事件 | 定义 |
|---|---|
| 基本讯息 | 应用对个人 (A2P) 消息
仅限对话代理：如果 P2A 消息以 对 A2P 消息作出回应，则“基本消息” 成为 A2P 对话的一部分；否则，会话将终止。答 客服人员始终会将基本消息发送给用户。 |
| 单条消息 | 应用对个人 (A2P) 消息
仅限对话代理：如果 P2A 消息递送到 24 小时内，单条消息成为 A2P 对话的一部分； 否则，会话将终止。始终发送一条消息 从代理传递给用户 |
| A2P 对话 | 仅适用于对话代理：A2P 对话 当 P2A 消息在 A2P 单点发送后的 24 小时内传送时启动 消息或 A2P 基本消息。请注意，如果 P2A 消息在 24 小时内显示多条 A2P 消息，但仅限于立即 之后，P2A 消息就用于创建对话会话。这个 A2P 消息以及在接下来的 24 小时内传送的所有消息 都属于新的 A2P 对话。 |
| P2A 对话 | 仅适用于对话式代理：P2A 对话 没有活动会话时发起（A2P 单条消息、A2P） 对话（简称 P2A 对话）发出，且系统传递了 P2A 消息，并且 商家会在 24 小时内回复。 |
| P2A 消息 | 非对话代理：用户向
具有结算类别的代理
（单条消息或基本消息）。
对话代理：用户向该代理发送的 P2A 消息 没有现成对话且客服人员 返回回复。 |
可用性
所有启用了 RBM 流量的运营商都会提供结算事件报告 。
格式
结算事件报告使用文件名格式
YYYY/MM/DD/rbm_billable_events_YYYY-MM-DD.csv。
文件名中的日期是文件的生成日期。中的记录 文件通常包含文件前两天的活动情况 生成日期。
记录中的字段以制表符分隔，并且每行一条记录。
每个结算事件都只有一条记录。例如，两个 A2P 将产生两个结算事件和两个 记录。
可结算事件报告中的每条记录都包含有关 每个事件：
| 字段 | 格式 | 说明 | 示例 |
|---|---|---|---|
billing_event_id
|
字符串 | UUID 标识符（一个随机数）， 状态 | |
type
|
字符串 | 事件类型：
<ph type="x-smartling-placeholder">
|
single_message
|
agent_id
|
字符串 | 参与事件的客服人员的标识符。 | rbm-welcome-bot@rbm.goog
|
agent_owner
|
字符串 | 相应合作伙伴账号当前所有者的电子邮件地址， 已创建代理。此值取自“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
|
YYYY-mm-ddTHH:00:00Z | 事件开始的世界协调时间 (UTC) 日期/时间，采用 ISO 8601 格式四舍五入到
最接近的小时数。
|
2019-07-25T08:00:00Z
|
duration
|
数值 | 事件的持续时间，四舍五入至最接近的分钟数。
当事件类型为 |
45
|
mt_messages
|
数值 | 事件中通过移动设备终止的消息的数量。 | 11
|
mo_messages
|
数值 | 事件中来自移动设备的消息的数量。 | 9
|
size_kilobytes
|
数值 | 活动中附加到邮件的所有文件的大小，四舍五入为 最接近的千字节（1 kB = 1024 字节）。 | 912
|
agent_name
|
字符串 |
参与活动的客服人员。 |
XYZ Mobile USA
|
owner_name
|
字符串 | 相应合作伙伴账号当前所有者的电子邮件地址， 已创建代理。此值取自“RBM Google 账号”字段 当合作伙伴 注册使用 RBM 时提供。 | XYZ Mobile
|
示例文件
您可以下载示例结算报告文件。
一般文件大小
活跃合作伙伴的每日报告文件可能包含大约 53,000 条记录， 大约 8Mb。
活动日志
活动日志是 RBM 平台上针对 用于审核可计费事件和构建自定义事件。
可用性
活动日志仅适用于在其设备上具有 RBM 流量的运营商 并在 Jibe Cloud 根据其自身的 服务条款 (ToS)。如果您根据 Jibe 的服务条款使用 Jibe Cloud，则无法访问 活动日志。
格式
活动日志使用的文件名格式 YYYY/MM/DD/rbm_activity_YYYY-MM-DD.csv。
文件名中的日期是文件的生成日期。中的记录 此文件通常包含此日期之前两天的活动情况 日期。
记录中的字段以制表符分隔，并且每行一条记录。
活动日志中的每条记录包含每项活动的以下字段 事件。
| 字段 | 格式 | 说明 | 示例 |
|---|---|---|---|
activity_id
|
字符串 | 活动的标识符。 | |
billing_event_id
|
字符串 | 发生活动的结算事件的标识符。如果 activity 未与任何会话关联（例如没有相应 delivery_receipt_event 的 text_message），则此字段可以为空。
|
|
agent_id
|
字符串 | 代理的标识符。 | welcome-bot@rbm.goog
|
user_id
|
字符串 | 用户的 MSISDN。 | 918369110173
|
direction
|
字符串 | 邮件的发送方向：
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | 将活动提交到 RBM 平台的世界协调时间 (UTC) 日期/时间。 请参阅注意。 | 2019-07-25T00:29:07.033Z
|
type
|
字符串 | 活动类型：
|
text_message
|
size_bytes
|
字符串 | 附加到 activity 的文件的大小（以字节为单位）。 | 912
|
关于时间戳的注意事项
活动日志中的时间戳记录的是将事件提交到 RBM 平台。对于向用户传送内容的事件， 会写入活动日志，直到消息传送完毕。
例如，假设在星期三 13:00 向用户发送 RBM 邮件，而 在星期日 09:00 之前收件人处于离线状态，则此活动会显示在 为星期日生成的活动日志。活动中事件的时间戳 日志时间为星期三 13:00。