Exporter des données

Cet article explique comment exporter des données de joueurs et d’événements à partir de PlayFab.

Exporter les données du compte du joueur

Lorsque vous envoyez une requête d’exportation des données d’un joueur, la requête est envoyée à un agent de traitement de file d’attente (comme pour la suppression d’un joueur). L’API ExportMasterPlayerData exporte toutes les données associées au PlayFabId donné, y compris les données de tous vos titres, telles que :

Statistiques
Données personnalisées
Inventaire
*Achats *
Objets créés par les joueurs/UGC
Historique des transactions
Soldes de monnaie virtuelle
Personnages
Appartenances aux groupes
Données d’éditeur
Données d’identification
Liaisons de comptes
Liste d’amis
Historique des événements PlayStream.

Veuillez lire Assurez-vous de trouver toutes les données, qui explique comment vous assurer de disposer de tous les PlayFabIds d’un joueur. Cette API renvoie immédiatement un JobReceiptId, que vous devez conserver dans vos archives pour référence ultérieure. L’exportation peut mettre un certain temps avant d’être disponible au téléchargement. Une fois l’exportation terminée, un e-mail contenant le lien de téléchargement de l’exportation est envoyé à l’adresse e-mail de notification configurée pour le titre. L’achèvement de la tâche déclenche également un événement PlayStream player_data_exported. L’événement contient le JobReceiptId en tant que propriété, ainsi que la propriété ExportDownloadUrl, qui donne accès aux données exportées. À l’aide des règles d’automatisation avec Azure Functions ou des Webhooks, vous pouvez vous inscrire pour recevoir ces événements sur le point de terminaison de votre choix et les traiter selon vos besoins. L’exemple suivant montre comment utiliser l’API Admin avec le SDK C#. Si vous souhaitez utiliser un autre SDK, sélectionnez-en un dans la liste des SDK PlayFab.

public static async void ExportMasterPlayerExample(Action<PlayFabError> callback)
{
    var task = await PlayFabAdminAPI.ExportMasterPlayerDataAsync(new ExportMasterPlayerDataRequest()
    {
        PlayFabId = PlayFabId
    });

    if(task.Error != null)
    {
        callback(task.Error);
    }

    var jobReceiptId = task.Result.JobReceiptId;

    Console.WriteLine(string.Format("Export Player Request Received - Receipt: {0}", jobReceiptId));

    callback(null);
}

L’URL reste disponible pendant 30 jours au maximum après la fin de l’exportation. Passé ce délai, le fichier est supprimé et vous devez lancer une nouvelle requête d’exportation.

Format des données exportées

Les données exportées sont empaquetées dans une archive ZIP dont le nom contient le JobReceiptId et l’heure de l’exportation. L’archive contient plusieurs fichiers organisés selon une arborescence de répertoires.

Chemin du fichier	Description
/master_player_export.json	Fichier JSON contenant les données du joueur enregistrées dans PlayFab. Il comprend les données de chacun des titres auxquels le joueur participe. Le schéma du document JSON est fourni sous forme de spécification OpenAPI. Consultez l’objet `MasterPlayerDataExport` dans `https://<your_title_id>.playfabapi.com/Swagger/MasterPlayerDataExport.swagger.json`
/CustomFiles/MasterPlayerFiles/*	Contient les fichiers d’entité personnalisés associés à l’entité `master_player_account` du joueur.
/CustomFiles/TitlePlayerFiles/<TitlePlayerAccountId>/*	Contient les fichiers d’entité personnalisés associés aux entités `title_player_account` du joueur. Les fichiers sont organisés en un sous-répertoire par titre auquel le joueur participe. Le nom de chaque sous-répertoire correspond à l’ID d’entité `title_player_account` du joueur dans le titre.
/TitlePlayerEvents/<TitleId>/event-history_1.jsonl … /TitlePlayerEvents/<TitleId>/event-history_<N>.jsonl	Les événements PlayStream et Telemetry enregistrés concernant le joueur. Les fichiers sont organisés en un sous-répertoire par titre auquel le joueur participe. Le nom de chaque sous-répertoire correspond à l’ID du titre. Chaque sous-répertoire contient un ou plusieurs fichiers `event-history`, selon la quantité de données dont dispose le joueur dans le titre concerné. Les fichiers contiennent les événements sérialisés en objets JSON, à raison d’un événement par ligne.

Exporter les données d’événements

PlayFab fournit plusieurs types de données d’événements : les données personnalisées, les objets d’entité et les fichiers d’entité.

Exporter les données personnalisées

Les données personnalisées désignent une vaste catégorie de fonctionnalités qui vous permettent d’associer des données arbitraires à un joueur. PlayFab fournit des méthodes pour interagir avec ces données à partir de la logique de votre jeu, mais n’interprète ni ne comprend autrement ces données.

Données des joueurs héritées

Lorsque vous utilisez l’API ExportMasterPlayerData (comme indiqué dans la section Exportation des données PlayFab), toutes les propriétés des données des joueurs se trouvent dans le fichier master_player_export.json à la racine de l’archive ZIP :

Les données « Publisher » se trouvent au JSONPath : $.PublisherData
Les données par titre se trouvent au JSONPath : $.Titles[*].CustomData

Ces valeurs peuvent également être récupérées via des API « get » dédiées, si vous n’avez besoin d’exporter que ces valeurs. L’avantage des API dédiées est qu’elles renvoient une réponse immédiatement. Toutefois, de par la conception de cette fonctionnalité, il faut appeler l’API appropriée en fonction du type de données spécifique requis : GetUserData, GetUserInternalData, GetUserReadOnlyData, GetUserPublisherData, GetUserPublisherInternalData, GetUserPublisherReadOnlyData

Exporter les objets d’entité

Lorsque vous utilisez l’API ExportMasterPlayerData, tous les objets d’entité se trouvent dans le fichier master_player_export.json à la racine de l’archive ZIP : Pour les objets d’entité master_player_account, au JSONPath : $.CustomObjects Pour les objets d’entité title_player_account, au JSONPath : $.Titles[*].CustomObjects Pour les objets d’entité de personnage, au JSONPath : $.Titles[].Characters[].CustomObjects Les objets d’entité peuvent également être récupérés via l’API GetObjects. Si vous savez déjà quels objets d’entités vous recherchez, il peut être plus simple d’utiliser les API dédiées, car elles renvoient les objets immédiatement. L’inconvénient est toutefois que l’API doit être appelée séparément pour l’entité master_player_account du joueur, pour chaque entité title_player_account et pour chaque entité de personnage.

Exporter les fichiers d’entité

Lorsque vous utilisez l’API ExportMasterPlayerData, tous les fichiers d’entité associés au joueur sont ajoutés tels quels à l’archive ZIP dans le répertoire /CustomFiles/, plus précisément : Pour l’entité master_player_account du joueur, les fichiers se trouvent sous /CustomFiles/MasterPlayerFiles/* Pour title_player_account, les fichiers se trouvent sous /CustomFiles/TitlePlayerFiles/<TitlePlayerAccountId>/*

Il existe un sous-répertoire pour chaque entité, dont le nom correspond à l’ID d’entité title_player_account.

Les fichiers d’entité peuvent également être téléchargés directement. Appelez d’abord l’API GetFiles pour obtenir les métadonnées des fichiers de l’entité. Chaque document de métadonnées de fichier comprend une propriété DownloadUrl, qui permet de télécharger directement le fichier.

XBOX Services

PlayFab

RGPD PlayFab - Exporter les données des joueurs

Exporter des données

Exporter les données du compte du joueur

Format des données exportées

Exporter les données d’événements

Exporter les données personnalisées

Données des joueurs héritées

Exporter les objets d’entité

Exporter les fichiers d’entité

​Exporter des données

​Exporter les données du compte du joueur

​Format des données exportées

​Exporter les données d’événements

​Exporter les données personnalisées

​Données des joueurs héritées

​Exporter les objets d’entité

​Exporter les fichiers d’entité

Exporter des données

Exporter les données du compte du joueur

Format des données exportées

Exporter les données d’événements

Exporter les données personnalisées

Données des joueurs héritées

Exporter les objets d’entité

Exporter les fichiers d’entité