合作伙伴中心分析 - 资源
适用于：合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | 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 | 合作伙伴在其中开展业务的国家/地区。 |