> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connexion de Python à Insights

> Interrogez l'ancienne version de PlayFab Insights à partir de Python et de Jupyter Notebooks avec le SDK Azure Kusto pour Python, en utilisant l'authentification Microsoft Entra ID pour les données de votre jeu.

# Tutoriel : Connexion de Python à Insights

Ce guide vous aide à commencer à utiliser Python avec Insights. Il utilise le SDK Azure Kusto pour Python. Une fois la connexion établie, vous pouvez interroger les données de votre jeu avec Python et utiliser la bibliothèque à partir de Jupyter Notebooks. Pour en savoir plus sur les autres outils que vous pouvez connecter à Insights, consultez [Connexion d'outils externes à Insights](/fr/services/playfab/data-analytics/legacy/connectivity).

<Note>
  PlayFab Insights Management a été mis hors service le 31/03/2026. Nous vous recommandons d'utiliser les [connexions Azure Data Explorer (ADX)](/fr/services/playfab/data-analytics/export-data/data-connection-adx) pour gérer vos performances et vos coûts à l'avenir. Si votre titre utilise toujours **Insights**, continuez à consulter cet article pour les détails d'implémentation. Pour plus d'informations, consultez [PlayFab Digest: March feature updates](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/).
</Note>

## Prérequis

### Compte PlayFab authentifié avec Azure AD

Vous avez besoin d'un compte ou d'un utilisateur PlayFab dont le fournisseur d'authentification est défini sur Microsoft. Le fournisseur d'authentification Microsoft utilise Azure Active Directory (Azure AD) pour l'authentification, ce qui est nécessaire pour utiliser les services Azure. Consultez [Authentification Azure Active Directory pour Game Manager](/fr/services/playfab/identity/dev-identity/authentication/aad-authentication) pour obtenir des instructions sur la création d'un compte ou d'un utilisateur authentifié par Azure AD.

Pour vérifier que le compte, ou l'utilisateur, est configuré pour utiliser le fournisseur d'authentification Microsoft :

* Rendez-vous sur la [page de connexion](https://developer.playfab.com) de PlayFab.
* Sélectionnez **Sign in with Microsoft** pour accéder à votre compte PlayFab.

Si vous parvenez à vous connecter, le compte est configuré pour utiliser le fournisseur d'authentification Microsoft.

### Autorisations Game Manager pour Insights

Vous devez attribuer à votre compte un [rôle d'utilisateur](/fr/services/playfab/identity/dev-identity/permissions/playfab-user-roles) avec les autorisations Game Manager suivantes activées :

* Statut d'administrateur.
* Accès à l'onglet Explorer et aux données associées.
* Accès en lecture et en écriture aux données Analytics.

Vous pouvez créer un nouveau rôle d'utilisateur ou ajouter ces autorisations à un rôle existant.

### Autres prérequis

* [Créer une application Azure Active Directory (AAD) et la connecter à la base de données de votre titre](/fr/services/playfab/data-analytics/legacy/connectivity/creating-AAD-app-for-insights)

## Installer les packages Python

1. Installez les packages Python suivants à l'aide de [pip](https://pypi.org/project/pip/) :
   * azure-kusto-data
   * azure-kusto-ingest
   * adal
2. Voici un exemple de script pour commencer.

```python theme={null}
from azure.kusto.data.exceptions import KustoServiceError
from azure.kusto.data.request import KustoClient, KustoConnectionStringBuilder, ClientRequestProperties

from msal import ConfidentialClientApplication

cluster = "https://insights.playfab.com"

# These parameters are taken from your Azure app
client_id = "<Azure app client id>"
client_secret = "<Azure app client secret>" 
tenant = "<Azure app tenant id>"

authority_url = "https://login.microsoftonline.com/" + tenant

client_instance = ConfidentialClientApplication(
  client_id=client_id,
  client_credential=client_secret,
  authority=authority_url,
)

# Acquire a token from AAD to pass to PlayFab
_scopes = ["https://help.kusto.windows.net"]
token_response = client_instance.acquire_token_for_client(scopes=_scopes)

token = None
if token_response:
    if token_response['access_token']:
        token = token_response['access_token']

kcsb = KustoConnectionStringBuilder.with_aad_application_token_authentication(cluster, token)
client = KustoClient(kcsb)

db = "<title id>"
query = "['events.all'] | count"

# Force Kusto to use the v1 query endpoint
client._query_endpoint = cluster + "/v1/rest/query"

crp = ClientRequestProperties()
crp.application = "KustoPythonSDK"
response = client.execute(db, query)

# Response processing
print(response)
```

## Ressources supplémentaires

* [Documentation du SDK Azure Kusto pour Python](https://learn.microsoft.com/en-us/azure/data-explorer/kusto/api/python/kusto-python-client-library)
* Pour en savoir plus sur les autres outils à connecter à Insights, consultez  [Connexion d'outils externes à Insights](/fr/services/playfab/data-analytics/legacy/connectivity)


## Related topics

- [Connexion d'outils externes à Insights](/fr/services/playfab/data-analytics/legacy/connectivity/index.md)
- [Connexion de Grafana à Insights](/fr/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights.md)
- [Connexion de Kusto Explorer à Insights](/fr/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-explorer-to-insights.md)
- [Connexion de Power BI à Insights](/fr/services/playfab/data-analytics/legacy/connectivity/connecting-power-bi-to-insights.md)
- [Insights](/fr/services/playfab/data-analytics/legacy/insights/overview.md)