パートナー センターの分析 - リソース
適用対象: パートナー センター | 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 | パートナーがビジネスを行う国/地域。 |