Criar um produto gerenciado

Com o Google Play Faturamento, você pode criar produtos no aplicativo que são cobrados dos usuários uma única vez. Esses são os chamados produtos gerenciados. Eles podem ser itens como produtos virtuais (por exemplo, níveis de jogos ou poções) e serviços premium no seu app no Google Play.

Importante: os produtos no aplicativo, incluindo produtos gerenciados e assinaturas, estão sujeitos às taxas de transações e às políticas do programa para desenvolvedores do Google Play.

Disponibilidade

Se você estiver em um local que aceite o registro de comerciantes, será possível usar o Google Play Faturamento.

Caso você esteja em um local compatível e queira usar os recursos do Google Play Faturamento nos seus apps, configure um perfil para pagamentos e leia a documentação da API Google Play Billing.

Depois de criado, o produto gerenciado estará disponível para os usuários que tiverem a versão mais recente da Google Play Store.

Permissões necessárias

Para oferecer um produto gerenciado, você precisa declarar a permissão com.android.vending.BILLING no arquivo de manifesto do APK do seu app. Se você distribuir seu app globalmente, ainda poderá publicar apps que usam a permissão com.android.vending.BILLING em todos os países.

Criar produtos gerenciados

Criar um único produto gerenciado

Antes de criar um produto gerenciado, planeje com atenção os IDs dos produtos. Eles precisam ser exclusivos ao seu app e não podem ser alterados nem reutilizados depois da criação.
  • Os IDs dos produtos precisam começar com uma letra minúscula ou um número. Além disso, eles precisam ser compostos somente por letras minúsculas (a-z), números (0-9), sublinhados (_) e pontos (.).
  • Observação: o ID do produto android.test não está disponível para uso nem qualquer outro ID que comece com android.test.

Para criar um produto gerenciado:

  1. Faça login no Play Console.
  2. Selecione um app.
  3. No menu à esquerda, clique em Presença na loja > Produtos no aplicativo > Produtos gerenciados.
  4. Clique em Criar um produto gerenciado.
  5. Insira os detalhes do produto.
    • Título: dê um nome curto para o item, com até 55 caracteres. Recomendamos limitar os títulos a 25 caracteres para exibição adequada em todos os contextos (por exemplo, "Poção do sono").
    • Descrição: adicione uma descrição longa do item usando até 80 caracteres (por exemplo, "Faz qualquer criatura dormir instantaneamente").
    • Preço: insira um preço na sua moeda local ou selecione um modelo de preços.
  6. Ao lado de "Status", selecione Ativo ou Inativo.
    • Caso você queira disponibilizar um produto para compra, ele precisa estar ativo, e seu app precisa estar publicado.
    • Se você estiver usando uma conta de teste, os itens ativos estarão disponíveis nos apps não publicados. Saiba mais no nosso site para desenvolvedores Android.
  7. Clique em Salvar.

Idiomas e traduções

Os produtos gerenciados usam o mesmo idioma padrão dos apps. Para adicionar traduções em idiomas específicos, selecione um produto gerenciado e clique em Adicionar traduçõesSaiba mais sobre como traduzir seu app.

Criar um lote de vários produtos gerenciados

Para criar vários produtos gerenciados ao mesmo tempo, faça upload de um arquivo CSV com detalhes sobre cada um dos produtos.
Os arquivos CSV usam vírgula (,) e ponto e vírgula (;) para separar valores de dados. As vírgulas separam os valores de dados principais, enquanto os pontos e vírgulas separam os subvalores.
Ao criar um arquivo CSV com produtos gerenciados, especifique a sintaxe do CSV na primeira linha e adicione os detalhes dos produtos às linhas seguintes.
Importante: é preciso que cada item apareça inteiro em uma única linha no arquivo CSV.

Fazer o upload de um arquivo CSV de produtos gerenciados

  1. Faça login no Play Console.
  2. Selecione um app.
  3. No menu à esquerda, clique em Presença na loja > Produtos no aplicativo > Produtos gerenciados.
  4. Clique em Importar/Exportar > Importar produtos gerenciados do arquivo CSV.
    • Para substituir os produtos gerenciados existentes na sua lista, marque a caixa de seleção Substituir os produtos existentes. Essa opção só funcionará se o valor de um Product ID do arquivo CSV corresponder ao do Product ID de um produto gerenciado existente na lista. Substituir produtos não exclui os produtos gerenciados que não estão incluídos no CSV.
  5. Clique em Procurar arquivos e selecione o arquivo CSV.

Exportar um arquivo CSV de produtos gerenciados existentes

Caso você tenha criado um produto gerenciado por vez no Play Console, sugerimos exportar um arquivo CSV para começar a criar produtos usando esses arquivos.

  1. Faça login no Play Console.
  2. Selecione um app.
  3. No menu à esquerda, clique em Presença na loja > Produtos no aplicativo > Produtos gerenciados.
  4. Clique em Importar/Exportar > Exportar produtos no aplicativo para um arquivo CSV.

Ver um exemplo de arquivo CSV

Veja um exemplo da sintaxe a ser usada no CSV e três exemplos de produtos gerenciados:
  • O primeiro exemplo define um título e uma descrição em dois idiomas diferentes (en_US e pt-BR). Um modelo de preços define o valor do item.
  • O segundo exemplo não usa um modelo de preços. Em vez disso, ele especifica um preço referente ao país padrão (US). O Play Console usa as taxas de câmbio atuais e os padrões de preços relevantes ao local para definir automaticamente os preços em todos os outros países onde o app é distribuído.
  • O terceiro exemplo também não usa um modelo de preços. O preço do item é definido manualmente para cada país onde o app é distribuído.

Exemplo de sintaxe do CSV

Product ID,Published State,Purchase Type,Auto Translate,Locale; Title; Description,Auto Fill Prices,Price,Pricing Template ID

Exemplos de produtos gerenciados

Exemplo 1

basic_sleeping_potion,published,managed_by_android,false,en_US; Basic Sleeping Potion; Puts small creatures to sleep.; pt-BR; Poção básica do sono; Faz com que criaturas pequenas durmam.,false,,4637138456024710495

Exemplo 2

standard_sleeping_potion, published,managed_by_android,false,en_US; Standard Sleeping Potion; Puts all creatures to sleep for 2 minutes.,true, 1990000,

Exemplo 3

invisibility_potion,published, managed_by_android,false,en_US; Invisibility Potion; Invisible to all enemies for 5 minutes.,false, US; 1990000; BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000,

Valores de dados para os arquivos CSV 

Cada linha em um arquivo CSV de produtos gerenciados pode conter os valores a seguir, mas pelo menos um deles não é definido em cada linha:  
Product ID

Configurar esse valor no arquivo CSV tem o mesmo efeito que inserir um ID do produto ao criar um novo produto gerenciado.

Se você especificar um Product ID atribuído a um produto gerenciado que já estiver em uma lista de produtos e marcar a caixa de seleção Substituir os produtos existentes na caixa de diálogo "Importar produtos no aplicativo", os dados do produto gerenciado existente serão substituídos pelos valores especificados no arquivo CSV.

Publish State É preciso definir esse valor como published ou unpublished. Isso é o mesmo que definir um produto gerenciado como Ativo ou Inativo.
Purchase Type

Esse valor precisa ser definido como managed_by_android.

Auto Translate

Esse valor precisa ser definido como false porque a tradução automática de detalhes de produtos gerenciados não está disponível.

Se você quiser fornecer traduções do título e da descrição de um produto gerenciado, especifique essas traduções explicitamente no valor de Locale.

Locale, Title e Description

Se você incluir apenas uma localidade para um item, será preciso especificar a localidade padrão do seu app, além do título e da descrição padrão do item:

app_default_locale; item_default_title; item_default_description;

Durante a definição do valor de Locale, você pode usar qualquer um dos códigos de idioma exibidos ao adicionar traduções dos Detalhes do app.

Observação: ao definir os valores de Title e Description, use barras invertidas para escapar os caracteres de ponto e vírgula (\;) e barra invertida (\\).

Se você quiser incluir versões traduzidas do título e da descrição do item, inclua a localidade, o título e a descrição padrão, seguidos pelos valores correspondentes de cada tradução. No exemplo a seguir, o produto gerenciado usa en_US (inglês dos Estados Unidos) como localidade padrão e pt-BR (português do Brasil) como tradução:

en_US; Invisibility Cloak; Makes you invisible.; pt-BR; Capa de invisibilidade; Faz você ficar invisível.

Observação: os apps têm um único idioma padrão, mas cada produto gerenciado tem a própria lista de traduções. Ainda que a primeira localidade no valor de Locale de cada item precise ser a mesma em todo o arquivo CSV, as outras localidades podem variar de um item para outro.

Auto Fill Prices, Country e Price

Você pode definir Auto Fill Prices como true ou false. Se um produto gerenciado usar um modelo de preços, defina Auto Fill Prices como false e não especifique um valor para Price.

Observação: ao definir o preço de um item em um arquivo CSV, forneça um valor em microunidades. Nesse caso, um milhão de microunidades é o equivalente a uma unidade de moeda real.

Usar preços com preenchimento automático

As seções a seguir descrevem como o valor de Auto Fill Prices afeta a sintaxe e o significado dos valores de Country e Price.

Se você definir Auto Fill Prices como true, especifique somente o preço padrão do item. Não inclua um valor de Country.

Por exemplo, nas seguintes condições:

  • A localidade padrão do app é en_US.
  • O preço padrão sem tributos de um produto gerenciado é US$ 1,99.
  • Você quer que os preços referentes a outros países sejam preenchidos automaticamente.

Você definiria os valores de Auto Fill Prices e Price no final de uma linha do arquivo CSV da seguinte maneira: true,1990000,

Definir seu próprio preço por país

Se você definir Auto Fill Prices como false, poderá especificar uma série de valores de Country e Price referentes a todos os países em que o app é distribuído, incluindo aquele correspondente à localidade padrão do app. Cada valor de Country é um código do país ISO com duas letras maiúsculas representando um país onde o app é distribuído.

Observação: é preciso fornecer um código e um preço referentes a cada país segmentado pelo app. Para ver e editar a lista desses países, abra a página Preço e distribuição do app.

Cada valor de Price representa o custo do item em microunidades da moeda usada no país em questão.

Por exemplo, se você oferecer o app pelos seguintes preços em outros países (todos os tributos incluídos):

  • R$ 6,99 no Brasil 
  • ₽ 129 na Rússia
  • ₹ 130 na Índia
  • Rp 27.000 na Indonésia
  • $ 37 no México

Defina os valores de Auto Fill Prices, Country e Price no final de uma linha do arquivo CSV da seguinte forma:

false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;

Pricing Template ID

Se um item estiver vinculado a um modelo de preços, defina Auto Fill Prices como false e não inclua um valor na coluna Price. Se o item não estiver vinculado a um modelo de preços, não adicione um valor referente a Pricing Template ID. Em vez disso, defina Auto Fill Prices, Country e Price de acordo com a maneira como você pretende definir os preços do produto gerenciado.

Se você importar um arquivo CSV e marcar a caixa de seleção Substituir os produtos existentes na caixa de diálogo "Importar produtos no aplicativo", poderá atualizar os vínculos entre os produtos gerenciados e os modelos de preços. Para vincular o produto a um modelo de preços específico, defina o valor de Pricing Template ID como o código desse modelo de preços. Para desvincular um produto gerenciado de todos os modelos de preços, não defina um valor de Pricing Template ID.

É possível vincular até mil preços de apps ou de produtos gerenciados a um modelo de preços específico. Por isso, não especifique o mesmo valor de Pricing Template ID em mais de mil linhas de um arquivo CSV.

Isso foi útil?
Como podemos melhorá-lo?