Integración directa con Google Play Store para Android

Admitimos suscripciones y compras únicas (productos dentro de la app). El paso 11 más abajo te pide activar las notificaciones para ambos tipos, y ambos se atribuyen y generan comisión de la misma forma.

Notificaciones para desarrolladores en tiempo real

Las notificaciones para desarrolladores en tiempo real RTDN son necesarias para que Insert Affiliate pueda registrar los eventos de compra.

1. Define el método de verificación de compras en Insert Affiliate

En la configuración de Insert Affiliate (pestaña Integraciones), define tu Método de Verificación de Compras en la App como "No uso un validador de recibos (integración Nativa de App Store / Google Play)".

  • Después de cambiar esta configuración, aparecerá una nueva sección llamada "URL del Endpoint Pub/Sub de Google Play Store", que contiene una URL; la necesitarás más adelante.
Sección de verificación de compras en la configuración del panel de Insert Affiliate con el desplegable del método de verificación resaltado

Haz clic para ver a tamaño completo

2. Activa Google Cloud Pub/Sub para tu proyecto

  1. Ve a Google Cloud Console e inicia sesión con la cuenta de Google asociada a tu app.
  2. Crea un proyecto nuevo o selecciona uno existente.
  3. Activa la Cloud Pub/Sub API, que puedes encontrar aquí

3. Crea un tema de Pub/Sub

  1. Crea un tema nuevo aquí, con insert-affiliate como Topic ID.
  2. Deja la configuración predeterminada y haz clic en Create.

4. Crea una cuenta de servicio

  1. Ve a la página Service Accounts de Google Cloud Console.
  2. Haz clic en Create Service Account, indica un nombre (p. ej. insert-affiliate) y haz clic en Create.
  3. Copia la dirección de correo electrónico de la cuenta de servicio que acabas de crear.

5. Crea una clave para la cuenta de servicio

  1. Haz clic en la cuenta de servicio que acabas de crear.
  2. Haz clic en Add Key > Create new key.
  3. Selecciona JSON y haz clic en Create.
  4. Sube la clave de servicio que se descargó a la página de configuración de Insert Affiliate (pestaña Integraciones), en Clave de Cuenta de Servicio de Google.
  5. Haz clic en Guardar.

5.1 Asigna roles de IAM a la cuenta de servicio

Antes de continuar, debes conceder los permisos correctos a la cuenta de servicio en Google Cloud IAM.

  1. Ve a Google Cloud IAM & Admin.
  2. Busca la Service Account que acabas de crear; si no existe, selecciona Grant Access y define el New Principal con la dirección de correo electrónico de la cuenta de servicio que creaste en el paso 4.
  3. Haz clic en Edit Permissions.
  4. Asigna los siguientes roles:
  • Pub/Sub Admin (para gestionar las notificaciones de Google Play)
  1. Haz clic en Save para aplicar los cambios.

Ahora tu cuenta de servicio tiene los permisos necesarios para interactuar con

6. Configura los permisos de Pub/Sub

  1. Ve a la sección Topics de Google Cloud Console y selecciona el tema insert-affiliate que acabas de crear.
  2. En Topic Settings, haz clic en Add Principal.
  3. Pega la dirección de correo electrónico de la cuenta de servicio que creaste en el paso 4.
  4. En el desplegable Role, selecciona Pub/Sub Publisher y haz clic en Save.

7. Añade la cuenta de notificaciones de Google Play al tema de Pub/Sub

  1. Ve a la sección Topics de Google Cloud Console y selecciona el tema insert-affiliate que acabas de crear.
  2. En Topic Settings, haz clic en Add Principal.
  3. Pega la dirección de correo electrónico [email protected]
  4. En el desplegable Role, selecciona Pub/Sub Publisher y haz clic en Save.

8. Crea una suscripción

  1. Ve a la sección Subscriptions de Google Cloud Console.
  2. Selecciona el tema insert-affiliate.
  3. Haz clic en Edit.
  4. Cambia el Delivery Type a Push.
  5. Pega la URL del Endpoint Pub/Sub de Google Play Store de la configuración de Insert Affiliate, obtenida en el paso 1, en el campo Push Endpoint.
  6. Haz clic en Update para guardar los cambios.

9. Activa la Google Play Android Developer API

Antes de conceder permisos, asegúrate de que la Google Play Android Developer API esté activada:

  1. Ve a la página de Google Play Android Developer API en Google Cloud Console.
  2. Haz clic en Enable API.

10. Concede permisos en Google Play Console

  1. Ve a Users and Permissions en Google Play Console.
  2. Haz clic en Invite new users.
  3. Introduce la dirección de correo electrónico de la cuenta de servicio que creaste en el paso 4.
  4. Selecciona la app para la que quieres conceder permisos
  • Concede el permiso Financial Data: View Financial Data and Manage Orders and Subsciprtions.
  1. Pulsa Apply para guardar los cambios.

10.1 Actualiza las suscripciones activas

Si antes usabas otro método de validación de recibos, es posible que tengas que desactivar y volver a activar tus suscripciones en Google Play para que Insert Affiliate las reconozca correctamente.

  1. Ve a Google Play Console.
  2. Selecciona tu app.
  3. Ve a Monetise with Play > Subscriptions.
  4. Selecciona cada suscripción activa y desactívala temporalmente.
  5. Tras unos instantes, vuelve a activar las suscripciones.
  6. Esto obliga a Google Play a reconocer la nueva integración de Insert Affiliate.

11. Activa las RTDN en tu app en Google Play Console

  1. Ve a Google Play Console.
  2. Selecciona tu app.
  3. En la navegación de la izquierda, selecciona Monetise with Play > Monetisation Setup.
  4. Activa la casilla *Real-time developer notifications.
  5. Añade el Topic Name como projects/{{ProjectID}}/topics/{{TopicID}} (sustituye {{ProjectId}} y {{TopicID}} por los ID del Google Cloud Project y del Topic definidos antes). Para el ejemplo anterior, el Topic Name sería projects/insert-affiliate/topics/insert-affiliate.
  • Puedes encontrar el ID de tu Google Cloud Project aquí.
  • Puedes encontrar el ID de tu Google Cloud Topic aquí.
  1. El contenido de las notificaciones debe configurarse como Subscriptions, voided purchases and all one-time products.
  2. Haz clic en Save.

12. Si antes no validabas los recibos

Si antes no validabas los recibos, es posible que tengas que desactivar y volver a activar tus suscripciones en Google Play para que Insert Affiliate las reconozca correctamente.

  1. Ve a Google Play Console.
  2. Selecciona tu app.
  3. Ve a Monetise with Play > Subscriptions.
  4. Selecciona cada suscripción activa y desactívala temporalmente.
  5. Tras unos instantes, vuelve a activar las suscripciones.
  6. Esto obliga a Google Play a reconocer la nueva integración de Insert Affiliate.

Integra el SDK de Insert Affiliate

Para completar la integración, sigue los pasos finales de integración que se detallan en el SDK de Insert Affiliate para tu plataforma: