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 flux de travail 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 que vous pouvez connecter à Insights, consultez Connexion d’outils externes à Insights. Dans ce tutoriel, vous apprendrez à :
[!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 votre rendement et vos coûts à l’avenir. Si votre titre utilise encore Insights, continuez à consulter cet article pour les détails de mise en œuvre. 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 requis 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 pouvez 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 d’analytique.
Vous pouvez soit créer un nouveau rôle d’utilisateur, soit 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. ADF - Créer une ressource
  2. Remplissez les champs obligatoires :
    • Pour Name, choisissez un nom pour votre fabrique de données. Le nom doit être unique à l’échelle mondiale.
    • 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 étapes 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, alors décochez la case ci-dessous. ADF - Nouvelle fabrique de données
  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 pipeline pour obtenir des données d’Insights. Pour créer un pipeline :
  1. Dans 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, remplissez le nom et la description. ADF - Commande Explorer
  3. Sélectionnez l’onglet Connection, puis sélectionnez New. ADF - Connexion de la commande Explorer
  4. Dans la fenêtre New linked service (Azure Data Explorer (Kusto)), remplissez les champs :
    • Pour Name, utilisez l’ID du titre.
    • Pour Account selection method, sélectionnez Enter manually.
    • Pour Endpoint, utilisez le point de terminaison de l’API PlayFab, soit 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 du titre entièrement en majuscules. ADF - Nouveau service lié 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. ADF - Tester la connexion
  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