Exemples de requêtes pour l’analytique programmatique pour la Place de marché commerciale
Cet article fournit des exemples de requêtes pour les rapports relatifs aux commandes, à l’utilisation et aux clients de la place de marché commerciale Microsoft. Vous pouvez faire référence à ces requêtes et créer d’autres requêtes en fonction de votre cas d’usage en appelant le point de terminaison de l’API Créer une requête de rapport.
Pour plus d’informations sur les noms de colonnes, les attributs et les descriptions, consultez les articles suivants :
- Tableau de bord clients
- Tableau de bord Commandes
- Tableau de bord d’utilisation
- Tableau de bord Insights de la Place de marché
- Tableau de bord des revenus
- Tableau de bord de la qualité de service
- Tableau de bord de rétention des clients
- Tableau de bord de licence
- Tableau de bord de la qualité de service
Requêtes de rapport clients
Ces exemples de requêtes s’appliquent au rapport clients.
| Description de la requête | Exemple de requête |
|---|---|
| Liste des détails des clients avec les clients actifs du partenaire jusqu’à la date que vous choisissez | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 1 |
| Liste des détails des clients avec les clients perdus du partenaire jusqu’à la date que vous choisissez | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 0 |
| Liste des nouveaux clients d’une zone géographique spécifique au cours des six derniers mois | SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE DateAcquired <= ‘2020-06-30’ AND CustomerCountryRegion = ‘United States’ |
Requêtes de rapport d’utilisation
Ces exemples de requêtes s’appliquent au rapport d’utilisation.
| Description de la requête | Exemple de requête |
|---|---|
| Liste des détails d’utilisation pour l’utilisation normalisée des machines virtuelles pour le type de licence de Place de marché « Facturé via Azure » pour les six derniers mois | SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Liste des détails d’utilisation pour l’utilisation brute des machines virtuelles pour le type de licence de Place de marché « Facturé via Azure » pour les douze derniers mois | SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_1_YEAR |
| Liste des détails d’utilisation pour l’utilisation normalisée des machines virtuelles pour le type de licence de la Place de marché « BYOL (apportez votre propre licence) » pour les six derniers mois | SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Liste des détails d’utilisation pour l’utilisation brute des machines virtuelles pour le type de licence de la Place de marché « BYOL (apportez votre propre licence) » pour les six derniers mois | SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS |
| Liste des détails d’utilisation avec date d’utilisation, utilisation normalisée totale quotidienne et « Frais étendus estimés (PC/CC) » pour les plans payants pour le dernier mois | SELECT UsageDate, NormalizedUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
| Liste des détails d’utilisation avec date d’utilisation, utilisation brute totale quotidienne et « Frais étendus estimés (PC/CC) » pour les plans payants pour le dernier mois | SELECT UsageDate, RawUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST\_MONTH |
| Liste des détails d’utilisation avec nom de l’offre, utilisation normalisée des machines virtuelles pour le type de licence de Place de marché « Facturé via Azure » pour les six derniers mois | SELECT OfferName, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferName = ‘Example Offer Name’ TIMESPAN LAST_6_MONTHS |
| Liste des détails d’utilisation avec nom de l’offre, utilisation contrôlée pour les six derniers mois | SELECT OfferName, MeteredUsage FROM ISVUsage WHERE OfferName = ‘Example Offer Name’ AND OfferType IN (‘SaaS’, ‘Azure Applications’) TIMESPAN LAST_6_MONTHS |
| Liste des détails d’utilisation de toutes les offres pour les six derniers mois | SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
| Liste des détails d’utilisation des offres privées pour les six derniers mois | SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage WHERE IsPrivateOffer = '1' ORDER BY UsageDate DESC TIMESPAN LAST_MONTH |
Requêtes de rapport commandes
Ces exemples de requêtes s’appliquent au rapport commandes.
| Description de la requête | Exemple de requête |
|---|---|
| Liste des détails de commandes pour le type de licence Azure « Enterprise » pour les six derniers mois | SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE AzureLicenseType = 'Enterprise' TIMESPAN LAST_6_MONTHS |
| Liste des détails de commandes pour le type de licence Azure « Paiement à l’utilisation » pour les six derniers mois | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, OrderStatus, OrderCancelDate FROM ISVOrder WHERE AzureLicenseType = 'Pay as You Go' TIMESPAN LAST_6_MONTHS |
| Liste des détails de commandes pour le nom de l’offre spécifique pour les six derniers mois | SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId , OrderPurchaseDate FROM ISVOrder WHERE OfferName = Contoso test Services' TIMESPAN LAST_6_MONTHS |
| Liste des détails de commandes pour les commandes actives pour les six derniers mois | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Liste des détails de commandes pour les commandes annulées pour les six derniers mois | SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Cancelled' TIMESPAN LAST_6_MONTHS |
| Liste des détails de commandes avec quantité, début du terme, date de fin du terme, frais estimés, devise pour les six derniers mois | SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId, TermStartDate, TermEndDate, BilledRevenue, Currency from ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Liste des détails de commandes pour les commandes d’essai actives pour les six derniers mois | SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId from ISVOrder WHERE OrderStatus = 'Active' and IsTrial = 'True' TIMESPAN LAST_6_MONTHS |
| Liste des détails de commandes pour toutes les offres actives pour les six derniers mois | SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
| Liste des détails de commandes pour les offres privées actives pour les six derniers mois | SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE IsPrivateOffer = '1' and OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS |
Requêtes de rapport sur les revenus
Ces exemples de requêtes s’appliquent au rapport sur les revenus.
| Description de la requête | Exemple de requête |
|---|---|
| Liste du revenu facturé du partenaire pour le dernier mois | SELECT BillingAccountId, OfferName, OfferType, Revenue, EarningAmountCC, EstimatedRevenueUSD, EarningAmountUSD, PayoutStatus, PurchaseRecordId, LineItemId,TransactionAmountCC,TransactionAmountUSD, Quantity,Units FROM ISVRevenue TIMESPAN LAST_MONTH |
| Lister les revenus estimés en USD de toutes les transactions envoyées au cours des 3 derniers mois | SELECT BillingAccountId, OfferName, OfferType, EstimatedRevenueUSD, EarningAmountUSD, PayoutStatus, PurchaseRecordId, LineItemId, TransactionAmountUSD FROM ISVRevenue where PayoutStatus='Sent' TIMESPAN LAST_3_MONTHS |
| Liste des transactions autres que des évaluations pour le modèle de facturation basé sur un abonnement | SELECT BillingAccountId, OfferName,OfferType, TrialDeployment EstimatedRevenueUSD, EarningAmountUSD FROM ISVRevenue WHERE TrialDeployment=’False’ and BillingModel=’SubscriptionBased’ |
Requêtes de rapport de qualité de service
Cet exemple de requête s’applique au rapport qualité de service.
| Description de la requête | Exemple de requête |
|---|---|
| Liste de l’état du déploiement des offres des six derniers mois | SELECT OfferId, Sku, DeploymentStatus, DeploymentCorrelationId, SubscriptionId, CustomerTenantId, CustomerName, TemplateType, StartTime, EndTime, DeploymentDurationInMilliSeconds, DeploymentRegion FROM ISVQualityOfService TIMESPAN LAST_6_MONTHS |
Requêtes de rapport de fidélisation des clients
Cet exemple de requête s’applique au rapport de fidélisation des clients.
| Description de la requête | Exemple de requête |
|---|---|
| Liste des détails de fidélisation des clients pour les six derniers mois | SELECT OfferCategory, OfferName, ProductId, DeploymentMethod, ServicePlanName, Sku, SkuBillingType, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode, FirstUsageDate, AzureLicenseType, OfferType, Offset FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS |
| Liste de l’activité d’utilisation et des détails de chiffre d’affaires de tous les clients au cours des six derniers mois | SELECT OfferCategory, OfferName, Sku, ProductId, OfferType, FirstUsageDate, Offset, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS |