Relatórios do Customer Insights

Fornecemos um relatório de insights do cliente diário e mensal, que inclui informações sobre quem são seus clientes e como eles estão usando o software.

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

Frequência do relatório

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

Você também pode ativar os relatórios de insights incrementais do cliente para receber versões mais detalhadas dos relatórios de insights do cliente no destino configurado. Os relatórios de insights incrementais do cliente contêm todas as mesmas informações dos 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 com atraso ou se houver problemas com os processos de faturamento interno do Google que atrasam o envio do relatório.

É altamente recomendável ativar os relatórios de insights incrementais do cliente, porque eles fornecem uma imagem mais precisa do uso dos clientes do que os relatórios de insights não incrementais do cliente e ajudam na reconciliação do uso informado com os relatórios de desembolso 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 de relatórios.

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

  3. Em Relatórios a serem exportados, 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 processa o uso que você informa com atraso, depois de ativar os relatórios de insights incrementais do cliente:

  1. Em 1º de janeiro de 2023, o cliente usa seu produto, mas você não informa todo ou parte do uso 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 1º de janeiro de 2023. Como você não informou o uso anterior de 1º de janeiro ao Google, o Cloud Marketplace não inclui esse uso no relatório.

  3. Em 10 de janeiro de 2023, você informa o uso de 1º de janeiro de 2023 que não havia informado antes.

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 resto das linhas tem um valor de 2023-01-09 para date. Você também vai encontrar uma nova coluna com o nome report_date, que tem um valor de 2023-01-09 para todas as linhas, indicando que o relatório é destinado a 9 de janeiro de 2023.

Se você quiser acompanhar 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 em 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(somente para o Relatório de insights incrementais do cliente) A data/mês principal em que o relatório foi gerado, no horário do Pacífico dos EUA e do Canadá (o relatório foi gerado alguns dias após essa data). Esse campo aparece depois que você ativa 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 ocorreu. Se você importou o relatório para um banco de dados, use essa opção para encontrar todas as linhas de um relatório específico.
date É a data/mês em que o uso ocorreu, no horário do Pacífico dos EUA e do Canadá. Se você tiver ativado os relatórios de insights incrementais do cliente, essa data poderá corresponder à report_date ou ser mais antiga, se o uso tiver sido informado com atraso.
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 primeiro 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. Você pode usá-lo para acompanhar a receita do cliente ao longo do tempo, a conversão de gratuito para pago e a taxa de cancelamento.
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 A descrição da SKU. Por exemplo, se um cliente tiver implantado uma solução do WordPress cobrada pelo número de núcleos da 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 "(charges - trial_use + prepay_credits + postpay_credits) * revenue share". Adicionamos prepay_credits e postpay_credits porque os valores são números negativos, quando presentes. Subtraímos trial_use porque o valor é um número positivo, quando presente.
trial_use Créditos de avaliação, de cupons e 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 for uma fração, o número indicará que o cliente escolheu um tipo de máquina 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 particular, insira o ID da oferta associado ao produto e à conta de faturamento da oferta. As ofertas particulares mais antigas eram conhecidas como cotações, e mantivemos o nome para 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 de 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 apenas ao uso considerado excessivo, conforme determinado pelos termos da oferta. Se não houver um desconto no nível da métrica para esse 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 análise por falta de pagamento, o Google reterá os pagamentos até que a conta volte a estar em situação regular. Essa coluna informa quanto teríamos que pagar se tivéssemos coletado do cliente. Quando a conta de faturamento estiver em situação regular, os fundos retidos serão liberados no próximo pagamento para você. Se ela nunca voltar para a 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 O 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 estamos liberando ou abandonando fundos, isso pode ter ocorrido em um mês anterior. Se a conta ainda estiver em período de teste, esse será o primeiro dia do mês em que retivemos os fundos, mas podemos ter começado a retenção antes disso.
probation_end O último dia em que o Google reteve fundos, no formato YYYY-MM-DD, no Horário do Pacífico (EUA e Canadá). No dia seguinte, ou conta retornou à situação regular ou foi encerrada. Se estiver em branco, significa que a conta ainda está em avaliação.
start_date O primeiro dia em que o direito está ativo, no formato YYYY-MM-DD, no horário do Pacífico nos EUA e Canadá. A data é determinada pela assinatura associada ou oferta privada do 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 do Canadá. A data é determinada pela assinatura associada ou oferta privada do direito. Se o direito tiver sido criado antes de 2021-01-10, o valor será NULL.
solution_name O nome do produto que será cobrado do cliente.
postpay_credits A quantidade de charges que foi coberta por um crédito de compromisso comprado com 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 você.
marketplace_fee_percent A porcentagem da taxa que o Cloud Marketplace mantém como parte do seu contrato de participação na receita com o Google.
marketplace_fee_amount O valor da taxa que o Cloud Marketplace retém como parte do seu contrato de participação na receita com o Google.

Mais informações sobre ofertas privadas

Se você criou ofertas particulares para clientes específicos, talvez apareçam as seguintes informações adicionais:

Campo Descrição
payment_schedule O tipo de calendário de pagamentos da oferta. Ele pode ter o valor PREPAY, PREPAY_INSTALLMENTS ou POSTPAY.

Observação:para ofertas privadas que usam frequência de faturamento (mensal, trimestral, anual ou personalizada) em vez de programações de pagamento no momento da criação, esse campo fica vazio. Para essas ofertas, recomendamos usar a 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 período atual da oferta.
order_start_date A data em que o preço da oferta privada passa a valer.
order_end_date A data em que o preço da oferta privada não está mais em vigor.
billing_frequency Descreve o intervalo de faturamento recorrente selecionado quando a oferta foi criada. Pode ter o valor monthly, quarterly, yearly, pay_go ou custom.

Observação:para ofertas privadas que usam cronogramas de pagamento (pré-pago ou pós-pago) em vez de frequência de faturamento (mensal, trimestral, anual ou personalizada) no momento da criação, o valor é 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 período atual da oferta, no formato YYYY-MM-DD.
final_installment_date A data de término da parcela final do período atual da oferta, no formato YYYY-MM-DD.
prepay_credits O valor de charges que foi coberto por um crédito de compromisso comprado com 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 você.
offer_title O texto que você insere no campo Offer Title da oferta privada ao criar a oferta. Ele fica visível para os clientes. Se o cliente tiver comprado várias ofertas privadas do mesmo produto usando a mesma conta do Cloud Billing, use esse campo para diferenciar essas ofertas na tabela de ofertas e nos relatórios. Para ofertas privadas criadas antes da disponibilidade desse campo, ele foi preenchido com o nome do produto da oferta.
entitlement_id ID do direito de oferta associado à compra feita pelo cliente. Se o cliente comprou várias ofertas privadas para o mesmo produto usando a mesma conta do Cloud Billing, use esse campo para diferenciar essas ofertas na tabela de ofertas e nos relatórios.

Outras informações para produtos revendidos

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

Campo Descrição
channel Indica se o uso é de um produto comprado diretamente de um fornecedor independente de software (ISV, na sigla em inglês) ou por meio de outra empresa que revende os 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.
wholesale_charges Para ofertas privadas revendidas (o campo channel tem um valor de RESOLD), o valor mostrado é: charges - reseller_discount.
Para ofertas privadas feitas diretamente a clientes finais (o campo channel tem um valor de DIRECT), esse campo tem o valor NULL.

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

Campo Descrição
transaction_type Descreve a relação entre o comprador, o vendedor e o Google para a transação. Esse valor pode ser THIRD_PARTY_RESELLER (o Google está vendendo os produtos do ISV diretamente) ou THIRD_PARTY_AGENCY (o Google está atuando como agente do vendedor).