Relatórios dos seus produtos do Google Cloud Marketplace

Nesta página, você verá como configurar e usar relatórios dos 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órios de uso e pagamento: contenham detalhes do uso do software e o valor a ser pago a você.
  • Relatório de insights sobre clientes: contém informações sobre quem são seus clientes e como eles usam seu software, como o número de máquinas virtuais (VMs) em que foram implantados seus produtos.
  • Relatório de geração de leads (para produtos de VM): contém dados de contato dos clientes que consentiram o compartilhamento de informações com você.
  • Relatório de migração de SKU: se migrarmos as SKUs do produto para outro serviço ou estrutura do Cloud Billing, esse relatório informará sobre a migração para que você possa adaptar a ingestão.

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 como os clientes são cobrados e configurar os 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ê usar uma pasta do Drive, sua conta do Google Cloud precisará ter a permissão Pode organizar, adicionar e editar para a pasta.

Os relatórios podem ser armazenados em um local compartilhado do Drive, em um bucket do Cloud Storage ou em ambos. Ao configurar o destino, o administrador do Google Workspace 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 usar listas de controle de acesso (ACLs, na sigla em inglês) para o bucket. Também recomendamos que você remova todas as políticas de retenção que você possa ter no bucket, porque a política de retenção pode impedir que os relatórios sejam atualizados até o final do período de armazenamento.

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

Para remover essas políticas da organização do bucket, para a pasta ou o projeto que contém o bucket, solicite que o administrador da política da organização defina a política como o gerenciamento 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, siga as etapas a seguir, dependendo se você usa o Portal do Produtor ou o Portal do Parceiro para gerenciar seu produto:

Portal do Produtor

  1. No Portal do Produtor, 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
    

    Código do projeto público é o ID do projeto que hospeda os componentes do seu produto. 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 Drive ou 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 no destino. É possível enviar cada relatório para quantos destinos precisar.

  6. Se você quiser outros 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 no teste. 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 Drive ou 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 no destino. É possível enviar cada relatório para quantos destinos precisar.

  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, dois relatórios são gerados no destino configurado, com os detalhes de uso e 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 aconteceu em abril de 2021.

Relatório de cobranças e uso

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

  • SKU: a descrição do produto 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 o produto foi executado. O recurso mostrado depende do modelo de preços.

  • Uso: a quantidade de recursos usada pelas implantações do produto.

  • 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 seu produto. 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 avaliação: o custo coberto pelos créditos da avaliação do produto. A partir do relatório de abril de 2021, se você receber pagamentos em uma moeda que não seja o dólar americano, esse campo usará sua moeda de pagamento.

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

  • Tipo de pagamento: a forma como você receberá o desembolso. Se for old, você receberá pagamentos do Google nos EUA ou de uma entidade regional do Google para sua empresa nos EUA. 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 tiver retido fundos, essa coluna mostrará o total dos fundos abandonados porque encerramos a conta de faturamento.

  • Início da experimentação: o primeiro dia em que o Google começou a reter fundos, no formato YYYY-MM-DD. Se estamos lançando ou abandonando fundos, isso pode estar mais cedo. Se a conta ainda estiver em análise, este será o primeiro dia do mês atual em que retemos fundos (que pode não ser o primeiro dia em que retemos fundos).

  • Término do período de teste: o último dia retido pelo Google, 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.

  • Término do reembolso: o último dia em que o Google reembolsou o uso de um cliente, no formato AAAA-MM-DD.

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

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

  • Motivo do reembolso: o motivo por que 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 mostram um ID de faturamento do 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 para a 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 no relatório de cobranças e uso ao nome do cliente, precisará

  1. Ative os 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 desembolsos

O segundo relatório é o YYYYMMDD Disbursements. Este relatório detalha o dinheiro 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 o dinheiro que o Google manteve, porque o cliente era inadimplente, que agora foi recebido e está pagando para você.
    Abandoned Payout
    indica o dinheiro que o Google retiu porque o cliente era inadimplente e nunca seria pago porque, segundo o Google, não é possível cobrar.
  • Moeda: a moeda em que o dinheiro está sendo pago.

  • Valor: o total do pagamento, antes de qualquer ajuste.

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

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

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

  • Tipo de pagamento: a forma como você recebe o pagamento. Se o valor for old, você receberá um ou mais pagamentos do Google ou de uma entidade regional do Google para 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 Conta de faturamento do Cloud, ele escolhe se é uma conta empresarial ou pessoal. Excluímos as informações de identificação do relatório de insights do cliente das contas que o cliente identificou como uma conta pessoal. Você verá n/a nas colunas de identificação dessas 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 um produto está configurado, uma única implantação pode ter vários IDs 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 implantou um produto do WordPress cobrado pelo número de núcleos de CPU, a descrição da SKU é semelhante à "Taxa de licenciamento do clique para implantar o 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 o produto.
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 g1-small foram usadas durante o período atual, das quais 0 f1-micro VMs são novas e duas VMs g1-small são novas.
quote_id Se você gerou receita a partir de uma oferta privada, o código da cotação associado ao produto 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 desembolso: se for old, você receberá pagamentos do Google nos EUA ou de uma entidade regional do Google para 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 lançando ou abandonando fundos, pode ser em um mês anterior. Se a conta ainda estiver sendo analisada, este é o primeiro dia do mês atual em que retemos fundos, que pode não ser o primeiro dia em que começamos a reter 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 ou oferta privada associada ao 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 ou oferta privada associada ao direito. Se o direito tiver sido criado antes de 10/01/2021, o valor será NULL.

Relatório de geração de leads

Para produtos de VM, é possível receber o relatório de geração de leads que inclui as informações dos clientes, como endereços de e-mail e números de telefone. Você pode escolher receber este relatório diariamente, semanalmente, quinzenalmente ou mensalmente.

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

  • Os campos que você quer incluir no relatório de cada produto.

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

  • Com que frequência você quer que o relatório seja gerado.

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 um produto 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
Email 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

Occasionallys vezes, podemos alterar como as SKUs relacionadas aos seus produtos são estruturadas ou ao produto no Faturamento do Cloud onde 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ê verá o ID da SKU na coluna sku_id no Relatório de insights do cliente.

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 do produto relacionado à SKU.
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.