Relatórios das suas soluções do Google Cloud Marketplace

Nesta página, explicamos como configurar e usar relatórios para seus produtos do Google Cloud Marketplace.

Dependendo do tipo de produto que você oferece no Google Cloud Marketplace, é possível receber os seguintes relatórios:

  • relatório de uso e gastos: contém detalhes de uso do software e o valor a ser pago a você;
  • relatório de insights do cliente: contém informações sobre quem são seus clientes e como eles estão usando o software, como o número de Máquinas virtuais (VMs) em que implantaram suas soluções;
  • relatório de geração de leads (para soluções de VM): contém informações de contato de clientes que consentiram em compartilhar essas informações com você.
  • Relatório de migração da SKU: se migrarmos suas SKUs de soluções para um serviço ou estrutura diferente do Cloud Billing, esse relatório informará a migração para que você possa adaptar a ingestão de relatórios.

Seus relatórios são entregues em uma pasta do Google Drive, em um bucket do Cloud Storage ou em ambos. Para as etapas de configuração dos destinos dos seus relatórios, consulte Como configurar relatórios.

Para saber mais sobre como os clientes são cobrados e configurar pagamentos, consulte Como receber pagamentos do Google.

Como configurar relatórios

Para receber seus relatórios do Google Cloud Marketplace, configure uma pasta do Google Drive, um bucket do Cloud Storage ou ambos. Você precisa ser o proprietário do destino escolhido. Por exemplo, se você usa uma pasta do Drive, sua conta do Google Cloud precisa ter a permissão Pode organizar, adicionar e editar na pasta.

Seus relatórios podem ser armazenados em um local compartilhado do Google Drive, um bucket do Cloud Storage ou ambos. Ao configurar seu destino, o administrador do G Suite ou do Cloud Storage precisa garantir que os destinos possam ser compartilhados com os domínios google.com e system.gserviceaccount.com.

Quando você adiciona o destino do seu relatório, as seguintes contas são adicionadas como editores ou administradores de objetos de armazenamento, conforme o caso:

  • A conta de serviço cloud-marketplace-stats@system.gserviceaccount.com, que carrega relatórios no bucket.
  • O grupo do Google gcp-marketplace-business-operations@google.com, para depurar e solucionar problemas que você possa ter com os relatórios.

Se você estiver configurando um bucket do Cloud Storage, recomendamos que use listas de controle de acesso (ACLs) para o bucket. Também recomendamos que você remova todas as políticas de retenção que tiverem no bucket, já que a política de retenção pode impedir que os relatórios sejam atualizados até que o período de retenção tenha passado.

Se você usar o recurso "Acesso uniforme no nível do bucket", as seguintes políticas da organização podem interferir no acesso:

Para remover essas políticas da organização do bucket, da pasta ou do projeto que contém o bucket, solicite que o administrador da política da organização defina a política como o padrão do Google.

Depois de configurar um local para armazenar os relatórios, você precisa configurar como eles serão entregues. Para configurar a entrega, use as seguintes etapas com base no uso do Portal do Produtor ou do Portal do Parceiro para gerenciar seu produto:

Portal do Produtor

  1. No Portal do Google Partners, abra a página "Relatórios de parceiros". O link direto para a página é:

    https://console.cloud.google.com/producer-portal/reports?project=YOUR_PUBLIC_PROJECT_ID
    

    Seu ID de projeto público é o ID do projeto que hospeda os componentes da sua solução. Você cria esse projeto quando se inscreve para se tornar um parceiro.

  2. Para adicionar um destino de relatório, clique em Adicionar destino.

  3. Em Local de destino, selecione se você quer enviar relatórios para uma pasta do Google Drive ou para um bucket do Cloud Storage.

  4. Clique em Procurar e selecione uma pasta ou bucket, conforme o caso.

  5. Selecione os relatórios para salvar nesse destino. É possível enviar cada relatório para quantos destinos forem necessários.

  6. Se você quiser mais níveis de detalhes nos relatórios de uso, em Opções de relatório de uso, selecione uma ou mais destas opções:

    • Separar o uso do cliente por local: divide seu relatório de uso e gastos pelos locais dos clientes.
    • Uso separado do cliente por conta de faturamento: divide seu uso e relatório de reembolso pelas contas de faturamento do Cloud dos clientes.

    Para informações sobre o que está incluído no relatório, consulte Relatórios de uso e gastos.

  7. Para configurar mais destinos, repita essas etapas.

  8. Se quiser, adicione uma ou mais contas de faturamento do Cloud para usar nos testes. Para saber mais sobre o teste de produtos, acesse Como testar seus produtos publicados do Google Cloud Marketplace.

  9. Para salvar as alterações, clique em Save. Você precisa concordar em conceder às contas do Google Cloud Marketplace acesso aos destinos de seus relatórios.

Portal do parceiro

  1. No Portal do Google Partners, abra a página "Relatórios de parceiros". O link direto para a página é:

    https://console.cloud.google.com/partner/reports?project=YOUR_PUBLIC_PROJECT_ID
    

    Seu ID de projeto público é o ID do projeto que hospeda os componentes da sua solução. Você cria esse projeto quando se inscreve para se tornar um parceiro.

  2. Para adicionar um destino de relatório, clique em Adicionar destino.

  3. Em Local de destino, selecione se você quer enviar relatórios para uma pasta do Google Drive ou para um bucket do Cloud Storage.

  4. Clique em Procurar e selecione uma pasta ou bucket, conforme o caso.

  5. Selecione os relatórios para salvar nesse destino. É possível enviar cada relatório para quantos destinos forem necessários.

  6. Se você quiser ver mais detalhes dos relatórios de uso, selecione uma ou mais destas opções:

    • Separar o uso do cliente por local: divide seu relatório de uso e gastos pelos locais dos clientes.
    • Uso separado do cliente por conta de faturamento: divide seu uso e relatório de reembolso pelas contas de faturamento do Cloud dos clientes.

    Para informações sobre o que está incluído no relatório, consulte Relatórios de uso e gastos.

  7. Para configurar mais destinos, repita essas etapas.

  8. Para salvar as alterações, clique em Salvar. Você precisa concordar em conceder às contas do Google Cloud Marketplace acesso aos destinos de seus relatórios.

Relatórios de uso e gastos

No décimo dia útil de cada mês, um relatório é gerado no destino que você configurou, com os detalhes de uso e a receita do mês anterior. Esses dois relatórios têm nomes que começam com o primeiro dia do mês: YYYYMMDD, por exemplo, 20210401 significa que o relatório é para o uso que ocorreu em abril de 2021.

Relatório de cobranças e uso

O relatório YYYYMMDD Charges and Usage inclui o seguinte conteúdo: Para quaisquer dúvidas sobre o relatório, entre em contato com o Engenheiro de parceiros.

  • SKU: a descrição da solução do Google Cloud Marketplace.

  • Entidade do Google: a empresa do Google que recebeu o pagamento dos clientes. Os pagamentos que você recebe provêm dessa empresa.

  • Recurso: o recurso em que a solução foi executada. O recurso mostrado depende do modelo de preços.

  • Usage: a quantidade de recurso usada pelas implantações da solução.

  • Unidades: a unidade em que a coluna "Uso" é medida, como horas, horas principais ou horas de gibibyte, dependendo do modelo de preços.

  • Moeda: a moeda em que as três colunas a seguir são medidas.

  • Cobranças: os custos do cliente para usar sua solução. A partir do relatório de abril de 2021, se você receber o pagamento em uma moeda que não seja o dólar americano, esse campo usará sua moeda de pagamento.

  • Uso em teste: o custo coberto pelos créditos do teste da solução. A partir do relatório de abril de 2021, se você receber o pagamento em uma moeda que não seja o dólar americano, esse campo usará a moeda do seu pagamento.

  • Devido ao parceiro: pagamento acumulado para você, calculado como (Charges - Trial Use) * revenue share.

  • Tipo de pagamento: os meios pelos quais você receberá o pagamento: se for old, você receberá pagamentos do Google nos EUA ou em uma entidade regional do Google na sua sede nesse país conta bancária. Se for new, você receberá um único pagamento na sua conta bancária local.

  • Retido: se a conta de faturamento de um cliente do Google Cloud for colocada como devedora por falta de pagamento, o Google reterá os pagamentos até que a conta esteja 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, liberaremos os fundos retidos no próximo pagamento para você. Se ela nunca voltar para a situação regular, abandonaremos os fundos retidos.

  • Liberado: 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.

  • Abandonado: se o Google reteve fundos, essa coluna mostra o total de fundos abandonados porque a conta de faturamento foi encerrada.

  • Início do período de teste: o primeiro dia em que o Google começou a reter fundos, no formato YYYY-MM-DD. 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 (que pode não ser o primeiro dia em que retivemos os fundos).

  • Término do período de teste: o último dia em que o Google retiu fundos, no formato YYYY-MM-DD. 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.

  • Início do reembolso: o primeiro dia em que o Google reembolsou o uso de um cliente, no formato AAAA-MM-DD.

  • End End: o último dia em que o Google reembolsou o uso de um cliente, no formato AAAA-MM-DD.

  • Saldo do reembolso deduzido este mês: o valor do pagamento que o Google subtraiu durante o mês relacionado ao reembolso de um cliente.

  • Reembolso de saldo pendente: se o deslocamento relacionado ao reembolso de um cliente for maior que o pagamento do mês, o valor restante será deduzido devido ao seu pagamento futuro.

  • Motivo do reembolso: o motivo pelo qual um cliente recebeu o reembolso.

Por padrão, o relatório é dividido em SKU, entidade do Google e recurso. Quando você configura seus relatórios, há estas outras divisões à sua escolha:

  • Por conta: isso adiciona as colunas ID da conta e ID da conta do Insights ao relatório, que mostra um ID de faturamento para o cliente. Use esse ID para rastrear métricas como desligamento de usuários ou conversões de avaliação. O ID da conta não é o ID de faturamento do Google Cloud do cliente, mas é específico da conta de faturamento do cliente. Existem duas formas de ID de conta ocultas no relatório. Isso acontece por motivos históricos: os dois relatórios usam algoritmos diferentes para ofuscar o ID real da conta. Use o ID da conta do Insights para corresponder o pagamento às informações sobre o cliente no Relatório de insights do cliente.

  • Por local: isso adiciona uma coluna Local ao relatório, que contém o código do país referente ao local do cliente. Se o cliente estiver nos EUA ou no Canadá, a coluna incluirá o código do país e do estado.

Se você precisar vincular um pagamento ao relatório de cobranças e uso ao nome do cliente, precisará

  1. Ativar geração de relatórios by account
  2. Configurar o recebimento de relatórios de insights do cliente
  3. Use a coluna Insights Account Id para encontrar a linha nos Relatórios de insights do cliente com a coluna external_account_id correspondente.

Relatório de pagamentos

O segundo é o relatório YYYYMMDD Disbursements. Este relatório detalha o valor que é transferido do Google para você no mês. Ele tem o seguinte conteúdo:

  • Entidade: o nome da entidade corporativa do Google que está emitindo o pagamento ou as entidades especiais Abandoned Payout ou Released Payout:

    Released Payout
    indica a quantia retida pelo Google porque o cliente foi inadimplente e recebeu e está pagando para você.
    Abandoned Payout
    indica a quantia retida pelo Google porque o cliente estava inadimplente e nunca será pago porque o Google determinou que ela é não coletável.
  • Currency: a moeda em que o dinheiro está sendo pago.

  • Valor: o total do pagamento, antes dos ajustes.

  • Reembolso do cliente: qualquer ajuste devido ao reembolso de clientes aos seus produtos.

  • Total: o valor final após os ajustes.

  • Observações: é o motivo do ajuste.

  • Tipo de pagamento: o meio pelo qual você recebe o pagamento. Se o valor for old, você receberá um ou mais pagamentos do Google US ou de uma entidade regional do Google na sua conta bancária nos EUA. Se o valor for new, você receberá um único pagamento na conta bancária local.

Relatório de insights do cliente

Você também recebe um relatório diário e mensal de insights do cliente, que inclui informações sobre quem são seus clientes e como eles estão usando o software. 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.

Quando um cliente configura a própria Conta de faturamento do Cloud, 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 pessoal. Você verá n/a nessas colunas de identificação para essas contas.

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

Campo Descrição
date A data dos relatórios de uso.
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 do e-mail do administrador de faturamento da organização. Se houver vários administradores associados à conta de faturamento, o domínio no relatório será aquele usado pela maioria dos administradores. 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 de faturamento associada ao projeto do cliente.
account_id A conta de faturamento associada ao cliente.
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 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.
due_vendor O valor recebido pelo uso.
trial_use Créditos de avaliação (se aplicável) que o cliente consumiu.
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 uma 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 a receita de uma oferta privada, insira o ID de cotação associado à solução e à conta de faturamento da oferta.
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.
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 de faturamento de um cliente do Google Cloud for colocada como devedora, o Google reterá os pagamentos até que a conta volte a ficar 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, 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. 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, que pode não ser o primeiro dia em que retivemos os fundos.
probation_end O último dia em que o Google retiu fundos, no formato YYYY-MM-DD. 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. A data é determinada pela assinatura associada ou oferta privada do direito. Se o direito tiver sido criado antes de 10/01/2021, o valor será NULL.
end_date O último dia em que o direito está ativo, no formato YYYY-MM-DD. A data é determinada pela assinatura associada ou oferta privada do direito. Se o direito tiver sido criado antes de 10/01/2021, o valor será NULL.

Informações adicionais sobre ofertas de pré-pagamento

Se você tiver criado ofertas particulares que usam um calendário de pagamentos pré-pagos, poderá ver as seguintes informações adicionais:

Field Descrição
payment_mode É o tipo de programação de pagamento da oferta. Pode ter o valor PREPAY, PREPAY_INSTALLMENTS ou POSTPAY.
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.
order_start_date A data em que os preços de oferta privada entram em vigor.
order_end_date A data em que os preços de oferta privada não estão mais em vigor.

Relatório de geração de leads

Para produtos de VM, é possível receber diariamente o relatório de geração de leads, que inclui informações dos clientes, como endereços de e-mail e números de telefone.

Se você quiser coletar essas informações, entre em contato com seu Engenheiro de parceiros com as seguintes informações:

  • Os campos que você gostaria de incluir no seu relatório para cada solução.

  • O URL da política de privacidade que rege seu uso dos campos coletados. Recomendamos que você seja explícito em relação ao uso que fará das informações. Assim, os clientes se sentirão confortáveis para compartilhá-las.

Os campos e a política de privacidade são usados para criar um formulário de consentimento. Quando os clientes começam a implantar uma solução de VM pela primeira vez, eles veem as informações que você quer coletar e sua política de privacidade. Após revisar as informações, os clientes podem conceder ou negar o consentimento para compartilhar as informações com você.

A primeira linha do relatório contém o número de clientes que optaram por não compartilhar as informações e os horários de início e término cobertos pelo relatório. Todas as respostas dos clientes no relatório estão entre dois horários. Os horários, baseados no fuso horário UTC, estão no formato ISO YYYY-MM-DDTHH:MM:SS+00:00. Por exemplo, a meia-noite UTC de 14 de março de 2019 é mostrada como 2019-03-14T00:00:00+00:00.

O relatório contém as seguintes informações referentes aos clientes que aceitaram participar:

Campo Descrição
Nome Nome do cliente
E-mail Endereço de email do cliente
Empresa O nome da empresa do cliente. Se o cliente não estiver associado a uma empresa, o valor será "_none_"
Código do país Código de país de duas letras referente ao país do cliente. Por exemplo, o código de duas letras para a França é FR
Address Endereço do cliente
Telefone Número de telefone do cliente

Relatório de migração da SKU

Em certos casos, podemos mudar a maneira como as SKUs relacionadas às suas soluções são estruturadas, ou então o produto no Cloud Billing onde elas aparecem. Quando isso acontece, criamos um arquivo sku-migration-report.csv no mesmo local dos relatórios do Customer Insights. Cada SKU está localizada em um serviço, que tem um ID hexadecimal de três partes no formato 0123-4567-89AB. Além disso, cada SKU tem seu próprio código hexadecimal de três partes, que é independente do ID de serviço e exclusivo em todos os serviços. Você vê o ID da SKU na coluna sku_id no relatório do Customer Insights.

O relatório de migração de SKUs é atualizado diariamente. Se você tiver uma política de armazenamento no seu bucket do Cloud Storage, a atualização será atrasada até que o período de retenção tenha passado. O relatório contém as seguintes informações:

Campo Descrição
source_sku_id O ID da SKU antiga.
target_sku_id O ID da SKU que substituiu a original. Se estiver branco, a SKU original não tem substituto.
target_service_id O ID de serviço em que a SKU de substituição é definida. Se estiver branco, a SKU original não tem substituto.
seller Nome da empresa.
product É o nome da solução a que a SKU está relacionada.
source_sku_name Um nome legível da SKU de origem (não é assim que aparece na fatura do cliente).
target_sku_name Um nome legível da SKU que substitui o original. Se essa informação estiver em branco, a SKU original não tem substituto.