Analytique de l’Espace partenaires - Ressources
S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government
L’API Analytics vous permet d’accéder par programmation aux données présentées dans l’expérience utilisateur.
Prérequis
- Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ces scénarios prennent uniquement en charge l’authentification avec les informations d’identification de l’utilisateur.
Programme CSP : Analytique de l’utilisation Azure
Le scénario suivant vous montre comment utiliser l’API Analytics pour récupérer toutes vos informations d’analyse d’utilisation Azure de l’Espace partenaires.
Ce scénario retourne vos informations d’analyse dans une collection de ressources d’utilisation Azure.
Ressource d’utilisation Azure
Représente toutes les données analytiques pour l’utilisation d’Azure.
| Propriété | Type | Description |
|---|---|---|
| CustomerTenantId | string | Identificateur du locataire du client. |
| customerName | string | Nom du client. |
| subscriptionId | string | Identificateur de l’abonnement. |
| subscriptionName | string | Le nom de l’abonnement. |
| usageDate | string | Date d’utilisation. |
| resourceLocation | string | Emplacement du centre de données, europe occidentale, par exemple. |
| meterCategory | string | La catégorie de compteurs, la gestion des données, par exemple. |
| meterSubcategory | string | Sous-catégorie du compteur, par exemple géoredondant. |
| meterUnit | string | Unité de compteur, telle que gigaoctets ou heures. |
| reservationOrderId | string | Ordre de réservation d’une instance réservée de machine virtuelle Azure. |
| reservationId | string | Instances réservées dans un ordre ri spécifique. |
| serviceType | string | Indique le type de machine virtuelle. Par exemple, Standard_E4s_v3. |
| quantité | long | Indique les nombres utilisés dans l’unité de compteur. |
Programme CSP : analytique des revendeurs indirects
Le scénario suivant vous montre comment utiliser l’API Analytics pour récupérer toutes vos informations d’analytique des revendeurs indirects de l’Espace partenaires.
Ce scénario retourne vos informations d’analyse dans une collection de ressources de revendeurs indirects .
Ressource revendeurs indirects
Représente toutes les données analytiques pour les revendeurs indirects.
| Propriété | Type | Description |
|---|---|---|
| partnerTenantId | string | ID de locataire du partenaire pour lequel vous souhaitez récupérer les données des revendeurs indirects. |
| id | string | ID de revendeur indirect. |
| name | chaîne | Nom du partenaire pour lequel vous souhaitez récupérer les données des revendeurs indirects. |
| market | string | Marché du partenaire pour lequel vous souhaitez récupérer les données des revendeurs indirects. |
| firstSubscriptionCreationDate | Chaîne au format date/heure UTC | Date de création du premier abonnement en fonction de laquelle vous souhaitez récupérer les données des revendeurs indirects. |
| latestSubscriptionCreationDate | Chaîne au format date/heure UTC | Date de création de l’abonnement le plus récent. |
| firstSubscriptionEndDate | Chaîne au format date/heure UTC | Première fois qu’un abonnement a été terminé. |
| latestSubscriptionEndDate | Chaîne au format date/heure UTC | Date la plus récente de la fin de l’abonnement. |
| firstSubscriptionSuspendedDate | Chaîne au format date/heure UTC | Première fois qu’un abonnement a été suspendu. |
| latestSubscriptionSuspendedDate | Chaîne au format date/heure UTC | Date la plus récente à laquelle un abonnement a été suspendu. |
| firstSubscriptionDeprovisionedDate | Chaîne au format date/heure UTC | Première fois qu’un abonnement a été déprovisionné. |
| latestSubscriptionDeprovisionedDate | Chaîne au format date/heure UTC | Date la plus récente à laquelle un abonnement a été déprovisionné. |
| subscriptionCount | double | Nombre d’abonnements pour tous les revendeurs à valeur ajoutée |
| licenseCount | double | Nombre de licences pour tous les revendeurs à valeur ajoutée |
| indirectResellerCount | double | Nombre de revendeurs indirects |
Programme CSP : analytique des abonnements
Les scénarios suivants vous montrent comment utiliser l’API Analytics pour récupérer toutes vos informations d’analyse d’abonnement à l’Espace partenaires, les filtrer avec une requête de recherche ou les regrouper par dates ou termes.
- Obtenir toutes les informations analytiques sur l’abonnement
- Obtenir des informations analytiques d’abonnement filtrées par une requête de recherche
- Obtenir des informations analytiques d’abonnement regroupées par dates ou périodes
Tous ces scénarios retournent vos informations d’analyse dans une collection de ressources d’abonnement.
Ressource d’abonnement
Représente toutes les données analytiques d’un abonnement.
| Propriété | Type | Description |
|---|---|---|
| customerTenantId | string | Chaîne au format GUID qui identifie le client. |
| customerName | string | Nom du client. |
| customerMarket | string | Pays/région dans lequel le client s’occupe. |
| id | string | Identificateur de l’abonnement. |
| statut | string | État de l’abonnement : « ACTIVE », « SUSPENDED » ou « DEPROVISIONED ». |
| productName | string | Nom du produit. |
| subscriptionType | string | Type d’abonnement. Remarque : ce champ respecte la casse. Les valeurs prises en charge sont : « Bureau », « Azure », « Microsoft365 », « Dynamics », « EMS ». |
| autoRenewEnabled | booléen | Valeur indiquant si l’abonnement est renouvelé automatiquement. |
| partnerId | string | The PartnerID. Pour un revendeur direct, ce paramètre sera l’ID partenaire du partenaire. Pour un revendeur indirect, ce paramètre sera l’ID partenaire du revendeur indirect. |
| friendlyName | string | Nom de l'abonnement. |
| partnerName | string | Nom du partenaire pour lequel l’abonnement a été acheté |
| Providername | string | Lorsque la transaction d’abonnement concerne le revendeur indirect, le nom du fournisseur est le fournisseur indirect qui a acheté l’abonnement. |
| effectiveStartDate | Chaîne au format date/heure UTC | Date de début de l’abonnement. |
| commitmentEndDate | Chaîne au format date/heure UTC | Date de fin de l’abonnement. |
| currentStateEndDate | Chaîne au format date/heure UTC | Date à laquelle l’état actuel de l’abonnement change. |
| trialToPaidConversionDate | Chaîne au format date/heure UTC | Date à laquelle l’abonnement passe de la version d’évaluation au paiement. La valeur par défaut est null. |
| trialStartDate | Chaîne au format date/heure UTC | Date à laquelle la période d’évaluation de l’abonnement a démarré. La valeur par défaut est null. |
| trialEndDate | Chaîne au format date/heure UTC | Date à laquelle la période d’évaluation de l’abonnement se termine. La valeur par défaut est null. |
| lastUsageDate | Chaîne au format date/heure UTC | Date à laquelle l’abonnement a été utilisé pour la dernière fois. La valeur par défaut est null. |
| deprovisionedDate | Chaîne au format date/heure UTC | Date à laquelle l’abonnement a été déprovisionné. La valeur par défaut est null. |
| lastRenewalDate | Chaîne au format date/heure UTC | Date à laquelle l’abonnement a été renouvelé pour la dernière fois. La valeur par défaut est null. |
| licenseCount | number | Nombre total de licences. |
| subscriptionCount | number | Nombre d’abonnements. Remarque : cette valeur apparaît uniquement dans la réponse d’une requête d’agrégation. |
Analyse de recherche
Remarque
L’appartenance au programme CSP n’est pas nécessaire pour obtenir l’analytique de recherche.
Le scénario suivant vous montre comment utiliser l’API Analytics pour récupérer toutes vos informations d’analyse de recherche dans l’Espace partenaires.
Ce scénario retourne vos informations d’analyse dans une collection de ressources de recherche.
Rechercher dans la ressource
Représente toutes les données analytiques d’une recherche.
| Propriété | Type | Description |
|---|---|---|
| companyName | string | Nom de la société de facturation. |
| contactButtonClicked | Boolean | Indique si le bouton contact a été cliqué. |
| mot clé Country | string | Pays/région spécifié dans la recherche. |
| detailsViewed | Boolean | Indique si les détails de la recherche ont été consultés. |
| mot clé IndustryFocus | string | L’industrie à rechercher dans, par exemple, la santé. |
| partnerId | string | The PartnerID. Pour un revendeur direct, ce paramètre sera l’ID partenaire du partenaire. Pour un revendeur indirect, ce paramètre sera l’ID partenaire du revendeur indirect. |
| partnerMarket | string | Paramètres régionaux où le partenaire effectue l’activité. |
| mot clé Product | string | Produit spécifié dans la recherche. |
| referralSubmitted | Boolean | Indique si une référence a été envoyée. |
| searchDate | Chaîne au format date/heure UTC | Date à laquelle la requête de recherche s’est produite. |
| mot clé SearchText | string | Texte spécifié dans la recherche. |
| searchResultPageViews | long | Nombre de fois où le partenaire est arrivé dans le résultat de la recherche. Partie d’une réponse uniquement sur l’agrégation. |
| contactClicks | long | Nombre de fois où le bouton de contact a été cliqué. Partie d’une réponse uniquement sur l’agrégation. |
| referralCount | long | Nombre de références générées à partir de la recherche. Partie d’une réponse uniquement sur l’agrégation. |
| profileViews | long | Nombre de fois où le profil partenaire a été consulté. Partie d’une réponse uniquement sur l’agrégation. |
Analyse des références
Remarque
L’appartenance au programme CSP n’est pas nécessaire pour obtenir l’analytique des références.
Le scénario suivant vous montre comment utiliser l’API Analytics pour récupérer toutes vos informations d’analyse des références de l’Espace partenaires.
Ce scénario retourne vos informations d’analyse dans une collection de ressources Références .
Remarque
L’analytique des références n’est pas disponible pour l’Espace partenaires géré par 21Vianet.
Ressource références
Représente toutes les données analytiques d’une référence.
| Propriété | Type | Description |
|---|---|---|
| id | string | Identificateur du locataire du client. |
| statut | string | Indique si la référence a conduit à un client. |
| customerMarket | string | Pays/région dans lequel le client s’occupe. |
| customerName | string | Nom du client. |
| customerOrgSize | string | Plage indiquant le nombre d’employés dans l’organisation du client. Par exemple, « 10to50employees ». |
| acceptedDate | Chaîne au format date/heure UTC | Date à laquelle la référence a été acceptée. |
| acknowledgedDate | Chaîne au format date/heure UTC | Date à laquelle la référence a été reconnue. |
| archivedDate | Chaîne au format date/heure UTC | Date à laquelle la référence a été archivée. |
| declinedDate | Chaîne au format date/heure UTC | Date à laquelle la référence a été refusée. |
| expiredDate | Chaîne au format date/heure UTC | Date à laquelle la référence a expiré. |
| lostDate | Chaîne au format date/heure UTC | Date à laquelle la référence a été perdue. |
| missedDate | Chaîne au format date/heure UTC | Date à laquelle la référence a été manquée. |
| createdDate | Chaîne au format date/heure UTC | Date de création de la référence. |
| skippedDate | Chaîne au format date/heure UTC | Date à laquelle la référence a été ignorée. |
| wonDate | Chaîne au format date/heure UTC | Date à laquelle la référence a été gagnée. |
| partnerMarket | string | Pays/région dans lequel le partenaire s’occupe. |