Cómo configurar la verificación de compras para tu aplicación
Para empezar a utilizar la verificación de compras, debes asegurarte de haber configurado correctamente el SDK de Adjust en tu aplicación y haber enviado a Adjust las credenciales necesarias para autorizar las compras desde la tienda correspondiente.
Antes de comenzar
La verificación de compras 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 administrador, editor o editor personalizado en Adjust
- Para crear y administrar las credenciales de las tiendas de aplicaciones:
- Google Cloud: rol de
Service Account Key Admin
en el proyecto o en la cuenta de servicio. - App Store Connect: derechos de
Admin
.
- Google Cloud: rol de
Puntos clave
- La verificación de compras está diseñada únicamente para las compras in-app realizadas por medio de Google Play Store o Apple App Store. No funciona para las compras de artículos físicos.
- Disponible para las aplicaciones de iOS, Android y Unity.
1. Configura el SDK de Adjust
Para integrar la Verificación de compras de Adjust en tu aplicación, asegúrate de tener instalada la versión mínima requerida del SDK y completa los pasos de implementación necesarios para enviar los eventos de ingresos de compras.
2. Busca tus credenciales de la tienda de aplicaciones
Para verificar las compras con una tienda, debes proporcionar a Adjust las credenciales que nos permitan hacer el matching de tu cuenta.
Android:
Parámetro de autenticación | Definición | Ejemplo |
---|---|---|
Clave JSON | Tu clave JSON descargada de la página Cuentas de servicio en Google Cloud Console. | example_key_file |
iOS:
Parámetro de autenticación | Definición | Ejemplo |
---|---|---|
ID del emisor | Tu ID del emisor proveniente de la página Integrations de App Store Connect. | 57246542-96fe-1a63-e053-0824d011072a |
ID de la clave | Tu ID de la clave privada proveniente de la pestaña Integrations de App Store Connect. | 2X9R4HXF34 |
Clave de API de compras in-app | Tu clave de API P8 descargada de App Store Connect. Esta clave autoriza el acceso a los datos de tu aplicación desde la API del servidor de App Store. | -----BEGIN PRIVATE KEY----- MIGTAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBHkwdwIBAQQgNxUqm0R2vt4IrLAQr9gfDPixwSxH9wJZ6NV3X0ax4eWgCgYIKoZIzj0DAQehasda2ANCAAQx53AlofI4Of54lbR04A6D2QMbe0mt8+JtRHkJJCEUesUfySoZsm2jeh3qodLE0pZ2Rayv26qFMKuKEwemB2Op -----END PRIVATE KEY----- |
Sigue las instrucciones correspondientes a la plataforma de tu tienda para encontrar las credenciales necesarias.
Para Android
Para poder crear una clave de la cuenta de servicio para un proyecto o una cuenta de servicio, tu cuenta de usuario debe tener el rol de administrador de la clave de la cuenta de servicio.
Habilita la API de desarrollador de Google Play Android
- En Google Play Console, dirígete a API y servicios.
- Selecciona + Habilitar API y servicios.
- En el campo
Mobile
, selecciona API de desarrollador de Google Play Android. - Selecciona Habilitar.
- Introduce las credenciales de API necesarias.
- En el campo API y servicios habilitados , selecciona API de desarrollador de Google Play Android.
- Selecciona Crear credenciales.
- En el campo
Select an API
, selecciona API de desarrollador de Google Play Android. - En el campo
What data will you be accessing?
, selecciona Datos de la aplicación. - Selecciona Siguiente.
Crea una cuenta de servicio
En Google Cloud, dirígete a Crear cuenta de servicio
Selecciona tu proyecto de Google Cloud.
Escribe un nombre para la cuenta de servicio.
- Cuando hagas esto, se generará automáticamente el ID de la cuenta de servicio.
Opcional: proporciona una descripción de la cuenta de servicio.
Selecciona Crear y continuar .
Otorga acceso al proyecto para la cuenta de servicio
- Asigna el rol Pub/Sub Admin a la cuenta de servicio.
- Selecciona + Agregar otro rol.
- Asigna el rol Visor de monitoreo a la cuenta de servicio.
- Selecciona Continuar .
- Opcional: otorga acceso a esta cuenta de servicio para algunos usuarios
- Selecciona LISTO .
Crea una nueva clave de API
- En Google Cloud, dirígete a IAM y Admin.
- Selecciona Cuentas de servicio para ver las cuentas de servicio de tu proyecto.
- Selecciona Acciones (ícono de tres puntos) en la cuenta de servicio que creaste.
- Selecciona Administrar claves .
- Selecciona Agregar clave > Crear nueva clave.
- En Tipo de clave, selecciona JSON.
- Cuando hagas esto, se descargará automáticamente la clave privada.
Para iOS
Debes tener derechos de administrador en App Store Connect para crear y administrar claves de API.
Busca tu ID del emisor
- En App Store Connect, selecciona el ícono de Usuarios y acceso.
- Selecciona la pestaña Integraciones.
- En el menú Tipo de clave que aparece en el lado izquierdo, selecciona Compra in-app.
- En la parte superior de la página, junto a ID del emisor, selecciona Copiar.
Genera una nueva clave de API
Te recomendamos generar una clave de API especial para la verificación de ingresos in-app de Adjust.
Selecciona Generar clave de API o haz clic en el ícono + para crear una nueva clave.
- Sí aún no solicitas el acceso de API en tu cuenta de App Store Connect, completa la solicitud para hacerlo.
En el campo Nombre , escribe un nombre para la clave.
Selecciona Generar.
Tu nueva clave de API aparecerá en la lista de claves activas con su ID de la clave.
En la clave que generaste, coloca el puntero sobre el valor que aparece en la columna de ID de la clave. Cuando aparezca el link Copiar ID de la clave , selecciónalo.
Selecciona Descargar clave de compras in-app.
Selecciona Descargar para continuar.
Copia la clave de API completa en el archivo descargado.
3. Para iOS: conecta a Adjust con App Store Connect
Sigue estos pasos para agregar las credenciales de App Store Connect en el Dashboard de Adjust:
- En Adjust, dirígete a DataWorks > Conexiones.
- Selecciona + Nueva conexión.
- Selecciona App Store Connect (compra in-app) en la lista.
- En Servicios, selecciona Verificación de compras.
- Escribe tu ID del emisor.
- Escribe tu ID de la clave.
- Abre el archivo .p8 en un editor de texto y copia toda la clave privada. Pégala en el campo Clave privada.
4. Agrega la verificación de compras a tu aplicación
Ahora, aplica la verificación de compras para tu aplicación:
En Adjust, dirígete a AppView y selecciona tu aplicación.
Dirígete a la pestaña Protección.
En la sección Verificación de compras , selecciona Editar ().
ACTIVA el indicador de Verificación de compras.
Proporciona la información específica de la plataforma:
- Para las aplicaciones de iOS: si tienes una aplicación de iOS, debes seleccionar la cuenta de App Store Connect que desees utilizar.
- Para las aplicaciones de Android: carga el archivo de clave JSON que descargaste anteriormente.
Haz clic en GUARDAR .
¡Y eso es todo!
Cómo compartir los datos de ingresos verificados con los socios
La herramienta de verificación de compras de Adjust te permite asegurarte de compartir con tus socios únicamente los datos de ingresos verificados. Esto significa que puedes confiar en los datos compartidos y en su uso para la optimización de campañas.
Si ya configuraste el envío de los ingresos in-app a tus socios en el Dashboard de Adjust, no tienes que hacer ningún cambio. Nuestro sistema reenvía únicamente los datos de ingresos que tienen el estado verified passed
.
Para configurar un nuevo socio y habilitar el envío de ingresos verificados in-app, sigue las instrucciones para la configuración de redes de publicidad en Campaign Lab. Cuando llegues al paso en el que debes elegir tus opciones de envío de datos, asegúrate de seleccionar ingresos in-app.
Es importante que te asegures de que tu configuración sea correcta, ya que si hay credenciales incorrectas, codificaciones duplicadas o cualquier otro tipo de error, los eventos no se verificarán correctamente.