Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Este documento mostra como testar os relatórios de uso dos produtos SaaS que você
oferece pelo Google Cloud Marketplace.
Antes de começar
Para testar os relatórios de uso, o plano de preços do seu produto precisa ser aprovado pelo
Google. Para mais detalhes, consulte
Enviar seus preços para análise.
Use uma conta de faturamento de teste, que tem 100% de desconto
no uso. Para saber como configurar uma conta de faturamento de teste, consulte
Criar uma conta de faturamento de teste.
Verifique se você ativou os relatórios de insights incrementais do cliente. Isso
envolve as seguintes etapas:
Para verificar seus relatórios de uso, execute um teste que os gera e compare-os com os resultados esperados. Para executar o teste,
faça o seguinte:
No Portal do Produtor, mude para um projeto Google Cloud associado
à sua conta de faturamento de teste.
Na página de listagem do Google Cloud Marketplace do seu produto, use a conta de faturamento de teste para comprar o produto.
Enviar um relatório de uso inicial para uma métrica única e reconhecível. O valor precisa ser maior que US$0, 01 e menor que o uso esperado para uma hora de uso. Por exemplo, se o produto for cobrado por GiB/hora,
envie um único relatório de uso equivalente a um GiB/hora. Isso facilita
a verificação de que a medição e o faturamento estão funcionando conforme o esperado quando
você compara com o relatório "Insights incrementais do cliente".
Para saber como enviar relatórios de uso, incluindo como formatar relatórios
e tempos de uso, consulte
Como informar o uso ao Google.
Continue enviando pelo menos um relatório de uso por hora por pelo menos seis horas.
Se você enviar mais de um relatório de uso por hora, isso não afetará a
duração mínima necessária do teste, que continua sendo de seis horas.
Durante o período de teste, crie registros que contenham as informações de uso que você está informando no formato CSV ou das Planilhas Google, com o seguinte formato:
Hora (UTC)
operationID
startTime
endTime
consumerId
metricName
metricValue
TIME
OPERATION_ID
START_TIME
END_TIME
project_number: PROJECT_NUMBER
METRIC_NAME
METRIC_VALUE
Envie esses registros, no formato CSV ou Planilhas Google, para a equipe de engenharia de parceiros do Cloud Marketplace.
Depois que você receber o relatório de insights incrementais do cliente correspondente ao período em que os testes foram executados, o Google vai comparar os valores no relatório com os valores esperados, incluindo os seguintes campos:
charges
sku_id
sku_description
usage
unit
currency
external_account_id
O Google envia os resultados da comparação.
Limpeza após o teste
Depois que o Google receber e verificar seu uso no período de teste, limpe
os recursos criados para o teste fazendo o seguinte:
Parar de enviar relatórios de uso dos direitos criados para
testes.
Cancele todos os direitos que você criou para teste.
Remova todos os membros da equipe do Google que você adicionou à sua conta do Cloud Billing
durante o teste.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[],[],null,["# Test usage reporting for SaaS products\n\nThis document shows how to test usage reporting for the SaaS products that you\noffer through Google Cloud Marketplace.\n\nBefore you begin\n----------------\n\n- To test usage reporting, your product's pricing plan must be approved by\n Google. For more details, see\n [Submit your pricing for review](/marketplace/docs/partners/integrated-saas/select-pricing#submit-pricing).\n\n | **Note:** When you make a change to your product's approved pricing plans, it might take up to four business days for Google to approve the changes.\n- Make sure that you use a Test Billing Account, which has 100% discounted\n usage. For steps to set up a Test Billing Account, see\n [Create a Test Billing Account](/marketplace/docs/partners/create-test-billing-account).\n\n- Verify that you've turned on Customer incremental insights reports. This\n involves the following steps:\n\n - [Set up to receive reports](/marketplace/docs/partners/reports/set-up-reports).\n - [Turn on Customer incremental insights reports](/marketplace/docs/partners/reports/report-customer-insight#turn-on-customer-incremental-insights).\n\nRun a test to generate usage\n----------------------------\n\nYou verify your usage reporting by running a test that generates usage reports,\nand then comparing the usage reports to your expected outcomes. To run the test,\ndo the following:\n\n1. In Producer Portal, switch to a Google Cloud project that's\n associated with your Test Billing Account.\n\n2. From your product's Google Cloud Marketplace listing page, use your Test Billing\n Account to purchase the product.\n\n3. Send an initial usage report for a single, recognizable metric. This should\n equal more than US$0.01, and be less than the amount of usage that you expect\n for one hour of usage. For example, if your product bills per GiB per hour,\n send a single usage report that's equivalent to one GiB per hour. This makes\n it easier to verify that metering and billing are working as expected when\n you compare against the Customer incremental insights report.\n\n For details about how to send usage reports, including how to format reports\n and usage times, see\n [Reporting usage to Google](/marketplace/docs/partners/integrated-saas/backend-integration#for_usage-based_pricing_reporting_usage_to_google).\n4. Continue to send at least one usage report per hour for at least six hours.\n If you send more than one usage report per hour, this doesn't affect the\n required minimum length of the test, which remains six hours.\n\n5. For the duration of the testing period, create logs that contain the usage\n information that you're reporting in Google Sheets or CSV format, with the\n following format:\n\n Provide these logs, in Google Sheets or CSV format, to your\n Cloud Marketplace partner engineering team.\n6. After you receive the Customer incremental insights report corresponding to\n the time period during which you ran your tests, Google compares the values\n in your report with your expected values, including the following fields:\n\n - `charges`\n - `sku_id`\n - `sku_description`\n - `usage`\n - `unit`\n - `currency`\n - `external_account_id`\n\n Google sends you the results of their comparison.\n\nClean up after testing\n----------------------\n\nAfter Google receives and verifies your usage from the testing period, you clean\nup the resources that you created for testing by doing the following:\n\n- Stop sending usage reports for the entitlements that you created for testing.\n- Cancel all entitlements that you created for testing.\n- Remove any Google team members that you added to your Cloud Billing account during testing.\n\nRelated topics\n--------------\n\n- [Preview your product in Producer Portal](/marketplace/docs/partners/integrated-saas/test-preview), to see how it appears to Cloud Marketplace users.\n- [Preview your product's pricing](/marketplace/docs/partners/integrated-saas/test-preview-pricing)."]]
