美国结算报告

本页介绍了 RCS for Business 创建的数据文件,这些文件可帮助美国运营商根据美国 RBM 框架进行结算和审核。如需详细了解美国 RBM 框架,您还可以访问 usrbm.org。

结算报告是已发布代理与用户之间可结算事件的汇总报告。“可计费”只是表示相应事件会产生费用。运营商会确定是否以及如何对可结算事件收费。所有正在积极运营 RCS for Business 的美国运营商都可以访问结算报告。

如需详细了解美国结算分类模型,请参阅美国结算常见问题解答。

文件生成

如需了解详情,请参阅文件生成。

文件存储和访问

如需了解详情,请参阅文件存储和访问。

文件可用性

如需了解详情,请参阅文件可用性。

结算报告

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

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

结算类别与可结算事件

了解代理结算类别和可结算事件之间的区别,对于了解代理的结算方式至关重要。

  • 结算类别是您在创建代理时选择的固定分类。它决定了您的智能体结算方式:按消息(非对话智能体)或按会话(对话智能体)。
  • 可计费事件是指 RCS for Business 代理与用户之间出于结算目的而跟踪的互动(例如 rich_message)。

美国代理机构结算类别

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

结算类别 代理类型 应用场景示例 结算方式
非对话 主要发送单向消息的代理。
  • 动态密码
  • 提醒
  • 促销优惠
针对向用户传送的每条消息收费。
对话式 旨在与用户进行来回对话的代理,无论对话由谁发起。
  • 寻找合适的产品
  • 预订门票
  • 排查问题
按会话收费:如果满足会话条件,则 24 小时会话窗口内的所有富媒体消息和富媒体消息均按固定费率收费,无论时长或片段数如何。

按消息收费:如果不满足会话条件,或者消息不在 24 小时会话窗口内,则富媒体消息或富媒体消息将按每条消息的费率单独收费,具体费率取决于各个运营商的价目表。

对话智能体与非对话式智能体

智能体结算分为两类:对话式和非对话式。

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

    • 此类别最适合不期望获得频繁回复的智能体。
  • 对话式代理按会话收取固定费率,前提是会话已触发,然后费用将涵盖 24 小时内交换的所有消息,包括触发会话的消息。对于不属于 24 小时会话的消息,对话智能体仍可能会产生费用。

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

会话结算逻辑

在美国结算模式下,会话由一系列4 条富媒体消息(包括至少 2 条 MO 消息和至少 1 条 MT 消息)触发,这些消息在触发序列中第一条消息发出后的 24 小时内进行交换。达到此阈值后,相应 24 小时窗口内的所有消息都将按单个会话计费。任何未触发会话或不属于会话的消息均按标准每条消息费率计费,具体费率因运营商而异,请参阅相应运营商的费率表。

下图展示了对话式代理的 A2P 结算会话示例。

  • MT(移动被叫)是商家发送的消息。
  • MO(移动设备发起)是指用户发起的消息或操作。

美国结算 - 会话

可计费事件

消息传递流程按其来源和方向进行分类。为了描述消息传递流量的方向,美国运营商通常使用 MT/MO 术语。这些术语与整个 RCS 商务版文档中使用的 A2P/P2A 术语相对应。下面简要介绍了这些术语的对应关系:

  • A2P(应用到个人)是 MT(移动被叫):由商家发送的消息。
  • P2A(个人到应用)是 MO(移动主叫):用户发起的消息或操作。
活动 说明 非对话智能体 对话智能体
a2p_rich_message 仅包含文字、回复建议或特定建议操作(拨打电话号码、在浏览器中打开网址)的智能体发送的消息。 始终被视为单独的结算事件。

按消息根据分段数计费(1 个分段相当于 160 个 UTF-8 字节)。

除非成为会话的一部分,否则会被视为单独的结算事件。
p2a_rich_message 用户发送的消息,其中仅包含自由格式的文本或通过点按回复建议输入的文本。 始终被视为单独的结算事件。

按消息收费,具体取决于消息的段数。

除非成为会话的一部分,否则会被视为单独的结算事件。
a2p_rich_media_message 包含媒体(图片、视频、音频)、复合信息卡、轮播界面或复杂操作(例如“查看位置”)的客服人员发送的消息。 始终被视为单独的结算事件。

无论活动规模或内容如何,都按单一的固定费率活动收费。

除非成为会话的一部分,否则会被视为单独的结算事件。
p2a_rich_media_message 包含上传的媒体文件(图片、视频、音频)的用户发送的消息。 始终被视为单独的结算事件。

按单次活动统一费率结算。

除非成为会话的一部分,否则会被视为单独的结算事件。
p2a_suggested_action 用户点按任何不是回复建议的建议操作(例如“查看位置”)。 始终被视为单独的结算事件。

每次点击生成一个可结算事件。

被视为单独的结算事件,每次点击都会生成一个结算事件,除非它成为会话的一部分。
a2p_session 24 小时的互动窗口,从启动会话触发器并发送第一条 MT 消息时开始。如需了解详情,请参阅什么是会话及其运作方式。 不适用。会话不适用于非对话智能体。 触发后,24 小时窗口中的所有消息都只需支付一次会话费用。24 小时会话中的任何付费事件都将分配给相应会话的付费事件 ID。
p2a_session 24 小时的互动窗口,从启动会话触发器并发送第一条 MO 消息时开始。如需了解详情,请参阅什么是会话以及会话的运作方式。 不适用。会话不适用于非对话智能体。 触发后,24 小时窗口中的所有消息都只需支付一次会话费用。24 小时会话中的任何付费事件都将分配给相应会话的付费事件 ID。

生成结算报告

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

这些报告假设 A2P 消息在传送时(而非发送时)会产生可结算的事件。未递送的消息或在递送前取消的消息不会触发可结算的事件。

结算报告格式

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

报告中的每一行都是一条记录,代表一个可结算的事件。 A2P/P2A 会话由多行表示,每行对应一条交换的消息。与会话关联的每一行(共享相同的 billing_event_id)都会在 mt_messages 和 mo_messages 列中报告整个 24 小时会话窗口的 MT 和 MO 消息总数。

文件采用 UTF-8 编码,不含字节顺序标记,并使用换行符作为行尾标记。每个文件的第一行都是包含字段名称的标题行。

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

字段 格式 说明 示例
billing_event_id 字符串 用于区分可结算事件的生成 ID。

属于同一会话的所有消息都将具有相同的 billing_event_id。

63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e
type 字符串 活动类型:
  • a2p_rich_message
  • a2p_rich_media_message
  • p2a_rich_message
  • p2a_rich_media_message
  • p2a_suggested_action
  • p2a_rich_message
    agent_id 字符串 参与相应活动的代理的唯一标识符。 acme_342h23_agent@rbm.goog
    agent_owner 字符串 创建代理的合作伙伴账号的当前所有者的电子邮件地址。 marketing@xyzaggregator.com
    billing_party 字符串 负责活动结算的方。 运营商
    max_duration_single_message 数值 用户在对话发起窗口关闭之前响应代理消息的最长时间(以小时为单位),超过此时间后,该消息将被归类为 single_message 事件。不适用于美国境内针对个人发送的富媒体消息。 24
    max_duration_a2p_conversation 数值 对于会话 Beta 版,此值反映的是从触发序列中的第一条消息开始计算的 24 小时会话窗口。时长以小时为单位。 24
    max_duration_p2a_conversation 数值 对于会话 Beta 版,此值反映的是从触发序列中的第一条消息开始计算的 24 小时会话窗口。 24
    start_time YYYY-mm-ddTHH:00:00Z

    活动开始的 UTC 日期/时间 (ISO 8601)。对于会话,这是触发序列中第一条消息的时间戳。

    A2P

  • 对于非会话事件(例如 a2p_rich_message 和 a2p_rich_media_message),这是消息传递给用户的时间。
  • 对于 a2p_session 事件,这是会话中的第一条消息传递给用户的时间。
  • P2A

  • 对于非会话事件(例如 p2a_rich_message 和 p2a_rich_media_message),这是用户发送消息的时间。
  • 对于 p2a_session 事件,这是用户发送对话中第一条消息的时间。
  • 2025-05-20T08:00:00Z
    duration 数值 时长仅与会话相关,以分钟为单位。如果相应事件是非会话事件,则该值为 0。 45
    mt_messages 数值 相应事件中的移动终端 (A2P) 消息数。对于会话,共享同一 billing_event_id 的每一行都显示整个会话中的 MT 消息总数。 5
    mo_messages 数值 相应事件中移动设备发起的 (P2A) 消息数量。对于会话,共享同一 billing_event_id 的每一行都会显示整个会话中的 MO 消息总数。 3
    size_kilobytes 数值 相应事件中附加到邮件的所有文件的大小,四舍五入到最接近的千字节(1 KB 等于 1024 字节)。 912
    agent_name 字符串 参与相应活动的代理的名称。 ACME Brand
    owner_name 字符串 创建代理的合作伙伴账号的当前所有者的名称。 XYZ Aggregator
    segment_count 数值 针对 a2p_rich_message events 和 p2a_rich_message 事件计算出的分段数(1 个分段等于 160 个 UTF-8 字节)。如果事件不是上述事件之一,则值为 0。 5
    session_type 字符串 会话类型:
  • a2p_session
  • p2a_session
  • 如果相应 activity 不符合会话条件,则为空。
    a2p_session

    结算报告示例

    您可以下载示例报告:

    典型文件大小

    有效 RCS for Business 合作伙伴的每日报告大小取决于他们在运营商网络上产生的活动量。