Configuración de suscripciones para aplicaciones de Android
Para que nuestro sistema se pueda comunicar con Google, debes proporcionar un conjunto de credenciales de servicio. En este artículo, te mostraremos cómo vincular tu proyecto de Google Cloud con Play Console y cómo autorizarlo mediante una cuenta de servicio.
- Configura las notificaciones de los desarrolladores en tiempo real para Android en tu cuenta de Google Play. Si configuras las notificaciones del servidor, Google Play Store notificará a nuestro sistema cuando haya alguna actualización en las suscripciones de tu aplicación. Esto permite que nuestro sistema active los eventos de suscripción a tiempo.
- Crea tu clave pública JSON para tu cuenta de servicio de Google. Necesitarás la clave JSON para conectar tu cuenta de servicio de Google con Adjust.
- Otorga acceso financiero a tu cuenta de servicio.
- Conecta tu cuenta de servicio de Google en Adjust.
Antes de comenzar
Esto es lo que debes saber antes de comenzar.
Suscripciones está disponible como herramienta de crecimiento de Adjust. Comunícate con tu representante de Adjust o envía un correo electrónico a sales@adjust.com para agregar esta herramienta a tu paquete.
Requisitos
- Permisos de
Account owner
en Google Play Console - Permisos para crear temas, crear suscripciones y asignar roles en Google Cloud Console
- Permisos de administrador, editor o editor personalizado en Adjust para conectar las credenciales de tu cuenta de servicio de Google con Adjust
Cómo configurar las notificaciones de los desarrolladores en tiempo real
Crea una suscripción push
Abre la sección de Topics (Temas) en Google Cloud Console.
Selecciona tu proyecto.
Selecciona Create topic (Crear tema).
Escribe el ID del tema y selecciona Create (Crear).
En el panel de navegación izquierdo, dirígete a la sección de Pub/Sub y selecciona Subscriptions (Suscripciones).
Selecciona Create subscription (Crear suscripción).
Escribe el ID de la suscripción.
En la lista titulada Select a Cloud Pub/Sub topic (Selecciona un tema de Cloud Pub/Sub), selecciona el tema que creaste en el paso 4.
En la opción Delivery type (Tipo de entrega), selecciona Push.
En el campo Endpoint URL , escribe
https://subscription.adjust.com/v3/playstore
.En la opción Retry policy (Política de reintento), selecciona Retry after exponential backoff delay (Reintentar después de un retraso de retirada exponencial) y escribe lo siguiente:
- Minimum backoff time (Tiempo mínimo de retirada): 10
- Maximum backoff time (Tiempo máximo de retirada): 600
Selecciona Create (Crear).
Cómo agregar una principal a tu suscripción
- Selecciona la suscripción que creaste y luego selecciona Add principal (Agregar principal).
- En el campo New principals (Nuevas principales), escribe
google-play-developer-notifications@system.gserviceaccount.com
. - En la lista titulada Assign roles (Asignar roles), selecciona Pub/Sub Publisher.
- Haz clic en Save (Guardar).
Copia el valor del nombre del tema
- Abre la sección de Topics (Temas) en Google Cloud Console.
- Selecciona el tema que agregaste al crear una suscripción push y copia el valor de su nombre.
- Tal vez debas seleccionar (ícono de flecha hacia abajo) para ver el nombre completo del tema. Luego, selecciona (ícono de Copiar) para copiar el valor del nombre del tema.
Necesitarás este valor en el siguiente paso.
Habilita las notificaciones de los desarrolladores en tiempo real para tus aplicaciones
- Abre Google Play Console.
- Selecciona tu aplicación.
- En la opción Monetize (Monetizar), selecciona Monetization setup (Configuración de monetización).
- Desplázate hacia abajo hasta la sección Google Play Billing (Facturación de Google Play).
- En la opción Manage notifications (Administrar notificaciones), selecciona Enable real-time notifications (Habilitar notificaciones en tiempo real).
- En el campo Topic name (Nombre del tema), pega el nombre del tema que copiaste en el paso anterior.
- Selecciona Save changes (Guardar cambios).
Repite los pasos del 2 al 7 con cada aplicación para la que desees configurar suscripciones.
Cómo crear tu clave pública JSON
Habilita la API de desarrollador de Google Play Android
- Abre Google Play Console.
- Selecciona un proyecto existente o crea uno nuevo.
- Dirígete a APIs & Services (API y servicios) > Enabled APIs and services (API y servicios habilitados).
- Selecciona + Enable APIs and Services (+ Habilitar API y servicios).
- Busca Google Play Android Developer API, selecciona esa opción y luego selecciona Enable (Habilitar).
- Selecciona Create credentials (Crear credenciales).
- En el campo Which API are you using? (¿Qué API utilizas?), selecciona Google Play Android Developer API (API de desarrollador de Google Play Android).
- En el campo What data will you be accessing? (¿A qué datos accederás?), selecciona Application data (Datos de la aplicación) y luego selecciona Next (Siguiente).
Es posible que debas esperar hasta 36 horas para que tus credenciales funcionen adecuadamente con la API de desarrollador de Google Play.
Crea una cuenta de servicio
Para crear una cuenta de servicio, sigue estos pasos.
Abre Google Cloud Console.
Selecciona el mismo proyecto que elegiste en el paso anterior.
Dirígete a IAM y Admin > Service Accounts (Cuentas de servicio).
Selecciona Create Service Account (Crear cuenta de servicio).
En la opción Service account details (Detalles de la cuenta de servicio), proporciona un nombre para tu cuenta de servicio.
- El campo Service account ID (ID de la cuenta de servicio) se llenará automáticamente. Este es el correo electrónico de la cuenta de servicio.
Selecciona Create and Continue (Crear y continuar).
En la sección Grant this service account access to project (optional) (Otorgar acceso al proyecto a esta cuenta de servicio, opcional), elige los siguientes roles y selecciona Continue (Continuar).
- Service Account Key Admin (Administrador de la clave de la cuenta de servicio): esto permite crear y administrar claves de la cuenta de servicio.
- Pub/Sub Admin : esto habilita las notificaciones del servidor de la plataforma.
- Monitoring Viewer (Visor de monitoreo): esto permite el monitoreo de la lista de notificaciones.
Selecciona Done (Listo) para regresar a la página de cuentas de servicio.
Genera las credenciales de tu clave pública
Para generar las credenciales de tu clave pública, sigue estos pasos.
- Abre Google Cloud Console.
- Selecciona el mismo proyecto que elegiste en el paso anterior.
- Dirígete a IAM y Admin > Service Accounts (Cuentas de servicio).
- En la cuenta de servicio que creaste, dirígete a Actions (Acciones) y selecciona Manage keys (Administrar claves).
- Selecciona Add key > Create new key (Agregar clave > Crear nueva clave).
- En Key type (Tipo de clave), selecciona JSON y luego selecciona Create (Crear).
- Al hacer esto, comenzará la descarga de un archivo JSON. Este archivo contiene las credenciales requeridas para la comunicación entre Adjust y Google. Necesitarás este archivo JSON para conectar tu cuenta de Google Service con Adjust.
Otorga acceso financiero
Si deseas otorgar acceso financiero a tu cuenta de servicio, sigue estos pasos.
En Google Cloud Console
- En Google Cloud Console, selecciona el mismo proyecto que elegiste en el paso anterior.
- Dirígete a IAM y Admin > Service Accounts (Cuentas de servicio).
- En la cuenta de servicio que creaste, copia el valor de Email .
- Necesitarás esta dirección de correo electrónico en el siguiente paso.
En Google Play Console
Abre Google Play Console.
Selecciona Users and permissions (Usuarios y permisos) > Invite new users (Invitar nuevos usuarios).
Escribe la dirección de correo electrónico de la cuenta de servicio que obtuviste en el paso anterior.
En la sección App permissions (Permisos de la aplicación), agrega tu aplicación.
En la sección Account permissions (Permisos de la cuenta), selecciona los siguientes permisos:
- View app information (read-only) (Ver información de la aplicación, solo lectura);
- View financial data (Ver datos financieros);
- Manage orders and subscriptions (Administrar pedidos y suscripciones).
Selecciona Invite user (Invitar usuario) y luego selecciona Send invite (Enviar invitación).
Si estas opciones no están disponibles, es posible que no tengas los permisos de la cuenta necesarios. Comunícate con el propietario o el administrador de tu cuenta.
Conecta tu cuenta de Google Service en Adjust
Sigue estos pasos para agregar las credenciales de tu cuenta de Google Service en Adjust.
- En la sección DataWorks, selecciona Conexiones.
- Selecciona + Nueva conexión.
- En la sección Socio, selecciona Cuenta de Google Service.
- En la sección Servicios, selecciona Suscripción.
- En el campo Archivo de credenciales, carga el archivo JSON que descargaste en el paso donde generaste las credenciales de tu clave pública.
- Selecciona Conectar.
➡️ A continuación: habilita las suscripciones para tu aplicación en Adjust.