合作伙伴中心分析 - 资源
适用于:合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心
通过 Analytics API,你可以以编程方式访问用户体验中显示的数据。
先决条件
- 合作伙伴中心身份验证中所述的凭据。 这些方案仅支持使用用户凭据进行身份验证。
CSP 计划:Azure 使用情况分析
以下方案演示如何使用分析 API 检索所有合作伙伴中心 Azure 使用情况分析信息。
此方案返回 Azure 使用情况资源的集合中的分析信息。
Azure 使用情况资源
表示 Azure 使用情况的所有分析数据。
properties | 类型 | 描述 |
---|---|---|
CustomerTenantId | string | 客户租户标识符。 |
customerName | string | 客户名称。 |
subscriptionId | string | 订阅标识符。 |
subscriptionName | string | 订阅名称。 |
usageDate | string | 使用日期。 |
resourceLocation | string | 例如,数据中心、西欧的位置。 |
meterCategory | string | 例如,计量类别、数据管理。 |
meterSubcategory | string | 计量子类别,例如异地冗余。 |
meterUnit | string | 计量单位,如千兆字节或小时。 |
reservationOrderId | string | Azure VM 预留实例的预留订单。 |
reservationId | string | 特定 RI 订单下的预留实例。 |
serviceType | string | 指示虚拟机类型。 例如,Standard_E4s_v3。 |
quantity | long | 指示计量单元中使用的数字。 |
CSP 计划:间接经销商分析
以下方案演示如何使用分析 API 检索所有合作伙伴中心间接经销商分析信息。
此方案返回间接经销商资源的集合中的分析信息。
间接经销商资源
表示间接经销商的所有分析数据。
properties | 类型 | 描述 |
---|---|---|
partnerTenantId | string | 要为其检索间接经销商数据的合作伙伴的租户 ID。 |
id | string | 间接经销商 ID。 |
name | string | 要为其检索间接经销商数据的合作伙伴的名称。 |
market | string | 要为其检索间接经销商数据的合作伙伴市场。 |
firstSubscriptionCreationDate | 采用 UTC 日期/时间格式的字符串 | 要检索间接经销商数据的第一个订阅的创建日期。 |
latestSubscriptionCreationDate | 采用 UTC 日期/时间格式的字符串 | 最新订阅的创建日期。 |
firstSubscriptionEndDate | 采用 UTC 日期/时间格式的字符串 | 首次终止任何订阅。 |
latestSubscriptionEndDate | 采用 UTC 日期/时间格式的字符串 | 终止任何订阅的最新日期。 |
firstSubscriptionSuspendedDate | 采用 UTC 日期/时间格式的字符串 | 首次暂停任何订阅。 |
latestSubscriptionSuspendedDate | 采用 UTC 日期/时间格式的字符串 | 暂停任何订阅的最新日期。 |
firstSubscriptionDeprovisionedDate | 采用 UTC 日期/时间格式的字符串 | 首次取消预配任何订阅。 |
latestSubscriptionDeprovisionedDate | 采用 UTC 日期/时间格式的字符串 | 取消预配任何订阅的最新日期。 |
subscriptionCount | double | 所有增值经销商的订阅计数 |
licenseCount | double | 所有增值经销商的许可证计数 |
indirectResellerCount | double | 间接经销商计数 |
CSP 计划:订阅分析
以下方案演示如何使用分析 API 检索所有合作伙伴中心订阅分析信息、使用搜索查询对其进行筛选,或按日期或术语对其进行分组。
所有这些方案都会在订阅资源的集合中返回分析信息。
订阅资源
表示订阅的所有分析数据。
properties | 类型 | 描述 |
---|---|---|
customerTenantId | string | 标识客户租户的 GUID 格式字符串。 |
customerName | string | 客户的名称。 |
customerMarket | string | 客户在其中开展业务的国家/地区。 |
id | string | 订阅标识符。 |
状态 | string | 订阅状态:“ACTIVE”、“SUSPENDED”或“DEPROVISIONED”。 |
productName | string | 产品的名称。 |
subscriptionType | string | 订阅类型。 注意:此字段区分大小写。 支持的值包括:“办公室”、“Azure”、“Microsoft365”、“Dynamics”、“EMS”。 |
autoRenewEnabled | boolean | 一个值,该值指示是否自动续订订阅。 |
partnerId | string | PartnerID。 对于直接经销商,此参数将是合作伙伴的 PartnerID。 对于间接经销商,此参数将是间接经销商的 PartnerID。 |
friendlyName | string | 订阅的名称。 |
partnerName | string | 为其购买订阅的合作伙伴的名称 |
providerName | string | 当订阅事务用于间接经销商时,提供商名称是购买订阅的间接提供商。 |
effectiveStartDate | 采用 UTC 日期/时间格式的字符串 | 订阅开始的日期。 |
commitmentEndDate | 采用 UTC 日期/时间格式的字符串 | 订阅结束的日期。 |
currentStateEndDate | 采用 UTC 日期/时间格式的字符串 | 订阅的当前状态将更改的日期。 |
trialToPaidConversionDate | 采用 UTC 日期/时间格式的字符串 | 订阅从试用版转换为付费日期。 默认值为 null。 |
trialStartDate | 采用 UTC 日期/时间格式的字符串 | 订阅的试用期开始的日期。 默认值为 null。 |
trialEndDate | 采用 UTC 日期/时间格式的字符串 | 订阅试用期结束的日期。 默认值为 null。 |
lastUsageDate | 采用 UTC 日期/时间格式的字符串 | 上次使用订阅的日期。 默认值为 null。 |
deprovisionedDate | 采用 UTC 日期/时间格式的字符串 | 取消预配订阅的日期。 默认值为 null。 |
lastRenewalDate | 采用 UTC 日期/时间格式的字符串 | 上次续订订阅的日期。 默认值为 null。 |
licenseCount | 数字 | 许可证总数。 |
subscriptionCount | number | 订阅数。 注意:此值仅显示在聚合查询的响应中。 |
搜索分析
注意
获取搜索分析不需要 CSP 计划成员身份。
以下方案演示如何使用分析 API 检索所有合作伙伴中心搜索分析信息。
此方案返回搜索资源集合中的分析信息。
搜索资源
表示搜索的所有分析数据。
properties | 类型 | 描述 |
---|---|---|
companyName | string | 计费公司名称。 |
contactButtonClicked | 布尔 | 指示是否已单击联系人按钮。 |
关键字 (keyword)Country | string | 搜索中指定的国家/地区。 |
detailsViewed | 布尔 | 指示是否查看了搜索详细信息。 |
关键字 (keyword)IndustryFocus | string | 要在其中搜索的行业,例如医疗保健。 |
partnerId | string | PartnerID。 对于直接经销商,此参数将是合作伙伴的 PartnerID。 对于间接经销商,此参数将是间接经销商的 PartnerID。 |
partnerMarket | string | 合作伙伴开展业务的区域设置。 |
关键字 (keyword)Product | string | 搜索中指定的产品。 |
referralSubmitted | 布尔 | 指示是否已提交引荐。 |
searchDate | 采用 UTC 日期/时间格式的字符串 | 搜索查询的发生日期。 |
关键字 (keyword)SearchText | string | 搜索中指定的文本。 |
searchResultPageViews | long | 合作伙伴出现在搜索结果中的次数。 仅对聚合做出响应的一部分。 |
contactClicks | long | 单击联系人按钮的次数。 仅对聚合做出响应的一部分。 |
referralCount | long | 从搜索生成的引荐数。 仅对聚合做出响应的一部分。 |
profileViews | long | 查看合作伙伴配置文件的次数。 仅对聚合做出响应的一部分。 |
引荐分析
注意
获取引荐分析不需要 CSP 计划成员身份。
以下方案演示如何使用分析 API 检索所有合作伙伴中心引荐分析信息。
此方案返回引荐资源集合中的分析信息。
注意
由世纪互联运营的合作伙伴中心不提供引荐分析。
引荐资源
表示引荐的所有分析数据。
properties | 类型 | 描述 |
---|---|---|
id | string | 客户租户标识符。 |
状态 | string | 指示引荐是否导致客户。 |
customerMarket | string | 客户在其中开展业务的国家/地区。 |
customerName | string | 客户的名称。 |
customerOrgSize | string | 一个范围,指示客户组织中的员工数。 例如,“10to50employees”。 |
acceptedDate | 采用 UTC 日期/时间格式的字符串 | 接受引荐的日期。 |
acknowledgedDate | 采用 UTC 日期/时间格式的字符串 | 引荐被确认的日期。 |
archivedDate | 采用 UTC 日期/时间格式的字符串 | 引荐存档的日期。 |
declinedDate | 采用 UTC 日期/时间格式的字符串 | 引荐被拒绝的日期。 |
expiredDate | 采用 UTC 日期/时间格式的字符串 | 引荐过期的日期。 |
lostDate | 采用 UTC 日期/时间格式的字符串 | 引荐丢失的日期。 |
missedDate | 采用 UTC 日期/时间格式的字符串 | 引荐错过的日期。 |
createdDate | 采用 UTC 日期/时间格式的字符串 | 创建引荐的日期。 |
skippedDate | 采用 UTC 日期/时间格式的字符串 | 跳过引荐的日期。 |
wonDate | 采用 UTC 日期/时间格式的字符串 | 引荐获胜的日期。 |
partnerMarket | string | 合作伙伴在其中开展业务的国家/地区。 |