De un vistazo: Prueba la integración de tu aplicación Android/iOS con AppsFlyer.
Cómo probar y depurar la integración del SDK
Prueba la integración del SDK antes de enviar una aplicación a la tienda de aplicaciones. En este artículo, SDK se refiere tanto a los SDK de AppsFlyer para iOS como a los SDK para Android.
Casos especiales de prueba y depuración
- Smart TV: el SDK es compatible con TV inteligentes con Android y Apple TV (tvOS). Prueba las aplicaciones de TV inteligentes usando las instrucciones de esta guía.
- Aplicaciones de tvOS no publicadas: consulta Cómo probar la integración de tvOS antes de publicar.
- Amazon Fire TV: consulta Prueba de tiendas alternativas de Android.
¿Por qué debo depurar y realizar pruebas?
La integración probada de manera exhaustiva garantiza que la recopilación de los datos sea precisa y completa. Al probar la integración del SDK, te aseguras de que las instalaciones y los eventos in-app se registren y atribuyan correctamente.
Cómo probar y depurar la integración de SDK
Usa uno de los siguientes métodos para probar y depurar la integración de SDK
-
Pruebas básicas:
- Cómo probar la integración mediante enlaces de atribución
- El modelo de atribución de AppsFlyer emplea enlaces de atribución. Es muy recomendable realizar pruebas con enlaces de atribución.
- Al probar la integración del SDK mediante enlaces de atribución se obtiene una visión profunda del modelo de atribución de AppsFlyer. Esto te da la oportunidad de optimizar tu operación y análisis de marketing.
-
Pruebas avanzadas:
- Depuración directamente desde el entorno de desarrollo.
- La sección Pruebas de integración de SDK solo permite realizar pruebas de un conjunto limitado de características. Prueba lo siguiente en el entorno de desarrollo utilizando el registro de depuración:
- Validación de compras
- Datos de conversión
- Errores en la configuración del SDK. Puedes probar estas opciones en el entorno de desarrollo con ayuda del registro de depuración.
Lecturas relacionadas para las redes de publicidad: Prueba de integración con redes publicitarias.
Desde la página de pruebas de integración de SDK, puedes ubicar los problemas de integración de tu proyecto. Úsala para probar instalaciones, eventos in-app y enlaces profundos.
Pruebas de integración de SDK
Para probar la integración del SDK:
- Prepara un dispositivo (iOS o Android) que no tenga la aplicación instalada. Si es necesario, desinstala (elimina) la aplicación del dispositivo.
- Registra el dispositivo como un dispositivo de prueba. ¡Nota! iOS: Si usas TestFlight para instalar la aplicación, no es necesario que registres el dispositivo.
- En AppsFlyer, selecciona la aplicación.
-
Ve a Integración > Pruebas de integración de SDK.
Se abre la página de pruebas de integración de SDK. - Selecciona una opción de prueba:
- Instalaciones no orgánicas
- Eventos in-app
- Enlaces profundos
- Utiliza el procedimiento de prueba que sigue según el tipo de prueba seleccionado.
Pruebas de instalaciones orgánicas
- Instala la aplicación en un dispositivo de prueba registrado.
- Inicia la aplicación.
- El panel de control de la aplicación muestra una instalación orgánica nueva.
Pruebas de instalaciones no orgánicas
- Selecciona Instalación no orgánica.
- Selecciona un dispositivo de la lista.
- Selecciona la fuente de la aplicación:
- Android:
- Google Play
- Otro (fuera de la tienda)
- iOS:
- App Store
- XCode
- TestFlight
- Android:
- Escanea el código QR con tu dispositivo de prueba registrado y sigue las instrucciones que aparecen en tu dispositivo.
- Espera a que la instalación no orgánica se registre en la página de prueba de integración de SDK en la cual se indique que la prueba se ha completado con éxito. Este paso puede llevar hasta dos minutos.
Si en ese tiempo la aplicación no registra una instalación no orgánica, consulta la sección de resolución de problemas de la página Pruebas de integración de SDK.
Para probar las instalaciones LAT:
- Habilita el modo LAT en tu dispositivo.
- Realiza una prueba de instalación no orgánica.
Para realizar pruebas no se instala ningún consentimiento ATT (sin IDFA):
- En el diálogo de consentimiento del ATT, haz clic en Solicitar a la aplicación que no realice el seguimiento.
- Realiza una prueba de instalación no orgánica.
Cómo probar eventos in-app
- Haz clic en Ejecutar prueba en Eventos in-app.
- Selecciona un dispositivo de prueba registrado en el menú desplegable, haz clic en Siguiente.
- Inicia tu aplicación y comienza a generar eventos in-app.
- Verás un registro de estos eventos a medida que se van registrando en tiempo real.
Pruebas de enlaces profundos
- Para probar enlaces profundos, debes haber definido OneLink para tu aplicación. Consulta nuestra guía de OneLink aquí. Es importante destacar que es altamente recomendable establecer enlaces profundos de SDK, tal como se describe en la guía de integración de enlaces profundos.
- Verifica que el retargeting esté activado.
- Haz clic en Ejecutar prueba en Enlaces profundos
- Selecciona un dispositivo de prueba registrado en el menú desplegable y haz clic en Siguiente.
- Selecciona el Tipo de prueba:
- OneLink: selecciona el OneLink que deseas probar en el menú desplegable Seleccionar un OneLink.
- Esquema URI: especifica el esquema URI que deseas probar. Por ejemplo greatapps://cars.
- Escanea el código QR con tu dispositivo de prueba registrado y sigue las instrucciones de tu dispositivo.
- Una vez completadas ambas pruebas, la prueba de enlaces profundos se registra como exitosa.
Cómo probar la integración del SDK mediante aplicaciones de depuración
Cuando realizas pruebas mediante enlaces de atribución, los datos se registran en el panel de control de la aplicación. Una vez que se registran los datos, no se pueden eliminar. Si no deseas que los datos de pruebas queden registrados como parte de una aplicación real, puedes probar la integración de SDK mediante aplicaciones de depuración.
Si no necesitas una aplicación de prueba o si no te preocupa mezclar datos de pruebas con datos reales, puedes omitir esta sección.
Las aplicaciones de depuración son copias exactas de las aplicaciones que se publican en las tiendas de aplicaciones. Al ejecutar las pruebas de integración de SDK con las aplicaciones de depuración, te aseguras de no mezclar los datos de pruebas con datos reales.
Las aplicaciones de depuración difieren de las aplicaciones de producción en tres aspectos principales:
- Tienen un ID de aplicación diferente.
- Tienen su propio panel de control.
- No están publicadas en las tiendas de aplicaciones.
Cómo crear una aplicación de prueba para Android
Para duplicar tu aplicación de Android
- Haga una copia de la carpeta de proyecto de Android y cámbiele el nombre.
- Abra el proyecto recién copiado en Android Studio.
- En Android Studio, expanda las carpetas hasta encontrar el paquete.
- Haga clic con el botón derecho en el nombre del paquete, elija la opción Refactorizar y, a continuación, Cambiar nombre.
- Cambie el nombre del paquete.
- En el nivel de la aplicación build.grade, cambie
applicationId
al nombre nuevo del paquete.
Agrega la aplicación de prueba de Android a Appsflyer
Siga las instrucciones para agregar una aplicación nueva a su panel de control de AppsFlyer. Asegúrese de que el nombre del paquete sea igual al nombre del paquete de la aplicación de prueba recién creada y no al nombre del paquete de la aplicación original. Además, recuerde configurar el estado de la aplicación como Pendiente de aprobación o sin publicar.
Ya puede ejecutar pruebas con la nueva aplicación de prueba.
Cómo crear una aplicación de prueba para iOS
Para duplicar tu aplicación de iOS
- Abra la carpeta de proyecto en el buscador.
- Duplique la carpeta.
- Abra el proyecto duplicado en XCode.
- En la clase
AppDelegate
, dentro del métododidFinishLaunchingWithOptions
, defina un nuevo ID de aplicación:Objective C
Swift
Nota
El ID de aplicación es el ID que se asigna a la aplicación una vez que se publique en la tienda de aplicaciones. Sin embargo, como se trata de una aplicación de prueba, puedes asignar cualquier ID que desees siempre que no haya una aplicación con el mismo ID. El formato debe ser 11111****. Por ejemplo, 111117538.
Asegúrate de que el ID tenga 9 dígitos. Comienza el ID con cinco unos (1). Los dígitos restantes deben ser aleatorios. Consulta el ejemplo de ID anterior.
Agregue la aplicación de prueba para iOS a su panel de control de AppsFlyer
Siga las instrucciones para agregar una aplicación nueva a su panel de control de AppsFlyer. Asegúrese de que el ID de la aplicación sea igual al ID de la aplicación de prueba recién creada. Además, recuerde configurar el estado de la aplicación como Pendiente de aprobación o sin publicar.
Ya puede ejecutar pruebas con la nueva aplicación de prueba.
Pruebas de uso de enlaces de atribución
En esta sección, se demuestra cómo probar la integración con ayuda de los enlaces de atribución
Antes de comenzar:
- Dispositivos registrados que utilizas para realizar pruebas
- Cuando pruebes reatribuciones, asegúrate de quitar el dispositivo registrado de la lista de permitidos.
- Si estás probando la atribución de aplicaciones disponibles en tiendas de aplicaciones Android de terceros, debes configurar el parámetro af_r en el enlace de atribución para hacer referencia a la tienda de aplicaciones específica.
Puedes probar la integración del SDK incluso si la aplicación está pendiente, es decir, si no figura en Google Play ni en la App Store de Apple.
Temas de esta sección:
- Cómo probar la atribución de instalaciones
- Cómo probar eventos in-app
- Cómo probar la función de retargeting (reatribución y recaptación)
Cómo probar la atribución de instalaciones
Las pruebas de instalaciones le permiten determinar si el SDK de AppsFlyer es capaz de atribuir instalaciones correctamente a diversas fuentes de medios.
Paso 1:
Copie el enlace a continuación:
https://app.appsflyer.com/<app_id>?pid=Test&c=Test&advertising_id=<GAID>
https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfa=<IDFA>
Cambia el parámetro app_id por tu ID de aplicación (incluido el prefijo id
. Por ejemplo: id0123456789
).
- El parámetro c especifica el nombre de la campaña.
- El parámetro pid especifica el nombre de la fuente de medios a la cual se atribuye la instalación.
- Si estás probando una aplicación disponible a través de una tienda Android de terceros: agrega af_r parameter al enlace de atribución.
Si pruebas el clic desde una computadora, agrega el ID de publicidad de Google ( GAID) para Android o el Identificador de anunciante (IDFA) para iOS.
Paso 2:
Copie el enlace, envíelo al dispositivo de prueba y siga el enlace con el navegador web.
Nota
En iOS, usa iMessenger o el correo electrónico para enviar el enlace al dispositivo. No pegues el enlace en la aplicación Notes de iOS y luego hagas clic en él porque podrías romper el enlace.
- Si la aplicación está activa, continúe con la instalación.
- Si la aplicación está pendiente, instale la aplicación desde su entorno de desarrollo:
-- Para Android: instale desde Android Studio o el shell ADB.
-- Para iOS: instale desde XCode.
Paso 3:
Es posible que deba esperar un par de minutos para que la instalación aparezca en el panel de control de la aplicación. Debería ver una instalación que está atribuida a la Prueba de fuente de medios debajo de la Prueba de campaña.
Para realizar una verificación más elaborada, descarga el reporte de raw data de la instalación.
- En AppsFlyer, ve a Reportes > Exportar datos.
- En la sección Reportes de raw data, descarga el reporte de raw data de la Instalación.
Consulta nuestro artículo sobre el reporte de raw data de instalaciones para obtener más información.
Cómo probar eventos in-app
Puede probar los eventos in-app para ver si muestran los ingresos asociados con dichos eventos y si están atribuidos a la fuente de medios que genera la instalación.
Después de instalar la aplicación mediante el enlace de atribución, activa algunos eventos in-app. Es posible que debas esperar un par de minutos para que los eventos aparezcan en el panel de control. Abre el panel de control de la aplicación y haga clic en la opción Eventos, que se encuentra en el menú lateral izquierdo.
Debería ver los eventos, los ingresos (si están asociados a los eventos) y la fuente de medios con la cual están relacionados.
Para realizar una verificación más elaborada, puede descargar el reporte de raw data de eventos in-app.
En el panel de control de la aplicación, haga clic en Exportar datos, debajo de Reportes. En la sección Reportes de raw data, descargue el reporte de raw data de eventos in-app.
Consulta nuestro artículo sobre reportes de raw data de eventos in-app para obtener más información.
Cómo hacer pruebas de OneLink
OneLink™ le permite definir un enlace de atribución único para iOS y Android. OneLink reconoce el dispositivo del usuario y lo redirige a la tienda de aplicaciones correspondiente.
Además, OneLink permite establecer enlaces profundos. Los enlaces profundos le permiten abrir la aplicación en una actividad específica de la aplicación mientras ofrece contenido personalizado.
Para obtener más información, consulte nuestra guía sobre pruebas de URL de OneLink.
Cómo probar la función de retargeting
Requisitos esenciales para las pruebas de retargeting
- Plantilla de OneLink: consulte la sección Configuración de la plantilla de OneLink.
- Habilite la función de retargeting en la página de configuración de la aplicación.
En el panel de control de la aplicación, haz clic en Configuración de la aplicación y activa la opción Habilitar medición de campañas de retargeting.
- Un dispositivo no registrado
Es muy sencillo realizar pruebas de retargeting. Crea un enlace de atribución personalizado a partir de una plantilla de OneLink. Asegúrate de activar la campaña de retargeting.
Cuando el enlace de atribución personalizado esté listo, aparecerá la siguiente pantalla, donde podrás recuperar la versión larga de la URL:
Otra forma de recuperar la versión larga de la URL es a través de la página de gestión de enlaces.
- En la página Gestión de enlaces, localiza el enlace de atribución.
- Del lado derecho, haz clic en los tres puntos que están debajo de Acciones.
- Haz clic en Ver detalles del enlace.
- Copia el Enlace largo.
¡Importante!
- Al probar el retargeting (reatribución y re-engagement), el ID de publicidad debe especificarse en la URL del enlace de atribución.
- El retargeting de las reinstalaciones (también conocido como reatribución) no puede probarse usando dispositivos de prueba registrados. Es decir, los dispositivos de usuario que figuran en la lista de dispositivos de prueba. Para este fin, puedes usar cualquier otro dispositivo.
- Para ver el ID de publicidad de Google (GAID) o el Identificador de anunciante (IDFA), sigue las instrucciones del artículo sobre cómo registrar un dispositivo de prueba. Nota:
El enlace OneLink final es el siguiente:
https://go.onelink.me/2rAD?pid=Test&c=Test&is_retargeting=true&advertising_id=<GAID>
https://go.onelink.me/2rAD?pid=Test&c=Test&is_retargeting=true&idfa=<IDFA>
Cómo probar la función de reatribución
Puedes probar la reatribución para verificar si es capaz de registrar instalaciones de su aplicación por parte de usuarios que reinstalan la aplicación después de haberla desinstalado en algún momento.
- Asegúrate de que tu dispositivo de prueba NO esté registrado
- Si la aplicación se instaló recién, espere unos minutos.
- Desinstale la aplicación del dispositivo.
- Repita los mismos pasos que siguió para probar la atribución de instalación: use el formato OneLink de más arriba.
- Es posible que deba esperar un par de minutos para que la instalación con retargeting aparezca en el panel de control.
- Abra el panel de control de la aplicación y haga clic en Retargeting en el menú lateral izquierdo.
- Debería ver la instalación reatribuida como atribuida a la Prueba de fuente de medios debajo de la Prueba de nombre de campaña.
Para realizar una verificación más elaborada, puede descargar el reporte de raw data de conversiones.
En el panel de control de la aplicación, haga clic en Exportar datos, debajo de Reportes. En la sección Reportes de retargeting, descargue el reporte de raw data de Conversiones.
Cómo probar la función de recaptación
La recaptación se produce cuando un usuario, que tiene la aplicación instalada, interactúa con una campaña de retargeting e inicia la aplicación.
Cómo probar la recaptación mediante App Open
El re-engagement mediante la apertura de la aplicación significa que se redirige al usuario a la tienda de aplicaciones, donde verá un botón para abrir la aplicación. Si el usuario hace clic en el botón de apertura e inicia la aplicación, se registra una instancia de re-engagement.
Para probar instancias de recaptación, siga los pasos a continuación:
- Asegúrese de tener la aplicación instalada en su dispositivo de prueba y de haberla iniciado varias veces.
- Si la aplicación se instaló recién, espere unos minutos.
- Use el mismo enlace OneLink que usó para probar la reatribución.
- Agregue el ID de dispositivo al enlace y envíelo a su dispositivo móvil.
- Siga el enlace con un navegador web.
- Abra la aplicación de forma manual con el botón Abrir de la tienda o desde el panel de inicio del dispositivo.
Debería ver una recaptación atribuida a la Prueba de la fuente de medios debajo de la Prueba del nombre de campaña.
Como probar la recaptación mediante enlaces profundos
Con re-engagement mediante conexiones profundas, puedes hacer que la aplicación se abra inmediatamente después de que el usuario haga clic en el enlace de atribución. Estas son las ventajas de usar la función de recaptación con enlaces profundos:
- Mejor experiencia del usuario: no se redirige al usuario a la tienda, y la aplicación se inicia automáticamente.
- Mejores campañas: puede abrir una actividad relacionada con una campaña específica y, de esta forma, maximizar los resultados de la campaña de retargeting.
Puedes probar la atribución de recaptación (re-engagement) empleando enlaces profundos. Es el mismo procedimiento que el de la prueba de recaptación con un enlace de atribución. La única diferencia es que el enlace de atribución contiene un parámetro af_dp
con el cual se redirige al usuario a una actividad específica en la aplicación.
Para probar las recaptaciones mediante enlaces profundos, siga los pasos a continuación:
- Asegúrese de configurar su aplicación para enlaces profundos.
- Asegúrese de tener la aplicación instalada en su dispositivo de prueba y de haberla iniciado varias veces.
- Si la aplicación se instaló recién, espere unos minutos.
- Genere un enlace de retargeting con el ID de dispositivo.
- Agregue el parámetro af_dp y a este parámetro, agregue el esquema que configuró en el paso 1.
- Siga el enlace con un navegador web.
- Si la aplicación está instalada, el enlace inicia la aplicación en la actividad que se especifica en el enlace.
Debería ver una recaptación atribuida a la Prueba de la fuente de medios debajo de la Prueba del nombre de campaña.
Para obtener más información, consulte nuestra guía sobre pruebas de enlaces profundos.
Maneras adicionales de probar la integración del SDK
Existen otras dos formas de probar la integración del SDK:
En esta sección, se demuestra cómo depurar el SDK. Consulte esta sección para realizar pruebas avanzadas y resolver problemas con la integración del SDK.
Depuración para Android
La depuración del SDK te ofrece una perspectiva detallada de cómo se integra con tu aplicación. La depuración te ayuda a resolver problemas relacionados con el registro de eventos in-app, los datos de conversión y la validación de compra.
Cómo habilitar el modo de depuración del SDK de Android
Para iniciar la depuración del SDK de Android, agregue la siguiente línea a la clase AFApplication:
AppsFlyerLib.getInstance().setDebugLog(true);
¡Advertencia!
La depuración debe restringirse a la fase de desarrollo solamente. No distribuya la aplicación en las tiendas de aplicaciones con la depuración habilitada. Esto implica riesgos importantes de seguridad y privacidad.
Cómo ver el resultado de la depuración
Para ver el resultado de la depuración, abra el terminal Logcat en Android Studio. Elija el nombre del paquete de la aplicación como el proceso que se depurará, defina el nivel de registro en Depuración y filtre por "AppsFlyer_".
Resolución de problemas con el SDK para Android
La instalación siempre se atribuye como orgánica
Situación
Estás realizando pruebas de atribución mediante enlaces de atribución. Implementaste el agente de escucha de conversión del SDK, pero el registro siempre muestra que la instalación es orgánica. Además, no hay ninguna instalación no orgánica registrada en el panel de control.
Causas posibles
- Su clave de desarrollador es incorrecta: si especifica una clave de desarrollador incorrecta, no se podrá atribuir la instalación.
- El enlace de atribución que usas es incorrecto. Consulta nuestra guía sobre enlaces de atribución.
- Asegúrate de que el dispositivo que usas para la prueba esté registrado.
- Hay un canal inadecuado definido en el manifiesto.
La instalación no se detecta o no se atribuye
Situación
Estás probando la atribución de instalaciones, pero el registro no muestra ningún dato sobre la instalación, p. ej., tipo, primer inicio, etc.
Causas posibles
- Asegúrese de que haya una llamada a los métodos
startTracking
einit
en la claseAFApplication
. - Asegúrate de que el dispositivo que usas para la prueba esté registrado.
Recibo un código de error 404 al registrar una instalación o evento.
Situación
Está probando eventos in-app para ver si están atribuidos a la fuente de medios correcta. Sin embargo, el registro muestra el código de respuesta 404 para la instalación y cuando envía los eventos in-app. Ni la instalación ni los eventos in-app aparecen en el panel de control.
Causas posibles
Un código de respuesta 404 indica que el ID de aplicación es incorrecto. Asegúrese de que el ID de aplicación que figura en el parámetro applicationId
del archivo build.gradle sea el mismo que figura en su panel de control.
Los ingresos no se registran correctamente.
Situación
Está probando eventos in-app con ingresos. Los eventos aparecen en el panel de control, pero los ingresos no se registran.
Causas posibles
El parámetro de ingresos no tiene el formato correcto. NO altere el formato del valor de ingresos de ninguna manera. No debe contener comas, signos de moneda ni texto. Por ejemplo, un evento generador de ingresos debería ser similar a 1234.56.
El registro muestra el mensaje "AppsFlyer's SDK cannot send any event without providing DevKey" cuando pruebo eventos in-app
Situación
Está intentando ver eventos in-app en el registro. Cuando activa eventos, el registro solo muestra el mensaje "AppsFlyer's SDK cannot send any event without providing DevKey" (El SDK de AppsFlyer no puede enviar ningún evento sin proporcionar la clave de desarrollador).
Causas posibles
Está llamando al método startTracking
sin pasar la clave de desarrollador como parámetro. Pase la clave de desarrollador al método.
El registro muestra el mensaje "Not sending data yet, waiting for dev key" cuando pruebo eventos in-app
Situación
Está intentando probar eventos in-app en el registro. Cuando activa eventos, el registro solo muestra el mensaje "Not sending data yet, waiting for dev key" (Aún no se envían los datos, en espera de la clave de desarrollador).
Causas posibles
Está llamando al método init
y pasa la clave de desarrollador como una cadena vacía. Pase la clave de desarrollador al método.
Recibo un código de respuesta 400 cuando pruebo eventos in-app
Situación
Está intentando probar eventos in-app en el registro. Cuando activa eventos, ve el código de respuesta 400 en los registros.
Causas posibles
Esto puede indicar un problema con la clave de desarrollador. Verifique que la clave de desarrollador sea la correcta. Además, asegúrese de que la clave de desarrollador contenga solo caracteres alfanuméricos.
El registro muestra el mensaje "WARNING: Google Play Services is missing"
Situación
El registro Logcat muestra el mensaje "WARNING: Google Play Services is missing" (ADVERTENCIA: no se encuentra Google Play Services).
Causas posibles
Faltan las dependencias de Google Play Services en la aplicación. Esto podría impedir que el SDK recopile el GAID, lo que podría causar problemas con la atribución.
Agregue las siguientes líneas:
implementation 'com.google.android.gms:play-services-base:15.0.1'
implementation 'com.google.android.gms:play-services-ads:15.0.1'
En el nivel del módulo (de la aplicación), archivo build.gradle.
Recibo el código de respuesta 400 cuando registro instalaciones o eventos.
Situación
Estás intentando probar las instalaciones y otros eventos de conversión en el registro. Cuando activas estos eventos, ves la respuesta 403 (prohibido) en los registros.
Causas posibles
Esto puede ser porque tienes el paquete Zero, que no incluye datos de atribución; solo datos sobre clics e impresiones. Para empezar a recibir datos de atribución, aprende más sobre los diferentes paquetes de AppsFlyer y actualiza según sea necesario. También puedes comunicarte con nuestro equipo de engagement del cliente a través de hello@appsflyer.com si tienes preguntas sobre nuestros paquetes.
Depuración para iOS
Cómo habilitar el modo de depuración del SDK de iOS
Para iniciar la depuración del SDK de iOS, agregue la siguiente línea en el método didFinishLaunchingWithOptions
:
Agregue la siguiente línea en AppDelegate.m:
[AppsFlyerLib shared].isDebug = true;
Agregue la siguiente línea en AppDelegate.swift:
AppsFlyerLib.shared().isDebug = true
¡Advertencia!
La depuración debe restringirse a la fase de desarrollo solamente. No distribuya la aplicación en las tiendas de aplicaciones con la depuración habilitada. Esto implica riesgos importantes de seguridad y privacidad.
Cómo ver el resultado de la depuración
Para ver el resultado de la depuración, abra el terminal de depuración en XCode y filtre por "AppsFlyer".
Resolución de problemas con el SDK para iOS
Las instalaciones y los eventos no se registran.
Podrían existir diversos motivos por los cuales no se registran las instalaciones y los eventos:
Si especificas un ID de aplicación con un formato incorrecto, no se registrarán las instalaciones y los eventos. Cuando configures el ID de aplicación en el archivo delegado, asegúrate de que esté compuesto solo por números.
Puede encontrar su clave de desarrollador en el panel de control de AppsFlyer, dentro de Configuración de la aplicación:
Correcto:
[AppsFlyerTracker sharedTracker].appleAppID = @"340954503";
Incorrecto:
[AppsFlyerTracker sharedTracker].appleAppID = @"id340954503";
Incorrecto:
[AppsFlyerTracker sharedTracker].appleAppID = @"com.appslyer.sampleapp";
Si el formato del ID de aplicación es incorrecto, el registro muestra el siguiente error:
[ERROR] AppsFlyer: -[AppsFlyerTracker validateAppID] AppsFlyer Error: appleAppID should be a number!
Si especificas un ID de aplicación que no existe en tu cuenta, no se registrarán las instalaciones y los eventos. El registro muestra el siguiente error:
AppsFlyer: -[AppsFlyerHTTPClient sendRequestEventToServer:isRequestFromCache:appID:isDebug:
completionHandler:]_block_invoke sent information to server, status = 404
El código de error 404 indica que el SDK no puede encontrar la aplicación en su cuenta.
Si especificas un ID de clave de desarrollador incorrecto, no se registrarán las instalaciones ni los eventos. El registro muestra el siguiente error:
AppsFlyer: -[AppsFlyerHTTPClient sendRequestEventToServer:isRequestFromCache:appID:isDebug:completionHandler:]
_block_invoke sent information to server, status = 400
El código de error 400 indica que el SDK no puede autenticar la solicitud para rastrear instalaciones y eventos. Verifica que la clave de desarrollador sea la correcta. Además, asegúrate de que la clave de desarrollador contenga solo caracteres alfanuméricos.
El ID de aplicación y la clave de desarrollador son correctos, pero la instalación no se registra.
Situación
La aplicación contiene el ID de aplicación y la clave de desarrollador correctos, pero las instalaciones no se registran.
Causas posibles
- El SDK no se inició correctamente. Asegúrese de llamar al método
trackAppLaunch
enapplicationDidBecomeActive
:
- (void)applicationDidBecomeActive:(UIApplication *)application { [[AppsFlyerTracker sharedTracker] trackAppLaunch]; }
func applicationDidBecomeActive(application: UIApplication) { AppsFlyerTracker.shared().trackAppLaunch() }
El registro muestra el mensaje "AppsFlyer dev key missing or empty. Aborting"
Situación
Está intentando ver instalaciones y eventos in-app en el registro. El registro muestra el mensaje "AppsFlyer dev key missing or empty. Aborting" (La clave de desarrollador de AppsFlyer no se encuentra o está vacía. Anulando).
Causas posibles
La clave de desarrollador no está definida. Asegúrese de configurarla en appDelegate en el método didFinishLaunchingWithOptions
:
[AppsFlyerTracker sharedTracker].appsFlyerDevKey = @"YOUR_DEV_KEY";
AppsFlyerTracker.shared().appsFlyerDevKey = "YOUR_DEV_KEY"
La instalación siempre se atribuye como orgánica
Situación
Estás realizando pruebas de atribución mediante enlaces de atribución. Implementaste el agente de escucha de conversión del SDK, pero el registro siempre muestra que la instalación es orgánica. Además, no hay ninguna instalación no orgánica registrada en el panel de control.
Causas posibles
- El enlace de atribución que usas es incorrecto. Consulta nuestra guía sobre enlaces de atribución.
- Asegúrate de que el dispositivo que usas para la prueba esté registrado.
Los ingresos no se registran correctamente.
Situación
Está probando eventos in-app con ingresos. Los eventos aparecen en el panel de control, pero los ingresos no se registran.
Causas posibles
El parámetro de ingresos no tiene el formato correcto. NO altere el formato del valor de ingresos de ninguna manera. No debe contener comas, signos de moneda ni texto. Por ejemplo, un evento generador de ingresos debería ser similar a 1234.56.
Recibo un código de error 404 al registrar una instalación o evento.
Situación
Está probando instalaciones y eventos in-app para ver si están atribuidos a la fuente de medios correcta. Sin embargo, aparece el código de respuesta 404 para la instalación y los eventos in-app. Ni la instalación ni los eventos in-app aparecen en el panel de control.
Causas posibles
Un código de respuesta 404 indica que el ID de aplicación es incorrecto. Consulta Las instalaciones y los eventos no se registran.
Recibo el código de respuesta 400 cuando registro instalaciones o eventos.
Situación
Está intentando probar eventos in-app en el registro. Cuando activa eventos, ve el código de respuesta 400 en los registros.
Causas posibles
Esto puede indicar un problema con la clave de desarrollador. Verifica que la clave de desarrollador sea la correcta. Además, asegúrate de que la clave de desarrollador contenga solo caracteres alfanuméricos. Consulta Las instalaciones y los eventos no se registran.
Recibo el código de respuesta 400 cuando registro instalaciones o eventos.
Situación
Estás intentando probar las instalaciones y otros eventos de conversión en el registro. Cuando activas estos eventos, ves la respuesta 403 (prohibido) en los registros.
Causas posibles
Esto puede ser porque tienes el paquete Zero, que no incluye datos de atribución; solo datos sobre clics e impresiones. Para empezar a recibir datos de atribución, aprende más sobre los diferentes paquetes de AppsFlyer y actualiza según sea necesario. También puedes comunicarte con nuestro equipo de engagement del cliente a través de hello@appsflyer.com si tienes preguntas sobre nuestros paquetes.
Depuración para Unity
Cómo habilitar el modo de depuración en Unity
Para iniciar la depuración del SDK de Unity, agregue la siguiente línea al método start
en el GameObject de AF.
AppsFlyer.setIsDebug (true);
¡Advertencia!
La depuración debe restringirse a la fase de desarrollo solamente. No distribuya la aplicación en las tiendas de aplicaciones con la depuración habilitada. Esto implica riesgos importantes de seguridad y privacidad.
Cómo ver el resultado de la depuración
El resultado de la depuración se visualiza mediante Android Studio o XCode.
Resolución de problemas con el SDK para Unity
Unity simplemente desarrolla aplicaciones para Android y iOS. Consulte los problemas frecuentes de cada plataforma para obtener más información:
Nota
Cuando hayas terminado de probar y depurar la integración del SDK, desactiva los registros del SDK.