Informes de sus productos de Google Cloud Marketplace

En esta página, se explica cómo configurar y usar los informes de 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 del software y el importe que se te pagará.
  • Informe de estadísticas de clientes: contiene información sobre quiénes son tus clientes y cómo usan tu 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 de los clientes que aceptaron compartir esta información contigo.
  • Informe de migración de SKU: si migramos los SKU de tu producto a un servicio o a una estructura de la Facturación de Cloud diferente, en este informe se describe la migración para que puedas adaptar la transferencia del 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 más información sobre la facturación de tus clientes y 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 el destino, el administrador de Google Workspace o de 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 que uses 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 la política de retención podría evitar que se actualicen los informes hasta que el período de retención haya terminado.

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

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

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

Producer Portal

  1. En Product Portal, abre la página Informes de 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
    

    El ID del 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 (Destination location), selecciona si deseas 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 que quieres guardar en ese destino. Puedes enviar cada informe a tantos destinos como necesites.

  6. Si deseas niveles adicionales de detalle en los informes de uso, en Opciones de informes de uso, selecciona una o más de estas 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, puedes agregar una o más cuentas de facturación de Cloud para usarlas. Para obtener más información sobre las pruebas de productos, visita Prueba los productos publicados de Google Cloud Marketplace.

  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 (Destination location), selecciona si deseas 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 que quieres 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

Al décimo día hábil de cada mes, se generan 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 cargos y uso

El informe YYYYMMDD Charges and Usage incluye el siguiente contenido. Si tienes preguntas sobre el informe, comunícate con tu ingeniero socio.

  • SKU: Es la descripción del producto 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: El recurso en el que se ejecutó el producto. Se muestra según tu modelo de precios.

  • Uso: Es la cantidad de recursos que usan 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: Los costos del cliente por el uso del producto A partir del informe de abril de 2021, si pagas en una moneda distinta del dólar estadounidense, este campo utilizará la 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, este campo utilizará la moneda de pago.

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

  • Tipo de pago: El medio por el que recibirás el desembolso: si es old, recibes pagos de Google de EE.UU. o de una entidad regional de Google hacia tu residente de EE.UU. cuenta bancaria. 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.

  • Abandonado: Si Google tenía fondos retenidos, en esta columna, se muestra el total de los fondos abandonados porque rescindimos la cuenta de facturación.

  • Inicio de la prueba: El primer día en que Google comenzó a retener fondos, en formato YYYY-MM-DD Si estamos lanzando o abandonando fondos, es posible que sea en un mes anterior. Si la cuenta aún está en estado de prueba, este es el primer día del mes en el que retuvimos los fondos (que puede no ser el primer día en el que retuvimos los fondos).

  • Final de la prueba: El último día en que Google retuvo 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.

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

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

  • Saldo de reembolso deducido este mes: Es el importe de pago que Google dedujo durante el mes en relación con un reembolso del cliente.

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

  • Motivo 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 e ID de cuenta de estadísticas al informe, que muestra un ID de facturación para el cliente. Puedes usar este ID para hacer un seguimiento de las métricas, como deserciones o conversiones de prueba. El ID de 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

  1. Habilite los informes de by account.
  2. Configure la recepción de informes de estadísticas de clientes
  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 que coincide.

Informe de desembolsos

El segundo informe es YYYYMMDD Disbursements. En este informe, se detalla el dinero que se te transfiere de Google 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 había retenido porque el cliente estaba en mora, que ahora recibió, y te lo paga.
    Abandoned Payout
    indica que el dinero había retenido Google porque el cliente estuvo en mora y nunca se le pagará porque Google determinó que no se puede cobrar.
  • Moneda: Corresponde a la moneda en la que se paga el dinero.

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

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

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

  • Notas: El motivo del ajuste.

  • Tipo de pago: El medio por el que recibes el desembolso. Si el valor es old, recibirás uno o más pagos de Google o una entidad regional de Google a 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 es una cuenta comercial o una personal. Excluimos la información de identificación del informe de estadísticas del cliente para las cuentas que el cliente identificó como una cuenta personal. Verás n/a en esas columnas de identificación de 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 de un producto, es posible que una sola implementación tenga varios ID de 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 cobró según la cantidad de núcleos de CPU, la descripción del SKU será similar a “Tarifa de licencia por implementación en un clic (costo por 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 usaron 1 VM con f1-micro y 3 g1-small en el período actual, de los cuales 0 VM con f1-micro son nuevos y 2 VM de g1-small son nuevas.
quote_id Si generaste ingresos a partir de una oferta privada, el ID de cotización asociado con el producto y la cuenta de facturación de la oferta.
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 El medio por el que recibirás el desembolso: Si es old, recibirás pagos de Google EE.UU. o de una entidad regional de Google a 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 que Google comenzó a retener fondos, en formato YYYY-MM-DD. Si retiramos o abandonamos fondos, es posible que el producto esté en un mes anterior. Si la cuenta aún está en estado de prueba, este es el primer día del mes en el que retuvimos los fondos, que puede no ser el primer día en que comenzamos a retener los fondos.
probation_end El último día en que Google retuvo 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 el derecho está activo, en formato YYYY-MM-DD. La fecha se determina según la suscripción privada 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 el derecho está activo, en formato YYYY-MM-DD. La fecha se determina según la suscripción privada o la oferta privada de la autorización. Si la autorización se creó antes del 10/01/2021, el valor es NULL.

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 incluye la información de los clientes, como direcciones de correo electrónico y números de teléfono. Puedes optar por recibir este informe de forma diaria, semanal, quincenal o mensual.

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

  • Para cada producto, los campos que deseas incluir en tu informe.

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

  • Con qué frecuencia deseas que se genere el informe.

Los campos y la Política de Privacidad se usan para crear un formulario de consentimiento. Cuando los clientes comienzan a implementar un producto de VM por primera vez, ven la información que deseas 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
Name 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

En ocasiones, podemos cambiar la forma en que se estructuran los SKU relacionados con tus productos o el producto en la Facturación de Cloud en el que aparecen. 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 se encuentra en un servicio, que tiene 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 del informe de estadísticas de 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 Es 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.