结算报告和活动日志

本页介绍了 RCS 商务版创建的数据文件，这些文件可帮助运营商进行结算和审核。

文件 说明 有权访问的人
结算报告 启动的代理与用户之间可结算事件的汇总报告。 所有正在积极运营 RCS for Business 的运营商。
活动日志 RCS for Business 活动的原始数据日志，包括可结算事件。 积极运营 RCS 商家服务并根据自己的服务条款 (ToS) 运营 Google RCS 服务的运营商。

RCS for Business 采用两种结算模式：针对非美国流量的标准结算模式和针对美国流量的美国结算模式。 标准模型或美国模型特有的信息（例如，不同的可结算事件分类或报告字段）会明确注明。

文件生成

每个数据文件都表示一天（以世界协调时间 [UTC] 为准）的 RCS 商务版使用情况。文件每天生成一次。生成过程可能需要数小时，完成时间可能会有所不同。

  • 对于非对话型代理，文件包含文件生成时间之前 24 小时内的数据。例如，如果系统在 5 月 5 日 11:00 UTC 生成结算报告，则该报告将包含 5 月 4 日 11:00 UTC 至 5 月 5 日 11:00 UTC 的数据。

  • 对于对话式代理，文件包含文件生成时间前 1-2 天内 24 小时的数据。例如，如果结算报告是在 5 月 5 日 11:00（世界协调时间 [UTC]）生成的，则其中可能包含 5 月 3 日 11:00（世界协调时间 [UTC]）至 5 月 4 日 11:00（世界协调时间 [UTC]）的数据。

    延迟的原因是，对话式代理的 RCS Business Messaging 活动与对话相关联，而对话最多可能需要 48 小时才能完成。此延迟时间可让 RCS Business Messaging 在计算可结算事件之前捕获对话中的所有消息。如需详细了解对话式代理，请参阅代理结算类别。

要点：

  • 无活动：如果某天没有平台活动，系统不会生成任何文件。

  • 命名：文件名中的日期是文件生成日期，而不是文件内数据的日期。

  • 保留期限：文件最多会存储 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 商务流量，系统将不会生成文件。 这意味着，可能在某些天内不会生成任何文件。如果您需要空文件来简化流程，请发送电子邮件至 rbm-support@google.com。

结算报告

结算报告是可结算事件的记录，这些事件是根据代理的结算类别和其发送的消息类型计算得出的。结算报告面向所有正在积极运营 RCS 商务的运营商提供。

结算报告包含机密信息，但不包含用户个人身份信息 (PII)，例如 MSISDN、经过哈希处理的 MSISDN 或任何用户唯一标识符。

代理机构结算类别

创建代理时，所有者会根据代理与用户的互动方式设置其结算类别。结算类别不会限制智能体可以发送的消息数量或类型。但它确实会决定代理如何为消息付费。下表介绍了两个主要结算类别。

结算类别 代理类型 应用场景示例 结算方式
与对话无关 主要发送单向消息的代理。
  • 动态密码
  • 提醒
  • 促销优惠
 按向用户发送的每条消息收费。
对话式 旨在与用户进行来回对话的代理。
  • 寻找合适的产品
  • 预订车票
  • 排查问题

按对话收费：如果一方（代理或用户）在 24 小时内回复另一方的消息，则对话开始。在对话窗口期（首次回复后的 24 小时内），客服人员和用户可以交换任意数量的消息，客服人员将按固定费率为对话付费。

按消息收费： 如果代理发送的消息在 24 小时内未收到用户回复，则系统会针对该条消息向代理收费，这与非对话型代理类似。

下图展示了对话型代理的 A2P 结算会话示例：

结算图

对话式代理与非对话式代理

主要有两大类结算方式：对话式和非对话式。

结算类别的主要区别在于对话式智能体和非对话式智能体：

  • 非对话型代理会针对其向用户发送的每条消息收取费用。

    • 此类别最适合不希望频繁收到回复的代理。

  • 对于对话式代理，系统会按固定费率收取对话费用，其中包括 24 小时内交换的所有消息。

    • 此类别最适合与用户进行多轮对话的代理。

可计费事件

结算报告中会记录五种类型的结算事件。这些事件包括 MT 事件和 MO 事件，分别称为 A2P 事件和 P2A 事件。

  • A2P（应用到个人）是 MT（移动被叫）：由商家发送的消息。
  • P2A（用户到应用）是 MO（移动主叫）：用户发起的某条消息或某项操作。

下表介绍了每种可结算事件（适用于非对话型代理和对话型代理）。

事件 说明 非对话式代理 对话智能体
basic_message 仅包含文本且不超过 160 个字符的 A2P 消息。如果文本包含带有 openGraph 标记的网站的网址，则消息可能会显示图片预览，而不会向合作伙伴收取额外费用。 始终视为单独的结算事件，无论用户是否回复。 除非用户在 24 小时内回复，否则系统会将此消息视为单独的付费事件。在这种情况下，消息会成为 a2p_conversation 的一部分。
single_message 包含富媒体内容或仅包含文字内容且长度超过 160 个字符的 A2P 消息。 始终视为单独的结算事件，无论用户是否回复。 除非用户在 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 Business Messaging 代理与用户之间出于结算目的而跟踪的互动（例如 basic_message、single_message、a2p_conversation）。

生成结算报告

只有具有非测试者流量的代理才会生成可计费事件。测试电话号码的活动不会显示在结算报告中。

这些报告假设事件是在消息传送时（而非发送时）计费的。未递送的邮件或在递送前取消的邮件不会触发可结算的事件。

结算报告格式

结算报告采用 rbm_billable_events_YYYY-MM-DD.csv 的文件名格式。文件名中的日期是文件生成日期。

报告中的每一行都是一条记录，代表一个可结算的事件。记录中的字段以制表符分隔。例如，与同一客服人员进行的两次 A2P 对话会生成两个单独的计费事件，并在结算报告中生成两条记录。

报告中的每条记录都包含每个可结算事件的以下信息。

字段 格式 说明 示例
billing_event_id 字符串 UUID 标识符。为每个新事件在创建时生成的随机数。 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
type 字符串 活动类型：

    标准结算模式

  • basic_message
  • single_message
  • a2p_conversation
  • p2a_conversation
  • p2a_message

    • 美国结算模式

  • a2P_rich_message
  • a2p_rich_media_message
  • p2a_rich_message
  • p2a_rich_media_message
  • suggested_action_click
 single_message

p2a_rich_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 消息

  • 对于 single_message 和 basic_message 事件，这是消息传递给用户的时间。
  • 对于 a2p_conversation 事件，这是会话中的第一条消息传递给用户的时间。

P2A 消息

  • 对于 single_message 和 basic_message 事件，这是用户发送消息的时间。
  • 对于 p2a_conversation 事件，这是用户发送对话中第一条消息的时间。
 2019-07-25T08:00:00Z
duration 数值 活动时长，四舍五入到最接近的分钟数。

如果事件类型为 single_message 或 basic_message，则该值为 0。

 45
mt_messages 数值 相应事件中的移动终端 (A2P) 消息数量。 11
mo_messages 数值 相应事件中移动设备发起的 (P2A) 消息数量。 9
size_kilobytes 数值 相应事件中附加到邮件的所有文件的大小，四舍五入到最接近的千字节（1kB = 1024 字节）。 912
agent_name 字符串

参与活动的代理的名称。

 XYZ Mobile USA
owner_name 字符串 创建代理的合作伙伴账号的当前所有者的名称。 XYZ Mobile
segment_count 数值 仅限美国结算模式

RICH_MESSAGE 事件的计算出的细分数量。

 5

结算事件报告示例

您可以下载示例报告：

典型文件大小

有效 RCS 商业合作伙伴的每日报告大小取决于他们在运营商网络上产生的活动量。例如，如果报告中有 53,000 条记录，则文件大小约为 8 MB。

活动日志

活动日志提供有关 RCS for Business 平台上的活动的原始数据。您可以使用这些日志来审核结算事件和创建自定义事件。

注意：活动日志中仅包含来自非测试人员电话号码的流量。

由于活动日志包含个人身份信息 (PII)，例如详细的交易信息和订阅者 MSISDN，因此只有当运营商根据自己的服务条款运营 RCS 时，才能使用活动日志。如果您在网络中拥有 RCS for Business 流量，并根据 Google 的服务条款通过 Google RCS 启用 RCS 活动，则无法访问活动日志。

活动日志格式

活动日志使用 rbm_activity_YYYY-MM-DD.csv 文件名格式。文件名中的日期是文件生成日期。

记录中的各个字段以制表符分隔，每行一条记录。

活动日志中的每条记录都包含以下字段，用于记录每项活动：

字段 格式 说明 示例
activity_id 字符串 活动的唯一标识符。 b422e1d3-ac99-442a-853d-a875d5e61762
billing_event_id 字符串 关联结算事件的唯一标识符。如果 activity 未与结算事件相关联，则可以为空，例如没有相应 delivery_receipt_event 的 text_message。 91yeb201-7c3b-412b-98d2-b0a0f7abe536
agent_id 字符串 代理的唯一标识符。 welcome-bot@rbm.goog
user_id 字符串 用户的 MSISDN。 918369110173
direction 字符串 消息的发送方向：
  • MT（移动终端）用于客服人员与用户之间的活动
  • MO（移动设备发起）用于用户与客服人员之间的互动
 MT
time YYYY-mm-ddTHH:MM:SS.SSSZ 事件提交到 RCS for Business 平台时的日期和时间（采用世界协调时间 [UTC] 格式）。请参阅时间戳。 2019-07-25T00:29:07.033Z
type 字符串 活动类型：
  • text_message
  • file_transfer
  • rich_card/carousel
  • suggestion_tap
  • delivery_receipt_event
  • read_receipt_event
  • spam_report
 text_message
size_bytes 字符串 附加到活动的文件的大小（以字节为单位）。 912

时间戳

活动日志中的时间戳记录了事件提交到 RCS 商务平台的时间。对于向用户传送内容的事件，在消息传送之前，活动日志中不会记录相应事件。

例如，如果某条 RCS 商务消息是在周三 13:00 发送给用户的，而接收者在周日 9:00 之前一直处于离线状态，那么该事件将显示在周日生成的活动日志中，但时间戳将为周三 13:00。