How can we help?

Búsqueda

Configurar la validación de recibos

  • Actualización

En resumen: La Validación de recibos mide los ingresos de las compras in-app y las suscripciones, y los verifica con las tiendas de aplicaciones, lo que garantiza resultados precisos de Retorno de la inversión publicitaria (ROAS).

Actualizar a la nueva validación de recibos

La validación de recibos heredada se desactivará el 7 de septiembre de 2026; consulta el Boletín: La validación de recibos heredada está obsoleta. Si tu aplicación usa la validación de recibos heredada, migra a la nueva siguiendo los pasos de configuración que se indican a continuación. Antes de empezar, revisa las diferencias principales y prepara la migración.

Novedades en la validación de recibos

Área Heredado Nueva validación de recibos
Método del SDK validateAndLogInAppPurchase (legacy/v1) validateAndLogInAppPurchase (v2), mismo nombre y nueva firma en iOS y Android
Entrada de precio y moneda Se pasa en la llamada del SDK Se extrae automáticamente de la tienda
Tipo de compra No es obligatorio Parámetro PurchaseType obligatorio (subscription o one-time purchase)
Configuración de ingresos No es obligatorio Obligatorio (página de configuración de ingresos)
Fuente del valor de af_revenue Valor pasado en la llamada del SDK Valor bruto devuelto por la tienda; cualquier valor personalizado que se pase en la llamada del SDK llega al objeto custom_data del evento
Granularidad del evento de compra Un único evento af_purchase para todos los tipos de transacción Eventos distintos por tipo de transacción: af_purchase, af_ars_trial_started, af_ars_subscription_started y variantes de sandbox
Soporte de StoreKit 2 (iOS) No compatible Compatible
Filtrado de fraude Limitado Mejorado en Android e iOS
Disponibilidad del SDK Eliminado del SDK de AppsFlyer v7.0.0+ Disponible a partir de Android v6.17.5, iOS v6.17.8 y plugins v6.17.8
Registro validado del evento de compra Con soporte hasta el 7 de septiembre de 2026 En curso

Prepara la migración

Antes de iniciar la migración, revisa las siguientes consideraciones:

  • Migra gradualmente sin afectar a los usuarios existentes. Activar la nueva validación de recibos en el dashboard de AppsFlyer no afecta a las versiones de la aplicación que siguen usando el método heredado. Ambos siguen funcionando hasta la retirada del sistema heredado el 7 de septiembre de 2026.
  • Espera cambios en los ingresos después de la migración. La nueva Validación de recibos usa el valor bruto que devuelve la tienda, mientras que la Validación de recibos heredada usaba el valor de ingresos enviado en la llamada al SDK. Si la llamada al SDK enviaba un valor no bruto, los dashboards y los postbacks de partners, que ahora reflejan valores brutos, mostrarán una cifra distinta después de la migración. Para los ingresos netos, usa ROI360 Store Revenue. Consulta Configurar ROI360 store revenue.
  • Informa a tus partners de UA sobre el cambio en los ingresos. Las ad networks que antes procesaban ingresos no brutos del postback af_purchase verán valores distintos después de la migración.
  • Planifica el cronograma de lanzamiento de tu aplicación. Después del 7 de septiembre de 2026, los usuarios que tengan versiones de la aplicación compiladas con versiones del SDK anteriores a Android v6.17.5 o iOS v6.17.8 dejarán de generar eventos af_purchase validados. Lanza la nueva versión de tu aplicación con suficiente antelación para llegar a la mayoría de tu base de usuarios antes de la descontinuación.

Cámbiate a ROI360 Store Revenue

Cambiar a ROI360 Store Revenue no requiere ningún cambio en el SDK, ya que ambos productos usan el mismo método validateAndLogInAppPurchase (v2). Añadir el Purchase Connector para la detección automática de compras es opcional.

Para obtener más información e instrucciones de configuración, consulta Configurar los ingresos de la tienda en ROI360.

Visión general

 Nota:

Para obtener más información sobre la Validación de recibos, incluido cómo funciona y cómo activarla en AppsFlyer, consulta Acerca de la Validación de recibos.

Para configurar la Validación de recibos, sigue estos pasos en este orden:

  1. Configurar las credenciales de la tienda (iOS y Android)
    • iOS: Configura las claves de App Store Connect (clave de In-App Purchase, ID de clave e ID del emisor) en AppsFlyer para activar la Validación de recibos.
    • Android: Configura una cuenta de servicio de Google Cloud, define los permisos necesarios en Google Play Console y sube la clave JSON de la cuenta de servicio a AppsFlyer.
  2. Implementar la API del SDK validateAndLog: Prepara a los desarrolladores para integrar la API del SDK validateAndLog de AppsFlyer y configurar el entorno sandbox para las pruebas.
  3. Probar la implementación de la API del SDK validateAndLog: Realiza compras y suscripciones de prueba en el entorno sandbox en iOS y Android para verificar que se generan los eventos de Validación de recibos y que AppsFlyer los registra correctamente.
  4. Verificar y actualizar la configuración: Confirma que el tipo de producto esté configurado como Validación de recibos y revisa los estados de la clave de la tienda y de la integración del SDK para garantizar una medición precisa y continua de los ingresos.
  5. Lanzar las versiones de la aplicación con la API del SDK validateAndLog: Lanza versiones actualizadas de la aplicación con la API del SDK validateAndLog integrada, asegurándote de que las marcas de sandbox estén desactivadas y de que los eventos in-app obligatorios no estén bloqueados por las reglas de validación.

Paso 1 (iOS): Configurar las claves de App Store Connect

En el paso 1, obtén las siguientes credenciales de App Store Connect e introdúcelas en la página de Configuración de ingresos de la plataforma de AppsFlyer.

  • Clave de compra in-app
  • ID de clave
  • ID del emisor

Antes de empezar:

  • La configuración de las credenciales implica pasos realizados tanto en App Store Connect como en AppsFlyer. Durante la configuración, mantén abiertas las pestañas App Store Connect y AppsFlyer.
  • Tu aplicación de iOS requiere StoreKit v1 o v2, que proporciona el framework para gestionar las compras y suscripciones in-app.

1.1 Crear las claves de App Store Connect

Para configurar las credenciales de iOS, sigue estos pasos:

  1. En App Store Connect, ve a Usuarios y acceso.

  2. Ve a Usuarios y acceso > Integraciones y, en la lista de Claves , selecciona Compra in-app.

  3. Haz clic en + para generar una nueva clave de compra in-app.

  4. Ingresa un nombre para tu clave de API.
  5. Haz clic en Generar.
  6. Haz clic en Descargar clave de compra in-app junto a la clave que acabas de generar para descargarla. Nota: Solo puedes descargar la clave una vez.

  7. Copia el ID de clave de la clave que acabas de generar y pégalo en la configuración de compras y suscripciones de AppsFlyer & para ID de clave.

  8. Copia el ID del emisor. Nota: Si el ID del emisor no se muestra en la parte superior de la página, crea una clave de API de App Store Connect (con cualquier nivel de acceso). Después de eso, el ID del emisor aparece en la parte superior de la página para la clave de compra in-app.

1.2 Configurar la clave de App Store Connect

  1. Habilita la Validación de recibos. #habilitar-validación-de-recibo
  2. En el paso Claves de App Store Connect keys , haz clic en  Cargar en el campo Clave de compra in-app para cargar el archivo p8.

  3. En la sección titulada Claves de App Store Connect keys, pega los valores que copiaste de App Store Connect.

    • ID de clave
    • ID del emisor
  4. Haz clic Validar claves para asegurarte de que las claves que has introducido sean correctas. Nota: La acción Validar claves puede no funcionar si tu app aún no se ha publicado en la App Store.
  5. Haz clic en Guardar y Siguiente.

Paso 1 (Android). Configurar la clave de cuenta de servicio y los permisos

En el paso 1, obtén las siguientes credenciales de Google Play y Google Cloud y e introdúcelas en la página de Configuración de ingresos de la plataforma de AppsFlyer.

Antes de empezar:

  • La configuración de la medición de las compras in-app y de los ingresos por suscripción implica pasos que se realizan en la Google Cloud Platform, Google Play Console, y la interfaz de usuario de AppsFlyer. Te recomendamos que mantengas un control de los tres lugares abiertos durante toda la configuración.
  • La configuración en la interfaz de usuario de AppsFlyer requiere permisos de administrador.

1.1 Vincula tu cuenta de desarrollador de Google Play a tu proyecto de Google Cloud

Requisitos previos: acceso a Google Play Console y a un proyecto de Google Cloud.

Para vincular tu cuenta de desarrollador de Google Play a tu proyecto de Google Cloud, sigue estos pasos:

  1. En Google Play Console, ve a tu cuenta de desarrollador de Google Play.
  2. Vincula la cuenta a tu proyecto de Google Cloud. Para obtener instrucciones, consulta este tema de ayuda de Google.

  3. Habilita la API para desarrolladores de Google Play. Para obtener instrucciones, consulta este tema de ayuda de Google.

1.2 Configura tu cuenta de servicio en Google Cloud Platform

Requisitos previos: acceso a Google Cloud Platform.

Para configurar tu cuenta de servicio, sigue estos pasos:

  1. Crea o localiza la cuenta de servicio:

    1. Ve a la sección Cuentas de servicio de Google Cloud platform y haz clic CREATE SERVICE ACCOUNT.
    2. Rellena los datos de la cuenta de servicio.
    3. Copia la dirección de correo electrónico.
    4. Haz clic en Create and continue.
    5. En el paso Otorgar a esta cuenta de servicio acceso al proyecto , selecciona el rol de Pub/Sub suscriptor.

    6. Haz clic Continuar > Hecho.

  2. Descarga la clave privada de la cuenta de servicio:

    1. En Google Cloud platform, ve a la sección Cuentas de servicio , busca en la lista la cuenta que quieres (la que acabas de crear) y haz clic en el icono More actions .
    2. Haz clic en Manage keys.

    3. Haz clic en Agregar clave > Crear nueva clave.

    4. En la ventana emergente Crear clave privada para Tipo de clave, selecciona JSON, y haz clic Crear.

    5. Haz clic Crear. Se descarga el archivo JSON de la clave privada.

    6. Guarda el archivo de clave JSON, que se cargará en AppsFlyer más tarde. 
      [Práctica recomendada]: Debes guardar la clave. no se podrá recuperar más adelante. Si no la guardas, tendrás que crear una clave completamente nueva.

1.3 Establecer permisos de acceso a la API en Google Play Console

Requisitos previos: acceso a Google Play Console.

Nota: Puede llevar un tiempo (a veces hasta 24 horas) después de configurar las credenciales y los permisos de la cuenta de servicio hasta poder utilizarlos. Esto puede provocar errores en pasos posteriores.

Para establecer permisos de acceso a la API en Google Play Console:

  1. En Google Play Console, ve a Usuarios y permisos, busca la cuenta de servicio que has creado y haz clic Invitar a nuevos usuarios.

  2. Introduce la dirección de correo electrónico que copiaste al configurar tu cuenta de servicio en el paso 1.2.1.3.

  3. En la sección Permisos , ve a la pestaña Permisos de cuenta y selecciona ambas opciones:

    • Ver los datos financieros, los pedidos y las respuestas a la encuesta de cancelación.
    • Gestionar los pedidos y las suscripciones.

  4. En la pestaña Permisos de la aplicación , haz clic en Agregar aplicación, luego selecciona tu aplicación. Agrega varias aplicaciones si es necesario.

  5. Haz clic Invitar al usuario.

  6. En la ventana emergente de confirmación, haz clic Enviar invitación.

1.4 Cargar la clave privada de la cuenta de servicio en AppsFlyer

Carga y valida la clave JSON de Google que descargaste en el paso 1.2.

Requisitos previos: acceso de administrador a AppsFlyer.

Para cargar la clave privada de la cuenta de servicio en AppsFlyer, sigue estos pasos:

  1. Activar la validación de recibos.
  2. En el paso Service Account Key and Permissions, en el campo Upload Google JSON key , haz clic Upload.
  3. Carga el archivo JSON que descargaste en el paso 1.2.

  4. Haz clic Validar clave. Nota:

    • Después de configurar las credenciales y los permisos de la cuenta de servicio, puede pasar algún tiempo (a veces incluso 24 horas) hasta que se puedan utilizar. Esto puede hacer que recibas errores al intentar validar la clave o realizar una prueba de validación.
    • Para evitar el tiempo de espera de 24 horas, en la Google Play Console, ve a cualquier aplicación, luego ve a Monetize > Products > Subscriptions/In-app products, y realiza un cambio. Por ejemplo, edita la descripción de tu producto y guárdalo. Esto suele actualizar inmediatamente las credenciales y los permisos de la cuenta. Luego puedes deshacer los cambios.
  5. Haz clic Siguiente. Se abre el paso Implementación del SDK.

2. Implementar SDK

En este paso, preparas a tus desarrolladores para integrar la API validateAndLog del SDK y configurar un entorno sandbox para las pruebas. Las versiones mínimas del SDK que dan soporte a la API validateAndLog más reciente son 6.17.5 para Android y 6.17.8 para iOS.

Para implementar la API validateAndLog del SDK, sigue estos pasos:

  1. En el paso Implementación del SDK, copia el mensaje predefinido que se muestra en el dashboard.

  2. Envíalo a tus desarrolladores. incluye:

    • El nombre y el ID de aplicación
    • Un enlace a la guía de integración del SDK.
    • Instrucciones para configurar el entorno sandbox (sandbox = true).
    • Pasos de prueba (con TestFlight).

    Este mensaje proporciona toda la información que tus desarrolladores necesitan para completar la integración y comenzar las pruebas.

  3. Haz clic Siguiente. Se abre el paso Verificar implementación del SDK.

3. Verificar la implementación del SDK

Prueba la integración de ingresos por compras in-app y suscripciones en un entorno sandbox para confirmar que el conector del SDK está correctamente integrado y que las notificaciones del Servidor están correctamente configuradas y son recibidas por AppsFlyer.

Prueba de implementación de SDK

Para comprobar si AppsFlyer ha recibido payloads válidos de validateAndLog de tu App en los últimos 7 días, realiza estos pasos:

  1. En el paso Verificar implementación del SDK, haz clic en Probar implementación del SDK.
  2. Revisa los resultados, incluida la marca de tiempo del payload más reciente que ha recibido AppsFlyer. Ten en cuenta que esta comprobación solo confirma que las solicitudes llegan a AppsFlyer y no verifica si los datos están completos o son correctos.
  3. Para validar completamente la implementación, continúa con los pasos de prueba que se indican a continuación.

Consideraciones sobre el entorno de pruebas

En un entorno de pruebas:

  • Solo los eventos de compra iniciales hacen que la API validateAndLog del SDK produzca un evento que es registrado por AppsFlyer. Un evento de compra in-app se llama af_purchase_sandbox_sdk. Un evento de suscripción se llama af_ars_sandbox_sdk.
  • Los eventos de Sandbox tienen ingresos de 0.
  • Para Android, las pruebas realizadas por License Testers dan como resultado eventos sandbox aunque el entorno sandbox no esté configurado en el SDK.

Probar las compras in-app y los ingresos por suscripciones

Para probar los ingresos por compras in-app y suscripciones:

  1. Pide a tus desarrolladores que sigan sus instrucciones para configurar el entorno sandbox para la API validateAndLog del SDK.
  2. Haz una compra o suscripción de prueba con License Tester en Google Play y TestFlight en iOS. 

  3. Verifica que los eventos de prueba se muestren de una de las siguientes maneras:

  4. Busca los siguientes eventos de prueba:

    • El af_purchase_sandbox_sdk para un evento de compra.
    • El af_ars_sandbox_sdk para un evento de suscripción.

  5. Asegúrate de que los eventos de prueba incluyan lo siguiente:

    • Un valor de ingresos de 0 (para no distorsionar los reportes reales de AppsFlyer).
    • Un af_sandbox_revenue parámetro que incluye el valor de ingresos del producto comprado, garantizando que se reporten los ingresos correctos.
    • Un parámetro af_validated con el valor true. Si af_validated es false, vuelve al paso 2 anterior y valida la clave proporcionada por la tienda
    • Un parámetro af_validation_type con el valor receipt_validation.

4. Verifica y actualiza los ajustes

Después de completar la configuración de los ajustes anteriores y guardar los pasos anteriores, se te redirige a la vista de configuración activa, donde puedes verificar o actualizar los siguientes ajustes:

  1. Verifica que el Tipo de producto sea Validación de recibos
  2. Asegúrate de que Verify purchases with the App Store esté activado.

  3. Verifica o actualiza los siguientes ajustes:

    • La configuración de la App Store key 
    • La configuración de la integración del SDK setup

Paso 5. Lanza las versiones de la aplicación con la API validateAndLog del SDK

Con todo lo de los pasos anteriores configurado y la API validateAndLog del SDK de AppsFlyer integrada en tu aplicación, indica a tus desarrolladores que publiquen la versión de la aplicación con la API validateAndLog del SDK integrada.

Antes de que los desarrolladores publiquen la nueva versión de la aplicación, asegúrate de que:

  • Los eventos in-app que quieres capturar como compra in-app o suscripción no están bloqueados por ninguna de las reglas de validación que has configurado en AppsFlyer.
  • Tus desarrolladores tienen todas las marcas de sandbox configuradas como false.

Una vez que se lance la aplicación con la API validateAndLog del SDK, los eventos de compra in-app y de suscripción se generarán y estarán disponibles en todos los dashboards de AppsFlyer, así como en los reportes de datos agregados y de raw data.

Los eventos solo se generan para los usuarios que han actualizado a una versión de la aplicación que incluye la API validateAndLog del SDK. Como resultado, es normal que haya una discrepancia entre los datos de ingresos de la aplicación y los datos de la tienda hasta que la versión actualizada de la aplicación se adopte por completo.

This article was translated automatically and may contain errors. The English version is the most accurate - use the language selector below to switch.

Share article: