RevGlanceDocumentación

Google Play

Conecta Google Play con una service account que lee los informes de tu Play Console y la Play Developer API.

RevGlance lee los informes mensuales de sales y earnings del bucket de Cloud Storage de tu Play Console, y consulta a la Play Developer API los periodos de facturación, los reembolsos y, con las notificaciones en tiempo real, las pruebas y las cancelaciones.

Conectar

  1. En Google Cloud, crea una service account en un proyecto, añádele una clave JSON y descárgala. Activa la Google Play Android Developer API para el proyecto.
  2. En Play Console, abre Users and permissions, invita al correo de la service account y dale View financial data para tu app.
  3. Copia tu bucket de informes desde Download reports › Financial: la parte pubsite_prod_rev_… del URI de Cloud Storage.
  4. Rellena el bucket, el nombre de paquete de tu app (com.example.app) y la clave JSON completa, y elige Conectar Google Play. Una invitación nueva puede tardar hasta un día en dar acceso a los informes.

Qué pide el formulario

CampoAspecto
Bucket de informespubsite_prod_rev_01234567890987654321
Nombre del paquetecom.example.app
JSON de la cuenta de servicioSe guarda cifrado{ "type": "service_account", … }

La service account inicia sesión con acceso de solo lectura a Cloud Storage (devstorage.read_only) y a la Android Publisher API.

Añadir el webhook

Sin las notificaciones, las pruebas son invisibles y una cancelación solo aparece cuando una renovación lleva tres días vencida. Con ellas, RevGlance conoce el purchase token de cada suscripción y pregunta a Play por su estado en tiempo real.

  1. En RevGlance, abre Configuración › Fuentes, abre el menú de la fuente de Google Play y elige Webhook. Guarda un secreto largo y aleatorio en Secreto de firma.
  2. En Google Cloud, crea un tema de Pub/Sub y permite que Google Play publique en él, como explica la página Monetization setup de Play Console.
  3. Añade una suscripción push al tema. Su endpoint es la URL del webhook con ?token= y tu secreto al final.
  4. En Play Console, abre Monetization setup, introduce el tema y envía una notificación de prueba. RevGlance confirma la recepción de las pruebas y de las notificaciones de otras apps sin actuar sobre ellas.

Qué esperar

  • Los informes llegan tarde. Google los publica entre tres y siete días después de la venta. Primero llegan las ventas; después las ganancias las sustituyen con lo que Google te pagó.
  • Clientes anónimos. Play no da nombres de compradores. Los pedidos de una misma suscripción comparten una raíz de ID (GPA.1234…), que se convierte en un cliente anónimo. Las compras únicas no tienen cliente.
  • Los reembolsos a través de la API llegan hasta 30 días atrás. Los reembolsos más antiguos llegan con el informe de ganancias.

Cómo se cuenta Google Play

  • Google publica los informes con tres a siete días de retraso. Primero llegan las ventas; después, las ganancias las sustituyen por lo que Google te pagó, tras su comisión. Los cobros cuentan antes de impuestos.
  • Se conserva cada línea de reembolso, también las parciales. Dos reembolsos parciales de un pedido repartidos en dos informes mensuales pueden coincidir, y uno puede perderse. Google no dice si los reembolsos son negativos en sus informes, así que se leen como importes reembolsados.
  • Los reembolsos a través de la API de Play solo llegan 30 días atrás. Los más antiguos llegan con el informe de ganancias.
  • Sin notificaciones en tiempo real, una cancelación solo aparece como una renovación con tres días de retraso, contada cuando los informes cubren ese día.
  • Las compras de prueba se dejan fuera. Una suscripción en espera sigue contando; una en pausa cuenta como baja hasta que se reanuda.
  • El MRR es el último pedido, antes de impuestos. Una oferta introductoria cuenta a su precio de oferta, y luego el precio normal aparece como una expansión.
  • Los cobros fallidos no se informan, así que esa cifra se queda en cero.