Importação de catálogo de itens de plataformas externas

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

Importar catálogo do Google Play

Aviso

Antes de começar a importar, verifique se a API do Google Play Android Developer está habilitada no seu projeto do Google Play. Visite /apis/api/androidpublisher.googleapis.com/overview?project={project_id}, onde project_id é o ID do seu projeto no Google Play. Se essa API estiver desabilitada, habilite-a. As configurações levarão algum tempo para serem aplicadas, então a importação pode falhar se você tentar imediatamente após habilitar as configurações. Aguarde alguns minutos e tente novamente.

Para importar itens do Google Play:

1. No seu projeto na Conta de Distribuidor, vá para a seção LiveOps > Canvas.
2. Na barra de ferramentas, clique no ícone .
3. Na área de lista de itens, clique no ícone + e selecione Import from platforms.

4. Selecione Google Play e clique em Import.
5. Especifique o Application ID — o ID do seu aplicativo no Google Play.

Observação

Você pode encontrar o Application ID no Google Play Console. No menu lateral, clique em All apps. Encontre o aplicativo necessário na tabela. Seu ID será especificado na coluna App, ao lado do nome e logotipo.

6. Faça upload do JSON com uma chave privada.

7. Vá para o Google Play Console, no menu lateral, clique em Users and permissions e adicione uma conta de serviço como um novo usuário com a função de Android Management User. Isso requer que você tenha a função de Project IAM admin.
8. Clique em Start import. A importação do catálogo começará automaticamente.
9. Clique em Save.

Observação

SKU corresponde ao Product ID na fonte de importação.

10. Para vender itens na loja web criada pelo Site Builder, configure grupos de itens na Conta de Distribuidor e atribua um ou mais deles a cada item.
11. Para exibir imagens de itens, faça upload delas na sua Conta de Distribuidor.

Importar catálogo da App Store

Antes de importar um catálogo da App Store, você precisa obter os seguintes dados:

• Application ID na seção App Information no App Store Connect.
• API Key e Issuer ID na seção Users and Access no App Store Connect.

Obtenção do ID do aplicativo

Para obter seu Application ID no App Store Connect:

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 até General Information > App Information.
5. Em General Information, copie o Application ID no campo Apple ID.

Obtenção de Chave API e ID de Emissor

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

A API Key é um identificador único usado para autenticar solicitações de API na App Store Connect API e garantir acesso seguro aos dados e funcionalidades da Conta de Desenvolvedor Apple.

Para obter o Issuer ID e a API Key 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 de API.

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

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

8. Na aba Team Keys, copie o Issuer ID.

Importação de catálogo da App Store

Para importar itens da App Store:

1. No seu projeto na Conta de Distribuidor, vá para a seção LiveOps > Canvas.
2. Na barra de ferramentas, clique no ícone .
3. Na área de lista de itens, clique no ícone + e selecione Import from platforms.

4. Selecione App Store e clique em Import.
5. Forneça os dados que você obteve no App Store Connect:
   • Application ID
   • Arquivo de chave privada (P8)
   • Issuer ID
   • Key ID
6. Clique em Start import. A importação do catálogo começará automaticamente.
7. Clique em Save.

Observação

SKU corresponde ao Product ID na fonte de importação.

8. Para vender itens na loja web criada pelo Site Builder, configure grupos de itens na Conta de Distribuidor e atribua um ou mais deles a cada item.
9. Para exibir imagens de itens, faça upload delas na sua Conta de Distribuidor.

Importar catálogo do PlayFab

Para importar itens do PlayFab:

1. No seu projeto na Conta de Distribuidor, vá para a seção LiveOps > Canvas.
2. Na barra de ferramentas, clique no ícone .
3. Na área de lista de itens, clique no ícone + e selecione Import from platforms.

4. Selecione PlayFab e clique em Import.
5. Insira os dados que você obteve no PlayFab:
   • Title ID
   • Chave secreta do projeto
6. Clique em Start import. A importação do catálogo começará automaticamente.
7. Clique em Save.
8. Para vender itens na loja web criada pelo Site Builder, configure grupos de itens na Conta de Distribuidor e atribua um ou mais deles a cada item.
9. Para exibir imagens de itens, faça upload delas na sua Conta de Distribuidor.

Sincronizar inventário com PlayFab

Para sincronizar o inventário de um usuário na Xsolla com o inventário dele no PlayFab:

1. No seu projeto na Conta de Distribuidor, vá para a seção LiveOps > Canvas.
2. Na barra de ferramentas, clique no ícone .
3. Na área de lista de itens, clique no ícone + e selecione Import from platforms.

4. Selecione PlayFab e clique em Import.
5. Selecione Inventory synchronization.
6. Insira os dados que você obteve no PlayFab:
   • Title ID
   • Chave secreta do projeto
7. Defina a opção Synchronize user inventory with PlayFab como ativa.
8. Clique em Save.

Reimportar catálogo

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

• Itens que já estão no catálogo da Xsolla serão atualizados.
• Itens que não estão presentes no catálogo da Xsolla serão adicionados.
• Itens que foram removidos da fonte de importação permanecerão no catálogo da Xsolla. Você pode excluí-los manualmente ou via API.