Exportar dados

Este artigo descreve como exportar dados de jogadores e de eventos do PlayFab.

Exportar dados da conta do jogador

Quando você faz uma solicitação para exportar os dados de um jogador, a solicitação é enviada para um agente de processamento de fila (de forma semelhante à exclusão de um jogador). A API ExportMasterPlayerData exporta todos os dados associados ao PlayFabId especificado, incluindo dados de todos os seus títulos, como:

Estatísticas
Dados personalizados
Inventário
*Compras *
Itens criados pelo jogador/UGC
Histórico de transações
Saldos de moeda virtual
Personagens
Associações a grupos
Dados do editor
Dados de credenciais
Vinculações de contas
Lista de amigos
Histórico de eventos do PlayStream.

Leia Certifique-se de encontrar todos os dados, que detalha como garantir que você tenha todos os PlayFabIds de um jogador. Essa API retorna imediatamente um JobReceiptId, que você deve armazenar em seus registros para referência futura. Pode levar algum tempo até que a exportação esteja disponível para download. Após a conclusão da exportação, um email contendo o link de download da exportação será enviado para o endereço de email de notificação configurado para o título. A conclusão da tarefa também disparará um evento player_data_exported do PlayStream. O evento contém o JobReceiptId como propriedade, bem como a propriedade ExportDownloadUrl, que fornece acesso aos dados exportados. Usando Regras de automação com Azure Functions ou Webhooks, você pode se registrar para receber esses eventos em um ponto de extremidade de sua escolha e processá-los conforme necessário. O exemplo a seguir mostra como usar a API de administração com o SDK do C#. Se você quiser usar outro SDK, selecione um na lista de SDKs do 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);
}

A URL ficará disponível por até 30 dias após a conclusão da exportação. Após esse período, o arquivo será excluído e você precisará iniciar uma nova solicitação de exportação.

Formato dos dados exportados

Os dados exportados são empacotados em um arquivo ZIP cujo nome contém o JobReceiptId e a hora da exportação. O arquivo contém vários arquivos organizados em uma estrutura de diretórios.

Caminho do arquivo	Descrição
/master_player_export.json	Um arquivo JSON que contém os dados do jogador registrados no PlayFab. Isso inclui dados de cada um dos títulos dos quais o jogador participa. O esquema do documento JSON é fornecido como uma especificação OpenAPI. Consulte o objeto `MasterPlayerDataExport` em `https://<your_title_id>.playfabapi.com/Swagger/MasterPlayerDataExport.swagger.json`
/CustomFiles/MasterPlayerFiles/*	Contém os Arquivos de entidade personalizados associados à entidade `master_player_account` do jogador.
/CustomFiles/TitlePlayerFiles/<TitlePlayerAccountId>/*	Contém os Arquivos de entidade personalizados associados às entidades `title_player_account` do jogador. Os arquivos são organizados em um subdiretório por título do qual o jogador participa. O nome de cada subdiretório é a ID da entidade `title_player_account` do jogador no título.
/TitlePlayerEvents/<TitleId>/event-history_1.jsonl … /TitlePlayerEvents/<TitleId>/event-history_<N>.jsonl	Os eventos do PlayStream e de Telemetry registrados sobre o jogador. Os arquivos são organizados em um subdiretório por título do qual o jogador participa. O nome de cada subdiretório é a ID do título. Cada subdiretório contém um ou mais arquivos `event-history`, dependendo da quantidade de dados que o jogador tem no título em questão. Os arquivos contêm os eventos serializados em objetos JSON, um evento por linha.

Exportar dados de eventos

O PlayFab fornece vários tipos de dados de eventos: dados personalizados, objetos de entidade e arquivos de entidade.

Exportar dados personalizados

Dados personalizados referem-se a uma ampla categoria de recursos que permitem associar dados arbitrários a um jogador. O PlayFab fornece métodos para interagir com os dados a partir da lógica do seu jogo, mas não interpreta nem compreende os dados de outra forma.

Dados de jogador herdados

Ao usar a API ExportMasterPlayerData (conforme mencionado na seção Exportando dados do PlayFab), todas as propriedades de dados de jogador podem ser encontradas no arquivo master_player_export.json, na raiz do arquivo ZIP:

Os dados de “Publisher” podem ser encontrados no JSONPath: $.PublisherData
Os dados por título podem ser encontrados no JSONPath: $.Titles[*].CustomData

Esses valores também podem ser recuperados por meio de APIs “get” dedicadas, caso você precise exportar apenas esses valores. A vantagem das APIs dedicadas é que elas retornam imediatamente. No entanto, de acordo com o design desse recurso, a API correta precisará ser chamada com base no tipo específico de dados necessário: GetUserData, GetUserInternalData, GetUserReadOnlyData, GetUserPublisherData, GetUserPublisherInternalData, GetUserPublisherReadOnlyData

Exportar objetos de entidade

Ao usar a API ExportMasterPlayerData, todos os objetos de entidade podem ser encontrados no arquivo master_player_export.json, na raiz do arquivo ZIP: Para objetos de entidade master_player_account, no JSONPath: $.CustomObjects Para objetos de entidade title_player_account, no JSONPath: $.Titles[*].CustomObjects Para objetos de entidade de personagem, no JSONPath: $.Titles[].Characters[].CustomObjects Os objetos de entidade também podem ser recuperados por meio da API GetObjects. Se você já souber de quais entidades está procurando os objetos, usar as APIs dedicadas pode ser mais fácil, pois elas retornarão os objetos imediatamente. No entanto, a desvantagem é que a API precisará ser chamada separadamente para a entidade master_player_account do jogador, para cada entidade title_player_account e para cada entidade de personagem.

Exportar arquivos de entidade

Ao usar a API ExportMasterPlayerData, todos os arquivos de entidade associados ao jogador são adicionados no estado em que se encontram ao arquivo ZIP, no diretório /CustomFiles/, especificamente: Para a entidade master_player_account do jogador, os arquivos ficam em /CustomFiles/MasterPlayerFiles/* Para title_player_account, os arquivos ficam em /CustomFiles/TitlePlayerFiles/<TitlePlayerAccountId>/*

Existe um subdiretório para cada entidade, com a ID da entidade title_player_account como nome do diretório.

Os arquivos de entidade também podem ser baixados diretamente. Primeiro, chame a API GetFiles para obter metadados sobre os arquivos da entidade. Cada documento de metadados de arquivo inclui uma propriedade DownloadUrl, que pode ser usada para baixar o arquivo diretamente.

XBOX Services

PlayFab

GDPR do PlayFab - Exportar dados do jogador

Exportar dados

Exportar dados da conta do jogador

Formato dos dados exportados

Exportar dados de eventos

Exportar dados personalizados

Dados de jogador herdados

Exportar objetos de entidade

Exportar arquivos de entidade

​Exportar dados

​Exportar dados da conta do jogador

​Formato dos dados exportados

​Exportar dados de eventos

​Exportar dados personalizados

​Dados de jogador herdados

​Exportar objetos de entidade

​Exportar arquivos de entidade

Exportar dados

Exportar dados da conta do jogador

Formato dos dados exportados

Exportar dados de eventos

Exportar dados personalizados

Dados de jogador herdados

Exportar objetos de entidade

Exportar arquivos de entidade