Exportación de datos

Este artículo describe cómo exportar datos de jugador y de eventos desde PlayFab.

Exportar los datos de la cuenta de jugador

Cuando realiza una solicitud para exportar los datos de un jugador, la solicitud se envía a un agente de procesamiento de colas (de forma similar a la eliminación de un jugador). La API ExportMasterPlayerData exporta todos los datos asociados al PlayFabId proporcionado, incluidos los datos de todos sus títulos, como:

Estadísticas
Datos personalizados
Inventario
*Compras *
Elementos creados por el jugador/UGC
Historial de transacciones
Saldos de moneda virtual
Personajes
Pertenencias a grupos
Datos del publicador
Datos de credenciales
Vinculaciones de cuentas
Lista de amigos
Historial de eventos de PlayStream.

Lea Asegúrese de encontrar todos los datos, donde se detalla cómo asegurarse de que dispone de todos los PlayFabId de un jugador. Esta API devuelve inmediatamente un JobReceiptId, que debería almacenar en sus registros para futuras consultas. La exportación puede tardar algún tiempo en estar disponible para su descarga. Al completarse la exportación, se enviará un correo electrónico con el vínculo de descarga de la exportación a la dirección de correo electrónico de notificación configurada para el título. La finalización de la tarea también desencadena un evento de PlayStream player_data_exported. El evento contiene el JobReceiptId como propiedad, así como la propiedad ExportDownloadUrl, que proporciona acceso a los datos exportados. Mediante las reglas de automatización con Azure Functions o los webhooks, puede registrarse para recibir estos eventos en el punto de conexión que elija y procesarlos según sea necesario. El siguiente ejemplo muestra cómo usar la API de administración con el SDK de C#. Si desea usar otro SDK, seleccione uno de la lista de SDK de 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);
}

La dirección URL estará disponible durante un máximo de 30 días después de completarse la exportación. Transcurrido este tiempo, el archivo se eliminará y deberá iniciar una nueva solicitud de exportación.

Formato de los datos exportados

Los datos exportados se empaquetan en un archivo ZIP cuyo nombre contiene el JobReceiptId y la hora de la exportación. El archivo contiene varios archivos organizados en una estructura de directorios.

Ruta de archivo	Descripción
/master_player_export.json	Un archivo JSON que contiene los datos del jugador registrados en PlayFab. Esto incluye los datos de cada uno de los títulos en los que participa el jugador. El esquema del documento JSON se proporciona como una especificación de OpenAPI. Consulte el objeto `MasterPlayerDataExport` en `https://<your_title_id>.playfabapi.com/Swagger/MasterPlayerDataExport.swagger.json`
/CustomFiles/MasterPlayerFiles/*	Contiene los archivos de entidad personalizados asociados a la entidad `master_player_account` del jugador.
/CustomFiles/TitlePlayerFiles/<TitlePlayerAccountId>/*	Contiene los archivos de entidad personalizados asociados a las entidades `title_player_account` del jugador. Los archivos están organizados en un subdirectorio por cada título en el que participa el jugador. El nombre de cada subdirectorio es el identificador de entidad `title_player_account` del jugador en el título.
/TitlePlayerEvents/<TitleId>/event-history_1.jsonl … /TitlePlayerEvents/<TitleId>/event-history_<N>.jsonl	Los eventos de PlayStream y de telemetría registrados sobre el jugador. Los archivos están organizados en un subdirectorio por cada título en el que participa el jugador. El nombre de cada subdirectorio es el identificador del título. Cada subdirectorio contiene uno o varios archivos `event-history`, según la cantidad de datos que tenga el jugador en el título en cuestión. Los archivos contienen los eventos serializados en objetos JSON, un evento por línea.

Exportar datos de eventos

PlayFab proporciona varios tipos de datos de eventos: datos personalizados, objetos de entidad y archivos de entidad.

Exportar datos personalizados

Los datos personalizados hacen referencia a una amplia categoría de características que le permiten asociar datos arbitrarios a un jugador. PlayFab proporciona métodos para interactuar con los datos desde la lógica de su juego, pero por lo demás no interpreta ni entiende los datos.

Datos de jugador heredados

Al usar la API ExportMasterPlayerData (como se menciona en la sección de exportación de datos de PlayFab), todas las propiedades de datos de jugador se pueden encontrar en el archivo master_player_export.json en la raíz del archivo ZIP:

Los datos de “Publisher” se pueden encontrar en la ruta JSONPath: $.PublisherData
Los datos por título se pueden encontrar en la ruta JSONPath: $.Titles[*].CustomData

Estos valores también se pueden recuperar mediante API “get” dedicadas, en caso de que solo necesite exportar estos valores. La ventaja de las API dedicadas es que devuelven el resultado de inmediato. Sin embargo, según el diseño de esta característica, será necesario llamar a la API adecuada en función del tipo concreto de datos necesarios: GetUserData, GetUserInternalData, GetUserReadOnlyData, GetUserPublisherData, GetUserPublisherInternalData, GetUserPublisherReadOnlyData

Exportar objetos de entidad

Al usar la API ExportMasterPlayerData, todos los objetos de entidad se pueden encontrar en el archivo master_player_export.json en la raíz del archivo ZIP: Para los objetos de entidad master_player_account, en la ruta JSONPath: $.CustomObjects Para los objetos de entidad title_player_account, en la ruta JSONPath: $.Titles[*].CustomObjects Para los objetos de entidad de personaje, en la ruta JSONPath: $.Titles[].Characters[].CustomObjects Los objetos de entidad también se pueden recuperar mediante la API GetObjects. Si ya sabe qué objetos de qué entidades está buscando, usar las API dedicadas puede ser más sencillo, ya que devuelven los objetos de inmediato. Sin embargo, la desventaja es que será necesario llamar a la API por separado para la entidad master_player_account del jugador, cada entidad title_player_account y cada entidad de personaje.

Exportar archivos de entidad

Al usar la API ExportMasterPlayerData, todos los archivos de entidad asociados al jugador se agregan tal cual al archivo ZIP en el directorio /CustomFiles/, en concreto: Para la entidad master_player_account del jugador, los archivos están en /CustomFiles/MasterPlayerFiles/* Para title_player_account, los archivos están en /CustomFiles/TitlePlayerFiles/<TitlePlayerAccountId>/*

Existe un subdirectorio por cada entidad, con el identificador de la entidad title_player_account como nombre del directorio.

Los archivos de entidad también se pueden descargar directamente. Primero, llame a la API GetFiles para obtener metadatos sobre los archivos de la entidad. Cada documento de metadatos de archivo incluye una propiedad DownloadUrl, que se puede usar para descargar el archivo directamente.

XBOX Services

PlayFab

RGPD de PlayFab: exportar datos de jugador

Exportación de datos

Exportar los datos de la cuenta de jugador

Formato de los datos exportados

Exportar datos de eventos

Exportar datos personalizados

Datos de jugador heredados

Exportar objetos de entidad

Exportar archivos de entidad

​Exportación de datos

​Exportar los datos de la cuenta de jugador

​Formato de los datos exportados

​Exportar datos de eventos

​Exportar datos personalizados

​Datos de jugador heredados

​Exportar objetos de entidad

​Exportar archivos de entidad

Exportación de datos

Exportar los datos de la cuenta de jugador

Formato de los datos exportados

Exportar datos de eventos

Exportar datos personalizados

Datos de jugador heredados

Exportar objetos de entidad

Exportar archivos de entidad