Relatórios do Customer Insights

Disponibilizamos um Relatório de insights do cliente diário e mensal com informações sobre quem são seus clientes e como eles usam seu software.

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

Frequência de relatórios

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

Relatórios de insights incrementais do cliente

Também é possível ativar relatórios de insights incrementais do cliente para conferir versões mais detalhadas deles no destino configurado. Os relatórios de insights incrementais do cliente contêm as mesmas informações que os relatórios de insights do cliente, além de qualquer uso de datas anteriores que não tenha sido incluído nos relatórios anteriores. Isso pode acontecer se você informar o uso ao Google tardiamente ou se houver problemas com os processos internos de faturamento do Google que atrasam a geração de relatórios.

Recomendamos que você ative os relatórios de insights incrementais do cliente, porque eles fornecem uma visão mais precisa do uso dos seus clientes do que os relatórios de insights não incrementais e ajudam a reconciliação do uso informado com os relatórios de pagamentos mensais.

Ativar relatórios de insights incrementais do cliente

Para ativar os relatórios de insights incrementais do cliente, siga estas etapas:

  1. No Portal do Produtor, acesse a página Relatórios.

  2. Em Configurar relatórios, selecione o destino do relatório em que você quer ativar os relatórios de insights incrementais do cliente.

  3. Em Relatórios para exportar, marque a caixa de seleção Insights incrementais do cliente.

Entender os relatórios de insights incrementais do cliente

O exemplo a seguir mostra como o Cloud Marketplace lida com o uso que você informa com atraso, depois de ter ativado os relatórios de insights incrementais do cliente:

  1. Em 1o de janeiro de 2023, um cliente já usou seu produto, mas você não informa todo ou parte dele.

  2. Em 3 de janeiro de 2023, o Cloud Marketplace gera um relatório de insights incrementais do cliente que inclui todos os dados conhecidos de 1o de janeiro de 2023. Como você não informou o uso anterior de 1o de janeiro ao Google, o Cloud Marketplace não inclui esse uso nesse relatório.

  3. Em 10 de janeiro de 2023, você informou o uso de 1o de janeiro de 2023 que não havia informado anteriormente.

Neste exemplo, o relatório chamado 2023-01-09 Incremental Daily Insights tem uma coluna chamada date. Uma linha tem um valor de 2023-01-01 para date, e o restante das linhas tem um valor de 2023-01-09 para date. Você também verá uma nova coluna report_date, que tem o valor 2023-01-09 em todas as linhas, indicando que o relatório se destina a 9 de janeiro de 2023.

Se você quiser rastrear todo o uso dos seus produtos por um cliente em um dia ou mês específico, talvez seja necessário combinar as linhas desse dia ou mês de vários relatórios de insights incrementais do cliente.

Campos do relatório

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

Campo Descrição
report_date(apenas para relatórios de insights incrementais do cliente) A data/mês principal de geração do relatório, no horário do Pacífico dos EUA e do Canadá (o relatório foi gerado alguns dias após essa data). Você vê esse campo depois de ativar os relatórios de insights incrementais do cliente. Cada relatório tem apenas um valor para esse campo, que pode ser diferente da data em que o uso aconteceu. Se você importou seu relatório para um banco de dados, pode usar isso para encontrar todas as linhas de um relatório específico.
date A data/mês em que o uso aconteceu, no horário do Pacífico dos EUA e Canadá. Se você ativou os relatórios de insights incrementais do cliente, essa data pode corresponder a report_date ou estar mais no passado, se o uso tiver sido informado atrasado.
company O nome da empresa do cliente. Se o cliente estiver usando uma conta pessoal, o nome da empresa será excluído do relatório.
domain O domínio em ordem alfabética do conjunto de domínios vinculados à conta pelo sistema de CRM do Google. Se o cliente estiver usando uma conta pessoal, o domínio será excluído do relatório.
external_account_id O ID da conta do Insights, gerado para a conta do Cloud Billing associada ao projeto do cliente. Esse campo está presente para todos os clientes, mesmo aqueles com contas pessoais. Ele pode ser usado para rastrear a receita do cliente ao longo do tempo, a conversão sem custo financeiro e a desistência de usuários.
account_id A conta do Cloud Billing associada ao cliente. Se o cliente estiver usando uma conta pessoal, o ID da conta será 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 usando uma conta pessoal, o código postal será excluído do relatório.
sku_id A SKU de cobrança do cliente. Dependendo de como uma solução é configurada, uma única implantação pode ter vários códigos de SKU. Por exemplo, uma SKU pode cobrir o custo de uso de CPUs na implantação e outro código de SKU pode cobrir o custo de uso de RAM.
sku_description Descrição da SKU. Por exemplo, se um cliente implantou um produto do WordPress cobrado pelo número de núcleos de CPU, a descrição da SKU será semelhante à "Taxa de licenciamento do Click to Deploy Wordpress (custo da CPU)".
usage A quantidade de recursos usados pelo cliente.
unit A métrica em que o uso é medido, como hora ou hora/gibibyte.
currency A moeda em que você recebe o pagamento.
charges As cobranças do cliente durante o período, na sua moeda.
due_vendor O valor recebido pelo uso. Isso é calculado como "(cobranças - trial_use + pré-pagamentos + pós-créditos) * participação na receita". Adicionamos prepay_credits e postpay_credits porque seus valores são números negativos, quando presentes. Subtraímos trial_use porque o valor dele é um número positivo, quando presente.
trial_use Créditos de teste, créditos criados por cupons e créditos de teste de produto consumidos, se aplicável.
num_vms O número de VMs em que o cliente implantou a solução.
num_cpus O número de núcleos de vCPU na implantação do cliente. Se o número for uma fração, ele indica que o cliente escolheu um tipo de máquina de vCPU compartilhada.
ram_mb O tamanho da RAM na implantação do cliente.
num_gpus O número de GPUs na implantação do cliente.
gpu_types Uma lista separada por espaço dos tipos de GPU na implantação do cliente. Por exemplo, o valor "NVIDIA_TESLA_P4 none NVIDIA_TESLA_P100" indica que pelo menos uma VM usou uma NVIDIA® Tesla® P4, pelo menos uma usou uma GPU P100 e pelo menos uma VM não tinha GPU. Para uma lista de GPUs disponíveis no Compute Engine, consulte GPUs no Compute Engine.
earliest A data mais antiga (UTC) em que o cliente criou uma VM que estava ativa durante o período do relatório.
latest A data mais recente (UTC) em que o cliente criou uma VM 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 1 VM f1-micro e 3 VMs g1-small foram usadas durante o período atual, das quais 0 VMs f1-micro são novas e 2 VMs g1-small são novas.
quote_id Se você gerou receita de uma oferta privada, o ID da oferta associado ao produto e à conta de faturamento dela. As ofertas privadas mais antigas eram conhecidas como cotações, e mantivemos o nome para garantir a continuidade do processamento de relatórios.
quote_creator Se você gerou receita de uma oferta particular, insira o endereço de e-mail do criador da oferta.
internal_note Se você gerou receita de uma oferta privada, insira uma observação interna opcional para a oferta. É possível usar notas internas para marcar ofertas para processamento adicional, como rastrear a receita e/ou os dados de uso gerados. Especifique a observação interna ao criar a oferta.
usage_metric_discount_percent Se o uso estiver relacionado a uma oferta privada que inclui descontos por métrica para essa SKU, essa será a porcentagem de desconto que poderá ser aplicada, dependendo do modelo de preços da oferta. Esse desconto pode ser aplicado a todo o uso ou somente ao uso considerado sobrecarregado, conforme determinado pelos termos da oferta. Se não houver desconto no nível da métrica para essa SKU na oferta associada, o valor será NULL.
payment_type O meio pelo qual você receberá o pagamento: se for old, você receberá pagamentos do Google nos EUA ou de uma entidade regional do Google na sua conta bancária nos EUA. Se for new, você receberá um único pagamento em sua conta bancária local.
withheld Se a conta do Cloud Billing de um cliente do Google Cloud for colocada em teste por falta de pagamento, o Google reterá os pagamentos até que a conta volte à situação regular. Essa coluna informa quanto pagaríamos se coletássemos dados do cliente. Quando a conta de faturamento estiver em situação regular, liberaremos os fundos retidos no próximo pagamento. Se a situação nunca voltar à situação regular, abandonaremos os fundos retidos.
released Se o Google reteve fundos, essa coluna mostra o total de fundos que agora estão liberados porque a conta de faturamento do cliente está em situação regular.
abandoned Se o Google reteve fundos, essa coluna mostra o total de fundos abandonados porque a conta de faturamento foi encerrada.
probation_start No primeiro dia em que o Google começou a reter fundos, no formato YYYY-MM-DD, no Horário do Pacífico dos EUA e do Canadá. Se estivermos liberando ou abandonando fundos, pode ser no mês anterior. Se a conta ainda está em teste, este é o primeiro dia do mês atual em que retemos os fundos, mas é possível que tenhamos começado a reter antes disso.
probation_end O último dia em que o Google reteve fundos, no formato YYYY-MM-DD, no horário do Pacífico dos EUA e do Canadá. No dia seguinte, a conta voltou à situação regular ou a encerramos. Se esse valor estiver em branco, a conta ainda está em teste.
start_date O primeiro dia em que o direito vai ficar ativo, no formato YYYY-MM-DD, no Horário do Pacífico dos EUA e do Canadá. A data é determinada pela assinatura ou oferta privada associada ao direito. Se o direito tiver sido criado antes de 2021-01-10, o valor será NULL.
end_date O último dia em que o direito está ativo, no formato YYYY-MM-DD, no Horário do Pacífico dos EUA e Canadá. A data é determinada pela assinatura ou oferta privada associada ao direito. Se o direito tiver sido criado antes de 2021-01-10, o valor será NULL.
solution_name O nome do produto pelo qual o cliente é cobrado.
postpay_credits O valor de charges que foi coberto por um crédito de compromisso comprado por meio 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 pagamento para você.

Informações adicionais sobre ofertas privadas

Se você tiver criado ofertas privadas para clientes específicos, poderá ver as seguintes informações adicionais:

Campo Descrição
payment_schedule Tipo de calendário de pagamentos da oferta. Pode ter o valor PREPAY, PREPAY_INSTALLMENTS ou POSTPAY.

Observação:para ofertas privadas que usam a frequência de faturamento (mensal, trimestral, anual ou personalizada) em vez de calendários de pagamento no momento da criação, esse campo está vazio. Para essas ofertas, recomendamos o uso da coluna billing_frequency.
private_offer_acceptance_date A data em que a oferta privada foi aceita pelo cliente.
private_offer_total_contract_value O valor total que o cliente paga em todas as parcelas da oferta privada.
term_total_contract_value O valor total que o cliente paga em todas as parcelas 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 não estará mais em vigor.
billing_frequency Descreve o intervalo de faturamento recorrente que foi selecionado quando a oferta foi criada. Pode ter o valor monthly, quarterly, yearly, pay_go ou custom.

Observação:no momento da criação das ofertas privadas que usam calendários de pagamento (pré-pagamento ou pós-pagamento) em vez da frequência de faturamento (mensal, trimestral, anual ou personalizado), elas terão o valor de prepay ou postpay .
installment_count O número de parcelas no prazo atual da oferta.
first_installment_date A data de início da primeira parcela do prazo atual da oferta, no formato YYYY-MM-DD.
final_installment_date A data de término da parcela final do prazo atual da oferta, no formato YYYY-MM-DD.
prepay_credits O valor de charges que estava coberto por um crédito de compromisso comprado em 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 pagamento para você.

Informações adicionais sobre produtos revendidos

Se você tiver ativado a revenda dos seus produtos do Cloud Marketplace, poderá ver as seguintes informações adicionais:

Campo Descrição
channel Indica se o uso é para um produto comprado diretamente de um fornecedor independente de software (ISV) ou por meio de outra empresa que revenda produtos de um ISV.
reseller_discount O valor do desconto para revendedores configurado pelo ISV.
parent_account_id A conta de faturamento associada ao revendedor para esse uso.

Outras informações para o modelo de transação da agência

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