调用GetMessageCampaignInsights接口获取营销活动成效分析数据-Chat App 消息服务-阿里云

查询预算指标。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

cams:GetMessageCampaignInsights

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
CustSpaceId	string	是	ISV 子客户的 SpaceId/实例 ID。即通道 ID，在通道管理界面查看。	cams-x**
PageId	string	是	要查询的页码。	323**
AdAccountId	string	是	Meta 广告账户 ID	23***
CampaignId	string	是	预算 ID	23**

返回参数

名称	类型	描述	示例值
	object
AccessDeniedDetail	string	访问被拒绝详细信息。	None
Message	string	错误描述信息。	OK
RequestId	string	请求 ID。	s39**
Data	array<object>	返回数据对象。
	object	返回数据。
MarketingMessagesLinkBtnClick	string	用户在营销消息中执行点击或轻触操作的次数，这些操作将引导用户前往广告主指定的 Meta 技术站内或站外目标位置。这项指标不包括发送到欧洲、阿根廷、土耳其、韩国和日本的消息。	268
MarketingMessagesSpend	string	在整个投放期为消息营销活动、消息组或消息花费的总金额。	38.87
MarketingMessagesDelivered	string	商家向用户发送并成功送达的消息数量。部分消息可能无法送达，例如用户设备无法使用时。这项指标不包括送达至欧洲和日本的消息。在某些情况下，该指标可能为预估值，且由于数据处理过程中存在细微差异，其值可能与您结算单上显示的数据不一致。	2755
DateStop	string	结束时间	2025-07-29
MarketingMessagesReadRate	string	已读消息数除以送达消息数。系统可能未捕捉到部分消息的已读状态，例如当客户关闭已读回执时。这项指标不包括发送到欧洲和日本的消息。	79.419238
MarketingMessagesCostPerDelivered	string	每条送达消息的平均费用。	2755
DateStart	string	开始时间	2025-07-01
MarketingMessagesDeliveryRate	string	消息到达率。	79.419238
MarketingMessagesLinkBtnClickRate	string	获得链接点击的送达消息占送达消息总数的百分比。这项指标不包括发送到欧洲、阿根廷、土耳其、韩国和日本的消息。	79.419238
MarketingMessagesCostPerLinkBtnClick	string	每次消息链接点击的平均费用。这项指标不包括发送到欧洲、阿根廷、土耳其、韩国和日本的消息。	268
Code	string	请求状态码。取值： OK：代表请求成功。其他错误码，请参见错误码列表。	OK
Success	boolean	操作是否成功。取值： true：成功。 false：失败。	true

示例

正常返回示例

JSON格式

{
  "AccessDeniedDetail": "None",
  "Message": "OK",
  "RequestId": "s39**",
  "Data": [
    {
      "MarketingMessagesLinkBtnClick": "268",
      "MarketingMessagesSpend": "38.87",
      "MarketingMessagesDelivered": "2755",
      "DateStop": "2025-07-29",
      "MarketingMessagesReadRate": "79.419238",
      "MarketingMessagesCostPerDelivered": "2755",
      "DateStart": "2025-07-01",
      "MarketingMessagesDeliveryRate": "79.419238",
      "MarketingMessagesLinkBtnClickRate": "79.419238",
      "MarketingMessagesCostPerLinkBtnClick": "268"
    }
  ],
  "Code": "OK",
  "Success": true
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。