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

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

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 Í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: accountName@project.iam.gserviceaccount.com

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

  1. Abra a Play Console.
  2. Selecione Definições 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. 
  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 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

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.

A informação foi útil?

Como podemos melhorá-la?

Precisa de mais ajuda?

Experimente estes passos seguintes:

Contacte-nos Forneça-nos mais informações e iremos ajudá-lo a encontrar o que procura.
true
Pesquisa
Limpar pesquisa
Fechar pesquisa
Menu principal
5773129037813574529
true
Pesquisar no Centro de ajuda
true
true
true
true
true
92637
false
false