Query di esempio per l'analisi a livello di codice per il marketplace commerciale
Questo articolo fornisce query di esempio per gli ordini, l'utilizzo e i report dei clienti del marketplace commerciale Microsoft. È possibile fare riferimento a queste query e creare altre query in base al caso d'uso chiamando l'endpoint API Create Report Query.
Per altre informazioni sui nomi, gli attributi e le descrizioni delle colonne, vedere gli articoli seguenti:
- dashboard Clienti
- dashboard Orders
- Dashboard di utilizzo
- dashboard di Marketplace Insights
- Dashboard dei ricavi
- Dashboard Qualità del Servizio
- dashboard di fidelizzazione dei clienti
- dashboard licenze
- dashboard della qualità del servizio
I clienti segnalano richieste
Queste query di esempio si applicano alla relazione Clienti.
| Descrizione query | query di esempio |
|---|---|
| Elencare i dettagli del cliente con i clienti attivi del partner fino alla data scelta | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 1 |
| Elencare i dettagli dei clienti con i clienti disdetti del partner fino alla data che scegli | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 0 |
| Elenco di nuovi clienti da una geografia specifica negli ultimi sei mesi | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE DateAcquired <= ‘2020-06-30’ AND CustomerCountryRegion = ‘United States’ |
Query sui rapporti di utilizzo
Queste query di esempio sono applicabili al rapporto sull'utilizzo.
| Descrizione query | Query di Esempio |
|---|---|
| Elenca i dettagli di utilizzo con l'utilizzo normalizzato della Macchina Virtuale (VM) per il tipo di licenza "Fatturato tramite Azure" nel Marketplace per gli ultimi 6 mesi. | SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli di utilizzo con l'utilizzo grezzo della macchina virtuale per il tipo di licenza "Fatturato tramite Azure" del Marketplace per gli ultimi 12 mesi. | SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_1_YEAR |
| Elenca i dettagli di utilizzo con l'utilizzo normalizzato VM per il tipo di licenza Marketplace "Bring Your Own License" per gli ultimi 6 mesi. | SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli di utilizzo con l'utilizzo grezzo della VM per il tipo di licenza del marketplace "Bring Your Own License" per gli ultimi 6 mesi | SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli di utilizzo con data di utilizzo, utilizzo normalizzato giornaliero giornaliero e "Addebiti estesi stimati (PC/CC)" per i piani a pagamento per l'ultimo mese | SELECT UsageDate, NormalizedUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
| Elencare i dettagli di utilizzo con data di utilizzo, utilizzo non elaborato giornaliero giornaliero e "Addebiti estesi stimati (PC/CC)" per i piani a pagamento per l'ultimo mese | SELECT UsageDate, RawUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST\_MONTH |
| Elencare i dettagli di utilizzo con il nome dell'offerta, l'utilizzo normalizzato della macchina virtuale per il tipo di licenza del Marketplace "Fatturato tramite Azure" negli ultimi 6 mesi. | SELECT OfferName, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferName = ‘Example Offer Name’ TIMESPAN LAST_6_MONTHS |
| Elenca i dettagli di utilizzo con il nome dell'offerta, l'utilizzo a consumo per gli ultimi 6 mesi. | SELECT OfferName, MeteredUsage FROM ISVUsage WHERE OfferName = ‘Example Offer Name’ AND OfferType IN (‘SaaS’, ‘Azure Applications’) TIMESPAN LAST_6_MONTHS |
| Elencare tutti i dettagli di utilizzo delle offerte per gli ultimi 6 mesi | SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
| Elenca tutti i dettagli di utilizzo delle offerte private per gli ultimi 6 mesi. | SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage WHERE IsPrivateOffer = '1' ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
Query sui ordini del report
Queste query di esempio si applicano al report degli ordini.
| Descrizione query | Query di esempio |
|---|---|
| Elenca i dettagli dell'ordine per il tipo di licenza di Azure come "Enterprise" negli ultimi 6 mesi | SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE AzureLicenseType = 'Enterprise' TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli dell'ordine per il tipo di licenza Azure indicato come "Pagamento in base al consumo" per gli ultimi 6 mesi. | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, OrderStatus, OrderCancelDate FROM ISVOrder WHERE AzureLicenseType = 'Pay as You Go' TIMESPAN LAST_6_MONTHS |
| Elenca i dettagli dell'ordine per il nome specifico dell'offerta per gli ultimi 6 mesi | SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId , OrderPurchaseDate FROM ISVOrder WHERE OfferName = Contoso test Services' TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli degli ordini attivi per gli ultimi 6 mesi | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Elenca i dettagli dell'ordine degli ordini annullati negli ultimi 6 mesi | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Cancelled' TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli dell'ordine con quantità, data di inizio del termine, data di fine del termine e costi stimati, valuta per gli ultimi 6 mesi. | SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId, TermStartDate, TermEndDate, BilledRevenue, Currency from ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli degli ordini per gli ordini di valutazione attivi negli ultimi 6 mesi | SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId from ISVOrder WHERE OrderStatus = 'Active' and IsTrial = 'True' TIMESPAN LAST_6_MONTHS |
| Elenca i dettagli degli ordini per tutte le offerte attive negli ultimi 6 mesi. | SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Elenca i dettagli dell'ordine per le offerte private attive negli ultimi 6 mesi | SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE IsPrivateOffer = '1' and OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
Richieste di rapporti sulle entrate
Queste query di esempio si applicano al rapporto sui ricavi.
| Descrizione query | query di esempio |
|---|---|
| Elencare i ricavi fatturati del partner per gli ultimi 1 mese | SELECT BillingAccountId, OfferName, OfferType, Revenue, EarningAmountCC, EstimatedRevenueUSD, EarningAmountUSD, PayoutStatus, PurchaseRecordId, LineItemId,TransactionAmountCC,TransactionAmountUSD, Quantity,Units FROM ISVRevenue TIMESPAN LAST_MONTH |
| Elenca i ricavi stimati in USD di tutte le transazioni con stato di 'inviato' negli ultimi 3 mesi | SELECT BillingAccountId, OfferName, OfferType, EstimatedRevenueUSD, EarningAmountUSD, PayoutStatus, PurchaseRecordId, LineItemId, TransactionAmountUSD FROM ISVRevenue where PayoutStatus='Sent' TIMESPAN LAST_3_MONTHS |
| Elenco delle transazioni non di prova per il modello di fatturazione basato sulla sottoscrizione | SELECT BillingAccountId, OfferName,OfferType, TrialDeployment EstimatedRevenueUSD, EarningAmountUSD FROM ISVRevenue WHERE TrialDeployment=’False’ and BillingModel=’SubscriptionBased’ |
Query sui rapporti sulla qualità del servizio
Questa query di esempio si applica al report Qualità del servizio.
| Descrizione query | query di esempio |
|---|---|
| Elencare lo stato di distribuzione delle offerte per gli ultimi 6 mesi | SELECT OfferId, Sku, DeploymentStatus, DeploymentCorrelationId, SubscriptionId, CustomerTenantId, CustomerName, TemplateType, StartTime, EndTime, DeploymentDurationInMilliSeconds, DeploymentRegion FROM ISVQualityOfService TIMESPAN LAST_6_MONTHS |
Query sui report di fidelizzazione dei clienti
Questa query di esempio si applica al report di conservazione dei clienti.
| Descrizione query | esempio di query |
|---|---|
| Elencare i dettagli di conservazione dei clienti per gli ultimi 6 mesi | SELECT OfferCategory, OfferName, ProductId, DeploymentMethod, ServicePlanName, Sku, SkuBillingType, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode, FirstUsageDate, AzureLicenseType, OfferType, Offset FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS |
| Elencare i dettagli sulle attività di utilizzo e sui ricavi di tutti i clienti negli ultimi 6 mesi | SELECT OfferCategory, OfferName, Sku, ProductId, OfferType, FirstUsageDate, Offset, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS |