> ## 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.

# Tutoriel sur PlayFab et l'analytique en temps réel de Microsoft Fabric

> Tutoriel de bout en bout pour intégrer PlayFab à l'analytique en temps réel de Microsoft Fabric afin de diffuser en continu les événements de jeu et d'explorer les KPI dans un tableau de bord Power BI.

Ce tutoriel explique les étapes de bout en bout pour intégrer **PlayFab** et **Fabric Real-Time Analytics** afin d'activer l'analytique et les renseignements en temps réel pour votre jeu. En suivant les instructions détaillées, vous apprendrez à utiliser le service Data Connections de PlayFab pour distribuer les événements de jeu vers la base de données Fabric Real-Time Analytics, et à accéder au tableau de bord Power BI de Fabric pour explorer les principaux KPI du jeu. Le tutoriel comprend un exemple de tableau de bord Power BI et toutes les ressources nécessaires pour réaliser l'intégration.

<iframe src="https://www.youtube.com/embed/lbHjRRz7i1I" width="100%" height="400" allowFullScreen frameBorder="0" />

### Prérequis

* Pour réussir ce tutoriel, vous avez besoin d'une [capacité](https://learn.microsoft.com/en-us/fabric/enterprise/licenses#capacity) compatible avec Microsoft Fabric. Pour une durée limitée, vous pouvez [vous inscrire à l'essai de Microsoft Fabric (préversion)](https://learn.microsoft.com/en-us/fabric/get-started/fabric-trial).
* Un compte de développeur PlayFab. Inscrivez-vous sur [playfab.com](https://developer.playfab.com)
* Microsoft Power BI Desktop installé. Consultez [Prise en main de Power BI Desktop](https://learn.microsoft.com/en-us/power-bi/fundamentals/desktop-getting-started#install-and-run-power-bi-desktop)

## Créer un espace de travail Fabric

1. Accédez à [Microsoft Fabric](https://msit.powerbi.com/home).
2. Dans la barre de navigation de gauche, sélectionnez **Workspaces** > **New workspace**.
3. Un volet s'ouvre sur le côté droit de l'écran.
4. Entrez un nom pour l'espace de travail. Le seul champ obligatoire est **Name**. Exemple : **PlayFabReports**.

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/reports/tutorials/create-workspace-fabric.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=2db6e2c3e95dfe7e0e5d2c3d76ac8c95" alt="Créer un espace de travail Microsoft Fabric" width="373" height="330" data-path="images/playfab/data-analytics/learn-data/reports/tutorials/create-workspace-fabric.png" />

5. Sélectionnez **Apply** pour enregistrer votre espace de travail.

Pour plus de détails, consultez [Créer un espace de travail - Microsoft Fabric | Microsoft Learn](https://learn.microsoft.com/en-us/fabric/get-started/create-workspaces)

## Créer une base de données KQL

Une fois votre espace de travail configuré, l'étape suivante consiste à créer une base de données KQL, dans laquelle tous vos événements PlayFab seront acheminés.

1. Accédez à [Microsoft Fabric](https://msit.powerbi.com/home).
2. Dans la barre de navigation de gauche, sélectionnez **Workspaces** > **Your Workspace**.
3. Sélectionnez **New** > **More Options** > **KQL Database**.
4. Entrez un nom dans le champ **KQL Database name** et sélectionnez **New database** comme **Type**.

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/reports/tutorials/new-kql-database.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=6207df09d76e50a47782669517a64875" alt="Créer une base de données KQL" width="336" height="263" data-path="images/playfab/data-analytics/learn-data/reports/tutorials/new-kql-database.png" />

5. Sélectionnez **Create** pour terminer la création de la base de données.

Pour en savoir plus, consultez [Analytique en temps réel - Créer des ressources](https://learn.microsoft.com/en-us/fabric/real-time-analytics/tutorial-1-resources).

## Créer une connexion de données Microsoft Fabric

Une fois créée, la base de données KQL s'affiche dans votre espace de travail, comme le montre la capture d'écran ci-dessous.

Créez maintenant une connexion de données afin que tous vos événements puissent être acheminés vers votre base de données KQL.

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/reports/tutorials/kql-database-overview.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=afd45271058fdd90abad4118af3c65db" alt="Vue d'ensemble de la base de données KQL" width="624" height="261" data-path="images/playfab/data-analytics/learn-data/reports/tutorials/kql-database-overview.png" />

1. Accédez à [Microsoft Fabric](https://msit.powerbi.com/home).
2. Sélectionnez **Workspaces** dans le panneau de gauche, puis sélectionnez **Your Workspace**.
3. Copiez le **Query URI** en sélectionnant l'icône **Copy** à côté de l'étiquette **Query URI**.
4. Accédez à **PlayFab** et connectez-vous à [Game Manager](https://developer.playfab.com/).
5. Sélectionnez **Data** dans le menu de gauche.
6. Sélectionnez l'onglet **Data Connections**.
7. Sélectionnez le bouton **New connection**.
8. Dans la liste déroulante **Destination type**, sélectionnez l'option **Fabric KQL Database**.
9. Donnez un nom à votre **connexion de données** dans le champ **Name**.
10. Assurez-vous que la case **Enabled** est cochée.
11. Collez le **Query URI** obtenu dans Fabric dans le champ **Ingestion URI**.
12. Dans le champ **Database**, entrez le nom de la **base de données KQL** que vous avez créée dans Fabric.
13. Remplissez le champ **Table** avec un nom significatif. Exemple : **Events**.

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/reports/tutorials/new-data-connection.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=2357a5b6c38a42d5d5d08afd9d78d6a6" alt="Nouvelle connexion de données" width="1366" height="960" data-path="images/playfab/data-analytics/learn-data/reports/tutorials/new-data-connection.png" />

Un ensemble de requêtes se trouve au bas de la page. Dans la section suivante, copions ces requêtes dans Fabric.

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/reports/tutorials/kql-queries.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=fe0de34e6152fb97dc31f87ae15a7b11" alt="Requêtes KQL" width="1616" height="234" data-path="images/playfab/data-analytics/learn-data/reports/tutorials/kql-queries.png" />

## Tout rassembler

1. Revenez à la page de votre **base de données KQL** dans **Fabric**.
2. Sélectionnez **Explore your data**.
3. Copiez et exécutez chacune des requêtes une à une en sélectionnant le bouton **Run** en haut du volet.
4. Le résultat devrait ressembler à ceci :

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/learn-data/reports/tutorials/kql-queries-result.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=ed4740a356a91fc72cb62a713f6cc803" alt="Résultat des requêtes KQL" width="624" height="541" data-path="images/playfab/data-analytics/learn-data/reports/tutorials/kql-queries-result.png" />

5. Revenez à l'onglet **Data Connections** dans **Game Manager**.
6. Sélectionnez **Save**.

## Voir le tout en action

Pour obtenir les meilleurs résultats, suivez ces étapes après avoir terminé toutes les instructions ci-dessus.

Maintenant, à des fins de démonstration, créons de nouveaux joueurs dans Game Manager de PlayFab; vous devriez ensuite pouvoir voir leurs données dans le rapport Power BI.

### Créer des joueurs dans Game Manager

1. Accédez à **PlayFab** et connectez-vous à [Game Manager](https://developer.playfab.com/).
2. Sélectionnez **Players** dans le menu de gauche.
3. Sélectionnez l'onglet **Players**.
4. Sélectionnez **New player**.
5. Sélectionnez **Create and login player**.
6. Répétez ces étapes pour créer autant de joueurs que vous le souhaitez!

### Téléverser le modèle Power BI de PlayFab dans Microsoft Fabric

Ce processus comporte deux étapes. D'abord, téléchargez le modèle Power BI de PlayFab, puis téléversez-le dans Microsoft Fabric.

#### Télécharger le modèle Power BI à partir de GitHub

1. Accédez à [GitHub](https://github.com/) et connectez-vous.
2. Accédez au référentiel [PlayFabPowerBITemplates](https://github.com/PlayFab/PlayFabPowerBITemplates).
3. Sélectionnez le **bouton à trois points** en haut à droite de la page pour télécharger le modèle.

#### Ouvrir le modèle dans Power BI Desktop et le publier dans Microsoft Fabric

1. Ouvrez **Power BI Desktop**.
2. Sélectionnez l'onglet **File** en haut de l'écran.
3. Sélectionnez **Browse this device** en bas à gauche de l'écran.
4. Recherchez le fichier de modèle (.pbit) que vous avez téléchargé, puis **sélectionnez-le** et **ouvrez-le**.

<Tip>
  Lorsque vous recherchez le modèle téléchargé, changez le type de fichier pour Power BI Template Files (\*.pbit) dans la liste déroulante, car celle-ci affiche par défaut les fichiers \*.pbix.
</Tip>

5. Remplissez les paramètres de connexion dans la fenêtre **PlayfabReportTemplate**.
   * Accédez à [Microsoft Fabric](https://msit.powerbi.com/home).
   * Sélectionnez **Workspaces** dans le panneau de gauche, puis sélectionnez votre espace de travail.
   * URI : copiez le Query URI en sélectionnant l'**icône Copy** à côté du champ URI.
   * Database : dans le champ **Database**, entrez le nom de la base de données KQL que vous avez créée dans Fabric.
   * Entrez sous **Table** le nom de la table que vous avez créée à l'étape [Créer une connexion de données Microsoft Fabric](#create-a-microsoft-fabric-data-connection). Si vous avez utilisé l'exemple de nom ci-dessus, il s'agit de **Events**.
6. Sélectionnez **Load**.
7. Sélectionnez **Publish** en haut de la page.
8. Sélectionnez **Save**.
9. Remplissez le formulaire **Save** this file. (Seulement si vous n'avez pas encore enregistré le fichier.)
   * Donnez au rapport un **Name** significatif pour vous. Exemple : **OverviewReport**
   * Sélectionnez un **Location** où l'enregistrer.
   * Sélectionnez **Save**.
10. Remplissez le formulaire **Publish** en sélectionnant votre **espace de travail Microsoft Fabric**.
11. Sélectionnez le lien **Open OverviewReport.pbit in Power BI**, qui ouvre le rapport modèle dans Fabric.

Une fois ces étapes terminées, sélectionnez votre espace de travail dans Fabric pour trouver la liste des bases de données et des rapports.

<Info>
  La quantité de données que vous voyez dépend du moment où la connexion de données a été créée. PlayFab ne remplit pas rétroactivement les données.
</Info>

## Voir aussi

* [Terminologie de Microsoft Fabric](https://learn.microsoft.com/en-us/fabric/get-started/fabric-terminology)
* [Créer un espace de travail](https://learn.microsoft.com/en-us/fabric/get-started/create-workspaces)
* [Accéder à vos éléments à partir de la page d'accueil de Microsoft Fabric](https://learn.microsoft.com/en-us/fabric/get-started/fabric-home)
* [Tutoriels de bout en bout dans Microsoft Fabric](https://learn.microsoft.com/en-us/fabric/get-started/end-to-end-tutorials)


## Related topics

- [Concepts de base de l'analytique en temps réel](/fr-CA/services/playfab/data-analytics/ingest-data/real-time-analytics-core-concepts.md)
- [Documentation sur les données et l'analytique PlayFab](/fr-CA/services/playfab/data-analytics/index.md)
- [Data Connections - Vue d'ensemble](/fr-CA/services/playfab/data-analytics/export-data/data-connection-overview.md)
- [Activer ou désactiver les événements générés par les services](/fr-CA/services/playfab/data-analytics/ingest-data/opt-in-events.md)
- [Qu'est-ce que PlayFab?](/fr-CA/services/playfab/get-started/what-is-playfab.md)
