Transfira e exporte relatórios mensais

Pode usar a Play Console para transferir relatórios mensais sobre apps individuais para ajudar a monitorizar e compreender o desempenho da sua app.

Tipos de relatórios

Relatórios detalhados

Relatórios agregados

Transfira relatórios

Abra a Play Console.
Clique em Transferir relatórios e selecione Críticas, Estatísticas ou Financeiros.
Em "Selecionar uma aplicação", escreva e selecione o nome da sua app.
Selecione o ano e o mês do relatório que pretende transferir.

Nota: os relatórios financeiros incluem todas as apps na sua conta.

Transfira relatórios a partir do Google Cloud Storage

Os relatórios estão disponíveis no Google Cloud Storage. Os relatórios são gerados diariamente e acumulados em ficheiros CSV mensais. Em seguida, são armazenados num contentor privado do Google Cloud Storage correspondente à sua conta de programador do Google Play.

É possível aceder aos relatórios através do Google Cloud Storage no navegador ou programaticamente com a ferramenta gsutil. Também pode usar outras ferramentas para aceder ao seu contentor do Cloud Storage programaticamente.

Sugestão: se pretender importar os relatórios do Google Cloud Storage para o BigQuery, tem de converter os ficheiros CSV de UTF-16 para UTF-8.

Procure o URI do Google Cloud Storage

Pode copiar o URI do Google Cloud Storage ao clicar no botão Copiar URI do Cloud Storage junto ao cabeçalho da secção correspondente nas páginas Transferir relatórios.

O URI do Cloud Storage começa por pubsite_prod_rev (por exemplo, pubsite_prod_rev_01234567890987654321).

Transfira relatórios com uma ferramenta de linha de comandos

Transfira relatórios com uma biblioteca cliente e uma conta de serviço

Passo 1: crie uma conta de serviço

Abra a Google Developers Console.
Se já tiver um projeto, utilize o menu pendente para o selecionar. Se não tiver um projeto no menu ou pretender criar um novo, clique em Criar projeto.
Selecione o ícone Menu > Autorizações > Contas de serviço > Criar conta de serviço.
Siga as instruções apresentadas no ecrã e selecione Criar.
Copie o endereço de email indicado.
- Exemplo: accountName@project.iam.gserviceaccount.com

Passo 2: adicione a conta de serviço à Play Console

Abra a Play Console.
Selecione Definições > Contas de utilizador e direitos > Convidar novo utilizador.
Cole ou escreva o endereço de email associado à sua conta de serviço.
Selecione as autorizações com base nos tipos de relatórios necessários.
- Sugestão: leia o artigo Adicione utilizadores a contas de programador e faça a gestão de autorizações para compreender os diferentes níveis de acesso que os utilizadores têm e os direitos que diferentes autorizações lhes concedem.
Clique em Adicionar utilizador. A sua conta de serviço é adicionada à sua conta.

Passo 3: obtenha relatórios através de uma chamada API

Instale a biblioteca cliente da API para a sua linguagem de programação preferida.
Configure o código que faz a chamada API para usar a autenticação servidor a servidor OAuth2 e pedir a autorização ao âmbito OAuth2 (https://www.googleapis.com/auth/devstorage.read_only).
Emita chamadas da API autenticadas para obter relatórios.

Veja um exemplo (Python)

Controle o acesso ao Google Cloud Storage

Os relatórios disponíveis no Google Cloud Storage estão sujeitos às mesmas restrições de acesso que controlam o acesso aos dados na Play Console. Isto significa que os utilizadores de contas com acesso a determinadas áreas de uma conta da Play Console têm acesso aos relatórios correspondentes no Google Cloud Storage.

Os proprietários da conta podem atualizar as autorizações para utilizadores individuais a qualquer momento.

Para aceder a relatórios em massa, a autorização "Ver informações da app" tem de estar definida como "Global".
Para transferir relatórios financeiros, a autorização "Ver dados financeiros" tem de estar definida como "Global".

Comandos e formatos de ficheiro para relatórios detalhados

Falhas de sistema e ANRs

A partir de maio de 2018, deixa de poder transferir relatórios detalhados para falhas de sistema e ANRs.

Críticas

Comando

gs://[developer_bucket_id]/reviews/reviews_[package_name]_YYYYMM.csv

Formato de ficheiro

Campo	Formato	Opcional	Exemplos e notas
Nome do pacote	String	NÃO	`com.company.app`
Código da versão da app	número inteiro	SIM	Apenas APKs de produção
Nome da versão da app	String	SIM
Idioma do revisor	String – abreviatura de duas letras ISO 639-1	SIM	`pt`
Dispositivo	String	SIM	`hammerhead`
Data e hora de envio da crítica	ISO_8601 incluindo a hora, o fuso horário UTC	NÃO	`2014-06-19T19:12:32Z`
Milissegundos desde epoch relativamente ao envio da crítica	inteiro, milissegundos desde epoch	NÃO
Data e hora da última atualização da crítica	ISO_8601 incluindo a hora, o fuso horário UTC	SIM	`2014-06-19T19:12:32Z`
Milissegundos desde epoch relativamente à última atualização da crítica	inteiro, milissegundos desde epoch	SIM
Número de estrelas	inteiro (entre 1 e 5)	NÃO
Título da crítica	String no idioma local do revisor (quebras de linha removidas)	SIM
Texto da crítica	String no idioma local do revisor (quebras de linha removidas)	SIM
Data e hora da resposta do programador	ISO_8601 incluindo a hora, o fuso horário UTC	SIM	`2014-06-19T19:12:32Z`
Milissegundos desde epoch relativamente à resposta do programador	inteiro, milissegundos desde epoch	SIM
Texto da resposta do programador	String (quebras de linha removidas e espaços em branco comprimidos)	SIM
Link da crítica	String	SIM	`https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..>`

Exemplo

Se quiser transferir todos os relatórios gerados em 2014 a partir do ID de segmento do relatório pubsite_prod_rev_0123456789 para a app com o nome de pacote com.example.app, o comando é:

gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /your/local/directory

Relatórios financeiros

Vendas estimadas

Recomendamos que não se baseie no número de colunas nos ficheiros CSV para os seus relatórios automáticos.

Acerca de

Pode utilizar o relatório de vendas estimadas para ver informações de baixa latência acerca das vendas de apps, de produtos na app ou de subscrições. Este relatório contém o valor pago pelos compradores e não contempla a dedução de impostos ou das taxas da Google face aos valores totais.

Pode usar este relatório para analisar tendências ou estatísticas, mas não é recomendado para fins de contabilidade. Em alternativa, consulte o Relatório de ganhos.

Pode notar diferenças entre este relatório e os seus ganhos por vários motivos. Por exemplo, o relatório de vendas estimadas não tem em conta os impostos de retenção na fonte nem os estornos. Este relatório contém valores pagos pelos compradores na respetiva moeda local e não contém valores convertidos na sua moeda de pagamento.

Comando

gs://[developer_bucket_id]/sales/salesreport_YYYYMM.zip

Exemplo

Se quiser transferir todos os relatórios gerados em 2014 a partir do ID de segmento do relatório pubsite_prod_rev_0123456789 para a app com o nome de pacote com.example.app, o comando é:

gsutil cp -r gs://pubsite_prod_rev_0123456789/sales/salesreport_2014* /your/local/directory

Formato de ficheiro

Campo	Formato	Opcional	Exemplos e notas
Número da encomenda	String	Não	`GPA.1234-1234-1234-12345` Os IDs da encomenda de subscrição incluem o número do ciclo de renovação no fim (por exemplo, a primeira renovação é `GPA.1234-1234-1234-12345..0`, a segunda renovação é `GPA.1234-1234 -1234-12345..1` e assim sucessivamente).
Data de cobrança da encomenda	String	Não	`2016-11-30` Data desta encomenda com base no fuso horário UTC (no formato AAAA-MM-DD).
Data/hora de cobrança da encomenda	Número inteiro	Não	`1480507200` A data/hora Unix em que a encomenda foi cobrada ao utilizador. Medida em segundos desde epoch.
Estado financeiro	String	Não	`charged, refund, partial refund,` e assim sucessivamente. Se reembolsar totalmente uma encomenda depois de emitir um reembolso parcial: O reembolso parcial é apresentado numa linha em separado A linha de reembolso total apresenta o saldo restante
Modelo do dispositivo	String	Não	`mako` e assim sucessivamente. Modelo do dispositivo Android usado para fazer a compra. Nas encomendas de subscrição, refere-se ao dispositivo usado na compra original.
Título do produto	String	Não	`coins, monthly subscription` e assim sucessivamente. Nome do produto especificado pelo programador. Apresentado no local do comprador.
ID do produto	String	Não	`com.example.app` Nome do pacote da app em que o produto foi vendido.
Tipo de produto	String	Não	`paidapp,` `subscription, inapp`
ID de SKU	String	Não	`treasure_chest_for_new_users` ID exclusivo do produto especificado pelo programador.
Moeda de venda	String	Não	`USD, EUR, THB` e assim sucessivamente.
Preço do artigo	Número inteiro	Não	`12,345.67` Apresentado na moeda local do comprador. Usa "," como separador dos milhares.
Impostos retidos	Número inteiro	Sim	`12,345.67` Na moeda local do comprador. Usa "," como separador dos milhares.
Montante cobrado	Número inteiro	Não	`12,345.67` Na moeda local do comprador. Esta é a soma de preço do artigo e dos impostos retidos. Usa "," como separador dos milhares.
Cidade do comprador	String	Sim	`Boston, Toronto` e assim sucessivamente. Apenas preenchido nas vendas em que é o comerciante de registo.
Estado do comprador	String	Sim	`MA, ON` e assim sucessivamente.
Código postal do comprador	String	Sim	`02140, M5B 1L6` e assim sucessivamente. Apenas preenchido nas vendas em que é o comerciante de registo.
País do comprador	String	Não	`US, CA` e assim sucessivamente.
ID do plano base	String	Sim	`weekly` O ID do plano base da subscrição. Preenchido apenas para subscrições. Saiba mais.
ID da oferta	String	Sim	`spring-offer` O ID da oferta da subscrição. Preenchido apenas para subscrições. Saiba mais.
ID do grupo	Número inteiro	Sim	`1234567891234567890` O ID exclusivo é fornecido quando é criado um grupo de contas de programador. Saiba mais.
Primeiro milhão de USD elegível	String	Sim	`Sim,` `Não` Preenchido apenas quando está configurado um grupo de contas de programador. Saiba mais.
ID da promoção	String	Sim	`PP.C2fy7Ns0/+e2w, PP.P2fy7Ns0/+e2w, Points used only` Apenas preenchido nas vendas relacionadas com os Play Points. Os prefixos "PP.C" e "PP.P" definem encomendas que envolvem cupões e promoções de produtos na app, respetivamente. As encomendas em que os Play Points são gastos diretamente também são apresentadas. Saiba mais.
Valor do cupão	Número inteiro	Sim	`3,00` Apresentado na moeda local do comprador. Usa "," como separador dos milhares. Apenas preenchido nas vendas relacionadas com os cupões do Play Points. Saiba mais.
Taxa de desconto	Número inteiro	Sim	`45, 55, 70` % da taxa com desconto usada para especificar a poupança que o utilizador alcança quando gasta Play Points em comparação com o pagamento em dinheiro. Apenas preenchido nas vendas relacionadas com os Play Points. Saiba mais.
ID de produtos em destaque	Número inteiro	Sim	`1234567891234567890` O ID exclusivo é indicado quando um programador cria um produto em destaque. Saiba mais.
ID da experiência de preços	String	Sim	`5697329857888256(Variant B)` ID da experiência de preço e grupo experimental

Ganhos

Recomendamos que não se baseie no número de colunas nos ficheiros CSV para os seus relatórios automáticos.

Acerca de

Pode usar o relatório de ganhos para compreender o pagamento e as transações. Cada linha no relatório representa um tipo de transação, como quando cobra dinheiro a um cliente ou paga uma taxa à Google, juntamente com os valores originais e os valores convertidos.

Os relatórios de ganhos contêm as transações do mês anterior. Vai receber o pagamento várias semanas após o relatório de ganhos ser disponibilizado.

O relatório de ganhos é gerado uma vez por mês e está geralmente disponível no dia 5 do mês seguinte. Ocasionalmente, a Google pode fazer ajustes aos seus ganhos para corrigir erros de cálculo. Se tal acontecer, entramos em contacto consigo para ficar a par do problema e criamos um ficheiro de ganhos adicional que contenha apenas as transações ajustadas para efeitos de registo.

Notas:

As taxas da Google são agora visíveis para todas as transações, independentemente de a Google ser ou não o comerciante de registo dos produtos vendidos.
O Relatório de ganhos não inclui estornos.
É gerado um único ficheiro para o Relatório de ganhos referente às transações todos os meses.
O imposto de retenção na fonte em Taiwan é pago no mês anterior até ao momento em que é comunicado

Comando

gs://[developer_bucket_id]/earnings/earnings_YYYYMM.zip

Exemplo

Se quiser transferir todos os relatórios gerados em 2014 a partir do ID de segmento do relatório pubsite_prod_rev_0123456789 para a app com o nome de pacote com.example.app, o comando é:

gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /your/local/directory

Formato de ficheiro

Campo	Formato	Opcional	Exemplos e notas
Descrição	String	Não	`GPA.1234-1234-1234-12345` Os IDs da encomenda de subscrição incluem o número do ciclo de renovação no fim (por exemplo, a primeira renovação é `GPA.1234-1234-1234-12345..0`, a segunda renovação é `GPA.1234-1234 -1234-12345..1` e assim sucessivamente).
Data da transação	String	Não	`Nov 30, 2016` Data desta encomenda com base no fuso horário do Pacífico (no formato MMM DD, AAAA). Tenha em atenção que a data/hora da transação pode ter o mês seguinte registado, uma vez que os relatórios são gerados pela data/hora do problema.
Hora da transação	String	Não	`12:00:00 PM PDT`
Tipo de imposto	String	Sim	`Third-party tax` Em branco para linhas sem imposto.
Tipo de transação	String	Não	`Charge, Google fee, Tax, Charge refund, Google fee refund, Charge rebill, Tax rebill, Google fee rebill, Adjustment.`
Tipo de reembolso	String	Sim	`Full, Partial` Os reembolsos em que o comprador foi reembolsado pelo valor total pago são marcados como "Full".Os reembolsos de parte do valor do pagamento de um utilizador são marcados como "Partial".
Título do produto	String	Não	`coins, monthly subscription` e assim sucessivamente. Nome do produto especificado pelo programador. Apresentado no local do comprador.
ID do produto	String	Não	`com.example.app` Nome do pacote da app em que o produto foi vendido.
Tipo de produto	Número inteiro	Não	`0,1` Usado para identificar o tipo de produto vendido. "0" representa a venda de uma app paga, "1" representa a venda de uma subscrição ou de um produto na app.
ID do SKU	String	Não	`treasure_chest_for_new_users` ID exclusivo do produto especificado pelo programador.
Hardware	String	Não	`mako` e assim sucessivamente. Modelo do dispositivo Android usado para fazer a compra. Nas encomendas de subscrição, refere-se ao modelo utilizado na compra original.
País do comprador	String	Não	`US, CA` e assim sucessivamente.
Estado do comprador	String	Sim	`MA, ON` e assim sucessivamente.
Código postal do comprador	String	Sim	`02140, M5B 1L6` e assim sucessivamente.
Moeda do comprador	String	Não	`USD, EUR, THB` e assim sucessivamente.
Montante (moeda do comprador)	Número inteiro	Não	`12345.67` Valor total para esta linha da fatura antes da conversão da moeda.
Taxa de conversão da moeda	Número inteiro	Não	`0.56789` Taxa de conversão utilizada ao converter os valores do comprador em valores de pagamento na moeda do comerciante.
Moeda do comerciante	String	Não	`USD, EUR, THB` e assim sucessivamente. Moeda para a qual a encomenda foi convertida. Esta é a moeda local do pagamento que recebe.
Montante (moeda do comerciante)	Número inteiro	Não	`12345.67` Valor total para esta linha da fatura após a conversão da moeda.
ID do plano base	String	Sim	`weekly` O ID do plano base da subscrição. Preenchido apenas para subscrições. Saiba mais.
ID da oferta	String	Sim	`spring-offer` O ID da oferta da subscrição. Preenchido apenas para subscrições. Saiba mais.
ID do grupo	Número inteiro	Sim	`1234567891234567890` O ID exclusivo é fornecido quando é criado um grupo de contas de programador. Saiba mais.
Primeiro milhão de USD elegível	String	Sim	`Sim,` `Não` Preenchido apenas quando está configurado um grupo de contas de programador. Saiba mais.
% de taxa de serviço	Número inteiro	Sim	`15`, `30`
Descrição da taxa	String	Sim	`SUBSCRIPTIONS` Detalhes fornecidos para o cálculo da taxa de serviço da Google.
ID da promoção	String	Sim	`PP.C_x0a08trvC1, PP.PdYfn342Ox10, pass-QbTfn350O810. Used by Points and Pass` Apenas preenchido nas vendas relacionadas com o Play Points e o Play Pass. Os prefixos "PP.C" e "PP.P" definem encomendas que envolvem cupões do Play Points e promoções de produtos na app, respetivamente. As encomendas em que os Play Points são gastos diretamente também são apresentadas. O prefixo "passe" define as encomendas em que os utilizadores aplicaram cupões fornecidos como parte da respetiva subscrição do Play Pass.

Custos de faturação

Recomendamos que não se baseie no número de colunas nos ficheiros CSV para os seus relatórios automáticos.

Informações

Se se inscreveu nos programas de faturação alternativa ou ofertas externas e comunicou transações ao Google Play, pode usar o relatório Custos de faturação para compreender as suas transações e as taxas de serviço da Google em dívida que lhe são faturadas.

O relatório Custos de faturação contém as transações do mês anterior num único ficheiro CSV. O relatório faculta uma discriminação por transação da cobrança ao utilizador, da taxa de serviço da Google e do valor do imposto, se aplicável. São incluídas informações como a percentagem da taxa de serviço e a taxa de conversão de moedas para ajudar a compreender como é calculado o valor da fatura das taxas de serviço.

Nota:

O relatório de custos da fatura é gerado uma vez por mês e está geralmente disponível no dia 5 do mês seguinte.
As linhas de impostos ou taxas da Google arredondadas a zero na moeda de faturação são excluídas do relatório.

Comando

gsutil cp -r gs://[developer_bucket_id]/invoice_billing_reports/invoice_billing_report_YYYYMM.zip /your/local/directory

Exemplo

Se quiser transferir todos os relatórios gerados em 2024 a partir do ID do contentor do relatório pubsite_prod_rev_0123456789, o comando é:

gsutil cp -r gs://pubsite_prod_rev_0123456789/invoice_billing_reports/invoice_billing_report_2024* /your/local/directory

Formato de ficheiro

Data da transação com base no fuso horário do Pacífico.

Campo	Formato	Opcional	Exemplos e notas
ID da fatura	String	Não	`1234567890` ID que corresponde ao número apresentado na fatura.
Programa	String	Sim	`User Choice Billing, Alternative Billing Only, External Offers` Definido apenas para linhas de taxa da Google.
ID da transação externo	String	Não	`com.example.app:1a2b3c4e5f`
Data da transação	String	Não	`1 de julho de 2024` Data da transação com base no fuso horário do Pacífico.
Data/hora da transação	Número inteiro	Não	`1719849600` A data/hora Unix da transação. Medida em segundos desde a época.
Tipo de transação	String	Não	`User charge, Google fee, Tax, User charge refund, Google fee refund, Tax refund, User charge partial refund, Google fee partial refund, Tax partial refund`
Tipo de imposto	String	Sim	`VAT / GST` Definido apenas para linhas de imposto.
Tipo de SKU	String	Não	`In-app product, Subscription`
ID do pacote	String	Não	`com.example.app` Nome do pacote da app em que o produto foi vendido.
País de venda	String	Não	`US, KR, and so on.`
Preço do artigo sem impostos (moeda de venda)	Número decimal	Sim	`12.34` Preço do produto na moeda da promoção, excluindo imposto. Definido apenas para linhas de cobrança do utilizador.
Moeda da venda	String	Não	`USD, KRW, and so on.` Moeda local do comprador.
Valor em dívida (moeda da venda)	Número decimal	Sim	`1.23 or -1.23` Valor em dívida na moeda de venda. Definido apenas para linhas de imposto e taxa da Google. Positivo para o valor cobrado e negativo para os valores de reembolso ou reembolso parcial.
Taxa de conversão de moedas	Número decimal	Não	`1.076` Taxa de câmbio usada ao converter o valor em dívida da moeda de venda para a moeda de faturação.
Moeda de faturação	String	Não	`USD, EUR, and so on.`
Valor em dívida (moeda de faturação)	Número decimal	Sim	`1.32` Valor em dívida na moeda de faturação. Definido apenas para linhas de imposto e taxa da Google. Positivo para o valor cobrado e negativo para os valores de reembolso ou reembolso parcial.
ID do grupo	Número inteiro	Sim	`1234567891234567890` O ID exclusivo é fornecido quando é criado um grupo de contas de programador. Saiba mais.
Primeiro milhão de USD elegível	String	Sim	`Yes, No` Preenchido apenas quando está configurado um grupo de contas de programador. Saiba mais.
% de taxa de serviço	Número inteiro	Sim	`11, 26, and so on`
Descrição da taxa	String	Sim	`SUBSCRIPTIONS, MEDIA_PARTNERSHIPS, and so on` Detalhes fornecidos para o cálculo da taxa de serviço da Google.

Encomendas financiadas pelo Saldo do Google Play de utilizadores coreanos

Informações

Se for um comerciante obrigado a emitir recibos em dinheiro na Coreia do Sul ao abrigo das regras e dos regulamentos aplicáveis ou caso se tenha registado voluntariamente para emitir recibos em dinheiro, terá de os emitir mediante pedido dos compradores em compras de apps pagas ou de produtos na app efetuadas com vales de oferta Google Play em won sul-coreano (KRW).

O relatório de encomendas financiadas pelo Saldo do Google Play de utilizadores coreanos contém as vendas financiadas pelo Saldo do Google Play em won sul-coreano para fins de envio de um recibo em dinheiro ao utilizador.

Nota: os utilizadores podem adicionar valor ao Saldo do Google Play a partir de várias origens, incluindo crédito de promoções da Google ou dos nossos parceiros. Antes de emitir um recibo em dinheiro, é importante garantir que o utilizador adicionou valor ao respetivo saldo através de um equivalente em dinheiro (por exemplo, um vale de oferta).

Comando

gs://[developer_bucket_id]/play_balance_krw/play_balance_krw_YYYYMM.zip

Exemplo

Se quiser transferir todos os relatórios gerados em 2018 a partir do ID do contentor do relatório pubsite_prod_rev_0123456789 para a app com o nome de pacote com.example.app, o comando é:

gsutil cp -r gs://pubsite_prod_rev_0123456789/play_balance_krw/play_balance_krw_2018* /your/local/directory

Formato de ficheiro

Campo	Formato	Opcional	Exemplos e notas
Número da encomenda	Número inteiro	Não	`GPA.1234-1234-1234-12345` Os IDs da encomenda de subscrição incluem o número do ciclo de renovação no fim (por exemplo, a primeira renovação é `GPA.1234-1234-1234-12345..0`, a segunda renovação é `GPA.1234-1234 -1234-12345..1`, etc.).
Data de cobrança da encomenda	String	Não	`2016-11-30` Data desta encomenda com base no fuso horário UTC (no formato AAAA-MM-DD).
Estado financeiro	String	Não	`Cobrança, reembolso, etc.`
Valor do financiamento do Saldo do Google Play	String	Não	`12,345.67` Valor da transação.
Moeda do Saldo do Google Play	String	Não	`KRW` Para os relatórios financeiros do saldo do Google Play de utilizadores coreanos, esta corresponde sempre ao won coreano (KRW).
Data/hora de cobrança da encomenda	Número inteiro	Não	`1480507200` A data/hora Unix em que a encomenda foi cobrada ao utilizador. Medida em segundos desde a época.

Subscrições

Respostas ao inquérito de cancelamento

Campo	Formato	Opcional	Exemplos e notas
Data de cancelamento	String	Não	`2016-11-30`
ID do SKU	String	Sim	`treasure_chest_for_new_users` ID exclusivo do produto especificado pelo programador.
País	String	Não	`US, CA, etc.`
Resposta	String	Não

Comandos e formatos de ficheiros para relatórios agregados

Estatísticas

Instalações

Comando

gs://[developer_bucket_id]/stats/installs/installs_[package_name]_yyyyMM_[dimension].csv

Formato de ficheiro

Campo	Formato	Opcional	Exemplo
Data	AAAA-mm-dd	NÃO	`2014-06-19`
Nome do pacote	String	NÃO	`com.my.app`
Dispositivo (ou qualquer outra dimensão suportada)	String	SIM	`hammerhead`
Instalações atuais em dispositivos	número inteiro	NÃO
Instalações em dispositivos ativos	número inteiro	NÃO
Instalações diárias em dispositivos	número inteiro	NÃO
Desinstalações diárias em dispositivos	número inteiro	NÃO
Atualizações diárias em dispositivos	número inteiro	NÃO
Instalações atuais de utilizadores	número inteiro	NÃO
Total de instalações de utilizadores	número inteiro	NÃO
Instalações diárias de utilizadores	número inteiro	NÃO
Desinstalações diárias de utilizadores	número inteiro	NÃO

Dimensões compatíveis

Dimensão	Nome do ficheiro
Código da versão da app	`..._app_version.csv`
Operador	`..._carrier.csv`
País	`..._country.csv`
Dispositivo	`..._device.csv`
Idioma	`..._language.csv`
Versão do SO Android	`..._os_version.csv`

Exemplo

Se quiser transferir todos os relatórios gerados em 2014 a partir do ID do contentor do relatório pubsite_prod_rev_0123456789 para a app com o nome de pacote com.example.app, o comando é:

gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/installs/installs_com.example.app_2014* /your/local/directory

Falhas

Nota: desde janeiro de 2018, as exportações passaram a incluir dados da nova origem de dados e a corresponder às informações presentes na página Estatísticas da sua app. As exportações anteriores a janeiro de 2018 apenas estão disponíveis para os dados recolhidos a partir da origem de dados anterior.

Comando

gs://[developer_bucket_id]/stats/crashes/crashes_[package_name]_yyyyMM_[dimension].csv

Formato de ficheiro

Campo	Formato	Opcional	Exemplo
Data	AAAA-mm-dd	NÃO	`2014-06-19`
Nome do pacote	String	NÃO	`com.my.app`
Dispositivo (ou qualquer outra dimensão suportada)	String	SIM	`hammerhead`
Falhas diárias	número inteiro	NÃO
ANRs diários	número inteiro	NÃO

Dimensões compatíveis

Dimensão	Nome do ficheiro
Código da versão da app	`..._app_version.csv`
Dispositivo	`..._device.csv`
Versão do SO Android	`..._os_version.csv`

Exemplo

Se quiser transferir todos os relatórios gerados em 2014 a partir do ID do contentor do relatório pubsite_prod_rev_0123456789 para a app com o nome de pacote com.example.app, o comando é:

gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/crashes/crashes_com.example.app_2014* /your/local/directory

Classificações

Comando

gs://[developer_bucket_id]/stats/ratings/ratings_[package_name]_yyyyMM_[dimension].csv

Formato de ficheiro

Campo	Formato	Opcional	Exemplo
Data	AAAA-mm-dd	NÃO	`2014-06-19`
Nome do pacote	String	NÃO	`com.my.app`
Dispositivo (ou qualquer outra dimensão suportada)	String	SIM	`hammerhead`
Classificação média diária	%.2f	SIM
Classificação média total	%.2f	Sim	`4.16`

Dimensões compatíveis

Dimensão	Nome do ficheiro
Código da versão da app	`..._app_version.csv`
Operador	`..._carrier.csv`
País	`..._country.csv`
Dispositivo	`..._device.csv`
Idioma	`..._language.csv`
Versão do SO Android	`..._os_version.csv`

Exemplo

Se quiser transferir todos os relatórios gerados em 2014 a partir do ID do contentor do relatório pubsite_prod_rev_0123456789 para a app com o nome de pacote com.example.app, o comando é:

gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/ratings/ratings_com.example.app_2014* /your/local/directory

Subscrições

Campo	Formato	Opcional	Exemplos e notas
Data	AAAA-MM-DD	NÃO	`2022-01-01` Data desta encomenda com base no fuso horário UTC (no formato AAAA-MM-DD)
Nome do pacote	String	NÃO	`com.example.app`
ID do produto	String	NÃO	`Premium access`
País	String	NÃO	`US, CA, etc.`
Novas subscrições	Número	NÃO	`1234`
Subscrições canceladas	Número	NÃO	`1234`
Subscrições ativas	Número	NÃO	`1234`
ID do plano base	String	NÃO	`weekly`
ID da oferta	String	NÃO	`spring-offer`

Dimensão	Nome do ficheiro
País	`..._country.csv`

Aquisição de utilizadores

O relatório de instaladores retidos e o relatório de compradores oferecem acesso programático aos dados do relatório de aquisição antigo. Esta exportação foi substituída por uma nova exportação programática, que inclui dados relativos às páginas Análise da loja eAnálise de conversão na Play Console. Foi disponibilizada em março de 2021.

Os relatórios antigos foram removidos em outubro de 2021.

Confirme que lê o artigo Como posso transferir os dados de aquisição? para saber mais.

Nota: o relatório Subscritores já não é suportado desde novembro de 2019. Para saber mais, certifique-se de que lê acerca das origens e métricas de aquisição.

Instaladores retidos (exportação antiga – disponível até agosto de 2021)

Comando

gs://[developer_bucket_id]/acquisition/retained_installers/retained_installers_[package_name]_yyyyMM_[dimension].csv

Formato de ficheiro

Campo	Formato	Opcional	Exemplos e notas
Data	AAAA-mm-dd	NÃO	A data em que o utilizador acedeu à sua Ficha da loja Nota: a adição de visitantes da Ficha da loja únicos em vários dias fará com que o número de visitantes da Ficha da loja seja superior ao apresentado nas visualizações de coorte semanal ou mensal. As visualizações de coorte semanal e mensal contabilizam cada visitante uma única vez, mesmo que estes acedam várias vezes.
Canal de aquisição	String	SIM	`Organic, Google Ads, UTM-Tagged` Presente para a dimensão "Canal de aquisição" Nota: o canal "Play Store (orgânicos)" é a soma da "Pesquisa (orgânica) na Play Store" e da "Procura (orgânica) na Play Store". Para evitar contabilizar os visitantes duas vezes neste relatório, ignore a linha "Play Store (orgânicos)" total ou as linhas de pesquisa e de procura.
País	String	SIM	Presente para as dimensões "País" e "País (orgânico da Play Store)"
Origem do UTM/campanha	String	SIM	Presente para a dimensão "Canais monitorizados (UTM)"
Palavra-chave	String	SIM	`Exemplo: "jogos"` Presente para a dimensão "Pesquisa (orgânica) da Play Store"
Visitantes da Ficha da loja	Número inteiro	NÃO
Instaladores	Número inteiro	NÃO
Taxa de conversão de visitante para instalador	Número decimal	NÃO
Referência da taxa de conversão média de visitante para instalador	Número decimal	SIM	Não é preenchido desde agosto de 2019. Está disponível um conjunto atualizado de referências, com um novo cálculo, na página Relatórios de aquisição. Para saber mais, certifique-se de que lê a Comparação de pares da taxa de conversão para o tráfego da Play Store.
Instaladores retidos durante 1 dia	Número inteiro	NÃO
Taxa de retenção de instalador para 1 dia	Número decimal	NÃO
Instaladores retidos durante 7 dias	Número inteiro	NÃO
Taxa de retenção de instalador para 7 dias	Número decimal	NÃO
Instaladores retidos durante 15 dias	Número inteiro	NÃO
Taxa de retenção de instalador para 15 dias	Número decimal	NÃO
Instaladores retidos durante 30 dias	Número inteiro	NÃO
Taxa de retenção de instalador para 30 dias	Número decimal	NÃO

Dimensões compatíveis

Dimensão	Nome do ficheiro
Canal de aquisição*	`..._channel.csv`
País	`..._country.csv`
País (orgânico da Play Store)	`..._play_country.csv`
Pesquisa (orgânica) na Play Store	`..._play_search.csv`
Canais monitorizados (UTM)	`..._utm_tagged.csv`

* Nota: o canal "Play Store (orgânicos)" é a soma da "Pesquisa (orgânica) na Play Store" e da "Procura (orgânica) na Play Store". Para evitar contabilizar os visitantes duas vezes neste relatório, ignore a linha "Play Store (orgânicos)" total ou as linhas de pesquisa e de procura.

A dimensão da Pesquisa Google (orgânica) já não é suportada desde junho de 2019.

Desempenho na loja (nova exportação – disponível em março de 2021)

Nomes dos CSVs

Cada ficheiro CSV disponível contém dados de um mês e detalhes. Os CSVs têm nomes estruturados que refletem o ano, o mês e os detalhes do relatório que abrangem, de acordo com o seguinte padrão:

Formato do nome do ficheiro: store_performance_[package_name]_[yyyyMM]_[breakdown].csv

Notas:

O nome do pacote é incluído no nome do ficheiro tal como está, com eventuais carateres especiais presentes ("." ou "_").
yyyyMM representa o ano e o mês, por exemplo, 202101.

Comando

gs://[developer_bucket_id]/stats/store_performance/store_performance_[package_name]_[yyyyMM]_[breakdown].csv

Formato de ficheiro

Campo	Formato	Opcional	Exemplo	Descrição
Data	AAAA-mm-dd	NÃO	`2021-01-01`	A data em que o utilizador acedeu à sua Ficha da loja
Nome do pacote	String	NÃO	`com.example.app`	O nome do pacote ao qual dizem respeito os dados do relatório
País/região	String	NÃO	`UK`	O país ou a região em que a Conta Google do utilizador está registada.
Origem do tráfego	String	NÃO	`Google Play search`	Como o utilizador acedeu à sua Ficha da loja: Pesquisa no Google Play Recomendações externas Exploração do Google Play Nota: pode ser `Other` se este valor não atingir determinados limites mínimos
Termo de pesquisa	String	SIM	`app store`	O termo que o utilizador pesquisou antes de navegar para a sua Ficha da loja. Disponível apenas para a pesquisa no Google Play. Nota: pode ser `Other` se este valor não atingir determinados limites mínimos
Origem do UTM	String	SIM	`google`	O valor do parâmetro de URL utm_source em links diretos para a sua Ficha da loja. Disponível apenas para recomendações externas. Nota: pode ser `Other` se este valor não atingir determinados limites mínimos
Campanha do UTM	String	SIM	`campaign`	O valor do parâmetro de URL utm_campaign em links diretos para a sua Ficha da loja. Disponível apenas para recomendações externas. Nota: pode ser `Other` se este valor não atingir determinados limites mínimos
Aquisições da Ficha da loja	Número inteiro	NÃO	`10`	O número de utilizadores que visitaram a sua Ficha da loja e instalaram a sua app e que não a tinham instalada em nenhum outro dispositivo na altura.
Visitantes da Ficha da loja	Número inteiro	NÃO	`100`	O número de utilizadores que visitaram a sua Ficha da loja e que ainda não tinham a sua app instalada em nenhum dos respetivos dispositivos.
Taxa de conversão da Ficha da loja	Número decimal	NÃO	`0.1`	A percentagem de visitantes da Ficha da loja que instalaram a sua app. Nota: não inclui visitas ou instalações de utilizadores que já tenham a sua app instalada noutro dispositivo.

Estrutura de discriminação disponível

Estão disponíveis as seguintes discriminações:

Nome da discriminação Campos em cada CSV (por ordem):

Nome da discriminação	Campos em cada CSV (por ordem):
`country` Exemplo de nome do ficheiro: `store_performance_com.example.app_202012_country.csv`	Data, Nome do pacote, País, Aquisições da Ficha da loja, Visitantes da Ficha da loja, Taxa de conversão da Ficha da loja
`traffic_source` Exemplo de nome do ficheiro: `store_performance_com.example.app_202012_traffic_source.csv`	Data, Nome do pacote, Origem do tráfego, Termo de pesquisa, Origem do UTM, Campanha do UTM, Aquisições da Ficha da loja, Visitantes da Ficha da loja, Taxa de conversão da Ficha da loja

country

Exemplo de nome do ficheiro:

store_performance_com.example.app_202012_country.csv

Data, Nome do pacote, País, Aquisições da Ficha da loja, Visitantes da Ficha da loja, Taxa de conversão da Ficha da loja

traffic_source

Exemplo de nome do ficheiro:

store_performance_com.example.app_202012_traffic_source.csv

Data, Nome do pacote, Origem do tráfego, Termo de pesquisa, Origem do UTM, Campanha do UTM, Aquisições da Ficha da loja, Visitantes da Ficha da loja, Taxa de conversão da Ficha da loja

Esquema de interpretação de forma literal

Duplique quaisquer aspas duplas. (" -> "")
Se uma célula tiver tabulações, novas linhas, aspas duplas ou vírgulas, coloque-a entre aspas duplas. (... -> "...")

Exemplo

Se quiser transferir todos os relatórios gerados em 2020 a partir do ID do contentor do relatório pubsite_prod_0123456789 para a app com o nome de pacote com.example.app, o comando é:

gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /your/local/directory

Compradores (7 dias após a instalação – disponível até agosto de 2021)

Comando

gs://[developer_bucket_id]/acquisition/buyers_7d/buyers_7d_[package_name]_yyyyMM_[dimension].csv

Formato de ficheiro

Campo	Formato	Opcional	Exemplos e notas
Data	AAAA-mm-dd	NÃO	A data em que o utilizador acedeu à sua Ficha da loja Nota: a adição de visitantes da Ficha da loja únicos em vários dias fará com que o número de visitantes da Ficha da loja seja superior ao apresentado nas visualizações de coorte semanal ou mensal. As visualizações de coorte semanal e mensal contabilizam cada visitante uma única vez, mesmo que estes acedam várias vezes.
Canal de aquisição	String	SIM	`Organic, Google Ads, UTM-Tagged` Presente para a dimensão "Canal de aquisição" Nota: o canal "Play Store (orgânicos)" é a soma da "Pesquisa (orgânica) na Play Store" e da "Procura (orgânica) na Play Store". Para evitar contabilizar os visitantes duas vezes neste relatório, ignore a linha "Play Store (orgânicos)" total ou as linhas de pesquisa e de procura.
País	String	SIM	Presente para as dimensões "País" e "País (orgânico da Play Store)"
Origem do UTM/campanha	String	SIM	Presente para a dimensão "Canais monitorizados (UTM)"
Palavra-chave	String	SIM	`Exemplo: "jogos"` Presente para a dimensão "Pesquisa (orgânica) da Play Store"
Visitantes da Ficha da loja	Número inteiro	NÃO
Instaladores	Número inteiro	NÃO
Taxa de conversão de visitante para instalador	Número decimal	NÃO
Referência da taxa de conversão média de visitante para instalador	Número decimal	SIM	Não é preenchido desde agosto de 2019. Está disponível um conjunto atualizado de referências, com um novo cálculo, na página Relatórios de aquisição. Para saber mais, certifique-se de que lê a Comparação de pares da taxa de conversão para o tráfego da Play Store.
Compradores	Número inteiro	NÃO
Taxa de conversão de instalador para comprador	Número decimal	NÃO
Compradores recorrentes	Número inteiro	NÃO
Taxa de conversão de instalador para comprador recorrente	Número decimal	NÃO
Taxa de conversão de comprador para comprador recorrente	Número inteiro	NÃO

Dimensões compatíveis

Dimensão	Nome do ficheiro
Canal de aquisição*	`..._channel.csv`
País	`..._country.csv`
País (orgânico da Play Store)	`..._play_country.csv`
Pesquisa (orgânica) na Play Store	`..._play_search.csv`
Canais monitorizados (UTM)	`..._utm_tagged.csv`

A dimensão da Pesquisa Google (orgânica) já não é suportada desde junho de 2019.

Escolha uma seção para enviar feedback

A informação foi útil?

Como podemos melhorá-la?

Transfira e exporte relatórios mensais

Tipos de relatórios

Transfira relatórios

Transfira relatórios a partir do Google Cloud Storage

Procure o URI do Google Cloud Storage

Controle o acesso ao Google Cloud Storage

Comandos e formatos de ficheiro para relatórios detalhados

Falhas de sistema e ANRs

Críticas

Relatórios financeiros

Subscrições

Comandos e formatos de ficheiros para relatórios agregados

Estatísticas

Aquisição de utilizadores

A informação foi útil?

Precisa de mais ajuda?

Experimente estes passos seguintes: