Crie um produto na app

O sistema de faturação do Google Play permite-lhe oferecer produtos na app que são cobrados aos utilizadores uma única vez. Os produtos na app podem incluir itens como bens virtuais (por exemplo, níveis do jogo ou poções) e serviços premium na sua app no Google Play.

Também pode criar uma subscrição, que é cobrada aos utilizadores de forma recorrente.

Importante: as Políticas do Programa para Programadores e as taxas de serviço do Google Play aplicam-se aos produtos na app e às subscrições.

Disponibilidade

Se estiver numa localização que suporta o registo de comerciantes, pode usar o sistema de faturação do Google Play.

Se estiver numa localização suportada e quiser começar a usar as funcionalidades do sistema de faturação do Google Play nas suas apps, configure um perfil de pagamentos e saiba como configurar o sistema de faturação do Google Play no site para programadores Android.

Para estar disponível para compra, um produto na app tem de estar ativo e a respetiva app tem de estar segmentada para o país ou a região do utilizador. Um produto na app está disponível para compra enquanto estiver ativo, mesmo que a respetiva app não esteja publicada. Tem de desativar um produto na app se não quiser que esteja disponível.

Se estiver a usar uma conta de teste, aceda ao site para programadores Android para saber como testar a integração da Biblioteca de Faturação do Google Play.

Depois de criar um produto na app, este fica disponível para utilizadores com a versão mais recente da Google Play Store.

Autorizações necessárias

Para oferecer um produto na app, tem de declarar a autorização com.android.vending.BILLING no ficheiro do manifesto do APK da sua app. Se distribuir a sua app em todo o mundo, pode continuar a publicar apps que usam a autorização com.android.vending.BILLING em todos os países.

Crie produtos na app

Crie um único produto na app

Antes de criar um produto, certifique-se de que planeia os IDs do produto cuidadosamente. Os IDs do produto têm de ser exclusivos para a sua app e, depois de os criar, não os pode alterar nem voltar a usar.

• Os IDs do produto têm de começar por um número ou uma letra minúscula e podem incluir números (0-9), letras minúsculas (a-z), sublinhados (_) e pontos (.).
• Depois de criar o produto, não pode alterar nem voltar a usar um ID do produto.
• Nota: o ID do produto android.test não está disponível para utilização, tal como todos os IDs do produto que começam por android.test.

Para criar um produto na app, siga estes passos:

1. Abra a Play Console.
2. Aceda à página Produtos na app (Rentabilizar > Produtos > Produtos na app).
3. Clique em Criar produto.
4. Introduza os detalhes do produto.
   • ID do produto: um ID exclusivo do produto na app.
   • Título: nome abreviado do artigo (até 55 carateres, mas recomendamos que os títulos tenham até 25 carateres para que sejam corretamente apresentados em todos os contextos), tais como "Poção do sono".
   • Descrição: uma descrição longa do item (até 200 carateres), como "Adormece criaturas imediatamente".
   • Ícone: uma imagem exclusiva e precisa do produto. Não inclua texto, promoções nem branding. O ícone do produto é apresentado na sua Ficha da loja e durante o fluxo de compra.
     • PNG de 32 bits
     • 512 x 512 píxeis
     • Até 1 MB
   • Preço: introduza um preço na sua moeda local ou selecione um modelo de preços.
   • Várias quantidades: permite o pagamento de várias quantidades para este produto. Os utilizadores vão poder comprar em várias quantidades dentro do limite do respetivo país ou região. Tenha em atenção as seguintes informações:
     • Para configurar o pagamento de várias quantidades na Play Console, a sua app precisa da Biblioteca de Faturação do Google Play 4.0. Visite o site para programadores Android para saber como integrar a Biblioteca de Faturação do Google Play na sua app.
     • O pagamento de várias quantidades não está disponível em alguns países ou regiões.
     • Na maioria dos países ou regiões onde o pagamento de várias quantidades está disponível, o limite de preço da SKU é de aproximadamente 100 USD. Para permitir o pagamento de várias quantidades, tem de ajustar o preço (antes de impostos) para ficar abaixo do limite em cada país ou região.
   • Exclusivo dos Play Points: disponibilize o seu produto apenas através dos Google Play Points.
5. Guarde as suas alterações e clique em Ativar para disponibilizar o produto na app aos utilizadores.

Idiomas e traduções

Os produtos na app usam o mesmo idioma predefinido que a respetiva app. Para adicionar traduções em idiomas específicos, selecione um produto na app e, de seguida, clique em Gerir traduções e aplique os idiomas que quer. Para saber como oferecer uma experiência localizada aos utilizadores, leia o artigo Traduza e localize a sua app.

Crie um lote de vários produtos na app

Para criar vários produtos na app em simultâneo, pode carregar um ficheiro CSV que inclua detalhes sobre cada um dos produtos.

Os ficheiros CSV usam vírgulas (,) e pontos e vírgula (;) para separar os valores de dados. As vírgulas separam valores de dados principais, e os pontos e vírgula separam subvalores.

Quando estiver a criar um ficheiro CSV com produtos na app, especifique a sintaxe do CSV na primeira linha, seguida dos detalhes dos produtos nas linhas seguintes.

Importante: cada item deve aparecer totalmente numa única linha no ficheiro CSV.

Carregue um ficheiro CSV de produtos na app

Para carregar um ficheiro CSV, siga estes passos:

1. Abra a Play Console.
2. Aceda à página Produtos na app (Rentabilizar > Produtos > Produtos na app).
3. Clique em Importar.
   • A importação de vários produtos ao carregar um ficheiro CSV substitui os produtos existentes apenas se o valor de um Product ID no ficheiro CSV corresponder ao Product ID de um produto na app existente na lista de produtos. A substituição de um produto não elimina produtos na app que não estejam incluídos no ficheiro CSV.
4. Largue o ficheiro CSV para o carregar ou clique em Carregar.

Exporte um ficheiro CSV de produtos na app existentes

Para exportar um ficheiro CSV, siga estes passos:

1. Abra a Play Console.
2. Aceda à página Produtos na app (Rentabilizar > Produtos > Produtos na app).
3. Clique em Exportar.

Veja um ficheiro CSV de exemplo

Segue-se um exemplo da sintaxe do CSV a usar e três exemplos de produtos na app:

• O primeiro exemplo define um título e uma descrição em dois idiomas diferentes (en_US e pt_PT). Um modelo de preços define o preço do artigo.
• O segundo exemplo não usa um modelo de preços. Em vez disso, especifica um preço para o país predefinido (EUA). A Play Console usa as taxas de câmbio atuais e os padrões de preços relevantes localmente para definir de forma automática os preços em todos os outros países onde a app é distribuída.
• O terceiro exemplo também não usa um modelo de preços. O preço do item é especificado manualmente para cada país onde a app é distribuída.

Sintaxe do CSV de exemplo

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

Exemplos de produtos na app

Exemplo 1

basic_sleeping_potion,publicado,managed_by_android,falso,en_US; Basic Sleeping Potion; Puts small creatures to sleep.; pt_PT; Poção básica para dormir; Faz com que as criaturas pequenas vão dormir.,false,,4637138456024710495

Exemplo 2

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

Exemplo 3

invisibility_potion,publicado, managed_by_android,falso,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 ficheiros CSV

Cada linha num ficheiro CSV de produtos na app pode conter os seguintes valores, mas pelo menos um destes valores não está definido em cada linha:

Product ID	A definição deste valor no ficheiro CSV tem o mesmo efeito que introduzir um ID do produto durante a criação de um novo produto na app. Se especificar um Product ID atribuído a um produto na app que já exista numa lista de produtos, os dados do produto na app existente são substituídos pelos valores especificados no ficheiro CSV.
Publish State	Tem de definir este valor como published ou unpublished. É o mesmo que definir um produto na app como Ativo ou Inativo.
Purchase Type	Tem de definir este valor como managed_by_android.
Auto Translate	Tem de definir este valor como false porque a tradução automática de detalhes de produtos na app não é suportada. Se quiser disponibilizar traduções do título e da descrição de um produto na app, especifique essas traduções explicitamente no valor Locale.
Locale, Title, e Description	Se incluir apenas um local para um item, tem de especificar o local predefinido da app, bem como o título e a descrição predefinidos do item: app_default_locale; item_default_title; item_default_description; Quando definir o valor Locale, pode usar qualquer um dos códigos de idioma que aparecem ao adicionar traduções da Ficha da loja. Nota:: quando especificar os valores de Title e Description, use barras invertidas como caráter de escape dos carateres de ponto e vírgula (\;) e barra invertida (\\). Se quiser incluir versões traduzidas do título e da descrição do item, tem de indicar o local, o título e a descrição predefinidos, seguidos dos locais, títulos e descrições para cada tradução. No exemplo seguinte, o produto na app utiliza en_US (inglês dos Estados Unidos) como o local predefinido e pt_PT (português de Portugal) como a tradução: en_US; Invisibility Cloak; Makes you invisible.; pt_PT; Capote invisível; Torna-o invisível. Nota: uma app contém um único idioma predefinido, mas cada produto na app mantém a sua própria lista de traduções. Embora o primeiro local no valor de Locale de cada item tenha de ser o mesmo em todo o ficheiro CSV, os outros locais podem ser diferentes para cada um dos itens.
Auto-Fill Prices, Country, e Price	Pode definir Auto-fill prices como true ou false. Se um produto na app usar um modelos de preços, tem de definir Auto-fill prices como false e não deve definir um valor para Price. Nota: quando especificar o preço de um item num ficheiro CSV, indique um preço em microunidades, em que 1 000 000 de microunidades é equivalente a 1 unidade de moeda real. Use preços preenchidos automaticamente As secções seguintes descrevem como o valor de Auto-fill prices afeta a sintaxe e o significado dos valores de Country e Price. Se definir Auto-fill prices como true, está a especificar apenas o preço predefinido do item; não está a incluir um valor de Country. Por exemplo, nas seguintes condições: O local predefinido da app é en_US. O preço predefinido de um produto na app, sem impostos, é de 1,99 USD. Quer que os preços para outros países sejam preenchidos automaticamente. Deve definir os valores de Auto-fill prices e Price no final de uma linha no ficheiro CSV do seguinte modo: true,1990000, Defina o preço por país Se definir Auto-fill prices como false, pode especificar uma série de valores de country e price para todos os países onde distribui a app, incluindo o país correspondente ao local predefinido da sua app. Cada valor de country corresponde ao código ISO do país de duas letras maiúsculas que representa um país onde a app é distribuída. Nota: tem de indicar um código do país e um preço para cada país a que a app se destina. Para ver e editar a lista de países a que a sua app se destina, use o separador Países/regiões na página Produção. Cada valor de price representa o custo do item em microunidades da moeda usada nesse país. Por exemplo, se estiver a disponibilizar a sua app aos seguintes preços (todos os impostos incluídos) noutros países: 6,99 R$ no Brasil 129 ₽ na Rússia 130 ₹ na Índia 27 000 Rp na Indonésia 37 $ no México Pode definir os valores de Auto-Fill Prices, Country e Price no final de uma linha no ficheiro CSV do seguinte modo: false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;
Pricing Template ID	Se um item estiver associado a um modelo de preços, deve definir Auto-Fill prices como false e não deve definir um valor para a coluna price. Se o item não estiver associado a um modelo de preços, não deve definir um valor para Pricing template ID. Em alternativa, deve definir Auto-Fill prices, Country e Price com base na forma como quer definir os preços do produto na app. Se importar um ficheiro CSV, pode atualizar as associações entre os produtos na app e os modelos de preços. Para associar o produto a um modelo de preços específico, defina o valor Pricing Template ID para o ID desse modelo de preços. Para desassociar um produto na app de todos os modelos de preços, não defina um valor para o respetivo Pricing template ID. Pode associar até 1000 preços de apps ou de produtos na app a um determinado modelo de preços. Assim, não especifique o mesmo valor de Pricing template ID em mais de 1000 linhas de um ficheiro CSV.
EEA Withdrawal Right Type	Se fizer a distribuição para utilizadores no Espaço Económico Europeu (EEE), deve definir o valor aqui como DIGITAL_CONTENT ou SERVICE.
Reduced VAT Rates	Se vender notícias, revistas, jornais e livros digitais, vídeos, música, áudio ou livros áudio em vários países ou regiões, pode ser elegível para taxas de IVA reduzidas. Para taxas reduzidas, os valores neste campo vão ter o seguinte formato: Código do país;Taxa de IVA; Cada par de país ou taxa deve ser seguido de um ponto e vírgula antes de adicionar um novo par de país ou taxa. Por exemplo: CA;BOOKS_1 para definir a taxa reduzida de nível 1 do Livros para o Canadá. FR;NEWS_1; GR; NEWS_2 para definir a taxa reduzida de nível 1 do Google Notícias para França e a taxa reduzida de nível 2 do Google Notícias para a Grécia. Os níveis podem ser definidos como BOOKS_1, NEWS_1, NEWS_2, MUSIC_OR_AUDIO_1, LIVE_OR_BROADCAST_1 (maiúsculas ou minúsculas)
Communications and amusement taxes	Se quiser cobrar os impostos aplicáveis às comunicações e diversões, tem de especificar que a sua app ou produto é um produto de streaming e definir este campo como ELIGIBLE. Caso contrário, deixe o campo em branco. Atualmente, os EUA são o único país permitido para este tipo de imposto. O valor deste campo é sempre definido como: Código do país;Elegibilidade;Taxa Por exemplo: US;ELIGIBLE;VIDEO_RENTAL Se for elegível, pode definir o campo de acordo com as seguintes categorias: VIDEO_RENTAL para streaming de vídeo – subscrição, aluguer ou pagamento por visualização VIDEO_SALES para streaming de vídeo – vendas VIDEO_MULTI_CHANNEL para streaming de vídeo – multicanal AUDIO_RENTAL para streaming de áudio – subscrições ou aluguer AUDIO_SALES para streaming de áudio – vendas AUDIO_MULTI_CHANNEL para streaming de áudio – multicanal