Transfira e exporte relatórios mensais

 

Ao usar o Website da Play Console, pode 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

Os relatórios detalhados incluem dados sobre eventos individuais:

• Críticas
• Dados financeiros: vendas estimadas, ganhos, produtos premiados e encomendas financiadas pelo Saldo do Google Play de utilizadores coreanos

Relatórios agregados

Os relatórios agregados incluem dados consolidados (médias, totais diários, etc.) relativos às estatísticas da app:

• Estatísticas: instalações, falhas de sistema, classificações e subscrições
• Aquisição de utilizadores: instaladores retidos, compradores (7 dias após a instalação) e subscritores

Transfira relatórios

1. Abra a Play Console.
2. Clique em Transferir relatórios e selecione Críticas, Estatísticas ou Financeiros.
3. Em "Selecionar uma aplicação", escreva e selecione o nome da sua app.
4. 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

1. Instale a ferramenta gsutil.
   • Certifique-se de que autentica a sua conta através de uma conta com acesso à Play Console.
   • Durante o processo de configuração, se estiver a usar a gsutil pela primeira vez e não tiver outros projetos configurados no Google Cloud Storage, pode escrever o nome da sua app quando lhe for pedido um ID do projeto.
2. Procure o ID do contentor de relatórios 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).
3. Use o comando gsutil cp para transferir relatórios.
   • Para ver comandos adicionais que ajudam a aceder aos seus relatórios, aceda à documentação da ferramenta gsutil.

Os relatórios são organizados em diretórios nomeados de acordo com cada tipo de relatório. Os nomes dos ficheiros CSV incluem o tipo de relatório, o nome do pacote, o período e a dimensão (se aplicável).

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

Passo 1: crie uma conta de serviço

1. Abra a Google Developers Console.
2. 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.
3. Selecione o ícone Menu > Autorizações > Contas de serviço > Criar conta de serviço.
4. Siga as instruções apresentadas no ecrã e selecione Criar.
5. Copie o endereço de email indicado.
   • Exemplo: [e-mail]

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

1. Abra a Play Console.
2. Selecione Definições > Contas de utilizador e direitos > Convidar novo utilizador.
3. Cole ou escreva o endereço de email associado à sua conta de serviço.
4. 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.
5. Clique em Adicionar utilizador. A sua conta de serviço é adicionada à sua conta.

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

1. Instale a biblioteca cliente da API para a sua linguagem de programação preferida.
2. 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).
3. Emita chamadas da API autenticadas para obter relatórios.

Veja um exemplo (Python)

Se utilizou linguagem Python para obter os relatórios, eis um exemplo de código:

import json

from httplib2 import Http

from oauth2client.client import SignedJwtAssertionCredentials

from apiclient.discovery import build

# Change these variables to fit your case

client_email = 'your service account here'

json_file = 'path_to_json_file_obtained_when_creating_the_service_account'

cloud_storage_bucket = 'pubsite_prod_rev_…'

report_to_download = ‘earnings/earnings_….zip’

 

private_key = json.loads(open(json_file).read())['private_key']

credentials = SignedJwtAssertionCredentials(client_email, private_key,

   'https://www.googleapis.com/auth/devstorage.read_only')

storage = build('storage', 'v1', http=credentials.authorize(Http()))

print storage.objects().get(

   bucket=cloud_storage_bucket,

   object=report_to_download).execute()

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

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, 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).
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 utilizado 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 obtém ao gastar 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

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 utilizar 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 efetuar ajustes aos seus ganhos para corrigir erros de cálculo. Se tal acontecer, entraremos em contacto consigo para ficar a par do problema e criaremos 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 ID exclusivo atribuído a esta encomenda. Os IDs da encomenda de subscrição incluem o número do ciclo de renovação na parte final.
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, etc. 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, etc. Modelo do dispositivo Android utilizado para efetuar a compra. Nas encomendas de subscrição, refere-se ao modelo utilizado na compra original.
País do comprador	String	Não	US, CA, etc.
Estado do comprador	String	Sim	MA, ON, etc.
Código postal do comprador	String	Sim	02140, M5B 1L6, etc.
Moeda do comprador	String	Não	USD, EUR, THB, etc.
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, etc. 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	10, 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, 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

Encomendas financiadas pelo Saldo do Google Play de utilizadores coreanos

Acerca de

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 epoch.

Subscrições

Respostas ao inquérito de cancelamento

Comando

gs://[developer_bucket_id]/subscriptions/cancellations/freeform_[package_name].csv

Formato de ficheiro

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

Comando

gs://[developer_bucket_id]/financial-stats/subscriptions/subscriptions_[package_name]_[product_id]_yyyyMM_[dimension].csv

Formato de ficheiro

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

Nota: para obter mais informações acerca das estatísticas de subscrições novas, canceladas e ativas, aceda a Reveja os dados da receita e dos compradores da app.

Dimensões compatíveis

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):
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

* 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.