パートナー センターの分析 - リソースPartner Center Analytics - Resources
適用対象Applies To
- パートナー センターPartner Center
- 21Vianet が運営するパートナー センターPartner Center operated by 21Vianet
- Microsoft Cloud ドイツのパートナー センターPartner Center for Microsoft Cloud Germany
- 米国政府機関向け Microsoft Cloud のパートナー センターPartner Center for Microsoft Cloud for US Government
Analytics API を使用すると、ユーザーエクスペリエンスに表示されているデータにプログラムでアクセスできます。The Analytics API allows you to programmatically access data that is being presented in the User Experience.
前提条件Prerequisites
- パートナー センターの認証に関するページで説明している資格情報。Credentials as described in Partner Center authentication. これらのシナリオでは、ユーザー資格情報のみを使用した認証がサポートされます。These scenarios support authentication with User credentials only.
CSP プログラム: Azure usage analyticsCSP program: Azure usage analytics
次のシナリオでは、Analytics API を使用して、パートナーセンターの Azure usage analytics のすべての情報を取得する方法について説明します。The following scenario shows you how to use the Analytics API to retrieve all your Partner Center Azure usage analytics information.
このシナリオでは、 Azure の使用リソースのコレクションに分析情報が返されます。This scenario returns your analytics information in a collection of Azure usage resources.
Azure の使用リソースAzure usage resource
Azure の使用に関するすべての分析データを表します。Represents all of the analytical data for Azure usage.
| プロパティProperty | TypeType | 説明Description |
|---|---|---|
| 顧客 TenantidCustomerTenantId | stringstring | 顧客のテナント識別子。The customer tenant identifier. |
| customerNamecustomerName | stringstring | 顧客名。The customer name. |
| subscriptionIdsubscriptionId | stringstring | サブスクリプションの識別子です。The subscription identifier. |
| subscriptionNamesubscriptionName | stringstring | サブスクリプション名。The subscription name. |
| 日付usageDate | stringstring | 使用日。The usage date. |
| resourceLocationresourceLocation | stringstring | データセンターの場所 (西ヨーロッパなど)。The location of the data center, Western Europe, for example. |
| meterCategorymeterCategory | stringstring | 測定カテゴリ、データ管理など。The meter category, data management, for example. |
| meterSubcategory カテゴリmeterSubcategory | stringstring | 測定サブカテゴリ (geo 冗長など)。The meter subcategory, for example, geo redundant. |
| meterUnitmeterUnit | stringstring | 測定単位 (ギガバイトや時間など)。The meter unit, such as gigabytes or hours. |
| reservationOrderIdreservationOrderId | stringstring | Azure VM の予約済みインスタンスの予約順序。The reservation order for an Azure VM Reserved Instance. |
| reservationIdreservationId | stringstring | 特定の RI 順序での予約インスタンス。Reserved instances under a specific RI order. |
| serviceTypeserviceType | stringstring | 仮想マシンの種類を示します。Indicates the virtual machine type. たとえば、Standard_E4s_v3 のようにします。For example, Standard_E4s_v3. |
| 数量quantity | longlong | メーター単位で使用される数値を示します。Indicates the numbers used in the meter unit. |
CSP プログラム: 間接リセラー分析CSP program: indirect resellers analytics
次のシナリオでは、Analytics API を使用して、すべてのパートナーセンターの間接リセラーの分析情報を取得する方法について説明します。The following scenario shows you how to use the Analytics API to retrieve all your Partner Center indirect resellers analytics information.
このシナリオでは、間接リセラーリソースのコレクションに分析情報が返されます。This scenario returns your analytics information in a collection of indirect resellers resources.
間接リセラーのリソースIndirect resellers resource
間接リセラーのすべての分析データを表します。Represents all of the analytical data for indirect resellers.
| プロパティProperty | TypeType | 説明Description |
|---|---|---|
| partnerTenantIdpartnerTenantId | stringstring | 間接リセラーデータを取得するパートナーのテナント ID。The Tenant ID of the partner for which you want to retrieve indirect resellers data. |
| idid | stringstring | 間接リセラー ID。Indirect reseller ID. |
| namename | stringstring | 間接リセラーデータを取得するパートナーの名前。The Name of the partner for which you want to retrieve indirect resellers data. |
| marketmarket | stringstring | 間接リセラーデータを取得するパートナーの市場。The Market of the partner for which you want to retrieve indirect resellers data. |
| firstSubscriptionCreationDatefirstSubscriptionCreationDate | UTC 日時形式の文字列string in UTC date time format | 間接リセラーデータを取得する最初のサブスクリプションの作成日。The creation date of the first subscription based on which you want to retrieve indirect resellers data. |
| latestSubscriptionCreationDatelatestSubscriptionCreationDate | UTC 日時形式の文字列string in UTC date time format | 最新のサブスクリプションの作成日。The creation date of the latest subscription. |
| firstSubscriptionEndDatefirstSubscriptionEndDate | UTC 日時形式の文字列string in UTC date time format | サブスクリプションが初めて終了したとき。First time any subscription was ended. |
| latestSubscriptionEndDatelatestSubscriptionEndDate | UTC 日時形式の文字列string in UTC date time format | 任意のサブスクリプションが終了した最後の日付。Latest date when any subscription was ended. |
| firstSubscriptionSuspendedDatefirstSubscriptionSuspendedDate | UTC 日時形式の文字列string in UTC date time format | サブスクリプションが初めて中断されたとき。First time any subscription was suspended. |
| latestSubscriptionSuspendedDatelatestSubscriptionSuspendedDate | UTC 日時形式の文字列string in UTC date time format | サブスクリプションが中断された最後の日付。Latest date when any subscription was suspended. |
| firstSubscriptionDeprovisionedDatefirstSubscriptionDeprovisionedDate | UTC 日時形式の文字列string in UTC date time format | サブスクリプションが初めてプロビジョニング解除されたとき。First time any subscription was deprovisioned. |
| latestSubscriptionDeprovisionedDatelatestSubscriptionDeprovisionedDate | UTC 日時形式の文字列string in UTC date time format | サブスクリプションがプロビジョニング解除された最後の日付。Latest date when any subscription was deprovisioned. |
| subscriptionCountsubscriptionCount | doubledouble | すべての付加価値再販業者のサブスクリプション数Subscription count for all value added resellers |
| licenseCountlicenseCount | doubledouble | すべての付加価値再販業者のライセンス数License count for all value added resellers |
| indirectResellerCountindirectResellerCount | doubledouble | 間接リセラー数Indirect resellers count |
CSP プログラム: サブスクリプション分析CSP program: subscription analytics
次のシナリオでは、Analytics API を使用して、すべてのパートナーセンターのサブスクリプション分析情報を取得したり、検索クエリでフィルター処理したり、日付や用語でグループ化したりする方法について説明します。The following scenarios show you how to use the Analytics API to retrieve all your Partner Center subscription analytics information, filter it with a search query, or group it by dates or terms.
- サブスクリプションの分析情報をすべて取得するGet all subscription analytics information
- 検索クエリでフィルター処理されたサブスクリプションの分析情報を取得するGet subscription analytics information filtered by a search query
- 日付またはご契約条件でグループ化されたサブスクリプションの分析情報を取得するGet subscription analytics information grouped by dates or terms
これらすべてのシナリオでは、サブスクリプションリソースのコレクションで分析情報が返されます。All of these scenarios return your analytics information in a collection of Subscription resources.
サブスクリプション リソースSubscription resource
サブスクリプションのすべての分析データを表します。Represents all of the analytical data for a subscription.
| プロパティProperty | TypeType | 説明Description |
|---|---|---|
| 顧客 TenantidcustomerTenantId | stringstring | 顧客のテナントを識別する GUID 形式の文字列。A GUID-formatted string that identifies the customer tenant. |
| customerNamecustomerName | stringstring | 顧客の名前。The name of the customer. |
| 顧客市場customerMarket | stringstring | 顧客が事業を行っている国/地域。The country/region that the customer does business in. |
| idid | stringstring | サブスクリプションの識別子です。The subscription identifier. |
| 状態status | stringstring | サブスクリプションの状態: "ACTIVE"、"中断"、または "プロビジョニング解除"。The subscription status: "ACTIVE", "SUSPENDED", or "DEPROVISIONED". |
| productNameproductName | stringstring | 製品の名前です。The name of the product. |
| subscriptionTypesubscriptionType | stringstring | サブスクリプションの種類。The subscription type. 注: このフィールドでは大文字と小文字が区別されます。Note: This field is case sensitive. サポートされている値は、"Office"、"Azure"、"Microsoft365"、"Dynamics"、"EMS" です。Supported values are: "Office", "Azure", "Microsoft365", "Dynamics", "EMS". |
| autoRenewEnabledautoRenewEnabled | booleanboolean | サブスクリプションが自動的に更新されるかどうかを示す値です。A value indicating whether the subscription is renewed automatically. |
| パートナーpartnerId | stringstring | MPN ID です。The MPN ID. ダイレクトリセラーの場合、このパラメーターはパートナーの MPN ID になります。For a direct reseller, this parameter will be the MPN ID of the partner. 間接リセラーの場合、このパラメーターは間接リセラーの MPN ID になります。For an indirect reseller, this parameter will be the MPN ID of the indirect reseller. |
| friendlyNamefriendlyName | stringstring | サブスクリプションの名前です。The name of the subscription. |
| partnerNamepartnerName | stringstring | サブスクリプションが購入されたパートナーの名前Name of the partner for whom the subscription was purchased |
| providerNameproviderName | stringstring | 間接リセラーのサブスクリプショントランザクションの場合、プロバイダー名はサブスクリプションを購入した間接プロバイダーになります。When subscription transaction is for the indirect reseller, provider name is the indirect provider who bought the subscription. |
| effectiveStartDateeffectiveStartDate | UTC 日時形式の文字列string in UTC date time format | サブスクリプションが開始された日付。The date the subscription starts. |
| Commitの EnddatecommitmentEndDate | UTC 日時形式の文字列string in UTC date time format | サブスクリプションが終了する日付。The date the subscription ends. |
| currentStateEndDatecurrentStateEndDate | UTC 日時形式の文字列string in UTC date time format | サブスクリプションの現在の状態が変更される日付。The date that the current status of the subscription will change. |
| trialToPaidConversionDatetrialToPaidConversionDate | UTC 日時形式の文字列string in UTC date time format | サブスクリプションが試用から有料に変換される日付。The date that the subscription converts from trial to paid. 既定値は、null です。The default value is null. |
| trialStartDatetrialStartDate | UTC 日時形式の文字列string in UTC date time format | サブスクリプションの試用期間が開始された日付。The date that the trial period for the subscription started. 既定値は、null です。The default value is null. |
| trialEndDatetrialEndDate | UTC 日時形式の文字列string in UTC date time format | サブスクリプションの試用期間が終了した日付。The date that the trial period for the subscription ends. 既定値は、null です。The default value is null. |
| Lastの終了日lastUsageDate | UTC 日時形式の文字列string in UTC date time format | サブスクリプションが最後に使用された日付。The date that the subscription was last used. 既定値は、null です。The default value is null. |
| deprovisionedDatedeprovisionedDate | UTC 日時形式の文字列string in UTC date time format | サブスクリプションがプロビジョニング解除された日付。The date that the subscription was deprovisioned. 既定値は、null です。The default value is null. |
| lastRenewalDatelastRenewalDate | UTC 日時形式の文字列string in UTC date time format | サブスクリプションが最後に更新された日付は、既定値は null になります。The date that the subscription was last renewed The default value is null. |
| licenseCountlicenseCount | numbernumber | ライセンスの合計数。The total number of licenses. |
| subscriptionCountsubscriptionCount | numbernumber | サブスクリプションの数。The number of subscriptions. 注: この値は、集計クエリの応答にのみ表示されます。Note: This value will only appear in the response of an aggregation query. |
検索分析Search analytics
注意
CSP プログラムのメンバーシップは、検索分析を取得するためには必要ありません。CSP program membership isn't required to get search analytics.
次のシナリオでは、Analytics API を使用して、すべてのパートナーセンター検索分析情報を取得する方法について説明します。The following scenario shows you how to use the Analytics API to retrieve all your Partner Center search analytics information.
このシナリオでは、検索リソースのコレクションに分析情報が返されます。This scenario returns your analytics information in a collection of Search resources.
リソースの検索Search resource
検索のすべての分析データを表します。Represents all of the analytical data for a search.
| プロパティProperty | TypeType | 説明Description |
|---|---|---|
| companyNamecompanyName | stringstring | 請求先の会社名。The billing company name. |
| contactButtonClicked クリックされましたcontactButtonClicked | BooleanBoolean | [Contact] ボタンがクリックされたかどうかを示します。Indicates if the contact button was clicked. |
| keywordCountrykeywordCountry | stringstring | 検索で指定された国。The country specified in the search. |
| 表示の表示detailsViewed | BooleanBoolean | 検索の詳細が表示されたかどうかを示します。Indicates if search details were viewed. |
| keywordIndustryFocuskeywordIndustryFocus | stringstring | 医療などで検索する業界。The industry to search within, for example, healthcare. |
| mpnIdmpnId | stringstring | Microsoft Partner Network (MPN) ID です。The Microsoft Partner Network (MPN) ID. ダイレクトリセラーの場合、このパラメーターはパートナーの MPN ID になります。For a direct reseller, this parameter will be the MPN ID of the partner. 間接リセラーの場合、このパラメーターは間接リセラーの MPN ID になります。For an indirect reseller, this parameter will be the MPN ID of the indirect reseller. |
| partnerMarketpartnerMarket | stringstring | パートナーがビジネスを運営するロケール。Locale where the partner conducts business. |
| keywordProductkeywordProduct | stringstring | 検索で指定された製品。The product specified in the search. |
| referralSubmittedreferralSubmitted | BooleanBoolean | 紹介が送信されたかどうかを示します。Indicates if a referral was submitted. |
| searchDatesearchDate | UTC 日時形式の文字列string in UTC date time format | 検索クエリが発生した日付。Date when the search query occurred. |
| keywordSearchTextkeywordSearchText | stringstring | 検索で指定されたテキスト。The text specified in the search. |
| searchResultPageViewssearchResultPageViews | longlong | パートナーが検索結果に登場した回数。Number of times the partner came up in the search result. 集計にのみ応答の一部。Part of a response only on aggregation. |
| contactClicks クリックcontactClicks | longlong | [Contact] ボタンがクリックされた回数。Number of times the contact button was clicked. 集計にのみ応答の一部。Part of a response only on aggregation. |
| referralCountreferralCount | longlong | 検索から生成された参照の数。Number of referrals generated from the search. 集計にのみ応答の一部。Part of a response only on aggregation. |
| profileViewsprofileViews | longlong | パートナープロファイルが表示された回数。Number of times the partner profile was viewed. 集計にのみ応答の一部。Part of a response only on aggregation. |
紹介分析Referrals analytics
注意
参照分析を取得するために CSP プログラムのメンバーシップは必要ありません。CSP program membership isn't required to get referrals analytics.
次のシナリオでは、Analytics API を使用して、すべてのパートナーセンターの紹介分析情報を取得する方法について説明します。The following scenario shows you how to use the Analytics API to retrieve all your Partner Center referrals analytics information.
このシナリオでは、参照リソースのコレクションに分析情報が返されます。This scenario returns your analytics information in a collection of Referrals resources.
注意
照会分析は、21Vianet が運用するパートナーセンターでは利用できません。Referrals analytics are not available to the Partner Center operated by 21Vianet.
参照リソースReferrals resource
紹介のすべての分析データを表します。Represents all of the analytical data for a referral.
| プロパティProperty | TypeType | 説明Description |
|---|---|---|
| idid | stringstring | 顧客のテナント識別子。The customer tenant identifier. |
| 状態status | stringstring | 紹介が顧客に対しているかどうかを示します。Indicates if the referral led to a customer. |
| 顧客市場customerMarket | stringstring | 顧客が事業を行っている国/地域。The country/region that the customer does business in. |
| customerNamecustomerName | stringstring | 顧客の名前。The name of the customer. |
| 顧客 OrgsizecustomerOrgSize | stringstring | 顧客の組織内の従業員の数を示す範囲。A range indicating the number of employees in the customer's organization. たとえば、"10to50employees" のようになります。For example, "10to50employees". |
| acceptedDateacceptedDate | UTC 日時形式の文字列string in UTC date time format | 紹介が受け入れられた日付。The date that the referral was accepted. |
| acknowledgedDateacknowledgedDate | UTC 日時形式の文字列string in UTC date time format | 参照が確認された日付。The date that the referral was acknowledged. |
| archivedDatearchivedDate | UTC 日時形式の文字列string in UTC date time format | 参照がアーカイブされた日付。The date that the referral was archived. |
| declinedDatedeclinedDate | UTC 日時形式の文字列string in UTC date time format | 参照が拒否された日付。The date that the referral was declined. |
| expiredDateexpiredDate | UTC 日時形式の文字列string in UTC date time format | 参照の有効期限が切れた日付。The date that the referral expired. |
| lostDatelostDate | UTC 日時形式の文字列string in UTC date time format | 参照が失われた日付。The date that the referral was lost. |
| missedDatemissedDate | UTC 日時形式の文字列string in UTC date time format | 参照が見つからなかった日付。The date that the referral was missed. |
| createdDatecreatedDate | UTC 日時形式の文字列string in UTC date time format | 参照が作成された日付。The date that the referral was created. |
| skippedDateskippedDate | UTC 日時形式の文字列string in UTC date time format | 参照がスキップされた日付。The date that the referral was skipped. |
| wonDatewonDate | UTC 日時形式の文字列string in UTC date time format | 参照が受注された日付。The date that the referral was won. |
| partnerMarketpartnerMarket | stringstring | パートナーが事業を行っている国/地域。The country/region that the partner does business in. |