Importe o catálogo de itens de plataformas externas

Você pode importar itens e assinaturas de plataformas externas e sincronizar o inventário do usuário.

Como importar o catálogo do Google Play

Aviso

Antes de iniciar a importação, verifique se a Google Play Android Developer API está ativada em seu projeto Google Play. Visite https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/overview?project={project_id}, onde project_id — seu ID do projeto na Google Play. Se essa API estiver desativada, ative-a. As configurações podem levar um tempo até serem aplicadas, então a importação pode falhar se você tentar imediatamente após a ativação das configurações. Espere alguns minutos e tente novamente.

1. Abra seu projeto em Conta de Distribuidor.
2. Clique em Store no menu lateral.
3. No painel Catalog Management, clique em Configure.
4. No painel Integration with external platforms, clique em Configure.
5. No painel Google Play, clique em Configure.
6. Especifique o Application ID — o ID do seu aplicativo no Google Play.

7. Envie o JSON com uma chave privada.

8. Vá para o Google Play Console. No menu lateral, clique em Users and permissions e adicione a conta de serviço como um novo usuário com a função de Android Management User. Isso exige que você tenha a função Project IAM admin.

9. Clique em Save.
10. Clique em Start import. A importação do catálogo começará imediatamente.

11. Para vender itens virtuais na loja virtual criada pelo Site Builder, configure grupos de itens na Conta de Distribuidor e atribua um ou mais deles a cada item.
12. Para exibir imagens de itens, envie-as para sua Conta de Distribuidor.

Importação de catálogo da App Store

• ID do Aplicativo na seção App Information do App Store Connect.
• Chave API e ID de Emissor da seção Users and Access no App Store Connect.

Obtenção do ID do aplicativo

1. Faça login no App Store Connect.
2. Vá para a seção Apps.
   
   

   

3. Abra a página do seu aplicativo.
4. Navegue para General Information > App Information.
5. Em General Information, copie o ID do Aplicativo no campo Apple ID.
   
   

   

Obter Chave API e ID de Emissor

O ID de Emissor no App Store Connect é usado para a interação com a Apple API, incluindo a App Store Connect API. Ele é necessário para configurar as chaves de API para automatizar tarefas tais como o gerenciamento do aplicativo, a recuperação de dados analíticos e outras operações no App Store Connect.

A Chave API é um identificador único para autenticar solicitações de API na App Store Connect API e garantir o acesso seguro aos dados e funcionalidades da Apple Developer Account.

Para obter o ID de Emissor e Chave API no App Store Connect:

1. Faça login no App Store Connect e vá para a seção Users and Access.
2. Abra a aba Integrations.
3. No menu lateral Keys, clique em App Store Connect API.
4. Vá para a aba Team Keys. Clique no ícone + para criar uma nova chave API.
   
   

   

5. Na janela Generate API Key, atribua um nome à chave e defina o nível de acesso a esta chave.
6. Clique em Generate.
   
   

   

7. A chave recém-criada aparecerá na lista de chaves API ativas. Baixe-a como um arquivo P8 e copie o ID da Chave.
   
   

   

8. Na aba Team Keys, copie o ID de Emissor.
   
   

   

Importação de catálogos da App Store

1. Abra sua Conta de Distribuidor e acesse Store > Catalog management > Integration with external platforms > App Store.
2. Forneça os dados obtidos no App Store Connect:
   • ID de Aplicativo;
   • Arquivo de chaves privadas (P8);
   • ID de Emissor;
   • ID da Chave.
3. Clique em Iniciar importação. A importação do catálogo começará automaticamente.
   
   

   

Para vender itens virtuais na loja virtual criada usando o Site Builder, crie grupos de itens na sua Conta de Distribuidor e atribua um ou mais grupos para cada item virtual.

Para exibir imagens de itens, você precisa enviá-los editando o item importado em Store > Virtual Items.

Como importar o catálogo do PlayFab

O PlayFab oferece aos desenvolvedores de jogos soluções de servidor prontas para uso no gerenciamento de catálogos e monetização. Após a integração com o PlayFab, você poderá importar catálogos do PlayFab direto à Store para usar junto as soluções Xsolla.

1. Abra seu projeto na Conta de Distribuidor.
2. Clique em Store no menu lateral.
3. No painel Catalog Management, clique em Configure.
4. No painel Integration with external platforms, clique em Configurar.
5. No painel PlayFab, clique em Configurar.
6. Na guia Importação de itens especifique:
   • ID do título — ID do projeto no PlayFab.
   • Chave secreta — a chave do projeto no PlayFab.
7. Clique em Salvar.
8. Sincronize o inventário do usuário com o PlayFab (opcional):
   1. Vá para Sincronização do inventário e especifique:
      • ID do título — ID do projeto no PlayFab.
      • Chave secreta — a chave do projeto no PlayFab.
   2. Defina a configuração Synchronize user inventory with PlayFab como On.
   3. Clique em Save.
9. Vá para a guia Item import e clique em Start import. A importação do catálogo será iniciada automaticamente.
10. Para vender itens virtuais na loja virtual criada pelo Construtor de Sites, configure grupos de itens na Conta de Distribuidor e atribua um ou mais deles a cada item.
11. Para exibir imagens de itens, envie-as à sua Conta de Distribuidor.

Para verificar se a importação foi concluída com sucesso, vá para a seção Store no menu lateral e verifique se os itens, a moeda e os pacotes estão habilitados nas abas Virtual currency, Virtual items e Bundles.

Reimportação de catálogo

Ao reimportar o catálogo, você precisa considerar que:

• Os itens que já estão na Store serão atualizados.
• Os itens que não estão disponíveis na Store serão adicionados.
• Os itens que já foram removidos da fonte de importação permanecerão na Store. Você pode excluí-los em sua Conta de Distribuidor ou via API.

Próximos passos

1. Implemente a concessão de compras ao usuário.
2. Implemente a obtenção de informações de assinatura.

Links úteis

• Fluxo de integração
• Configure o catálogo manualmente