本页介绍了 RCS for Business 创建的数据文件，以帮助运营商进行计费和审计。
| 文件 | 描述 | 谁有权访问 |
|---|---|---|
| 账单报告 | 已启动代理和用户之间计费事件的汇总报告。 | 所有正在积极运营 RCS for Business 的运营商。 |
| 活动日志 | RCS for Business 活动的原始数据日志，包括计费事件。 | 积极运营 RCS for Business 并根据其自身服务条款 (ToS) 运营 Google RCS 服务的运营商。 |
RCS for Business 对非美国流量采用标准计费模式。详情请参阅计费常见问题解答。
文件生成
每个数据文件代表太平洋标准时间 (PST) 下一天的 RCS for Business 使用情况。文件每日生成，反映前 24 小时（午夜至午夜）的活动。生成过程可能需要几个小时，完成时间可能有所不同。
- 对于非对话式代理，文件包含生成该文件当日之前 24 小时内的数据。例如，5 月 5 日生成的报告涵盖 5 月 4 日凌晨 12:00 至 5 月 5 日凌晨 12:00 的数据。此处所指时间为太平洋标准时间 (PST)。
对于对话式代理，文件包含生成文件前 1-2 天的 24 小时数据。例如，5 月 5 日生成的报告涵盖 5 月 2 日或 3 日的 24 小时数据。指定时间为太平洋标准时间 (PST)。
造成延迟的原因是，RCS for Business 中对话代理的活动与会话相关联，而会话可能需要长达 24 小时才能完成。此延迟允许 RCS for Business 在计算计费事件之前捕获对话中的所有消息。有关对话代理的更多信息，请参阅“代理计费类别” 。
要点：
- 无活动：默认情况下，如果某一天平台没有任何活动，则不会生成任何文件。但是，您可以选择接收空文件（如有需要）。要选择接收，请联系 rbm-support@google.com。
- 命名：文件名中的日期是文件生成日期，而不是文件内容的日期。
- 保留期限：文件最多保存 63 天，之后将被删除。
您可以利用这些文件，通过最新的平台使用指标来更新您的数据仓库。
文件存储和访问
数据文件在存储和传输过程中均进行加密。
要通过安全文件传输协议 (SFTP) 获取数据文件，请提供您的 SFTP 公钥。要生成密钥，请参阅“为 SFTP Dropbox 生成安全外壳 (SSH) 密钥对” 。
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> ，并为每种报告类型提供单独的帐户。
我们为访问不同类型的报告提供了单独的账户。
文件可用性
如果尚未生成任何数据文件，您将看到类似于remote readdir("/"): No such file or directory SFTP 错误，这是预期的。
如果没有 RCS for Business 流量需要报告，则不会生成文件。这意味着可能有些日子不会生成任何文件。如果您需要空文件来简化流程，请联系 RCS for Business 支持团队。
账单报告
计费报告记录了可计费事件，其计算依据是代理的计费类别及其发送的消息类型。所有积极运营 RCS for Business 的运营商均可获取计费报告。
账单报告包含机密信息，但不包含用户个人身份信息 (PII)，例如 MSISDN、哈希 MSISDN 或任何用户唯一标识符。
代理计费类别
创建代理时，所有者会根据代理与用户的互动方式设置其计费类别。计费类别不会限制代理可以发送的消息数量或类型，但会决定代理发送消息的计费方式。下表描述了两种主要的计费类别。
| 计费类别 | 代理类型 | 示例用例 | 计费方式 |
|---|---|---|---|
| 非对话式 | 主要发送单向信息的代理。 |
| 按发送给用户的每条消息收费。 |
| 对话 | 专为与用户进行双向交流而设计的代理。 |
| 按对话次数计费：如果一方（客服人员或用户）在 24 小时内回复另一方的消息，则对话开始。在对话有效期内（自首次回复之日起 24 小时内），客服人员和用户可以交换任意数量的消息，客服人员将按固定费率支付对话费用。 按消息计费：如果客服人员发送的消息用户在 24 小时内没有回复，客服人员将按该消息单独计费，类似于非对话式客服人员。 |
下图展示了对话式代理的 A2P 计费会话示例：
对话式代理与非对话式代理
计费方式主要分为两大类：对话式计费和非对话式计费。
计费类别的主要区别在于对话式代理和非对话式代理：
非对话式代理会根据其向用户发送的每条消息收费。
- 这一类别最适合那些不期望频繁收到回复的经纪人。
对话代理按对话次数收取固定费用，其中包括 24 小时内交换的所有消息。
- 此类别最适合与用户进行多轮对话的代理。
计费事件
计费报告中记录了五种计费事件。这些事件包括 MT 和 MO 事件，分别称为 A2P 事件和 P2A 事件。
- A2P（应用程序到个人）是 MT（移动终端） ：由企业发送的消息。
- P2A（人机交互）即 MO（移动端发起） ：由用户发起的消息或操作。
下表描述了适用于非对话式代理和对话式代理的每项计费事件。
| 事件 | 描述 | 非对话代理 | 对话代理 |
|---|---|---|---|
basic_message | A2P消息仅包含不超过160个字符的文本。如果文本包含带有OpenGraph标签的网站URL，则消息可以显示图像预览，合作伙伴无需支付额外费用。 | 无论用户是否回复，始终将其视为单独的计费事件。 | 除非用户在 24 小时内回复，否则该消息将被视为单独的计费事件。在这种情况下，该消息将成为a2p_conversation的一部分。 |
single_message | A2P 消息，可以是包含丰富内容的消息，也可以是超过 160 个字符的纯文本消息。 | 无论用户是否回复，始终将其视为单独的计费事件。 | 除非用户在 24 小时内回复，否则该消息将被视为单独的计费事件。在这种情况下，该消息将成为a2p_conversation的一部分。 |
a2p_conversation （企业发起） | 当用户在收到 A2P 消息后的 24 小时内回复该消息，且该回复不是在现有对话中发起时，即触发此事件。 | 不适用。非对话式智能体永远不会产生此类事件。 | 如果一条 P2A 消息在多条 A2P 消息发出后的 24 小时内送达，则仅使用紧邻 P2A 消息之前的 A2P 消息来启动对话。这条 A2P 消息以及接下来 24 小时内送达的任何消息都属于a2p_conversation的一部分。 |
p2a_conversation （用户发起） | 当客服人员在收到 P2A 消息后的 24 小时内，在现有对话之外回复该消息时，即发起此操作。 | 不适用。非对话式智能体永远不会产生此类事件。 | 如果一条 A2P 消息在多条 P2A 消息发出后的 24 小时内送达，则仅使用紧邻该 A2P 消息之前的 P2A 消息来启动对话。这条 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 | 细绳 | 用于区分计费事件的生成 ID。 | 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 | YYYY-mm-ddTHH:00:00Z | 事件开始的 UTC 日期/时间，采用 ISO 8601 格式，四舍五入到最接近的小时。 A2P消息
P2A消息
| 2019-07-25T08:00:00Z |
duration | 数字 | 事件持续时间，四舍五入到最接近的分钟。 对于任何非对话事件，该值为 0。 | 45 |
mt_messages | 数字 | 事件中移动终端（A2P）消息的数量。 | 11 |
mo_messages | 数字 | 事件中移动端发起的（P2A）消息数量。 | 9 |
size_kilobytes | 数字 | 事件中所有附加到消息的文件的大小，四舍五入到最接近的千字节（1kB 等于 1024 字节）。 | 912 |
agent_name | 细绳 | 参与此次活动的代理人姓名。 | XYZ Mobile USA |
owner_name | 细绳 | 创建代理的合作伙伴帐户的当前所有者的姓名。 | XYZ Mobile |
账单样本报告
可供下载的报告样本：
典型文件大小
活跃的RCS for Business合作伙伴每日报告的大小取决于他们在运营商网络上产生的活动量。例如，如果报告中有53,000条记录，则文件大小约为8MB。
活动日志
活动日志提供有关 RCS for Business 平台上活动的原始数据。您可以使用这些日志来审核计费事件并创建自定义事件。
由于活动日志包含个人身份信息 (PII)，例如详细的交易信息和用户 MSISDN，因此只有当运营商根据其自身的服务条款运营 RCS 时，才能访问这些日志。如果您在网络上使用 RCS for Business 流量，并根据 Google 的服务条款启用 Google RCS 活动，则您将无法访问活动日志。
活动日志格式
活动日志使用rbm_activity_YYYY-MM-DD.csv的文件名格式。文件名中的日期是文件生成日期。
记录中的字段以制表符分隔，每行一条记录。
活动日志中的每条记录都包含以下字段，分别对应每项活动：
| 场地 | 格式 | 描述 | 例子 |
|---|---|---|---|
activity_id | 细绳 | 活动的唯一标识符。 | b422e1d3-ac99-442a-853d-a875d5e61762 |
billing_event_id | 细绳 | 关联计费事件的唯一标识符。如果活动未与计费事件关联，例如没有相应delivery_receipt_event text_message ，则可以为空。 | 91yeb201-7c3b-412b-98d2-b0a0f7abe536 |
agent_id | 细绳 | 代理的唯一标识符。 | welcome-bot@rbm.goog |
user_id | 细绳 | 用户MSISDN。 | 918369110173 |
direction | 细绳 | 信息发送方向：
| MT |
time | YYYY-mm-ddTHH:MM:SS.SSSZ | 事件提交至 RCS for Business 平台的日期和时间（UTC 格式）。请参阅时间戳。 | 2019-07-25T00:29:07.033Z |
type | 细绳 | 活动类型：
| text_message |
size_bytes | 细绳 | 活动附件的大小（以字节为单位）。 | 912 |
时间戳
活动日志中的时间戳记录了事件提交到 RCS for Business 平台的时间。对于向用户传递内容的事件，只有在消息送达后才会记录在活动日志中。
例如，如果周三 13:00 向用户发送 RCS for Business 消息，而收件人直到周日 9:00 才上线，则该事件将出现在周日生成的活动日志中，但时间戳将显示为周三 13:00。