Google Play Store

Adicionando a fonte de dados

Adicionando o conector

Adicionando o conector da Google Play Store na Kondado, você pode ter acesso aos dados dos seus aplicativos da Play Store diretamente no seu Data Warehouse ou Data Lake - processo também conhecido como ETL ou ELT

Para adicionar o conector, você deverá possuir um usuário que tem acesso ao console do Google Play e aos seus relatórios

1) Faça login no console do google play: https://play.google.com/console

2) Uma vez logado, vá para a sessão de "Download reports" no menu à esquerda e selecione qualquer categoria de relatórios

3) Na página de download de relatórios, clique no botão "Copy Cloud Storage URI" e cole o valor em um bloco de anotações

4) Agora faça login na Kondado, vá para a seção de adicionar conectores e selecione o conector do Google Play Store e clique em AUTORIZAR

5) Selecione a conta que irá utilizar

ATENÇÃO: Certifique-se que você selecionou a conta do google com acesso ao console do google play e acesso ao bucket do Google Cloud Storage copiado no passo 3

6) Na próxima tela, marque TODAS as permissões que são requisitadas e clique em Continue

7) Com o acesso autorizado, dê um nome ao seu conector, preencha o bucket obtido no passo (3) e clique em SALVAR

Pipelines

Resumo

Diagrama de relacionamento

Clique para expandir

Crashes

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual mês os dados serão lidos
  • Detalhamento: Escolha o detalhamento que deseja obter no relatório

Relatório de estatísticas de estabilidade da Google Play, agregado por dia e pela dimensão escolhida, com contagens diárias de falhas (crashes) e de erros ANR.

Campo Tipo

_kdd_report_file

text

[pt] Identificador interno do Kondado: nome do arquivo de relatório (CSV) de origem no bucket do Google Play do qual esta linha foi extraída. Usado como chave para evitar duplicidade.

dimension

text

[pt] Valor da dimensão pela qual o relatório está segmentado (versão do app, dispositivo ou versão do Android, conforme a dimensão escolhida no pipeline).

date

date

[pt] Data (UTC) a que as métricas agregadas desta linha se referem, na granularidade diária.

package_name

text

[pt] Nome do pacote (application ID) do app na Google Play Store, ex.: com.empresa.app.

daily_crashes

float

[pt] Número de falhas (crashes) do app registradas no dia.

daily_anrs

float

[pt] Número de erros ANR (Application Not Responding) do app registrados no dia.

Earnings

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual mês os dados serão lidos

Relatório de ganhos (Earnings) da Google Play: uma linha por tipo de movimentação financeira (cobrança, taxa do Google, imposto, reembolso, ajuste), com valores na moeda do comprador e na moeda do desenvolvedor.

Campo Tipo

_kdd_report_file

text

[pt] Identificador interno do Kondado: nome do arquivo de relatório (CSV) de origem no bucket do Google Play do qual esta linha foi extraída. Usado como chave para evitar duplicidade.

merchant_currency

text

[pt] Código da moeda (ISO) em que o desenvolvedor (merchant) recebe o pagamento.

hardware

text

[pt] Modelo do dispositivo Android usado na compra (para assinaturas, o da compra original).

product_type

float

[pt] Tipo de produto da transação (ex.: produto in-app gerenciado ou assinatura).

transaction_date

date

[pt] Data (UTC) em que a transação ocorreu.

description

text

[pt] Descrição da transação/produto associada à linha de ganhos.

product_title

text

[pt] Nome/título do produto (app pago, produto in-app ou assinatura).

refund_type

text

[pt] Tipo de reembolso quando a linha representa um estorno (ex.: total, parcial).

product_id

text

[pt] Identificador do app ou produto: package name do app ou ID do produto in-app/assinatura.

amount_merchant_currency

float

[pt] Valor da linha de transação na moeda do desenvolvedor (merchant), já convertido.

transaction_type

text

[pt] Tipo da transação (ex.: Charge, Google fee, Tax, Charge refund, Adjustment).

sku_id

text

[pt] SKU (identificador) do produto in-app ou plano de assinatura.

buyer_country

text

[pt] Código do país (ISO) do comprador.

buyer_postal_code

text

[pt] CEP/código postal do comprador.

buyer_state

text

[pt] Estado/região do comprador.

transaction_time

text

[pt] Hora/timestamp (UTC) em que a transação ocorreu.

buyer_currency

text

[pt] Código da moeda (ISO) em que o comprador efetuou o pagamento.

tax_type

text

[pt] Tipo de imposto aplicado à linha (ex.: imposto de terceiros); em branco para linhas não tributárias.

currency_conversion_rate

float

[pt] Taxa de conversão usada para converter o valor da moeda do comprador para a moeda do desenvolvedor.

amount_buyer_currency

float

[pt] Valor da linha de transação na moeda do comprador, antes da conversão.

Estimated sales

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual mês os dados serão lidos

Relatório de vendas estimadas (Estimated Sales) da Google Play: uma linha por transação de compra de app pago, produto in-app ou assinatura, com valores antes de impostos e taxas do Google.

Campo Tipo

_kdd_report_file

text

[pt] Identificador interno do Kondado: nome do arquivo de relatório (CSV) de origem no bucket do Google Play do qual esta linha foi extraída. Usado como chave para evitar duplicidade.

state_of_buyer

text

[pt] Estado/região do endereço de cobrança do comprador.

city_of_buyer

text

[pt] Cidade do endereço de cobrança do comprador.

country_of_buyer

text

[pt] Código do país (ISO) do endereço de cobrança do comprador.

device_model

text

[pt] Modelo do dispositivo usado para realizar a compra.

product_title

text

[pt] Nome/título do produto (app pago, produto in-app ou assinatura).

item_price

float

[pt] Preço unitário de tabela do item na moeda da venda, antes de impostos e taxas.

product_id

text

[pt] Identificador do app ou produto: package name do app ou ID do produto in-app/assinatura.

order_charged_date_utc

date

[pt] Data (UTC) em que a transação foi cobrada do comprador.

taxes_collected

float

[pt] Valor de impostos recolhidos na transação, na moeda da venda.

sku_id

text

[pt] SKU (identificador) do produto in-app ou plano de assinatura.

financial_status

text

[pt] Situação financeira da transação (ex.: Charged, Refund, Chargeback).

postal_code_of_buyer

text

[pt] CEP/código postal do endereço de cobrança do comprador.

order_charged_timestamp

float

[pt] Timestamp (epoch) do momento em que a transação foi cobrada.

product_type

text

[pt] Tipo de produto da transação (ex.: 1 = produto in-app gerenciado, 2 = assinatura).

currency_of_sale

text

[pt] Código da moeda (ISO) em que a venda foi realizada.

charged amount

float

[pt] Valor total cobrado do comprador na transação, na moeda da venda.

order_number

text

[pt] Número/identificador único do pedido na Google Play.

base_plan_id

text

[pt] Identificador do plano base (base plan) da assinatura, quando aplicável.

offer_id

text

[pt] Identificador da oferta (offer) aplicada à assinatura, quando aplicável.

Installs

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual mês os dados serão lidos
  • Detalhamento: Escolha o detalhamento que deseja obter no relatório

Relatório de estatísticas de instalações da Google Play, agregado por dia e pela dimensão escolhida, com métricas de instalações, desinstalações e atualizações nos níveis de usuário e de dispositivo.

Campo Tipo

_kdd_report_file

text

[pt] Identificador interno do Kondado: nome do arquivo de relatório (CSV) de origem no bucket do Google Play do qual esta linha foi extraída. Usado como chave para evitar duplicidade.

dimension

text

[pt] Valor da dimensão pela qual o relatório está segmentado (ex.: país, dispositivo, versão do app, idioma, operadora ou versão do Android, conforme a dimensão escolhida no pipeline).

date

date

[pt] Data (UTC) a que as métricas agregadas desta linha se referem, na granularidade diária.

package_name

text

[pt] Nome do pacote (application ID) do app na Google Play Store, ex.: com.empresa.app.

daily_user_installs

float

[pt] Número de novos usuários únicos que instalaram o app no dia (nível de usuário).

daily_device_upgrades

float

[pt] Número de dispositivos que atualizaram o app para uma nova versão no dia.

daily_device_installs

float

[pt] Número de instalações do app em dispositivos no dia, incluindo novas instalações e reinstalações (nível de dispositivo).

total_user_installs

float

[pt] Total acumulado de usuários únicos que possuem o app instalado até a data.

uninstall_events

float

[pt] Número de eventos de desinstalação registrados no dia.

daily_device_uninstalls

float

[pt] Número de dispositivos que desinstalaram o app no dia (nível de dispositivo).

install_events

float

[pt] Número de eventos de instalação registrados no dia.

update_events

float

[pt] Número de eventos de atualização do app registrados no dia.

daily_user_uninstalls

float

[pt] Número de usuários únicos que desinstalaram o app no dia (nível de usuário).

active_device_installs

float

[pt] Número de dispositivos ativos (usados ao menos uma vez nos últimos 30 dias) com o app instalado.

Ratings

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual mês os dados serão lidos
  • Detalhamento: Escolha o detalhamento que deseja obter no relatório

Relatório de estatísticas de avaliações da Google Play, agregado por dia e pela dimensão escolhida, com a média diária e a média acumulada das notas em estrelas.

Campo Tipo

_kdd_report_file

text

[pt] Identificador interno do Kondado: nome do arquivo de relatório (CSV) de origem no bucket do Google Play do qual esta linha foi extraída. Usado como chave para evitar duplicidade.

dimension

text

[pt] Valor da dimensão pela qual o relatório está segmentado (ex.: país, dispositivo, versão do app, idioma, operadora ou versão do Android, conforme a dimensão escolhida no pipeline).

date

date

[pt] Data (UTC) a que as métricas agregadas desta linha se referem, na granularidade diária.

package_name

text

[pt] Nome do pacote (application ID) do app na Google Play Store, ex.: com.empresa.app.

daily_average_rating

float

[pt] Média das notas em estrelas recebidas no dia (1 a 5).

total_average_rating

float

[pt] Média acumulada de todas as notas em estrelas até a data (1 a 5).

Reviews

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual mês os dados serão lidos

Avaliações (reviews) públicas do app na Google Play Store, com nota em estrelas, texto do usuário e resposta do desenvolvedor. Uma linha por avaliação.

Campo Tipo

_kdd_report_file

text

[pt] Identificador interno do Kondado: nome do arquivo de relatório (CSV) de origem no bucket do Google Play do qual esta linha foi extraída. Usado como chave para evitar duplicidade.

package_name

text

[pt] Nome do pacote (application ID) do app na Google Play Store, ex.: com.empresa.app.

app_version_code

float

[pt] Código numérico da versão (versionCode) do app instalado no dispositivo em que a avaliação foi feita.

app_version_name

text

[pt] Nome/rótulo da versão (versionName) do app instalado no dispositivo no momento da avaliação.

reviewer_language

text

[pt] Código de idioma (ex.: pt_BR) configurado no dispositivo do autor da avaliação.

device

text

[pt] Codinome (codename) do modelo de dispositivo a partir do qual a avaliação foi enviada.

review_submit_date_utc

timestamp

[pt] Data e hora (UTC) em que a avaliação foi enviada originalmente pelo usuário.

review_last_update_date_utc

timestamp

[pt] Data e hora (UTC) da última atualização da avaliação pelo usuário.

star_rating

float

[pt] Nota em estrelas atribuída pelo usuário, de 1 a 5.

review_title

text

[pt] Título da avaliação escrito pelo usuário (pode estar vazio).

review_text

text

[pt] Texto/comentário da avaliação escrito pelo usuário (pode estar vazio).

developer_reply_date_utc

timestamp

[pt] Data e hora (UTC) da resposta do desenvolvedor à avaliação, quando houver.

developer_reply_text

text

[pt] Texto da resposta do desenvolvedor à avaliação, quando houver.

review_link

text

[pt] URL para a avaliação no Google Play Console.

Subscriptions

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual mês os dados serão lidos
  • Detalhamento: Escolha o detalhamento que deseja obter no relatório

Relatório de estatísticas de assinaturas da Google Play, agregado por dia e pela dimensão escolhida, com contagens de assinaturas novas, canceladas e ativas.

Campo Tipo

_kdd_report_file

text

[pt] Identificador interno do Kondado: nome do arquivo de relatório (CSV) de origem no bucket do Google Play do qual esta linha foi extraída. Usado como chave para evitar duplicidade.

dimension

text

[pt] Valor da dimensão pela qual o relatório de assinaturas está segmentado (país ou dispositivo).

date

date

[pt] Data (UTC) a que as métricas agregadas desta linha se referem, na granularidade diária.

package_name

text

[pt] Nome do pacote (application ID) do app na Google Play Store, ex.: com.empresa.app.

product_id

text

[pt] Identificador do produto de assinatura.

new_subscriptions

float

[pt] Número de novas assinaturas adquiridas no dia.

cancelled_subscriptions

float

[pt] Número de assinaturas canceladas no dia.

active_subscriptions

float

[pt] Número de assinaturas ativas na data.

Notas

As integrações utilizam os dados de relatórios mensais agregados pelo Google diariamente, que pode levar até 3 dias para disponibilizar as datas mais recentes.

  • Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas

Integrar dados do Google Play Store na Kondado

Conecte os relatórios de apps da Google Play Store ao seu Data Warehouse ou Data Lake em poucos passos.

1
Acesse o console do Google Play

Faça login no Google Play Console com um usuário que tenha acesso aos relatórios dos seus aplicativos.

2
Copie o URI do Cloud Storage

No menu à esquerda, vá em "Download reports", selecione uma categoria e clique em "Copy Cloud Storage URI". Guarde esse valor para usar no conector.

3
Adicione o conector na Kondado

Acesse a página do conector Google Play Store na Kondado e clique em AUTORIZAR para iniciar a configuração.

4
Autorize com a conta correta

Selecione a conta Google com acesso ao console e ao bucket do Cloud Storage copiado anteriormente. Marque TODAS as permissões solicitadas e clique em Continue.

5
Configure e salve o conector

Dê um nome ao conector, preencha o bucket obtido no passo 2 e clique em SALVAR. Os dados serão integrados ao seu destino escolhido.

Perguntas frequentes

Quais relatórios do Google Play Store posso integrar pela Kondado?
Você pode integrar relatórios de Reviews, Estimated sales, Earnings, Installs, Crashes, Ratings e Subscriptions. Todos esses dados são extraídos dos relatórios mensais agregados pelo Google e enviados para o seu Data Warehouse ou Data Lake.
Por que preciso copiar o Cloud Storage URI do Google Play Console?
O conector Google Play Store usa esse URI para acessar o bucket do Google Cloud Storage onde os relatórios são armazenados. Sem ele, a Kondado não consegue localizar e extrair os dados dos seus aplicativos.
Quanto tempo leva para os dados mais recentes aparecerem na integração?
As integrações utilizam relatórios mensais agregados pelo Google diariamente, e pode levar até 3 dias para que as datas mais recentes estejam disponíveis no bucket do Cloud Storage.
Posso usar os dados do Google Play Store em dashboards e planilhas?
Sim. Após a integração, você pode enviar os dados para diferentes destinos como BI tools, data warehouses ou planilhas, e também consultar as dashboards prontas da Kondado.
É necessário ter acesso ao Google Play Console para configurar o conector?
Sim, você precisa de um usuário com acesso ao console do Google Play e aos relatórios dos seus aplicativos. Além disso, a conta Google selecionada na autorização deve ter acesso ao bucket do Google Cloud Storage copiado no passo de configuração.

Escrito por·Publicado em 2021-02-08·Atualizado em 2026-06-01