Informes para tus soluciones de Google Cloud Marketplace

En esta página, se explica cómo configurar y usar los informes para tus productos de Google Cloud Marketplace.

Según el tipo de productos que ofrezcas en Google Cloud Marketplace, puedes recibir los siguientes informes:

  • Informes de uso y desembolso: contienen detalles sobre el uso de tu software y el monto que se te pagará.
  • Informe de estadísticas personalizadas: contiene información sobre quiénes son tus clientes y cómo usan el software, como la cantidad de máquinas virtuales (VM) en las que implementaron tus productos.
  • Informe de generación de clientes potenciales (para productos de VM): contiene información de contacto para clientes que dieron su consentimiento para compartir esta información contigo.
  • Informe de migración de SKU: Si migramos tus SKU de producto a un servicio o estructura de Facturación de Cloud diferente, este informe te dará información sobre la migración para que puedas adaptar la transferencia de tu informe.

Tus informes se entregarán en una carpeta de Google Drive, un bucket de Cloud Storage o ambos. Si quieres consultar los pasos a fin de configurar los destinos de tu informe, consulta Configuración de informes.

Para obtener información sobre cómo se facturan los clientes y cómo configurar los pagos, consulta Recibe pagos de Google.

Configura informes

Para recibir tus informes de Google Cloud Marketplace, configura una carpeta de Drive, un bucket de Cloud Storage o ambos. Debe ser propietario del destino que elijas. Por ejemplo, si usas una carpeta de Drive, tu cuenta de Google Cloud debe tener el permiso Puede organizar, agregar y editar para la carpeta.

Tus informes se pueden almacenar en una ubicación de Drive compartida, un bucket de Cloud Storage o ambos. Cuando configures tu destino, el administrador de Google Workspace o Cloud Storage debe asegurarse de que los destinos se puedan compartir con los dominios google.com y system.gserviceaccount.com.

Cuando agregas el destino de tu informe, las siguientes cuentas se agregan como editores o administradores de objetos de almacenamiento, según corresponda:

  • La cuenta de servicio cloud-marketplace-stats@system.gserviceaccount.com, que sube los informes en el depósito.
  • El grupo de Google gcp-marketplace-business-operations@google.com, para depurar y solucionar problemas que puedas tener con los informes.

Si configuras un bucket de Cloud Storage, te recomendamos usar las listas de control de acceso (LCA) para el bucket. También te recomendamos quitar las políticas de retención que tengas en el bucket, ya que esto podría impedir que los informes se actualicen hasta que finalice el período de retención.

Si usas el acceso uniforme a nivel de bucket, ten en cuenta que las siguientes políticas de la organización pueden interferir en el acceso:

Para quitar estas políticas de la organización de tu bucket, en la carpeta o el proyecto que contiene tu bucket, solicita al administrador de políticas de tu organización que establezca la política como el control predeterminado de Google.

Después de configurar una ubicación para almacenar los informes, debes configurar la forma en que se entregan. A fin de configurar la entrega, sigue estos pasos en función de si usas Producer Portal o el Portal para socios a fin de administrar tu producto:

Producer Portal

  1. En Producer Portal, abre la página Informes de los socios. El vínculo directo a la página es el que se muestra a continuación:

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

    Tu ID de proyecto público es el ID del proyecto que aloja los componentes de tu producto. Este proyecto se crea cuando te registras para convertirte en socio.

  2. Para agregar un destino de informe, haz clic en Agregar destino.

  3. En Ubicación de destino, selecciona si quieres enviar informes a una carpeta de Drive o a un bucket de Cloud Storage.

  4. Haz clic en Examinar y selecciona una carpeta o depósito, según corresponda.

  5. Selecciona los informes para guardar en ese destino. Puedes enviar cada informe a tantos destinos como necesites.

  6. Si quieres niveles de detalle adicionales en los informes de uso, en Opciones de informes de uso, selecciona una o más de las siguientes opciones:

    • Separa el uso del cliente por ubicación: divide tu informe de uso y desembolso por las ubicaciones de los clientes.
    • Separa el uso del cliente por cuenta de facturación: divide tu informe de uso y desembolso de las cuentas de Facturación de Cloud de los clientes.

    Para obtener información sobre lo que se incluye en el informe, consulta Informes de uso y desembolso.

  7. Si deseas configurar más destinos, repite estos pasos.

  8. De manera opcional, agrega una o más cuentas de facturación de Cloud a fin de usarlas para las pruebas. Para obtener información sobre las pruebas de productos, visita Prueba los productos de Google Cloud Marketplace publicados.

  9. Para guardar los cambios, haz clic en Guardar. Debes estar de acuerdo en dar acceso a las cuentas de Google Cloud Marketplace a tus destinos de informes.

Portal para socios

  1. En el portal de Partners, abre la página Informes de los socios. El vínculo directo a la página es el que se muestra a continuación:

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

    Tu ID de proyecto público es el ID del proyecto que aloja los componentes de tu solución. Este proyecto se crea cuando te registras para convertirte en socio.

  2. Para agregar un destino de informe, haz clic en Agregar destino.

  3. En Ubicación de destino, selecciona si quieres enviar informes a una carpeta de Drive o a un bucket de Cloud Storage.

  4. Haz clic en Examinar y selecciona una carpeta o depósito, según corresponda.

  5. Selecciona los informes para guardar en ese destino. Puedes enviar cada informe a tantos destinos como necesites.

  6. Si quieres niveles de detalle adicionales en los informes de uso, selecciona una o más de las siguientes opciones:

    • Separa el uso del cliente por ubicación: divide tu informe de uso y desembolso por las ubicaciones de los clientes.
    • Separa el uso del cliente por cuenta de facturación: divide tu informe de uso y desembolso de las cuentas de Facturación de Cloud de los clientes.

    Para obtener información sobre lo que se incluye en el informe, consulta Informes de uso y desembolso.

  7. Si deseas configurar más destinos, repite estos pasos.

  8. Para guardar los cambios, haz clic en Guardar. Debes estar de acuerdo en dar acceso a las cuentas de Google Cloud Marketplace a tus destinos de informes.

Informes de uso y desembolso

El décimo día hábil de cada mes, se generarán dos informes en el destino que configuraste, con los detalles de uso y los ingresos del mes anterior. Estos dos informes tienen nombres que comienzan con el primer día del mes: YYYYMMDD; por ejemplo, 20210401 significa que el informe corresponde al uso que se realizó en abril de 2021.

Informe de uso y cargos

El informe YYYYMMDD Charges and Usage incluye el contenido que se muestra a continuación. Si tienes preguntas sobre el informe, comunícate con tu ingeniero socio.

  • SKU: corresponde a la descripción del producto de Google Cloud Marketplace.

  • Entidad de Google: corresponde a la corporación de Google que recibió el pago de los clientes. El pago que recibes proviene de esta corporación.

  • Recurso: corresponde al recurso en el que se ejecutó el producto. Se muestra según tu modelo de precios.

  • Uso: corresponde a la cantidad de recursos que se usaron en las implementaciones del producto.

  • Unidades: corresponde a la unidad en que se mide la columna de uso, como horas, horas básicas o gigabyte, según tu modelo de precios.

  • Divisa: corresponde a la divisa con que se miden las tres siguientes columnas.

  • Cargos: corresponde a los costos del cliente por usar tu producto. A partir del informe de abril de 2021, si pagas en una moneda distinta del dólar estadounidense, este campo usa tu moneda de pago.

  • Uso de prueba: corresponde al costo cubierto por los créditos de prueba del producto. A partir del informe de abril de 2021, si pagas en una moneda distinta del dólar estadounidense, se usa tu moneda de pago.

  • Saldo para el socio: corresponde al pago acumulado que recibirás, calculado como (Charges - Trial Use) * revenue share.

  • Tipo de pago: significa que recibirás el reembolso: si es old, recibirás pagos de Google de EE.UU. o una entidad regional de Google hacia tu cuenta bancaria en EE.UU. Si es new, recibirás un solo pago en tu cuenta bancaria local.

  • Retenido: Si la cuenta de facturación de un cliente de Google Cloud se suspende debido a la falta de pago, Google retendrá los pagos hasta que la cuenta vuelva a estar en regla.

    Esta columna te indica cuánto te habríamos pagado si lo hubiéramos recopilado del cliente.

    Cuando la cuenta de facturación vuelva a estar en regla, enviaremos los fondos retenidos en el próximo pago. Si nunca vuelve a estar en regla, abandonamos los fondos retenidos.

  • Lanzamiento: Si Google retuvo fondos, esta columna muestra el total de los fondos que se liberan porque la cuenta de facturación del cliente vuelve a estar en regla.

  • Abandono: Si Google retuvo fondos, esta columna muestra el total de los fondos abandonados porque cancelamos la cuenta.

  • Inicio de prueba: Es el primer día en que Google comenzó a retener fondos, en formato YYYY-MM-DD. Si enviamos o abandonamos fondos, es posible que sea en un mes anterior. Si la cuenta aún se encuentra en prueba, este es el primer día del mes actual en el que retuvimos los fondos (que puede no ser el primer día en el que retuvimos los fondos).

  • Finalización de la prueba: Es el último día que Google retendrá los fondos, en formato YYYY-MM-DD. El día después de esto, la cuenta regresa a estar en regla o la cerramos. Si se deja en blanco, la cuenta aún está en prueba.

  • Inicio del reembolso: El primer día en que Google reembolsó el uso de un cliente, en formato AAAA-MM-DD.

  • Fin del reembolso: El último día que Google reembolsó el uso de un cliente, en formato AAAA-MM-DD.

  • Reembolso del saldo deducido este mes: El importe del pago que Google restó durante el mes en relación con un reembolso del cliente.

  • Reembolso del saldo pendiente: Si la compensación relacionada con el reembolso de un cliente es mayor que el pago del mes, es la compensación restante debido a tu pago futuro.

  • Razón del reembolso: El motivo por el que un cliente recibió el reembolso.

De forma predeterminada, el informe se desglosa por SKU, entidad de Google y recurso. Cuando configuras tus informes, puedes elegir estos desgloses adicionales:

  • Por cuenta: esto agrega las columnas ID de cuenta y, también, ID de cuenta de estadísticas al informe, que muestra un ID de facturación del cliente. Puedes usar este ID para hacer un seguimiento de las métricas, como deserciones o conversiones de prueba. El ID de la cuenta no es el ID de facturación de Google Cloud del cliente, pero es específico de la cuenta de facturación del cliente. Hay dos formas de ID de cuenta ocultos en el informe porque, por razones históricas, los dos informes usan algoritmos diferentes para ocultar el ID de cuenta real. Usa el ID de la cuenta de estadísticas para hacer coincidir el desembolso con la información sobre el cliente en el informe de estadísticas del cliente.

  • Por ubicación: esto agrega al informe la columna Ubicación, que contiene el código de país para la ubicación del cliente. La columna incluye el código de país y estado, si el cliente se encuentra en los EE.UU. o Canadá.

Si necesitas vincular un pago en el informe de cargos y uso al nombre del cliente, deberás hacer lo siguiente:

  1. Habilita los informes de by account.
  2. Configura la recepción de informes de estadísticas del cliente
  3. Usa la columna Insights Account Id para encontrar la fila en los informes de estadísticas de clientes con la columna external_account_id coincidente.

Informe de desembolsos

El segundo informe es el informe de YYYYMMDD Disbursements. En este informe, se detalla el dinero que se te transfirió de Google hacia ti durante el mes. Incluye el siguiente contenido:

  • Entidad: El nombre de la entidad corporativa de Google que emite el pago, o las entidades especiales Abandoned Payout o Released Payout:

    Released Payout
    Indica el dinero que Google retuvo porque el cliente era un moroso, que ahora recibió y te está pagando.
    Abandoned Payout
    indica el dinero que retuvo Google porque el cliente estaba en mora, que nunca se pagará porque Google determinó que no se puede recolectar.
  • Moneda: Corresponde a la divisa con que se paga el dinero.

  • Importe: El total del desembolso, antes de cualquier ajuste.

  • Reembolso de los clientes: cualquier ajuste debido a que se le reembolsó dinero a los clientes por tus productos.

  • Total: El importe final después de los ajustes.

  • Notas: El motivo del ajuste.

  • Tipo de pago: Los medios por los cuales recibes el reembolso. Si el valor es old, recibirás uno o más pagos de Google o una entidad regional de Google en tu cuenta bancaria de EE.UU. Si el valor es new, recibirás un solo pago en tu cuenta bancaria local.

Informe sobre estadísticas del cliente

También recibirás un informe de estadísticas del cliente diario y mensual, que incluye información sobre quiénes son tus clientes y cómo usan tu software. Los informes diarios se generan con un retraso de dos días, según la hora del Pacífico (PT). Por ejemplo, el informe del 1 de junio se genera el 3 de junio. El informe mensual se genera el segundo día corrido del mes siguiente.

Cuando un cliente configura su cuenta de facturación de Cloud, elige si se trata de una cuenta comercial o una cuenta personal. Excluimos la información de identificación del informe de estadísticas personalizadas para las cuentas que el cliente identificó como una cuenta personal. Verás n/a en esas columnas de identificación para esas cuentas.

El Informe de ventas contiene la siguiente información, a partir del 13 de julio de 2018:

Campo Descripción
date La fecha de los informes de uso.
company El nombre de la empresa del cliente. Este se excluirá del informe si el cliente usa una cuenta personal.
domain El dominio de correo electrónico del administrador de facturación de la organización. Si hay varios administradores asociados con la cuenta de facturación, en el informe se usará el dominio que más usen. Se excluirá del informe si el cliente usa una cuenta personal.
external_account_id El ID de la cuenta de estadísticas, que se genera para la cuenta de facturación asociada al proyecto del cliente.
account_id La cuenta de facturación asociada con el cliente.
country El país del cliente.
state_or_province El estado o la provincia del cliente, si corresponde.
postal_code El código postal del cliente, si corresponde. Se excluirá del informe si el cliente usa una cuenta personal.
sku_id El SKU por el cual se cobró al cliente. Según la configuración del producto, es posible que una única implementación tenga varios ID del SKU. Por ejemplo, es posible que un SKU abarque el costo de uso de CPU en la implementación, pero quizás otro ID del SKU cubra el costo de uso de RAM.
sku_description Es la descripción del SKU. Por ejemplo, si un cliente implementó un producto de WordPress que se cobra según la cantidad de núcleos de CPU, la descripción de SKU será similar a la “Tarifa de licencia por implementación en un clic de WordPress” (costo de CPU).
usage La cantidad de recursos que usó el cliente.
unit La métrica con la que se mide el uso, como por hora o gibibyte por hora.
currency La divisa en que recibes los pagos.
charges Los cargos que se facturaron al cliente durante el período.
due_vendor El importe que recibirás por el uso.
trial_use Créditos de prueba que utilizó el cliente, si corresponde.
num_vms La cantidad de VM en las que el cliente implementó el producto.
num_cpus La cantidad de núcleos de CPU virtuales en la implementación del cliente. Si es una fracción, significa que el cliente eligió una CPU virtual compartida.
ram_mb El tamaño de la RAM en la implementación del cliente.
num_gpus La cantidad de GPU en la implementación del cliente.
gpu_types Una lista separada por espacios de los tipos de GPU en la implementación del cliente. Por ejemplo, el valor “NVIDIA_TESLA_P4 none NVIDIA_TESLA_P100” indica que al menos una VM usaba una NVIDIA® Tesla® P4, al menos una usaba una GPU P100 y al menos una VM no tenía GPU. Para obtener una lista de las GPU disponibles en Compute Engine, consulta GPU en Compute Engine.
earliest La fecha más temprana (UTC) en la que el cliente creó una VM que estuvo activa durante el período del informe.
latest La última fecha (UTC) en la que el cliente creó una VM que estuvo activa durante el período del informe.
machine_spec_sum Una lista separada por espacios de recuentos nuevos y totales por [tipo de máquina](/compute/docs/machine-types). Por ejemplo, el valor “F1_MICRO:0/1 G1_SMALL:2/3” indica que se usó 1 VM f1-micro y 3 VM g1-small durante el período actual, de las cuales 0 VM f1-micro y 2 VM g1-small son nuevas.
quote_id Si generaste ingresos a partir de una oferta privada, el ID de cotización asociado al producto de la oferta y a la cuenta de facturación.
quote_creator Si generaste ingresos a partir de una oferta privada, la dirección de correo electrónico del creador de la oferta.
internal_note Si generaste ingresos a partir de una oferta privada, incluye una nota interna opcional para la oferta. Puedes usar notas internas a fin de etiquetar las ofertas para su procesamiento adicional, como el seguimiento de los datos de uso o ingresos que generan. Especificas la nota interna cuando creas la oferta.
payment_type Los medios por los que recibirás el reembolso: si es old, recibirás pagos de Google de EE.UU. o de una entidad regional de Google en tu cuenta bancaria de EE.UU. Si es new, recibirás un solo pago en tu cuenta bancaria local.
withheld Si la cuenta de facturación de un cliente de Google Cloud se suspende debido a la falta de pago, Google retendrá los pagos hasta que la cuenta vuelva a estar en regla. En esta columna, se indica cuánto te habríamos pagado si lo hubiéramos recopilado del cliente. Cuando la cuenta de facturación vuelva a estar en regla, enviaremos los fondos retenidos en el próximo pago. Si nunca vuelve a estar en regla, abandonamos los fondos retenidos.
released Si Google retuvo fondos, esta columna muestra el total de los fondos que se liberan porque la cuenta de facturación del cliente vuelve a estar en regla.
abandoned Si Google retuvo fondos, esta columna muestra el total de los fondos abandonados porque cancelamos la cuenta.
probation_start El primer día en el que Google comenzó a retener fondos, en formato YYYY-MM-DD. Si enviamos o abandonamos fondos, es posible que sea en un mes anterior. Si la cuenta sigue en prueba, este es el primer día del mes actual en que retuvimos los fondos, que podrían no ser el primer día en que comenzamos a retener los fondos.
probation_end El último día que Google retendrá los fondos, en formato YYYY-MM-DD. El día después de esto, la cuenta regresa a estar en regla o la cerramos. Si se deja en blanco, la cuenta aún está en prueba.
start_date El primer día en que la autorización está activa, en formato YYYY-MM-DD. La fecha se determina por la suscripción asociada o la oferta privada de la autorización. Si la autorización se creó antes del 10/01/2021, el valor es NULL.
end_date El último día en que la autorización está activa, en formato YYYY-MM-DD. La fecha se determina por la suscripción asociada o la oferta privada de la autorización. Si la autorización se creó antes del 10/01/2021, el valor es NULL.

Información adicional para ofertas de prepago

Si creaste ofertas privadas que usan una programación de pagos de prepago, es posible que veas la siguiente información adicional:

Campo Descripción
payment_mode Indica el tipo de programación de pagos de la oferta. El valor puede ser PREPAY, PREPAY_INSTALLMENTS o POSTPAY.
private_offer_acceptance_date La fecha en la que el cliente aceptó la oferta privada.
private_offer_total_contract_value Importe total que paga el cliente en todas las cuotas de la oferta privada.
order_start_date Es la fecha de entrada en vigencia del precio de la oferta privada.
order_end_date La fecha en la que el precio de la oferta privada ya no está vigente.

Informe de generación de clientes potenciales

En el caso de los productos de VM, puedes obtener el informe de generación de clientes potenciales que incluya información diaria, como direcciones de correo electrónico y números de teléfono.

Si deseas recopilar esta información, comunícate con tu ingeniero socio con la siguiente información:

  • Los campos que deseas en tu informe para cada producto.

  • La URL de la Política de Privacidad que estipula cómo usarás los campos que recopilas. Recomendamos ser explícito sobre para qué usarás la información, de modo que los clientes se sientan cómodos compartiéndola.

Los campos y la Política de Privacidad se usan para crear un formulario de consentimiento. Cuando los clientes comiencen a implementar un producto de VM por primera vez, verán la información que desean recopilar y tu Política de Privacidad. Después de revisar la información, los clientes pueden otorgar o denegar su consentimiento para compartir su información contigo.

La primera fila del informe contiene la cantidad de clientes que optaron por no compartir su información y las horas de inicio y finalización que abarca el informe. Todas las respuestas de los clientes en el informe son de entre los dos momentos. Las horas se basan en la zona horaria UTC y están en el formato ISO YYYY-MM-DDTHH:MM:SS+00:00. Por ejemplo, la medianoche UTC del 14 de marzo de 2019 se muestra como 2019-03-14T00:00:00+00:00.

Para los clientes que optaron por participar, el informe contiene la siguiente información:

Campo Descripción
Nombre El nombre del cliente
Correo electrónico La dirección de correo electrónico del cliente
Datos El nombre de la empresa del cliente. Si el cliente no está asociado con una empresa, el valor es “_none_”.
Código de país El código de dos letras del país del cliente Por ejemplo, el código de dos letras para Francia es FR.
Address La dirección del cliente
Phone El número de teléfono del cliente

Informe de migración de SKU

A veces, es posible que cambiemos la estructura de los SKU relacionados con tus producto, o el producto en la Facturación de Cloud. Cuando esto sucede, creamos un archivo sku-migration-report.csv en la misma ubicación que tus informes de estadísticas de clientes. Cada SKU está ubicado en un servicio, con un ID hexadecimal de 3 partes con el formato 0123-4567-89AB. Además, cada SKU tiene su propio ID hexadecimal de 3 partes que es independiente del ID de servicio y es único en todos los servicios. Verás el ID de SKU en la columna sku_id en el informe de estadísticas de los clientes.

El informe de migración de SKU se actualiza a diario. Si tienes una política de retención en tu bucket de Cloud Storage, la actualización se demora hasta que haya pasado el período de retención. El informe contiene la siguiente información:

Campo Descripción
source_sku_id El ID de SKU del SKU anterior.
target_sku_id El ID de SKU del SKU que reemplazó al original. Si está en blanco, entonces el SKU original no tiene reemplazo.
target_service_id El ID de servicio en el que se define el SKU de reemplazo. Si está en blanco, entonces el SKU original no tiene reemplazo.
seller El nombre de tu empresa
product El nombre del producto con el que se relaciona el SKU.
source_sku_name Un nombre legible del SKU de origen (esto no es la forma en que aparece en la factura del cliente).
target_sku_name Un nombre legible del SKU que reemplazó al original. Si está en blanco, entonces el SKU original no tiene reemplazo.