Passer au contenu principal

Tutoriel : Connexion d’Azure Data Factory (ADF) à Insights

Ce guide vous aide à commencer à utiliser Azure Data Factory (ADF) avec Insights. Une fois la connexion établie, vous pouvez utiliser Azure Data Factory pour créer des workflows permettant d’orchestrer le déplacement des données et de transformer les données de jeu à grande échelle. Pour en savoir plus sur les autres outils auxquels vous pouvez connecter Insights, consultez Connexion d’outils externes à Insights. Dans ce tutoriel, vous allez apprendre à :
[!div class=“checklist”] * Créer une fabrique de données dans Azure * Créer un pipeline
PlayFab Insights Management a été mis hors service le 31/03/2026. Nous vous recommandons d’utiliser les connexions Azure Data Explorer (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.

Prérequis

Compte PlayFab authentifié avec AAD

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 (AAD) pour l’authentification, ce qui est nécessaire pour utiliser les services Azure. Consultez Authentification Azure Active Directory pour Game Manager pour obtenir des instructions sur la création d’un compte ou d’un utilisateur authentifié par AAD. Pour vérifier que le compte, ou l’utilisateur, est configuré pour utiliser le fournisseur d’authentification Microsoft :
  • Accédez à developer.playfab.com.
  • 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 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 fabrique de données

Pour créer une fabrique de données :
  1. Connectez-vous au portail Azure. Dans la page d’accueil, sous Azure Services, sélectionnez Create a resource. Recherchez Data Factory, sélectionnez-le, puis sélectionnez Create. Création d'une ressource ADF
  2. Remplissez les champs obligatoires :
    • Pour Name, choisissez un nom pour votre fabrique de données. Le nom doit être globalement unique.
    • Pour Subscription, sélectionnez l’abonnement Azure dans lequel vous souhaitez créer la fabrique de données.
    • Pour Resource Group, effectuez l’une des opérations suivantes :
      • Sélectionnez Use existing, puis sélectionnez un groupe de ressources existant dans la liste.
      • Sélectionnez Create new, puis entrez le nom d’un groupe de ressources.
    • Vous n’avez pas besoin d’activer GIT pour l’instant ; décochez donc la case ci-dessous. Nouvelle fabrique de données ADF
  3. Sélectionnez Create. Une fois le déploiement terminé, sous Next steps, sélectionnez Go to resource.
  4. Pour ouvrir l’interface utilisateur de Data Factory dans un onglet distinct, sélectionnez Author & Monitor.

Créer un pipeline

Nous allons maintenant créer un nouveau pipeline pour obtenir des données à partir d’Insights. Pour créer un pipeline :
  1. Sur la page Let’s get started, sélectionnez Create pipeline.
  2. Dans le panneau Activities, sous Azure Data Explorer, faites glisser une Azure Data Explorer Command dans l’espace de travail vide. Dans le panneau inférieur, sous General, renseignez le nom et la description. Commande Explorer ADF
  3. Sélectionnez l’onglet Connection, puis sélectionnez New. Connexion de la commande Explorer ADF
  4. Dans la fenêtre New linked service (Azure Data Explorer (Kusto)), remplissez les champs :
    • Pour Name, utilisez l’ID de titre.
    • Pour Account selection method, sélectionnez Enter manually.
    • Pour Endpoint, utilisez le point de terminaison de l’API PlayFab, qui est https://insights.playfab.com.
    • Pour Service Principal ID, entrez l’ID client de votre application Azure.
    • Pour Service Principal Key, entrez la clé secrète client de votre application Azure.
    • Dans la zone Database, tapez l’ID de titre entièrement en majuscules. Nouveau service lié ADF Sélectionnez Create. Le pipeline est maintenant prêt. Vous pouvez revenir à la vue principale du pipeline en cliquant sur le nom du pipeline.
  5. Pour vérifier que toutes les informations sont correctes, sélectionnez Test connection. Si tout est configuré correctement, une réponse Connection successful est retournée. Test de connexion ADF
  6. Pour valider et déboguer le pipeline, dans la barre d’outils au-dessus de l’espace de travail, sélectionnez Validate, puis Debug.

Ressources supplémentaires

Dernière modification le 6 octobre 2026