パートナー センターの分析 - リソース

  • [アーティクル]

適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター

Analytics API を使用すると、ユーザー エクスペリエンスに表示されているデータにプログラムでアクセスできます。

前提条件

  • パートナー センターの認証に関するページで説明している資格情報。 これらのシナリオでは、ユーザー資格情報のみを使用した認証がサポートされます。

CSP プログラム: Azure 使用状況分析

次のシナリオでは、Analytics API を使用して、すべてのパートナー センターの Azure 使用状況分析情報を取得する方法を示します。

このシナリオでは、Azure 使用状況リソースのコレクション内の分析情報が返されます。

Azure 使用状況リソース

Azure の使用状況に関するすべての分析データを表します。

プロパティ タイプ 説明
CustomerTenantId string 顧客テナント識別子。
customerName string 顧客名。
subscriptionId string サブスクリプション識別子です。
subscriptionName string サブスクリプション名。
usageDate string 使用日。
resourceLocation string データ センターの場所 (西ヨーロッパなど)。
meterCategory string 測定カテゴリ、データ管理など。
meterSubcategory string メーターサブカテゴリ (geo 冗長など)。
meterUnit string ギガバイトや時間などの測定単位。
reservationOrderId string Azure VM 予約インスタンスの予約注文。
reservationId string 特定の RI 注文の予約インスタンス。
serviceType string 仮想マシンの種類を示します。 たとえば、Standard_E4s_v3。
数量 long 測定単位で使用される数値を示します。

CSP プログラム: 間接リセラー分析

次のシナリオでは、Analytics API を使用して、パートナー センターのすべての間接リセラー分析情報を取得する方法を示します。

このシナリオでは、間接リセラー リソースのコレクション内の 分析情報が返されます 。

間接リセラー リソース

間接リセラーのすべての分析データを表します。

プロパティ タイプ 説明
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 倍精度浮動小数点 すべての付加価値リセラーのサブスクリプション数
licenseCount 倍精度浮動小数点 すべての付加価値リセラーのライセンス数
indirectResellerCount 倍精度浮動小数点 間接リセラー数

CSP プログラム: サブスクリプション分析

次のシナリオでは、Analytics API を使用して、パートナー センターのすべてのサブスクリプション分析情報を取得する方法、検索クエリでフィルター処理する方法、日付または用語でグループ化する方法を示します。

これらのシナリオはすべて、サブスクリプション リソースのコレクション内の分析情報を返します。

サブスクリプション リソース

サブスクリプションのすべての分析データを表します。

プロパティ タイプ 説明
customerTenantId string 顧客テナントを識別する GUID 形式の文字列。
customerName string 顧客の名前。
customerMarket string 顧客がビジネスを行う国/地域。
ID string サブスクリプション識別子です。
status string サブスクリプションの状態: "ACTIVE"、"SUSPENDED"、または "DEPROVISIONED"。
productName string 生産の名前。
subscriptionType string サブスクリプションの種類。 注: このフィールドでは大文字と小文字が区別されます。 サポートされている値は、"Office"、"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 数値 サブスクリプションの数。 注: この値は、集計クエリの応答にのみ表示されます。

検索分析

Note

検索分析を取得するために CSP プログラムメンバーシップは必要ありません。

次のシナリオでは、Analytics API を使用して、すべてのパートナー センター検索分析情報を取得する方法を示します。

このシナリオでは、Search リソースのコレクション内の分析情報が返されます。

リソースを検索

検索のすべての分析データを表します。

プロパティ タイプ 説明
companyName string 請求先の会社名。
contactButtonClicked Boolean 連絡先ボタンがクリックされたかどうかを示します。
キーワード (keyword)Country string 検索で指定された国/地域。
detailsViewed Boolean 検索の詳細が表示されたかどうかを示します。
キーワード (keyword)IndustryFocus string 医療など、検索対象の業界。
partnerId string PartnerID。 直接リセラーの場合、このパラメーターはパートナーの PartnerID になります。 間接リセラーの場合、このパラメーターは間接リセラーの PartnerID になります。
partnerMarket string パートナーがビジネスを行うロケール。
キーワード (keyword)Product string 検索で指定された製品。
referralSubmitted Boolean 紹介が送信されたかどうかを示します。
searchDate UTC 日時形式の文字列 検索クエリが発生した日付。
キーワード (keyword)SearchText string 検索で指定されたテキスト。
searchResultPageViews long 検索結果にパートナーが表示された回数。 集計についてのみ応答の一部。
contactClicks long 連絡先ボタンがクリックされた回数。 集計についてのみ応答の一部。
referralCount long 検索から生成された紹介の数。 集計についてのみ応答の一部。
profileViews long パートナー プロファイルが表示された回数。 集計についてのみ応答の一部。

紹介分析

Note

紹介分析を取得するために CSP プログラムメンバーシップは必要ありません。

次のシナリオでは、Analytics API を使用して、すべてのパートナー センター紹介分析情報を取得する方法を示します。

このシナリオでは、紹介リソースの コレクション内の分析情報が 返されます。

Note

21Vianet が運営するパートナー センターでは紹介分析を利用できません。

紹介リソース

紹介のすべての分析データを表します。

プロパティ タイプ 内容
id string 顧客テナント識別子。
status 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 パートナーがビジネスを行う国/地域。