Gestionar errores en integraciones

Al usar cualquier integración de atribución, mensajería o analíticas, puede que encuentres algunos errores comunes. Consulta esta guía para los casos de solución de problemas.

Discrepancia de datos

Motivo: Esto puede ocurrir porque no todos tus usuarios usan la versión de la app que tiene el SDK de Adapty.

Solución: Para garantizar la consistencia de los datos, puedes obligar a tus usuarios a actualizar la app a una versión con el SDK de Adapty.

Errores de red

Motivo: Lo más probable es que no haya habido conexión a internet entre el servidor de Adapty y el servidor de la integración.

Solución: Estos problemas normalmente no duran mucho y solo afectan a un pequeño número de eventos.

El servidor de integración no pudo procesar el evento

Motivo: La integración está configurada incorrectamente.

Solución: Consulta el artículo sobre la integración en nuestra documentación. Asegúrate de haber completado todos los pasos de configuración tanto en el Adapty Dashboard, como en el lado de la herramienta de terceros y en el código de tu app.

Datos de integración faltantes

Motivo: Al perfil le falta algún ID específico de la integración. Esto puede ocurrir cuando la integración no está configurada correctamente en el código de la app.

Solución: Consulta el artículo sobre la integración en nuestra documentación. Asegúrate de haber implementado los métodos de los fragmentos de código en el código de tu app, y de que estos métodos interactúen realmente con los perfiles de tus usuarios.

Credenciales de integración faltantes

Motivo: Faltan algunas credenciales de integración o son incorrectas.

Solución: Comprueba todas las credenciales de esa integración en el Adapty Dashboard. El problema puede deberse a un desajuste de versión o de entorno.

El evento ha expirado

Motivo: La opción Exclude historical events está habilitada en la configuración de la integración, y la fecha de creación del evento es anterior a la fecha de creación del perfil en nuestro sistema.

Esto puede ocurrir si una cadena de transacciones que comenzó hace muchos años llega a Adapty mediante la validación de recibos para un perfil creado recientemente.

Solución: Asegúrate de que esto no ocurra con nuevos eventos. Si quieres enviar eventos históricos a la integración, desactiva Exclude historical events.

Tipo de evento desactivado/no compatible

Motivo: El evento no es compatible con esta integración, o lo desactivaste al configurarla.

Solución:

Comprueba si la integración admite este tipo de evento. Los siguientes eventos no llegan a todas las integraciones:
- access_level_updated: solo el webhook.
- Eventos sintéticos (trial_active, subscription_active): Adjust, Amplitude, AppMetrica, AppsFlyer, Branch, Facebook Analytics, Firebase, Mixpanel, OneSignal, PostHog, Singular, SplitMetrics y el webhook.
Si la integración es compatible, asegúrate de que el evento está activado en la configuración de la integración.

Un evento sintético nunca llegó

Razón: Los eventos sintéticos se lanzan una vez, con un temporizador, y hay cuatro situaciones que los detienen sin mostrar un error:

La prueba o suscripción terminó antes de que transcurriera el retraso. Una compra convertida, expirada o reembolsada no genera nada, y Adapty no vuelve a comprobarlo. Busca trial_converted, trial_expired, subscription_expired o subscription_refunded en su lugar.
El usuario desactivó la renovación automática antes de que transcurriera el retraso. Su acceso se mantiene hasta el final del período pagado, pero Adapty omite el envío. Busca trial_renewal_cancelled o subscription_renewal_cancelled en su lugar.
Activaste el evento después de que comenzara la compra. Adapty inicia el temporizador cuando llega trial_started o subscription_started, así que solo las compras realizadas después de que actives el evento generarán uno.
Cambiaste el retraso después de que comenzara la compra. Los envíos ya programados conservan el retraso con el que fueron creados.

Solución: Ninguno de estos es un fallo de entrega, por lo que no hay nada que reintentar y no aparece nada en el Event Feed. Para confirmar que la configuración funciona, activa el evento y observa una compra realizada a partir de ese momento.