Notas de la versión del SDK para Android de AppsFlyer

En resumen: Consulta las notas de la versión del SDK para obtener una visión general de los últimos cambios introducidos en el SDK de Android. Los desarrolladores que deseen información más detallada pueden consultar las notas de la versión de Android en el Dev Hub.

SDK de Android V6  

Guía de integración del SDK de Android para desarrolladores

Versión Fecha de lanzamiento Notas
6.15.2 10-10-2024
  • Mejoras y correcciones de estabilidad
  • Actualizaciones internas relacionadas con la API de Atribución de Privacy Sandbox
6.15.1 28-08-2024 Actualización de versiones:
  • targetSDKVersion: v34
  • Gradle: v8.7
  • Java: v17
6.15.0 31-07-2024
  • Se agregó el método logAdRevenue para enviar datos de ingresos publicitarios a AppsFlyer. Nota: A partir de esta versión, ya no se debe utilizar el conector AdRevenue; debe ser reemplazado por el método logAdRevenue. Saber más
6.14.2 10-06-2024
  • Se solucionó un problema con la obtención de Meta Install Referrer en aplicaciones creadas con Unity.
6.14.1 29-05-2024 Mantenimiento del SDK
6.14.0 18-04-2024
  • Se ha agregado compatibilidad con el flujo de validación de compras actualizado. Esta función se encuentra actualmente en beta cerrada. Saber más
  • Se actualizó la integración de Huawei Referrer. Saber más.
6.13.1 03-04-2024 Mantenimiento del SDK
6.13.0 08-02-2024
  • Se agregó soporte para la nueva política de consentimiento de la UE de Google.
6.12.6 29-01-2024 Mantenimiento del SDK
6.12.5 18-12-2023
  • Se ha añadido el parámetro original_link al callback de deep linking en el flujo de resolución ESP.
6.12.4 25-10-2023
  • Dexguard se actualizó a la versión 9.4.16 para mejorar la estabilidad del SDK.
6.12.3 31-08-2023 Mantenimiento del SDK
6.12.2 02-08-2023
  • Se ha corregido un error que podía provocar que la aplicación fallara en algunos dispositivos en Android 8.1.0 y Android 11.
6.12.1 29-06-2023
  • Se ha corregido un problema que hacía que la apertura de la Play Store se retrasara en la promoción cruzada.
  • Se ha corregido un error que provocaba que la aplicación fallara en algunos dispositivos.
6.12.0 28-06-2023
  • En desuso: utiliza la versión 6.12.1.
6.11.2 29-06-2023
  • Se ha corregido un error que provocaba que la aplicación fallara en algunos dispositivos.
6.11.1 06-06-2023
  • En desuso: utiliza la versión 6.12.1.
  • Se corrigió un error por el que la aplicación a veces fallaba después de inicializar el SDK.
6.11.0 16-05-2022
  • Se ha corregido un problema que a veces provocaba que la aplicación se congelara en algunos dispositivos cuando el SDK intentaba obtener el Google Play Referrer.
6.10.3 25-04-2023 Mantenimiento del SDK
6.10.1 01-03-2023
  • Se corrigió un problema que a veces provocaba que las aplicaciones de los dispositivos Samsung se cerraran al inicializar el SDK. Este problema afectó a las aplicaciones con SDK V6.6.0 y superiores.
6.10.0 13-02-2023
  • Nuevo dominio de AppsFlyer para la comunicación entre el SDK y los servidores de AppsFlyer.
  • Se ha cambiado la API setHost cuando se envían valores vacíos o nulos. Saber más
6.9.4 06-12-2022
  • Se ha corregido un problema por el cual el envío de un evento de ingresos por publicidad desde el conector del SDK de ingresos por publicidad activaba una llamada al listener de conversión.
  • Se ha corregido un problema que a veces provocaba que las aplicaciones se congelaran cuando se enviaba un evento de ingresos por publicidad desde el conector del SDK de ingresos por publicidad.
6.9.3 28-11-2022
  • Se actualizó la estructura interna de las solicitudes para obtener datos de conversión (GCD). Nota: Los datos de respuesta siguen siendo los mismos.
  • Se corrigió un problema por el que el SDK activaba una solicitud de GCD cuando la aplicación tenía el ConversionListener establecido en nulo.
6.9.2 02-10-2022
  • Se corrigió un problema relacionado con un retraso en la solicitud de una validación de compra usando la API validateAndLogInAppPurchase.
6.9.1 19-09-2022 Mantenimiento del SDK
6.9.0 12-09-2022
6.8.2 29-08-2022
  • Se corrigió un problema crítico con el mecanismo de almacenamiento en caché del SDK introducido en la V6.7.0, que provocaba que los eventos en caché se enviaran varias veces.
6.8.1
(Obsoleto)
24-08-2022
  • Obsoleto. Utilice V6.8.2.
6.8.0
(Obsoleto)
18-07-2022
  • Obsoleto. Utilice V6.8.2.
  • Se ha eliminado el enableLocationCollection API del SDK. La aplicación aún puede informar los datos de ubicación del usuario pasándolos al SDK directamente a través de la función logLocation de la API.
  • Se agregó el permiso com.google.android.gms.permission.AD_ID para los AndroidManifest.xml del SDK. Leer más sobre ello aquí.
  • Se corrigió un problema relacionado con la optimización y ofuscación mediante el uso de R8.
6.7.0
(Obsoleto)
19-06-2022
  • Obsoleto. Utilice V6.8.2.
  • Se cambió el modo en que el SDK gestiona las peticiones a los servidores de AppsFlyer. Después de este cambio, la solicitud para reportar la primera apertura de la aplicación (conversión) se priorizará sobre los eventos in-app y otros tipos de solicitudes. Más información aquí.
  • Nueva API: setDisableNetworkData para optar por no recopilar la información sobre la red celular (nombre del transportista, nombre del operador).
6.6.1 16-05-2022 Mantenimiento del SDK
6.6.0 01-05-2022
  • Se agregaron más parámetros a los UDL callback onDeepLinking para el flujo de deep linking directos (usuarios existentes). Saber más.
6.5.4 23-03-2022 Mantenimiento del SDK
6.5.3 09-03-2022
  • Corrección de errores: Se ha solucionado un problema con la creación de enlaces de invitación a usuarios que contienen caracteres que no estén en inglés.
6.5.2 26-01-2022
  • Se solucionó el problema al resolver la URL para los deferred deep linking en UDL.
  • Actualizado a DexGuard 9.2
  • Refactorización y cambios internos.
6.5.1 29-12-2021
6.5.0 07-12-2021
  • Refactorización y cambios internos.
6.4.3 14-11-2021
  • Se ha corregido un error introducido en V6.4.2 con LinkGenerator que provocaba la creación de enlaces en los que faltaban parámetros de URL.
6.4.2 24-10-2021 Se resolvieron los siguientes:
  • pid que se añade dos veces a las URLs personalizadas generadas por LinkGenerator.
  • Se ha añadido / adicional al valor af_dp cuando se utiliza LinkGenerator para crear esquemas URI personalizados.
  • Se recopilaban tanto el IMEI como el AndroidID, si la aplicación activaba la recopilación de solo uno de ellos.
6.4.1 17-10-2021 Se resolvió el error de compilación al usar una versión de Gradle anterior a V3.5.4.
6.4.0 12-09-2021

Nueva API: setSharingFilterForPartners permite configurar qué partners debe excluir el SDK del uso compartido de datos.

A partir de esta versión, setSharingFilter y setSharingFilterForAllPartners se dejarán de utilizar.

6.3.2

Desuso: 31/08/2024

06-06-2021 Nueva API: setDisableAdvertisingIdentifiers

6.3.1

Desuso: 31/08/2024

26-05-2021
  • Nueva API: performOnDeepLinking
  • Se ha añadido la posibilidad de activar el método API de invitación de usuario Antes de llamar start/después de llamar stop
  • Corrección de errores: Se ha corregido un problema por el que una llamada a waitForCustomerUserId no se liberaba incluso después de llamar a setCustomerUserId

6.3.0

Desuso: 31/08/2024

29-04-2021
  • Corrección de errores: Invocación incorrecta de onConversionDataFail en caso de error de solicitud de envío de eventos in-app
  • Corrección de errores: recopilación de métricas de sensor de movimiento (para detección de fraude)
  • Corrección de errores: Corrección de UDL relacionada con la ofuscación
  • Actualización técnica de la API de OneLink
6.2.3
Desuso: 31/08/2024
04-03-2021 Mantenimiento del SDK
6.2.0
Desuso: 31/08/2024
07-02-2021
6.1.4
Desuso: 31/08/2024
12-01-2021
  • Se agregó soporte para DexGuard V9
6.1.3
Desuso: 31/08/2024
24-12-2020
6.1.1
Desuso: 31/08/2024
03-12-2020
  • Se agregó soporte para Samsung Galaxy Store referrer
  • Corrección de errores menores y mejoras de rendimiento.
6.1.0
Desuso: 31/08/2024
09-11-2020
6.0.1
Desuso: 31/08/2024
28-10-2020 Mantenimiento del SDK
6.0.0
Desuso: 31/08/2024
14-10-2020
  • Cambios importantes en la funcionalidad del SDK y la API, incluidos los cambios en el nombre de los métodos y la entrada en desuso. Saber más

Notas de la versión de Android V6.0.0

Se eliminaron o dejaron en desuso los métodos o se cambió su nombre

Métodos eliminados/en desuso

Los siguientes métodos se han eliminado del SDK:

  • sendDeepLinkData
  • trackAppLaunch
  • setPluginDeepLinkData
  • setConsumeAFDeepLinks
  • setHostName

Se cambió el nombre de los métodos

Nombre de la API (antes de V6) Nombre de la API actual (V6 y posteriores)
stopTracking stop
setCustomerIdAndTrack setCustomerIdAndLogSession
startTracking start
trackLocation logLocation
reportTrackSession logSession
trackEvent logEvent
setDeviceTrackingDisabled anonymizeUser
validateAndTrackInAppPurchase validateAndLogInAppPurchase
isStopTracking isStopped
trackAndOpenStore logAndOpenStore
trackCrossPromoteImpression logCrossPromoteImpression
trackInvite logInvite

Se cambió el nombre de la interfaz

Nombre de la interfaz (antes de V6) Nombre de la interfaz actual (V6 y posteriores)
AppsFlyerTrackingRequestListener AppsFlyerRequestListener

Versiones obsoletas

Notas de la versión del SDK de Android V5

Versión Fecha de lanzamiento Solo mantenimiento Notas
5.4.6 09-11-2020  
  • Se agregó soporte para Huawei AppGallery referrer.
5.4.4 01-10-2020  
  • Se agregó soporte para que el SDK maneje múltiples redireccionamientos desde ESPs
  • Corrección de errores y mantenimiento
5.4.3 30-07-2020  
  • Capacidades extendidas de registro y depuración
  • Corrección de errores y mantenimiento
  • Soporte para Google install referrer V2
5.4.1 30-06-2020  
  • Permitir a los anunciantes controlar el intercambio de datos con redes/partners integrados. Saber más
  • Corrección de errores y mantenimiento
5.4.0 03-06-2020  
  • Soporte completo para la recopilación automática del OAID
  • Compatibilidad con referencias múltiples: El SDK puede recopilar referencias de Huawei y Google
  • Mejoras en el rendimiento del SDK
  • Corrección de errores y mantenimiento
5.3.0 27-04-2020   
  • Acceso a los últimos datos de conversión de direct deep linking en cualquier momento, a través del método onAppOpenAttribution
  • Parámetros adicionales disponibles para impresiones de promoción cruzada
  • Corrección de errores: problemas corregidos con los nombres de archivo a. y b. en Windows
  • El método sendDeepLinkData para obtener datos de atribución incluso si el usuario está vinculado a una actividad específica ha quedado obsoleto en favor del método startTracking()
5.2.0 10-03-2020   
  • Permitir la inicialización del SDK en cualquier actividad
  • Capacidades extendidas de seguridad, registro y depuración
  • Corrección de errores y mantenimiento
5.1.2 19-02-2020  
5.1.1 23-01-2020     
5.1.0 06-01-2020      
  • Direccionar a Android 9 (API nivel 28) según los requisitos de nivel de API de destino de Google
  • Mejoras en la protección antifraude para los clientes de Protect360
  • Módulo opcional para recopilar el OAID (relevante para China doméstica) - Xiaomi y Huawei (ver https://github.com/AppsFlyerSDK/appsflyer-oaid).
  • Mejora de estabilidad al usar setOneLinkCustomDomain para ESPs
5.0.2 23-12-2019     
5.0.1 12-12-2019     
5.0.0 12-11-2019
  • Corrección de errores y mantenimiento
  • Cambios importantes en la funcionalidad del SDK y la API, incluidos los cambios en el nombre de los métodos y la entrada en desuso. Saber más

Notas de la versión de Android V5.0.0

Mejora del tiempo de respuesta del SDK

A partir del SDK V5.0.0, se mejoró el tiempo de respuesta de GCD para las instalaciones orgánicas.

Se eliminaron los métodos o se cambió su nombre

Cambios en los nombres de método

Los nombres de los métodos de datos de conversión de instalaciones son ahora los mismos para Android e iOS. Esto tiene impacto en los métodos que manejan:

  • datos de conversión en la instalación
  • errores si los datos no están disponibles
Nombre de Android anterior al SDK V5  Nombre de iOS anterior al SDK V5 Nombre estandarizado
onInstallConversionDataLoaded onConversionDataReceived onConversionDataSuccess
onInstallConversionFailure onConversionDataRequestFailure onConversionDataFail

Métodos eliminados

Los siguientes métodos quedaron en desuso en versiones anteriores del SDK. Ahora se han eliminado del SDK.

Android

  • setGCMProjectID (String projectNumber)
  • setGCMProjectNumber (String projectNumber)
  • setGCMProjectNumber (Context context, String projectNumber)
  • enableUninstallTracking (String senderId)
  • setAppUserId (String id)
  • setUserEmail (String email)
  • setCollectFingerPrint (boolean isCollect) 
  • getAttributionId (ContentResolver contentResolver)
  • FirebaseInstanceIdListener class (instance of FirebaseInstanceIdService)

 iOS

  • loadConversionDataWithDelegate: (id<AppsFlyerTrackerDelegate>)delegate
  • setHost:(NSString *)host 

Cambios para obtener el formato de los datos de conversión

En esta versión, por cada instalación o apertura de la aplicación, el SDK devuelve un objeto de mapa que contiene datos de conversión (GCD), como la fuente de medio y el nombre de la campaña. En versiones anteriores del SDK, GCD devolvía solo los parámetros que tenían un valor.

A partir de esta versión, se devuelven todos los parámetros, incluidos aquellos sin valor. Los parámetros sin valor tienen un valor nulo. 

 Ejemplo

Una instalación sigue a un clic en la siguiente URL:

https://app.appsflyer.com/com.sample.app?pid=super_media_source&c=awesome_campaign
  &campaign_id=1234&af_sub1=promo
  

Las respuestas son las siguientes:

Respuesta de GCD antes del SDK V5 Respuesta de GCD a partir del SDK V5
   {
      "install_time": "2019-11-11 15:00:59.828",
      "media_source": "super_media_source",
      "orig_cost": "0.0",
      "advertising_id": "215d8172-c61e-4d0c-9eb2-aa4d0971ed8c",
      "af_status": "Non-organic",
      "is_first_launch": "true",
      "af_sub1": "promo",
      "af_click_lookback": "7d",
      "cost_cents_USD": "0",
      "iscache": "true",
      "click_time": "2019-11-11 15:00:35.102",
      "campaign": "awesome_campaign",
      "campaign_id": "1234",
  }
      

GCD devuelve la misma estructura sin importar los datos. Si un parámetro está vacío, se incluye en GCD con un valor nulo. Esto facilita a los desarrolladores procesar GCD sin tener que ajustar la lógica de procesamiento de GCD, independientemente de si ciertos parámetros están incluidos o no. Para aprender más sobre los datos de conversión en diferentes situaciones, consulta aquí.

Notas de la versión Android V4.0.0

Versión Fecha de lanzamiento Notas
4.11.0 22-10-2019
  • Registro mejorado para mejores capacidades de depuración de:
    • ESP
    • Resolución de enlaces de marca
    • onInstallConversionData y onAppOpenAttribution.
  • Corrección de errores y mantenimiento
4.10.3 15-09-2019
  • Corrección de errores y mantenimiento
  • Soporte para Open Advertiser ID (OAID)  
4.10.2
4.10.1 01-07-2019 Corrección de errores y mantenimiento
4.10.0 14-05-2019
  • Mejoras en el SDK para desarrolladores que utilizan ProGuard.
  • Corrección de errores y mantenimiento
4.9.0 17-03-2019
  • API setResolveDeepLinkURLs para resolver OneLinks encapsulados con otro Universal Link
  • Corrección del registro de notificaciones push cuando el registro de notificación push descartada de la carga útil anterior contenía el mismo pid y todavía estaba en la memoria.
  • Corrección de error tipográfico de af_county a af_country
  • Corrección de errores y mantenimiento
4.8.20 13-02-2019
  • Capacidades mejoradas de calificación cero para proveedores de teléfonos móviles
  • Corrección de errores y mantenimiento
4.8.19 26-12-2018
  • Solucionado el problema por el que el método waitForCustomerUserId() rompía generateLink
  • Corrección de errores y mantenimiento
4.8.18 11-11-2018
  • Se corrigieron problemas de deep linking de las actividades de trampolín
  • Precisión mejorada del re-engagement al moverse entre el fondo y el primer plano
  • Corrección de errores y mantenimiento
4.8.17 02-11-2018 Corrección de un problema relacionado con conflictos en ProGuard que causaban la pérdida de datos del inicio de la aplicación en algunos casos. Este problema afectó solo a la versión 4.8.16 del SDK
4.8.16 31-10-2018 Corrección de errores y mantenimiento
4.8.15 27-08-2018
  • Eventos adicionales del SDK: Suscribirse, Iniciar Prueba, Clic en Anuncio, Ver Anuncio
  • Corrección de errores y mantenimiento
4.8.14 31-07-2018
  • Se han añadido las APIs setOutOfStore y getOutOfStore para establecer dinámicamente el valor de AF_STORE.
  • Se han añadido las API onTrackingRequestFailure y onTrackingRequestSuccess para recibir una confirmación de que AppsFlyer ha recibido correctamente los servidores de solicitud de seguimiento.
4.8.13 20-06-2018
  • Se corrigió un error en un caso en el que faltaba el IMEI cuando se transmitía explícitamente a través de la API setImeiData
  • Corrección de errores y mantenimiento
4.8.12 27-05-2018
  • Se corrigió el fallo de la aplicación al usar la prueba JUnit que usa Robolectric
  • Corrección de errores y mantenimiento
4.8.11 02-05-2018 Corrección de errores y mantenimiento
4.8.10 26-04-2018
  • Añadida la API setPreinstallAttribution
  • Corrección de errores y mantenimiento
4.8.9 02-04-2018
  • Recopilar IMEI solo si GooglePlayServices no existe en el dispositivo y no es posible recuperar el GAID en ese dispositivo
  • Corrección de errores y mantenimiento
4.8.8 11-03-2018
  • Se agregó la API para retrasar la inicialización del SDK hasta que se proporcione el customerUserID
  • Corrección de errores y mantenimiento.
4.8.7 25-01-2018
  • API isStopTracking para cerrar todas las actividades del SDK
  • Parámetro de evento af_content
4.8.5 29-11-2017
  • Soporte para la nueva Google referrer API
  • Nuevo método init que recibe contexto
4.8.4 14-11-2017
  • Añadida una bandera a getConversionData is_first_launch que indica si esta es la primera apertura de la aplicación. Este indicador permite a los desarrolladores identificar el primer inicio de la aplicación fácilmente dentro de la respuesta de callback getConversionData que se devuelve en cada inicio. Los valores posibles para is_first_launch son "true" o "false"
  • Corrección de errores y mantenimiento
4.8.3 27-09-2017 Se agregó soporte para datos de referente HTTP en getConversionData
4.8.2 19-09-2017 Corrección en sendDeepLinkData(this) para aplicaciones que se enlazan a múltiples actividades
4.8.1 17-09-2017 Protección mejorada contra eventos in-app llamados antes de la inicialización del SDK
4.8.0 03-09-2017
  • API de invitación de usuarios
  • API de promoción cruzada
  • Tiempo Personalizado Entre Sesiones
  • Soporte para calificación cero de proveedores de teléfonos móviles
  • Parámetro de evento adicional af_projected_revenue
  • Corrección de errores y mantenimiento
  • Método init adicional introducido - AppsFlyerLib.getInstance().init(AF_DEV_KEY,conversionDataListener);
4.7.4 28-06-2017 Manejo mejorado de múltiples paradas de ScheduledExecutorSerice
4.7.3 06-06-2017 Mejoras para la integración de mParticle
4.7.2 22-05-2017
  • Se corrigió un problema menor de fuga de memoria
  • Precisión mejorada de la medición de desinstalaciones
  • Se corrigió la advertencia de ProGuard que afectaba a la medición de desinstalaciones
  • Corrección de errores y mantenimiento
4.7.1 22-02-2017 Se corrigió la advertencia activada por ProGuard
4.7.0 13-02-2017
  • Parámetros adicionales del evento
  • Soporte de la medición de desinstalaciones basada en Firebase
  • Corrección de errores y mantenimiento