Tipos de relatórios
Relatórios detalhadosOs relatórios detalhados incluem dados de eventos individuais:
- Avaliações
- Finanças: vendas estimadas, ganhos, produtos concedidos como prêmio e financiamento do saldo do Google Play coreano
Os relatórios agregados incluem dados consolidados (médias, totais diários etc.) das estatísticas de apps:
- "Estatísticas": instalações, falhas, classificações e assinaturas
- "Aquisição de usuários": instalações retidas, compradores (sete dias após a instalação) e assinaturas
Fazer o download de relatórios
- Abra o Play Console.
- Clique em Fazer o download de relatórios e selecione Avaliações, Estatísticas ou Finanças.
- Em "Selecionar um app", digite e selecione o nome do seu app.
- Selecione o ano e o mês do relatório que você quer salvar.
Observação: os relatórios financeiros incluem todos os apps na sua conta.
Fazer o download de relatórios no Google Cloud Storage
Os relatórios estão disponíveis no Google Cloud Storage. Eles são gerados diariamente e acumulados em arquivos CSV mensais. Eles são armazenados em um bucket particular do Google Cloud Storage referente à sua conta de desenvolvedor do Google Play.
É possível acessar relatórios com o Google Cloud Storage no navegador ou de maneira programática com a gsutil. Use também outras ferramentas para acessar o bucket do Google Cloud Storage de maneira programática.
Dica: se você quiser importar seus relatórios do Google Cloud Storage para o BigQuery, vai ser preciso converter os arquivos CSV de UTF-16
em UTF-8
.
Encontrar o URI do Google Cloud Storage
Para copiar o URI do Google Cloud Storage, clique no botão Copiar o URI do Cloud Storage ao lado do cabeçalho da seção correspondente nas páginas Fazer o download de relatórios.
O URI do Cloud Storage começa com pubsite_prod_rev
(por exemplo, pubsite_prod_rev_01234567890987654321
).
- Instale a ferramenta gsutil.
- Não esqueça de autenticar sua conta usando uma conta com acesso ao Play Console.
- Durante o processo de configuração, se você estiver usando a gsutil pela primeira vez e não tiver outros projetos definidos no Google Cloud Storage, digite o nome do seu app quando o ID do projeto for solicitado.
- Para encontrar o ID do bucket de relatório, clique no botão Copiar o URI do Cloud Storage ao lado do cabeçalho da seção correspondente nas páginas Fazer o download de relatórios.
- O URI do Cloud Storage começa com
pubsite_prod_rev
(por exemplo,pubsite_prod_rev_01234567890987654321
).
- O URI do Cloud Storage começa com
- Use o comando
gsutil cp
para fazer o download dos relatórios.- Para ver outros comandos que podem ajudar você a acessar os relatórios, consulte a documentação da gsutil.
Os relatórios são organizados em diretórios nomeados de acordo com cada tipo de relatório. Os nomes dos arquivos CSV incluem o tipo de relatório, assim como o nome, o período e a dimensão do pacote (se aplicável).
Etapa 1: criar uma conta de serviço
- Abra o Google Developers Console.
- Se você já tiver um projeto, use o menu suspenso para selecionar. Se você não tiver um projeto na lista ou quiser criar um novo, clique em Criar projeto.
- Selecione o ícone Menu > Permissões > Contas de serviço > Criar conta de serviço.
- Siga as instruções na tela e selecione Criar.
- Copie o endereço de e-mail exibido.
- Exemplo:
[email protected]
- Exemplo:
Etapa 2: adicionar a conta de serviço ao Play Console
- Abra o Play Console.
- Selecione Configurações > Contas e direitos do usuário > Convidar novo usuário.
- Cole ou digite o endereço de e-mail associado à sua conta de serviço.
- Com base nos tipos de relatórios necessários, selecione as permissões.
- Dica: leia o artigo Adicionar usuários à conta de desenvolvedor e gerenciar permissões para entender os vários níveis de acesso dos usuários e os direitos concedidos por diferentes permissões.
- Clique em Adicionar usuário. Sua conta de serviço será adicionada à sua conta.
Etapa 3: buscar relatórios usando uma chamada da API
- Instale a biblioteca de cliente da API na sua linguagem de código preferida.
- Configure o código realizando a chamada de API para usar a autenticação
OAuth2
de servidor para servidor e para solicitar permissão ao escopoOAuth2
(https://googleapis.com/auth/devstorage.read_only). - Realize chamadas autenticadas da API para buscar relatórios.
Se você tiver usado Python para buscar relatórios, veja 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://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()
Controlar o acesso ao Google Cloud Storage
Os relatórios disponíveis no Google Cloud Storage usam as mesmas restrições de acesso que controlam o acesso de dados no Play Console. Isso significa que os usuários com acesso a áreas de uma conta do Play Console também podem ver os relatórios correspondentes no Google Cloud Storage.
Os proprietários da conta podem atualizar as permissões de usuários individuais a qualquer momento.
- Para acessar relatórios em massa, a permissão "Ver informações do app" precisa ser definida como "Global".
- Para fazer o download de relatórios financeiros, defina a permissão "Ver dados financeiros" como "Global".
Comandos e formatos de arquivo para relatórios detalhados
Falhas e ANRs
Desde maio de 2018, não é mais possível fazer o download de relatórios detalhados de falhas e ANRs.
Avaliações
Comando
gs://[developer_bucket_id]/reviews/reviews_[package_name]_YYYYMM.csv
Formato do arquivo
Campo | Formato | Opcional | Exemplos e observações |
---|---|---|---|
Nome do pacote | String | NÃO | com.company.app |
Código da versão do app | Número inteiro | SIM | Produção somente de APKs |
Nome da versão do app | String | SIM | |
Idioma do avaliador | String: abreviação de duas letras conforme ISO 639-1 | SIM | pt-BR |
Dispositivo | String | SIM | hammerhead |
Data e horário de envio da avaliação | ISO_8601 incluindo horário, fuso horário UTC | NÃO | 2014-06-19T19:12:32Z |
Milissegundos do envio da avaliação desde época | Número inteiro, milissegundos desde época | NÃO | |
Data e hora da última atualização da avaliação | ISO_8601 incluindo horário, fuso horário UTC | SIM | 2014-06-19T19:12:32Z |
Milissegundos da última atualização da avaliação desde época | Número inteiro, milissegundos desde época | SIM | |
Nota | Número inteiro (entre um e cinco) | NÃO | |
Título da avaliação | String, no idioma local do avaliador (quebras de linhas removidas) | SIM | |
Texto da avaliação | String, no idioma local do avaliador (quebras de linhas removidas) | SIM | |
Data e hora da resposta do desenvolvedor | ISO_8601 incluindo horário, fuso horário UTC | SIM | 2014-06-19T19:12:32Z |
Milissegundos da resposta do desenvolvedor desde época | Número inteiro, milissegundos desde época | SIM | |
Texto da resposta do desenvolvedor | String (quebras de linhas removidas e sem espaços em branco) | SIM | |
Link da avaliação | String | SIM | https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..> |
Exemplo
Se você quiser fazer o download de todos os relatórios gerados em 2014 com base no ID do bucket de relatório pubsite_prod_rev_0123456789
do seu app com o nome do pacote "com.example.app", o comando será:
gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /your/local/directory
Relatórios financeiros
Vendas estimadasNão é recomendável depender do número de colunas nos arquivos CSV para os relatórios automatizados.
Sobre
É possível usar o relatório da estimativa de vendas para ver informações de baixa latência sobre apps, produtos no app ou vendas de assinaturas. O relatório indica o valor pago pelos compradores, sem deduzir dos totais os tributos nem as taxas do Google.
Use esse relatório para análises de dados ou de tendências. No entanto, ele não é recomendado para contabilidade. Em vez disso, veja o relatório de receitas.
Pode haver diferenças entre os valores desse relatório e seus lucros por diversas razões. Por exemplo, o relatório da estimativa de vendas não considera os tributos retidos nem os estornos. Esse relatório mostra os pagamentos dos compradores na moeda local, e não os valores convertidos na moeda em que você recebe pelas transações.
Comando
gs://[developer_bucket_id]/sales/salesreport_YYYYMM.zip
Exemplo
Se você quiser fazer o download de todos os relatórios gerados em 2014 com base no ID do bucket de relatório pubsite_prod_rev_0123456789
do seu app com o nome do pacote "com.example.app", o comando será:
gsutil cp -r gs://pubsite_prod_rev_0123456789/sales/salesreport_2014* /your/local/directory
Formato do arquivo
Campo | Formato | Opcional | Exemplos e observações |
---|---|---|---|
Número do pedido |
String |
Não |
Os códigos de pedido de assinatura incluem o número do ciclo de renovação no final. Por exemplo, a primeira renovação é |
Data da cobrança do pedido |
String |
Não |
É a data do pedido com base no fuso horário UTC (no formato AAAA-MM-DD). |
Carimbo de data/hora da cobrança do pedido |
Número inteiro |
Não |
É o carimbo de data/hora UNIX de quando o pedido foi cobrado do usuário. Isso é medido em segundos desde época. |
Status financeiro |
String |
Não |
Se você reembolsar totalmente um pedido depois de emitir um reembolso parcial:
|
Modelo do dispositivo |
String |
Não |
É o modelo de dispositivo Android usado para realizar a compra. Para pedidos de assinatura, isso se refere ao dispositivo usado na compra original. |
Título do produto |
String |
Não |
É o nome do produto criado pelo desenvolvedor. É exibido na localidade do comprador. |
ID do produto |
String |
Não |
É o nome do pacote do app em que o produto foi vendido. |
Tipo de produto |
String |
Não |
|
Código de SKU |
String |
Não |
É um ID exclusivo do produto especificado pelo desenvolvedor. |
Moeda de venda |
String |
Não |
|
Preço do item |
Número inteiro |
Não |
É exibido na moeda local do comprador. Usa "," como um separador de milhares. |
Impostos cobrados |
Número inteiro |
Sim |
É expresso na moeda local do comprador. Usa "," como um separador de milhares. |
Valor cobrado |
Número inteiro |
Não |
É expresso na moeda local do comprador. É a soma do preço do item e dos tributos cobrados. Usa "," como um separador de milhares. |
Cidade do comprador |
String |
Sim |
Só é preenchido nas vendas em que você é o comerciante responsável pelo processamento. |
Estado do comprador |
String |
Sim |
|
Código postal do comprador |
String |
Sim |
Só é preenchido nas vendas em que você é o comerciante responsável pelo processamento. |
País do comprador |
String |
Não |
|
ID do plano básico |
String |
Sim |
É o ID do plano básico da assinatura. Preenchido apenas para assinaturas. Saiba mais. |
ID da oferta |
String |
Sim |
É o ID da oferta da assinatura. Preenchido apenas para assinaturas. Saiba mais. |
ID do grupo | Número inteiro | Sim |
O ID exclusivo é fornecido na criação de um grupo de contas de desenvolvedor. Saiba mais. |
Qualificação do primeiro USD 1 milhão | String | Sim |
Preenchido apenas quando há um grupo de contas de desenvolvedor configurado. Saiba mais. |
ID da promoção | String | Sim |
|
Valor do cupom | Número inteiro | Sim |
É exibido na moeda local do comprador. Usa "," como um separador de milhares. Só é preenchido nas vendas relacionadas a cupons do Play Points. Saiba mais. |
Preço com desconto | Número inteiro | Sim |
É a taxa de desconto usada para especificar a economia do usuário ao gastar Pontos do Play Points em vez de dinheiro. Só é preenchido nas vendas relacionadas aos Pontos do Play Points. Saiba mais. |
ID dos produtos em destaque |
Número inteiro |
Sim |
O ID exclusivo é fornecido quando um desenvolvedor cria um produto em destaque. Saiba mais. |
ID do experimento de preço | String | Sim |
ID do experimento de preço e grupo experimental |
Não é recomendável depender do número de colunas nos arquivos CSV para os relatórios automatizados.
Sobre
É possível usar o relatório de receitas para entender os pagamentos e as transações. Cada linha no relatório representa um tipo de transação, como quando você cobra uma quantia do cliente ou paga ao Google uma taxa, junto com os montantes originais e convertidos.
Os relatórios de ganhos contêm transações do mês anterior. Você vai receber o pagamento várias semanas após esse relatório ser disponibilizado.
O relatório de ganhos é gerado uma vez por mês e geralmente fica disponível até o dia 5 do mês seguinte. Às vezes, o Google pode fazer ajustes aos seus ganhos para corrigir erros de cálculo. Se isso acontecer, vamos entrar em contato para informar o problema e criar um arquivo adicional com apenas as transações ajustadas para fins de registro.
Observações:
- Agora, as taxas do Google ficam visíveis para todas as transações, mesmo que o Google não seja o comerciante responsável pelo processamento dos produtos vendidos.
- O relatório de ganhos não inclui estornos.
- Um único arquivo é gerado para o relatório de ganhos das transações a cada mês.
- O tributo retido de Taiwan vai ser pago no mês anterior ao relatório.
Comando
gs://[developer_bucket_id]/earnings/earnings_YYYYMM.zip
Exemplo
Se você quiser fazer o download de todos os relatórios gerados em 2014 com base no ID do bucket de relatório pubsite_prod_rev_0123456789
do seu app com o nome do pacote "com.example.app", o comando será:
gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /your/local/directory
Formato do arquivo
Campo | Formato | Opcional | Exemplos e observações |
---|---|---|---|
Descrição |
String |
Não |
Os códigos de pedido de assinatura incluem o número do ciclo de renovação no final. Por exemplo, a primeira renovação é |
Data da transação |
String |
Não |
É a data do pedido com base no fuso horário do Pacífico (no formato MMM DD, AAAA). O carimbo de data/hora da transação talvez tenha o mês seguinte registrado, porque os relatórios são gerados com base no carimbo de data/hora da emissão. |
Horário da transação |
String |
Não |
|
Tipo de tributo |
String |
Sim |
Permanece em branco nas linhas que não são relacionadas a impostos. |
Tipo de transação |
String |
Não |
|
Tipo de reembolso |
String |
Sim |
Os reembolsos em que o comprador foi ressarcido por completo serão marcados como "Completo". Os reembolsos referentes a parte do valor pago pelo usuário serão marcados como "Parcial". |
Título do produto |
String |
Não |
É o nome do produto criado pelo desenvolvedor. Exibido na localidade do comprador. |
ID do produto |
String |
Não |
É o nome do pacote do app em que o produto foi vendido. |
Tipo de produto |
Número inteiro |
Não |
É usado para identificar o tipo de produto vendido. "0" representa a venda de um app pago, enquanto "1" representa a venda de um produto ou assinatura no app. |
ID de SKU |
String |
Não |
É um ID exclusivo do produto especificado pelo desenvolvedor. |
Hardware |
String |
Não |
É o modelo de dispositivo Android usado para realizar a compra. Para pedidos de assinatura, isso se refere ao modelo usado para a compra original. |
País do comprador |
String |
Não |
|
Estado do comprador |
String |
Sim |
|
Código postal do comprador |
String |
Sim |
|
Moeda do comprador |
String |
Não |
|
Valor (moeda do comprador) |
Número inteiro |
Não |
É o valor total da linha da fatura antes da conversão de moeda. |
Taxa de conversão de moeda |
Número inteiro |
Não |
É a taxa de câmbio utilizada ao converter os montantes do comprador em valores de pagamento na moeda do comerciante. |
Moeda do comerciante | String | Não |
É a moeda em que o pedido foi convertido. Esta é a moeda local em que você receberá o pagamento. |
Valor (moeda do comerciante) | Número inteiro | Não |
É o valor total desta linha da fatura após a conversão de moeda. |
ID do plano básico |
String |
Sim |
É o ID do plano básico da assinatura. Preenchido apenas para assinaturas. Saiba mais. |
ID da oferta |
String |
Sim |
É o ID da oferta da assinatura. Preenchido apenas para assinaturas. Saiba mais. |
ID do grupo | Número inteiro | Sim |
O ID exclusivo é fornecido na criação de um grupo de contas de desenvolvedor. Saiba mais. |
Qualificação do primeiro USD 1 milhão | String | Sim |
Preenchido apenas quando há um grupo de contas de desenvolvedor configurado. Saiba mais. |
Porcentagem da taxa de serviço |
Número inteiro |
Sim |
|
Descrição da taxa | String | Sim |
São os detalhes fornecidos para o cálculo da taxa de serviço do Google. |
ID da promoção | String | Sim |
Isso só é preenchido nas vendas relacionadas ao Play Points e ao Play Pass. Os prefixos "PP.C" e "PP.P" definem os pedidos que envolvem cupons do Play Points e promoções de produtos nos apps, respectivamente. Os pedidos em que os pontos do Play Points são gastos diretamente também são exibidos. O prefixo "pass" define pedidos em que os usuários usaram cupons fornecidos como parte da assinatura do Play Pass. |
Não é recomendável depender do número de colunas nos arquivos CSV para os relatórios automatizados.
Sobre
Se você se inscreveu nos programas de faturamento alternativo ou promoções externas e informou transações ao Google Play, use o relatório de cobrança por fatura para entender suas transações e as taxas de serviço do Google faturadas.
O relatório de cobrança por fatura tem transações do mês anterior em um único arquivo CSV. Ele mostra um detalhamento por transação da cobrança do usuário, da taxa de serviço do Google e do valor dos tributos, se aplicável. Informações como a porcentagem da taxa de serviço e a taxa de câmbio são incluídas para esclarecer como o valor das taxas de serviço na fatura é calculado.
Observação:
- O relatório de cobrança por fatura é gerado uma vez por mês e geralmente está disponível até o dia 5 do mês seguinte.
- As linhas de tributos ou taxas do Google arredondadas para zero na moeda de faturamento não aparecem no relatório.
Comando
gsutil cp -r gs://[developer_bucket_id]/invoice_billing_reports/invoice_billing_report_YYYYMM.zip /your/local/directory
Exemplo
Se você quiser baixar todos os relatórios gerados em 2024 com base no ID do bucket de relatório pubsite_prod_rev_0123456789
, o comando será este:
gsutil cp -r gs://pubsite_prod_rev_0123456789/invoice_billing_reports/invoice_billing_report_2024* /your/local/directory
Formato do arquivo
É a data da transação com base no fuso horário do Pacífico.
Campo | Formato | Opcional | Exemplos e observações |
---|---|---|---|
ID da fatura |
String |
Não |
É o ID que corresponde ao número exibido na fatura. |
Programa |
String |
Sim |
Definido apenas para linhas de taxas do Google. |
ID externo da transação |
String |
Não |
|
Data da transação |
String |
Não |
É a data da transação com base no fuso horário do Pacífico. |
Carimbo de data/hora da transação |
Número inteiro |
Não |
É o carimbo de data/hora UNIX da transação. Isso é medido em segundos desde é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 tributo |
String |
Sim |
Definido apenas para linhas de tributos. |
Tipo de SKU |
String |
Não |
|
ID do pacote |
String |
Não |
É o nome do pacote do app em que o produto foi vendido. |
País de venda |
String |
Não |
|
Preço do item sem tributos (moeda de venda) |
Decimal |
Sim |
É o preço do produto sem tributos na moeda de venda. Definido apenas para linhas de cobrança do usuário. |
Moeda de venda |
String |
Não |
É a moeda local do comprador. |
Valor devido (moeda de venda) |
Decimal |
Sim |
Valor devido na moeda de venda. Definido apenas para linhas de taxas e tributos do Google. Positivo para o valor cobrado e negativo para reembolsos integrais ou parciais. |
Taxa de câmbio |
Decimal |
Não |
É a taxa de câmbio usada ao converter o valor devido da moeda de venda para a de faturamento. |
Moeda de faturamento |
String |
Não |
|
Valor devido (moeda de faturamento) |
Decimal |
Sim |
É o valor devido na moeda de faturamento. Definido apenas para linhas de taxas e tributos do Google. Positivo para o valor cobrado e negativo para reembolsos integrais ou parciais. |
ID do grupo |
Número inteiro |
Sim |
O ID exclusivo é fornecido na criação de um grupo de contas de desenvolvedor. Saiba mais. |
Qualificação do primeiro USD 1 milhão |
String |
Sim |
Preenchido apenas quando há um grupo de contas de desenvolvedor configurado. Saiba mais. |
Porcentagem da taxa de serviço |
Número inteiro |
Sim |
|
Descrição da taxa |
String |
Sim |
São os detalhes fornecidos para o cálculo da taxa de serviço do Google. |
Sobre
No caso dos comerciantes obrigados a emitir recibos na Repúblicada Coreia de acordo com a regulamentação aplicável ou daqueles que se cadastraram voluntariamente para fazer isso, é preciso emitir (mediante solicitação do comprador) recibos dos apps pagos ou das compras de produtos em apps feitas com vales-presente do Google Play em won sul-coreano (KRW).
O relatório de financiamento do saldo do Google Play para coreanos exibe vendas de saldo realizadas com won sul-coreano. Com esses dados, é possível enviar um recibo para o usuário.
Observação: os usuários podem adicionar saldo ao Google Play por diversas fontes, incluindo crédito promocional do Google ou dos nossos parceiros. Antes de emitir um recibo, é importante garantir que o usuário adicionou saldo usando um equivalente em dinheiro (por exemplo, um vale-presente).
Comando
gs://[developer_bucket_id]/play_balance_krw/play_balance_krw_YYYYMM.zip
Exemplo
Se você quiser fazer o download de todos os relatórios gerados em 2018 com base no ID do bucket de relatório pubsite_prod_rev_0123456789
do seu app com o nome do pacote "com.example.app", o comando será:
gsutil cp -r gs://pubsite_prod_rev_0123456789/play_balance_krw/play_balance_krw_2018* /seu/diretório/local/
Formato do arquivo
Campo | Formato | Opcional | Exemplos e observações |
---|---|---|---|
Número do pedido |
Número inteiro |
Não |
Os códigos de pedido de assinatura incluem o número do ciclo de renovação no final. Por exemplo, a primeira renovação é |
Data da cobrança do pedido |
String |
Não |
É a data do pedido com base no fuso horário UTC (no formato AAAA-MM-DD). |
Status financeiro |
String |
Não |
|
Valor de financiamento do saldo do Google Play |
String |
Não |
É o valor da transação. |
Moeda de saldo do Google Play | String | Não | KRW Para relatórios de financiamento do saldo do Google Play para coreanos, é sempre o won sul-coreano (KRW). |
Timestamp da cobrança do pedido | Número inteiro | Não | 1480507200
É o carimbo de data/hora UNIX de quando o pedido foi cobrado do usuário. Isso é medido em segundos desde época. |
Inscrições
Respostas à pesquisa de cancelamentoComando
gs://[developer_bucket_id]/subscriptions/cancellations/freeform_[package_name].csv
Formato do arquivo
Campo | Formato | Opcional | Exemplos e observações |
---|---|---|---|
Data de cancelamento | String | Não | 2016-11-30 |
ID de SKU | String | Sim | treasure_chest_for_new_users É um ID exclusivo do produto especificado pelo desenvolvedor. |
País | String | Não | US, CA, etc. |
Resposta | String | Não |
Comandos e formatos de arquivos para relatórios agregados
Estatísticas
InstalaçõesComando
gs://[developer_bucket_id]/stats/installs/installs_[package_name]_yyyyMM_[dimension].csv
Formato do arquivo
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 compatível) | String | SIM | hammerhead |
Instalações presentes no dispositivo | Número inteiro | NÃO | |
Instalações em dispositivos ativos | Número inteiro | NÃO | |
Instalações diárias no dispositivo | Número inteiro | NÃO | |
Desinstalações diárias no dispositivo | Número inteiro | NÃO | |
Upgrades diários no dispositivo | Número inteiro | NÃO | |
Instalações atuais do usuário | Número inteiro | NÃO | |
Instalações totais do usuário | Número inteiro | NÃO | |
Instalações diárias do usuário | Número inteiro | NÃO | |
Desinstalações diárias do usuário | Número inteiro | NÃO |
Dimensões compatíveis
Dimensão | Nome do arquivo |
---|---|
Código da versão do app | ..._app_version.csv |
Operadora | ..._carrier.csv |
País | ..._country.csv |
Dispositivo | ..._device.csv |
Idioma | ..._language.csv |
Versão do SO Android | ..._os_version.csv |
Exemplo
Se você quiser fazer o download de todos os relatórios gerados em 2014 com base no ID do bucket de relatório pubsite_prod_rev_0123456789
do seu app com o nome do pacote "com.example.app", o comando será:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/installs/installs_com.example.app_2014* /your/local/directory
Observação: desde janeiro de 2018, as exportações incluem dados da nova origem de dados e correspondem às informações da página Estatísticas do app. As exportações anteriores a janeiro de 2018 só estarão disponíveis para coletas da fonte de dados anterior.
Comando
gs://[developer_bucket_id]/stats/crashes/crashes_[package_name]_yyyyMM_[dimension].csv
Formato do arquivo
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 compatível) | 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 arquivo |
---|---|
Código da versão do app | ..._app_version.csv |
Dispositivo | ..._device.csv |
Versão do SO Android | ..._os_version.csv |
Exemplo
Se você quiser fazer o download de todos os relatórios gerados em 2014 com base no ID do bucket de relatório pubsite_prod_rev_0123456789
do seu app com o nome do pacote "com.example.app", o comando será:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/crashes/crashes_com.example.app_2014* /your/local/directory
Comando
gs://[developer_bucket_id]/stats/ratings/ratings_[package_name]_yyyyMM_[dimension].csv
Formato do arquivo
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 compatível) | String | SIM | hammerhead |
Nota média diária | %.2f | SIM | |
Nota média total | %.2f | Sim | 4.16 |
Dimensões compatíveis
Dimensão | Nome do arquivo |
---|---|
Código da versão do app | ..._app_version.csv |
Operadora | ..._carrier.csv |
País | ..._country.csv |
Dispositivo | ..._device.csv |
Idioma | ..._language.csv |
Versão do SO Android | ..._os_version.csv |
Exemplo
Se você quiser fazer o download de todos os relatórios gerados em 2014 com base no ID do bucket de relatório pubsite_prod_rev_0123456789
do seu app com o nome do pacote "com.example.app", o comando será:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/ratings/ratings_com.example.app_2014* /your/local/directory
Comando
gs://[developer_bucket_id]/financial-stats/subscriptions/subscriptions_[package_name]_[product_id]_yyyyMM_[dimension].csv
Formato do arquivo
Campo | Formato | Opcional | Exemplos e observações |
---|---|---|---|
Data | AAAA-MM-DD | NÃO |
É a data do pedido 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 |
|
Novas assinaturas | Número | NÃO | 1234 |
Assinaturas canceladas | Número | NÃO | 1234 |
Assinaturas ativas | Número | NÃO | 1234 |
ID do plano básico | String | NÃO | weekly |
ID da oferta | String | NÃO | spring-offer |
Observação: para saber mais sobre estatísticas de assinaturas novas, ativas ou canceladas, consulte o artigo Analisar os dados de receita e de compradores do app.
Dimensões compatíveis
Dimensão | Nome do arquivo |
---|---|
País | ..._country.csv |
Aquisição de usuários
Os relatórios de instalações retidas e de compradores fornecem acesso programático aos dados do antigo relatório de aquisição. Essa exportação foi substituída por uma nova exportação programática, que inclui dados das páginas Análise da loja e Análises de conversão no Play Console. Ela foi disponibilizada em março de 2021.
Os relatórios antigos foram removidos em outubro de 2021.
Leia Como posso fazer o download dos dados de aquisição? para saber mais.
Observação: desde novembro de 2019, o relatório Assinantes não é mais compatível. Para saber mais, leia sobre as origens e métricas de aquisição.
Instalações retidas (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 do arquivo
Campo | Formato | Opcional | Exemplos e observações |
---|---|---|---|
Data | AAAA-mm-dd | NÃO |
Data em que o usuário acessou a página "Detalhes do app" Observação: adicionar visitantes únicos da página "Detalhes do app" durante vários dias gera um número de visitantes maior do que o visualizado na coorte a cada semana ou mês. As visualizações de coorte semanais e mensais contam cada visitante uma só vez, mesmo que este acesse os Detalhes várias vezes. |
Canal de aquisição | String | SIM |
Presente com a dimensão "Canal de aquisição" Observação: o canal "Play Store (orgânico)" é a soma da "pesquisa da Play Store (orgânica)" e da "navegação da Play Store (orgânica)". Para evitar a contagem dupla de visitantes neste relatório, ignore a linha total "Play Store (orgânico)" ou as linhas de pesquisa e navegação. |
País | String | SIM | Presente com as dimensões "País" e "País (orgânico da Play Store)" |
Campanha/origem de UTM | String | SIM |
Presente com a dimensão "Canais rastreados (UTM)" |
Palavra-chave | String | SIM |
Presente com a dimensão "pesquisa da Play Store (orgânica)" |
Visitantes da página "Detalhes do app" | Número inteiro | NÃO | |
Instaladores | Número inteiro | NÃO | |
Taxa de conversão de visitante para instalador | Decimal | NÃO | |
Comparativo de mercado mediano da taxa de conversão de visitante para instalador | Decimal | SIM |
Não é preenchido desde agosto de 2019. Os comparativos de mercado atualizados, que usam um novo cálculo, estão disponíveis na página "Relatórios de aquisição". Para saber mais, leia Comparação da taxa de conversão de apps semelhantes para o tráfego da Play Store. |
Instalações retidas por 1 dia | Número inteiro | NÃO | |
Taxa de retenção do instalador para 1 dia | Decimal | NÃO | |
Instaladores retidos por 7 dias | Número inteiro | NÃO | |
Taxa de retenção do instalador para 7 dias | Decimal | NÃO | |
Instaladores retidos por 15 dias | Número inteiro | NÃO | |
Taxa de retenção do instalador para 15 dias | Decimal | NÃO | |
Instaladores retidos por 30 dias | Número inteiro | NÃO | |
Taxa de retenção do instalador para 30 dias | Decimal | NÃO |
Dimensões compatíveis
Dimensão | Nome do arquivo |
---|---|
Canal de aquisição * | ..._channel.csv |
País | ..._country.csv |
País (orgânico da Play Store) | ..._play_country.csv |
Pesquisa da Play Store (orgânica) | ..._play_search.csv |
Canais rastreados (UTM) | ..._utm_tagged.csv |
* Observação: o canal "Play Store (orgânico)" é a soma da "pesquisa da Play Store (orgânica)" e da "navegação da Play Store (orgânica)". Para evitar a contagem dupla de visitantes neste relatório, ignore a linha total "Play Store (orgânico)" ou as linhas de pesquisa e navegação.
A dimensão da Pesquisa Google (orgânica) não está mais disponível desde junho de 2019.
Nomes dos arquivos CSV
Cada arquivo CSV disponível contém dados de um mês e detalhamento. Os CSVs recebem nomes estruturados que refletem o ano, o mês e o detalhamento do relatório que eles cobrem, de acordo com o seguinte padrão:
Formato do nome do arquivo: store_performance_[package_name]_[yyyyMM]_[breakdown].csv
Observações:
- O nome do pacote será incluído no nome do arquivo no estado em que se encontrar, incluindo caracteres especiais, se estiverem 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 do arquivo
Campo | Formato | Opcional | Exemplo | Descrição |
---|---|---|---|---|
Data | AAAA-mm-dd | NÃO | 2021-01-01 |
Data em que o usuário acessou a página "Detalhes do app" |
Nome do pacote | String | NÃO | com.example.app |
É o nome do pacote que contém os dados do relatório. |
País/região | String | NÃO | UK |
É o país ou a região em que a Conta do Google do usuário está registrada. |
Origem do tráfego | String | NÃO | Google Play search |
É como os usuários acessam a página "Detalhes do app":
Observação: poderá ser |
Termo de pesquisa | String | SIM | app store |
É o termo pesquisado pelo usuário antes de acessar a página "Detalhes do app". Disponível somente na pesquisa do Google Play. Observação: poderá ser |
Origem do UTM (monitor de tráfego do Urchin) | String | SIM | google |
É o valor do parâmetro de URL utm_source nos links diretos para a página "Detalhes do app". Disponível somente para indicações de terceiros. Observação: poderá ser |
Campanha do UTM (monitor de tráfego do Urchin) | String | SIM | campanha |
É o valor do parâmetro de URL utm_campaign nos links diretos para a página "Detalhes do app". Disponível somente para indicações de terceiros. Observação: poderá serOther se esse valor não atingir certos limites mínimos. |
Aquisições da página "Detalhes do app" | Número inteiro | NÃO | 10 |
É o número de usuários que visitaram a página "Detalhes do app" e o instalaram, mas ainda não tinham feito isso em nenhum outro dispositivo. |
Visitantes da página "Detalhes do app" | Número inteiro | NÃO | 100 |
É o número de usuários que visitaram a página "Detalhes do app" e ainda não o tinham instalado em nenhum dispositivo. |
Taxa de conversão da página "Detalhes do app" | Decimal | NÃO | 0.1 |
É a porcentagem de visitantes da página "Detalhes do app" que instalaram o app. Observação: não inclui visitas nem instalações de usuários que já instalaram o app em outro dispositivo. |
Estrutura de detalhamento disponível
Os seguintes detalhamentos estão disponíveis:
Nome do detalhamento | Campos em cada CSV (em ordem): |
---|---|
Exemplo de nome do arquivo:
|
Data, nome do pacote, país, aquisições da página "Detalhes do app", visitantes da página "Detalhes do app" e taxa de conversão da página "Detalhes do app" |
Exemplo de nome do arquivo:
|
Data, nome do pacote, origem do tráfego, termo de pesquisa, origem do UTM, campanha do UTM, aquisições da página "Detalhes do app", visitantes da página "Detalhes do app" e taxa de conversão da página "Detalhes do app" |
Esquema de escape
- Use duas aspas duplas. (
"
->""
) - Se uma célula tiver guias, quebras de linhas, aspas duplas ou vírgulas, coloque-a entre aspas duplas. (
...
->"..."
)
Exemplo
Se você quiser fazer o download de todos os relatórios gerados em 2020 com base no ID do bucket de relatório pubsite_prod_0123456789
do seu app com o nome do pacote com.example.app
, o comando será:
gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /your/local/directory
Comando
gs://[developer_bucket_id]/acquisition/buyers_7d/buyers_7d_[package_name]_yyyyMM_[dimension].csv
Formato do arquivo
Campo | Formato | Opcional | Exemplos e observações |
---|---|---|---|
Data | AAAA-mm-dd | NÃO |
Data em que o usuário acessou a página "Detalhes do app" Observação: adicionar visitantes únicos da página "Detalhes do app" durante vários dias gera um número de visitantes maior do que o visualizado na coorte a cada semana ou mês. As visualizações de coorte semanais e mensais contam cada visitante uma só vez, mesmo que este acesse os Detalhes várias vezes. |
Canal de aquisição | String | SIM |
Presente com a dimensão "Canal de aquisição" Observação: o canal "Play Store (orgânico)" é a soma da "pesquisa da Play Store (orgânica)" e da "navegação da Play Store (orgânica)". Para evitar a contagem dupla de visitantes neste relatório, ignore a linha total "Play Store (orgânico)" ou as linhas de pesquisa e navegação. |
País | String | SIM | Presente com as dimensões "País" e "País (orgânico da Play Store)" |
Campanha/origem de UTM | String | SIM | Presente com a dimensão "Canais rastreados (UTM)" |
Palavra-chave | String | SIM |
Presente com a dimensão "pesquisa da Play Store (orgânica)" |
Visitantes da página "Detalhes do app" | Número inteiro | NÃO | |
Instaladores | Número inteiro | NÃO | |
Taxa de conversão de visitante para instalador | Decimal | NÃO | |
Comparativo de mercado mediano da taxa de conversão de visitante para instalador | Decimal | SIM |
Não é preenchido desde agosto de 2019. Os comparativos de mercado atualizados, que usam um novo cálculo, estão disponíveis na página "Relatórios de aquisição". Para saber mais, leia Comparação da taxa de conversão de apps semelhantes para o tráfego da Play Store. |
Compradores | Número inteiro | NÃO | |
Taxa de conversão de instalador para comprador | Decimal | NÃO | |
Compradores recorrentes | Número inteiro | NÃO | |
Taxa de conversão de instalador para comprador recorrente | 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 arquivo |
---|---|
Canal de aquisição * | ..._channel.csv |
País |
..._country.csv |
País (orgânico da Play Store) |
..._play_country.csv |
Pesquisa da Play Store (orgânica) | ..._play_search.csv |
Canais rastreados (UTM) | ..._utm_tagged.csv |
* Observação: o canal "Play Store (orgânico)" é a soma da "pesquisa da Play Store (orgânica)" e da "navegação da Play Store (orgânica)". Para evitar a contagem dupla de visitantes neste relatório, ignore a linha total "Play Store (orgânico)" ou as linhas de pesquisa e navegação.
A dimensão da Pesquisa Google (orgânica) não está mais disponível desde junho de 2019.