Oferecemos 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. Para acessar o relatório de insights do cliente, acesse o destino ou o conjunto de dados do BigQuery especificado ao configurar o recebimento de relatórios.
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 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 de clientes
Se quiser, ative 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 foi incluído em relatórios anteriores. Isso pode acontecer se você informar o uso ao Google com atraso ou se houver problemas com os processos internos de faturamento do Google que atrasam a geração de relatórios.
Recomendamos ativar os relatórios de insights incrementais do cliente, porque eles oferecem uma visão mais precisa do uso dos clientes do que os relatórios de insights não incrementais e ajudam na conciliação do uso informado com os relatórios de desembolso mensais.
Ativar relatórios de insights incrementais de clientes
Para ativar os relatórios de insights incrementais dos clientes na exportação para CSV, siga estas etapas:
No Portal do Produtor, acesse a página "Relatórios".
Em Configurar relatórios, selecione o destino em que você quer ativar os relatórios de insights incrementais de clientes.
Em Relatórios para exportar, marque a caixa de seleção Insights incrementais de clientes.
Entender os relatórios de insights incrementais dos clientes
O exemplo a seguir mostra como o Cloud Marketplace processa o uso informado com atraso, depois que você ativa os relatórios de insights incrementais do cliente:
Em 1º de janeiro de 2023, seu cliente usa seu produto, mas você não informa todo ou parte do uso dele.
Em 3 de janeiro de 2023, o Cloud Marketplace gerou um relatório de insights incrementais de clientes 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 neste relatório.
Em 10 de janeiro de 2023, você informa o uso de 1º de janeiro de 2023 que não foi informado antes.
Neste exemplo, o relatório chamado 2023-01-09 Incremental Daily Insights
na exportação em CSV ou a tabela do BigQuery marketplace_report.incremental_insights
com _PARTITIONDATE
como 2023-01-09
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 vai encontrar uma nova coluna chamada report_date
, que tem o valor 2023-01-09
em todas as linhas, indicando que este 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 período 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 (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 depois dessa data). Esse campo aparece depois que você ativa os relatórios de insights incrementais de clientes. 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 isso 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ê ativou os relatórios de insights incrementais de clientes, essa data pode corresponder ao report_date ou ser mais antiga, caso o uso tenha 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. Use para acompanhar a receita do cliente ao longo do tempo, a conversão de gratuito para pago e o churn de clientes. |
account_id |
A conta do Cloud Billing associada ao cliente. Se o cliente estiver usando uma conta pessoal, o ID 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 deles 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 for uma fração, o número indicará que o cliente escolheu um tipo de máquina com 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, insira o ID associado ao produto e à conta de faturamento da oferta. As ofertas particulares mais antigas eram conhecidas como cotações, e mantivemos o nome para dar continuidade ao 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étricas 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 excedente, 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 Google Cloud for colocada em análise por falta de pagamento, o Google vai reter os pagamentos até que a conta esteja em situação regular. Essa coluna informa quanto você pagaria se o coletasse 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, vamos abandonar 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 avaliação, esse será o primeiro dia do mês
em que retivemos os fundos, mas podemos ter começado a reter antes disso. |
probation_end |
O último dia em que o Google reteve os fundos, no formato YYYY-MM-DD , no horário do Pacífico dos EUA e do 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 cobrado do cliente. |
postpay_credits |
A quantidade de charges coberta por um crédito de compromisso comprado com um compromisso pós-pago. Se presente, é um número negativo que reduz o valor de due_vendor , porque diminui o valor usado para calcular o pagamento a você. |
marketplace_fee_percent |
A porcentagem que o Cloud Marketplace reté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 privadas para clientes específicos, talvez veja as seguintes informações adicionais:
Campo | Descrição |
---|---|
payment_schedule |
O tipo de calendário de pagamentos da oferta. Esse valor pode ser
PREPAY , PREPAY_INSTALLMENTS ou
POSTPAY .Observação:para ofertas privadas que usam uma 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 que você use 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 os preços da oferta privada entram em vigor. |
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, isso tem 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 período 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 foi coberto por um crédito de compromisso comprado com um compromisso pré-pago. Se presente, é um número negativo que reduz o valor de due_vendor , porque diminui o valor usado para calcular o pagamento a você. |
offer_title |
O texto inserido no campo Offer Title da oferta privada ao criar a oferta. Isso 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 as ofertas na tabela e nos relatórios. Para ofertas privadas criadas antes da disponibilização desse campo, ele foi preenchido com o nome do produto da oferta. |
entitlement_id |
ID do direito da oferta associado à compra feita pelo cliente. 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 e nos relatórios. |
Informações adicionais para produtos revendidos
Se você ativou a revenda dos seus produtos do Cloud Marketplace, as seguintes informações adicionais podem aparecer:
Campo | Descrição |
---|---|
channel |
Indica se o uso é de um produto comprado diretamente de um fornecedor independente de software (ISV) ou por 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 particulares revendidas (o campo channel tem um valor de
RESOLD ), isso mostra o valor:
charges - reseller_discount .Para ofertas privadas feitas diretamente aos clientes finais (o campo channel
tem o valor DIRECT ), este campo tem o valor
NULL . |
Mais informações sobre 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 na transação. Isso pode ter o valor THIRD_PARTY_RESELLER (o Google está vendendo os produtos do ISV diretamente) ou THIRD_PARTY_AGENCY (o Google está atuando como agente do vendedor). |