パートナー センターの分析 - リソース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.

これらすべてのシナリオでは、サブスクリプションリソースのコレクションで分析情報が返されます。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.