Relatórios do Customer Insights

Fornecemos um relatório de estatísticas dos clientes diário e mensal, que inclui informações sobre quem são os seus clientes e como estão a usar o seu software. Para aceder ao relatório de estatísticas do cliente, visite o destino ou o conjunto de dados do BigQuery que especificou quando configurou a receção de relatórios.

Quando um cliente configura a respetiva conta do Cloud Billing, escolhe se é uma conta empresarial ou uma conta pessoal. Excluímos as informações de identificação do relatório de estatísticas do cliente para as contas que o cliente identificou como contas pessoais. Para essas contas, vê n/a nas colunas.

Frequência dos relatórios

Os relatórios diários são gerados com um atraso de dois dias, com base na Hora do Pacífico (PT). Por exemplo, o relatório de 1 de junho é gerado a 3 de junho. O relatório mensal é gerado no segundo dia do mês seguinte.

Relatórios de estatísticas incrementais dos clientes

Opcionalmente, pode ativar os relatórios de estatísticas incrementais dos clientes para receber versões mais detalhadas dos relatórios de estatísticas dos clientes no destino que configurou. Os relatórios de estatísticas incrementais dos clientes contêm todas as mesmas informações que os relatórios de estatísticas dos clientes, bem como qualquer utilização de datas anteriores que não tenha sido incluída nos relatórios anteriores. Pode deparar-se com esta situação se comunicar o uso à Google com atraso ou se existirem problemas com os processos de faturação internos da Google que atrasam os relatórios.

Recomendamos vivamente que ative os relatórios de estatísticas incrementais dos clientes, porque oferecem uma imagem mais precisa da utilização por parte dos clientes do que os relatórios de estatísticas dos clientes não incrementais e ajudam na conciliação da utilização comunicada com os relatórios de desembolsos mensais.

Ative os relatórios de estatísticas incrementais de clientes

Se ativou a exportação do BigQuery, ativou os relatórios de estatísticas incrementais de clientes e não tem de realizar nenhuma ação adicional.

Para ativar os relatórios de estatísticas incrementais de clientes na exportação CSV, conclua os seguintes passos:

  1. No Producer Portal, aceda à página Relatórios.

  2. Em Configurar relatórios, selecione o destino do relatório para o qual quer ativar os relatórios de estatísticas incrementais de clientes.

  3. Em Relatórios a exportar, selecione a caixa de verificação Estatísticas incrementais dos clientes.

Compreenda os relatórios de estatísticas incrementais dos clientes

O exemplo seguinte mostra como o Cloud Marketplace processa a utilização que comunica tardiamente, depois de ativar os relatórios de estatísticas incrementais dos clientes:

  1. A 1 de janeiro de 2023, o seu cliente usa o seu produto, mas não comunica toda ou parte da respetiva utilização.

  2. A 3 de janeiro de 2023, o Cloud Marketplace gera um relatório de estatísticas incrementais dos clientes que inclui todos os dados conhecidos para 1 de janeiro de 2023. Uma vez que não comunicou à Google a utilização anterior de 1 de janeiro, o Cloud Marketplace não inclui essa utilização neste relatório.

  3. A 10 de janeiro de 2023, comunica a utilização de 1 de janeiro de 2023 que não tinha comunicado anteriormente.

Neste exemplo, o relatório denominado 2023-01-09 Incremental Daily Insights na exportação CSV ou na tabela do BigQuery marketplace_report.incremental_insights com _PARTITIONDATE como 2023-01-09, tem uma coluna etiquetada como date. Uma linha tem um valor de 2023-01-01 para date e as restantes linhas têm um valor de 2023-01-09 para date. Também vê uma nova coluna etiquetada como report_date, que tem um valor de 2023-01-09 para todas as linhas, o que indica que este relatório se destina a 9 de janeiro de 2023. Consoante a forma como usa os dados dos relatórios, pode querer atualizar as suas integrações para ter em conta o novo campo report_date.

Para acompanhar toda a utilização dos seus produtos por um cliente durante um dia ou um mês específico, pode ter de combinar as linhas desse dia ou mês de vários relatórios de estatísticas incrementais de clientes.

Para relatórios de estatísticas mensais incrementais, como os dados de utilização de junho de 2025, as convenções de nomenclatura variam consoante o tipo de exportação. Numa exportação CSV, o ficheiro tem o nome 2025-06-01 Incremental Monthly Insights. Numa exportação do BigQuery, os dados encontram-se na tabela marketplace_report.incremental_monthly_insights com _PARTITIONDATE como 2025-07-01.

Campos do relatório

O relatório de vendas contém as seguintes informações a partir de 13 de julho de 2018:

Campo Descrição
report_date(apenas para o relatório de estatísticas incrementais dos clientes) A data/mês principal para a qual o relatório foi gerado, na hora do Pacífico dos EUA e do Canadá (o relatório foi gerado alguns dias após esta data). Este campo é apresentado depois de ativar os relatórios de estatísticas incrementais de clientes. Cada relatório tem apenas um valor para este campo, que pode ser diferente da data em que a utilização ocorreu. Se importou o relatório para uma base de dados, pode usar esta opção para encontrar todas as linhas de um relatório específico.
date A data/mês em que a utilização ocorreu, na Hora do Pacífico dos EUA e do Canadá. Se ativou os relatórios de estatísticas incrementais de clientes, esta data pode corresponder à data de report_date ou pode ser mais antiga, se a utilização tiver sido comunicada com atraso.
company O nome da empresa do cliente. Para transações que envolvam fornecedores que revendem produtos do Cloud Marketplace, este é o nome do fornecedor que revende os produtos ao cliente. Se o cliente estiver a usar uma conta pessoal, o nome da empresa é excluído do relatório.
domain O valor do campo website para esta conta no sistema de CRM da Google. Para transações que envolvam fornecedores que revendem produtos do Cloud Marketplace, este é o domínio associado à conta do fornecedor de revenda. Se o cliente estiver a usar uma conta pessoal, excluímos o domínio do relatório.
external_account_id O ID da conta do Insights, gerado para a conta de faturação do Google Cloud associada ao projeto do cliente. Este campo está presente para todos os clientes, mesmo os que têm contas pessoais. Pode usá-lo para acompanhar a receita do cliente ao longo do tempo, a conversão de gratuito para pago e a rotatividade de clientes.
account_id A conta do Cloud Billing associada ao cliente. Se o cliente estiver a usar uma conta pessoal, o ID da conta é excluído do relatório.
country O país do cliente.
state_or_province O estado ou a província do cliente, se aplicável.
postal_code O código postal do cliente, se aplicável. Se o cliente estiver a usar uma conta pessoal, o código postal é excluído do relatório.
sku_id O SKU pelo qual foi feita uma cobrança ao cliente. Consoante a forma como um produto está configurado, uma única implementação pode ter vários IDs de SKU. Por exemplo, um SKU pode cobrir o custo da utilização de CPUs na implementação e outro ID do SKU pode cobrir o custo da utilização de RAM.
sku_description A descrição do SKU. Por exemplo, se um cliente implementou um produto do WordPress que cobrava pelo número de núcleos da CPU, a descrição do SKU é semelhante a "Taxa de licenciamento para o WordPress de implementação com um clique (custo da CPU)".
usage A quantidade de recursos usados pelo cliente.
unit A métrica pela qual a utilização é medida, como hora ou gibibyte por hora.
currency A moeda em que recebe os pagamentos.
charges As cobranças faturadas ao cliente durante o período, na sua moeda.
due_vendor O valor que recebe pela utilização. Este valor é calculado como `(charges - trial_use + prepay_credits + postpay_credits) * revenue share`. Adicionamos prepay_credits e postpay_credits porque os respetivos valores são números negativos, quando presentes. Subtraímos trial_use porque o respetivo valor é um número positivo, quando presente.
trial_use Créditos de avaliação, créditos criados por cupões e créditos de testes de produtos consumidos, se aplicável.
num_vms O número de VMs nas quais o cliente implementou o produto.
num_cpus O número de núcleos de vCPU na implementação do cliente. Se o número for uma fração, indica que o cliente escolheu um tipo de máquina de vCPU partilhada.
ram_mb O tamanho da RAM na implementação do cliente.
num_gpus O número de GPUs na implementação do cliente.
gpu_types Uma lista separada por espaços dos tipos de GPUs na implementação do cliente. Por exemplo, o valor "NVIDIA_TESLA_P4 none NVIDIA_TESLA_P100" indica que, pelo menos, uma MV usou uma NVIDIA® Tesla® P4, pelo menos, uma usou uma GPU P100 e, pelo menos, uma MV não tinha GPU. Para ver uma lista das GPUs disponíveis no Compute Engine, consulte o artigo GPUs no Compute Engine.
earliest A data mais antiga (UTC) em que o cliente criou uma MV que estava ativa durante o período do relatório.
latest A data mais recente (UTC) em que o cliente criou uma MV que estava ativa durante o período do relatório.
machine_spec_sum Uma lista separada por espaços de contagens novas e totais por [tipo de máquina](/compute/docs/machine-types). Por exemplo, o valor "F1_MICRO:0/1 G1_SMALL:2/3" indica que foram usadas 1 f1-micro VM e 3 g1-small VMs durante o período atual, das quais 0 f1-micro VMs são novas e 2 g1-small VMs são novas.
quote_id Se gerou receita a partir de uma oferta privada, o ID da oferta está associado ao produto e à conta de faturação da oferta. (As ofertas privadas mais antigas eram conhecidas como orçamentos e mantivemos o nome para a continuidade do processamento de relatórios.)
quote_creator Se gerou receita a partir de uma oferta privada, o endereço de email do criador da oferta.
internal_note Se gerou receita a partir de uma oferta privada, pode adicionar uma nota interna opcional para a oferta. Pode usar notas internas para etiquetar ofertas para processamento adicional, como o acompanhamento da receita e/ou dos dados de utilização que geram. Especifica a nota interna quando cria a oferta.
usage_metric_discount_percent Se a utilização estiver relacionada com uma oferta privada que inclua descontos de métricas para este SKU, este é o percentual de desconto que pode ser aplicado, consoante o modelo de preços da oferta. Este desconto pode aplicar-se a toda a utilização ou apenas à utilização considerada excedente, conforme determinado pelos termos da oferta. Se não existir nenhum desconto ao nível da métrica para este SKU na oferta associada, o valor é NULL.
payment_type Os meios através dos quais vai receber o desembolso: se for old, recebe pagamentos da Google US ou de uma entidade Google regional para a sua conta bancária sediada nos EUA. Se for new, recebe um único pagamento na sua conta bancária local.
withheld Se a conta do Cloud Billing de um Google Cloud cliente for colocada em período de experiência devido à falta de pagamento, a Google retém os desembolsos até que a conta esteja novamente em conformidade. Esta coluna indica o valor que lhe teríamos pago se o tivéssemos cobrado ao cliente. Quando a conta de faturação voltar a estar em conformidade, libertamos os fundos retidos no pagamento seguinte. Se nunca voltar a estar em situação regular, abandonamos os fundos retidos.
released Se a Google tiver retido fundos, esta coluna mostra o total dos fundos que lhe foram libertados porque a conta de faturação do cliente voltou a estar em situação regular.
abandoned Se a Google tiver retido fundos, esta coluna mostra o total dos fundos abandonados porque terminámos a conta de faturação.
probation_start O primeiro dia em que a Google começou a reter fundos, no formato YYYY-MM-DD, na hora do Pacífico dos EUA e do Canadá. Se estivermos a libertar ou a abandonar fundos, isto pode acontecer num mês anterior. Se a conta ainda estiver em período de experiência, este é o primeiro dia do mês atual em que retivemos fundos, mas podemos ter começado a reter fundos antes desta data.
probation_end O último dia em que a Google reteve fundos, no formato YYYY-MM-DD, na hora do Pacífico dos EUA e do Canadá. No dia seguinte, a conta voltou a estar em conformidade ou foi encerrada. Se este campo estiver em branco, significa que a conta ainda está em período de experiência.
start_date O primeiro dia em que a concessão está ativa, no formato YYYY-MM-DD, na hora do Pacífico dos EUA e do Canadá. A data é determinada pela subscrição ou oferta privada associada à concessão. Se a autorização foi criada antes de 2021-01-10, o valor é NULL.
end_date O último dia em que a concessão está ativa, no formato YYYY-MM-DD, na hora do Pacífico dos EUA e do Canadá. A data é determinada pela subscrição ou oferta privada associada à concessão. Se a autorização foi criada antes de 2021-01-10, o valor é NULL.
solution_name O nome do produto pelo qual é feita a cobrança ao cliente.
postpay_credits O valor dos charges que foram cobertos por um crédito de compromisso comprado através de um compromisso pós-pago. Se estiver presente, é um número negativo que reduz o valor de due_vendor, porque reduz o valor usado para calcular o desembolso para si.
marketplace_fee_percent A taxa percentual que o Cloud Marketplace retém como parte do seu contrato de partilha de receita com a Google.
marketplace_fee_amount O valor da taxa que o Cloud Marketplace retém como parte do seu contrato de partilha de receita com a Google.

Informações adicionais para ofertas privadas

Se criou ofertas privadas para clientes específicos, pode ver as seguintes informações adicionais:

Campo Descrição
payment_schedule O tipo de programação de pagamentos da oferta. Pode ter o valor PREPAY, PREPAY_INSTALLMENTS ou POSTPAY.

Nota: para ofertas privadas que usam a frequência de faturação (mensal, trimestral, anual ou personalizada) em vez de programações de pagamento no momento da respetiva criação, este campo está vazio. Para estas ofertas, recomendamos que use a coluna billing_frequency em alternativa.
private_offer_acceptance_date A data em que a oferta privada foi aceite pelo cliente.
private_offer_total_contract_value O valor total que o cliente paga em todas as prestações da oferta privada.
term_total_contract_value O valor total que o cliente paga em todas as prestações do prazo atual da oferta.
order_start_date A data em que os preços da oferta privada entram em vigor.
order_end_date A data em que o preço da oferta privada deixa de estar em vigor.
billing_frequency Descreve o intervalo de faturação recorrente que foi selecionado quando a oferta foi criada. Pode ter o valor monthly, quarterly, yearly, pay_go ou custom.

Nota: para ofertas privadas que usam programações de pagamentos (pré-pagamento ou pós-pagamento) em vez da frequência de faturação (mensal, trimestral, anual ou personalizada) no momento da respetiva criação, isto tem o valor de prepay ou postpay .
installment_count O número de prestações no prazo atual da oferta.
first_installment_date A data de início da primeira prestação do prazo atual da oferta, no formato YYYY-MM-DD.
final_installment_date A data de fim da prestação final do prazo atual da oferta, no formato YYYY-MM-DD.
prepay_credits O valor de charges que foi coberto por um crédito de compromisso comprado através de um compromisso pré-pago. Se estiver presente, é um número negativo que reduz o valor de due_vendor, porque reduz o valor usado para calcular o desembolso para si.
offer_title O texto que introduz no campo Offer Title da oferta privada quando a cria. Esta informação é visível para os seus clientes. Se o cliente tiver comprado várias ofertas privadas para o mesmo produto através da mesma conta de faturação do Google Cloud, pode usar este campo para diferenciar essas ofertas na tabela de ofertas e nos relatórios. Para as ofertas privadas criadas antes de este campo ficar disponível, este campo foi preenchido retroativamente com o nome do produto da oferta.
entitlement_id ID da concessão da oferta associado à compra feita pelo cliente. Se o cliente tiver comprado várias ofertas privadas para o mesmo produto através da mesma conta de faturação do Google Cloud, pode usar este campo para diferenciar essas ofertas na tabela de ofertas e nos relatórios.

Informações adicionais para produtos revendidos

Se ativou a revenda para os seus produtos do Cloud Marketplace, pode ver as seguintes informações adicionais:

Campo Descrição
channel Indica se a utilização é para um produto comprado diretamente a um fornecedor de software independente (ISV) ou através de outra empresa que revende os produtos de um ISV.
reseller_discount O valor do desconto de revendedor configurado pelo ISV.
parent_account_id A conta de faturação associada ao revendedor para esta utilização.
wholesale_charges Para ofertas privadas revendidas (o campo channel tem um valor de RESOLD), isto mostra o valor: charges - reseller_discount.
Para ofertas privadas feitas diretamente aos clientes finais (o campo channel tem um valor de DIRECT), este campo tem o valor NULL.

Informações adicionais para o modelo de transação de agência

Campo Descrição
transaction_type Descreve a relação entre o comprador, o vendedor e a Google para a transação. Pode ter o valor THIRD_PARTY_RESELLER (a Google está a vender os produtos do ISV diretamente) ou THIRD_PARTY_AGENCY (a Google está a atuar como agente do vendedor).