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

Para:
Marketers Desarrolladores
Última actualización:

De un vistazo: Notas de la versión del SDK de Android a partir de la V4.x.

SDK de Android V6 

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

Versión Fecha de lanzamiento Solo mantenimiento Notas

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. Aprender 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 oyente 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 Sí  

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
(En desuso)

 24-08-2022 Sí

En desuso. Por favor utiliza la V6.8.2.

6.8.0
(En desuso)

 18-07-2022  
  • En desuso. Por favor utiliza la V6.8.2.
  • Se eliminó la API enableLocationCollection del SDK. La aplicación aún puede reportar los datos de ubicación del usuario pasándolos al SDK directamente a través de la API logLocation.
  • Se agregó el permiso com.google.android.gms.permission.AD_ID al 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
(En desuso)

 19-06-2022  
  • En desuso. Por favor utiliza la V6.8.2.
  • Se cambió la forma en que el SDK maneja las solicitudes 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. Leer más sobre ello aquí.
  • Nueva API: setDisableNetworkData para optar por no recopilar la información sobre la red de telefonía celular (nombre de la compañía telefónica, nombre del operador).

6.6.1

 16-05-2022 Sí  

6.6.0

 01-05-2022   Se agregaron más parámetros a la devolución de llamada onDeepLinking de UDL para el flujo de enlaces profundos directos (usuarios existentes). Para más información.

6.5.4

 23-03-2022 Sí  

6.5.3

 09-03-2022  
  • Corrección de errores: se solucionó el problema con la creación de enlaces de invitación de usuario que contienen caracteres no ingleses.

6.5.2

 26-01-2022  
  • Se solucionó el problema al resolver la URL para los enlaces profundos diferidos en UDL.
  • Actualizado a DexGuard 9.2
  • Refactorización y cambios internos.

6.5.1

 29-12-2021   Resolución de enlaces profundos con UDL para aplicaciones que utilizan la opción Fuera de la tienda con canal.

6.5.0

 07-12-2021   Refactorización y cambios internos.

6.4.3

 14-11-2021   Se solucionó un error introducido en  V6.4.2 con LinkGenerator, que causaba la creación de enlaces con parámetros de URL faltantes.

6.4.2

 24-10-2021  

Se resolvieron los siguientes:

  • pid se anexa dos veces a las URL personalizadas generadas por LinkGenerator.
  • Se agregó un / adicional al valor af_dp al usar 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 te permite configurar qué partners debe excluir el SDK del uso compartido de datos.

A partir de esta versión, setSharingFilter y setSharingFilterForAllPartners están en desuso.
6.3.2 06-06-2021  

Nueva API: setDisableAdvertisingIdentifiers
6.3.1 26-05-2021  
  • Nueva API: performOnDeepLinking
  • Se agregó la capacidad de activar la API de invitación de usuarios antes de llamar a start/después de llamar a stop
  • Corrección de errores: se corrigió un problema por el que una llamada a waitForCustomerUserId no se lanzaba incluso después de llamar a setCustomerUserId
6.3.0 29-04-2021  
  • Corrección de errores: invocación incorrecta de onConversionDataFail tras un error en la 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 relacionada con la ofuscación para UDL
  • Actualización técnica de la API de OneLink
6.2.3 04-03-2021 Sí  
6.2.0 07-02-2021  
6.1.4 12-01-2021  
  • Se agregó soporte para DexGuard V9
6.1.3 24-12-2020  
6.1.1 03-12-2020  
  • Se agregó soporte para el referente de Samsung Galaxy Store
  • Corrección de errores menores y mejoras de rendimiento.
6.1.0 09-11-2020  
6.0.1 28-10-2020 Sí

 
6.0.0 2020-10-14  
  • 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. Aprender 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

detener

setCustomerIdAndTrack

setCustomerIdAndLogSession

startTracking

comenzar

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

SDK de Android V5 

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 el referente de Huawei AppGallery.

5.4.4

 01-10-2020  
  • Se agregó soporte para que el SDK maneje múltiples redireccionamientos desde ESP
  • 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 el referente de instalación de Google V2

5.4.1

 30-06-2020  
  • Permitir a los anunciantes controlar el intercambio de datos con redes/partners integrados. Aprender más
  • Corrección de errores y mantenimiento

5.4.0

 03-06-2020  
  • Soporte completo para la recopilación automática del OAID
  • Soporte de múltiples referentes: el SDK puede recopilar referentes 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 enlaces profundos directos 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á enlazado profundamente a una actividad específica, se ha dejado en desuso a 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 Sí

 
5.1.1 23-01-2020    Sí  
5.1.0 06-01-2020      
  • Apuntar a Android 9 (API nivel 28) según los requisitos de nivel de API de apuntamiento de Google
  • Mejoras en las protecciones antifraude para 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 ESP

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 (cadena projectNumber)
  • setGCMProjectNumber (cadena projectNumber)
  • setGCMProjectNumber (contexto context, cadena projectNumber)
  • enableUninstallTracking (cadena senderId)
  • setAppUserId (cadena id)
  • setUserEmail (cadena email)
  • setCollectFingerPrint (booleano isCollect) 
  • getAttributionId (ContentResolver contentResolver)
  • Clase FirebaseInstanceIdListener (instancia de 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 aplicación abierta, el SDK devuelve un objeto de mapa que contiene datos de conversión (GCD) como la fuente de medios y el nombre de 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í.

Versiones en desuso

    Lectura relacionada: Política de control de versiones del SDK de AppsFlyer

Versión Fecha de lanzamiento Notas
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. Aprender más
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 enlace universal
  • 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 telefonía celular
  • Corrección de errores y mantenimiento
4.8.19 26-12-2018
  • Se solucionó el problema por el que el método waitForCustomerUserId() rompe generateLink
  • Corrección de errores y mantenimiento
4.8.18 11-11-2018
  • Se corrigieron problemas de enlaces profundos 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 anuncios, vista de anuncios
  • Corrección de errores y mantenimiento
4.8.14 31-07-2018
  • Added setOutOfStore and getOutOfStore APIs for dynamically setting the AF_STORE value
  • Se agregaron las API onTrackingRequestFailure y onTrackingRequestSuccess para recibir una confirmación de que AppsFlyer recibió correctamente los servidores de solicitudes de tracking
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
  • Se agregó 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
  • Cierre de la API isStopTracking de todas las actividades del SDK
  • Parámetro de evento af_content
4.8.5 29-11-2017
  • Soporte para la nueva API de referente de Google
  • Nuevo método init que recibe contexto
4.8.4 14-11-2017
  • Se agregó un indicador a getConversionData is_first_launch, que indica si este es el primer inicio 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 devolución de llamada getConversionData que se devuelve en cada inicio. Los valores posibles para is_first_launch sonc"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 profundamente 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 telefonía celular
  • 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

Sumas de verificación del SDK de Android

AppsFlyer usa sumas de verificación md5:

Sumas de verificación V6

Versión del SDK de Android Suma de verificación
6.6.1 1ec98047f8cb4145137f3c97459d052c
6.6.0 6f5aef27ea407c7fc1691b52ff800c61
6.5.4 c71aacbf201449dd5ef1158b55bd2ad0
6.5.3 7db44f0852be1c94fe36cc535b7c61f7
6.5.2 71e3a16c4278f857cd86b7b05aedd066
6.5.1 261928cfc55b27a6c2ab19cf9081d705
6.5.0 2a6d500fd4939a8faa47bbbba97288b6
6.4.3 c62f9359d6b5497d54e248c526c5f547
6.4.2 dc385fb62eaf68aff2e7f9c1c0ed19ea
6.4.1 94945db2c0e81baab79535393f210f1b
6.4.0 d7910a35901d4299b54259f1c1bbe2d6
6.3.2 46bc92bb2eed1416de28ccccb3a28620
6.3.1 ca47af77ffbcd7525e82d0bdaaef5b91
6.3.0 f969bb5a62885e8084794d5334787275
6.2.3 bab1309f77acd1f0453372150c82694a
6.2.0 fc727698c7b8bfb1ca448726492931b4
6.1.4 983785b1c30a15e8fac029e370bb3b73
6.1.3 c0392a091659dc445a1014e14da6a31a
6.1.1 0a18fafb2826c90b3388b371a3cbdeec
6.1.0 e8d6df04ac2642b2d7b16efb57f315e9
6.0.1 9ebeb6f4f49476667c07d0e8eb1aa2e8
6.0.0 cff3d453ea94e67182f5b1b023aeb1c1

Sumas de verificación V5

Versión del SDK de Android Suma de verificación
5.4.6 4f1bdc33ac0d6dd3f9b75411c3c0a06c
5.4.4 13a04913cf61276238f54e5e2d73e88d
5.4.3 7b1caef46942c70edcd2e59cad69e439
5.4.1 e4eb21c0030f376857b53e2e30022fc8
5.4.0 8c0270f6c3e7e58b1db42be82cc341d8
5.3.0 d602dd28d9ee807855e5426d6a9b7ebf
5.2.0 64fe94447def6d99549d3274ce908f09
5.1.2 1a7dbb23aad32d697835f3ec29337ca9
5.1.1 dfea6a49e6ae57fc2c700f6dcd904bc1
5.1.0 89cc7e08a0430180e64f3cccf955768f
5.0.2 c113618ea379531cba6ce42bc4c79d72
5.0.1 db0502faa5b02102dd99ac6cec666d04
5.0.0 98f1f78ae5f63cb4f40ba838d3d1be22

Sumas de verificación V4

Versión del SDK de Android Suma de verificación
4.10.3 855186d68912810fa47897262a9ba0a0
4.10.2 13ed5716d5a8583eeee527f01bd2a69d
4.10.1 ab3e49bb4640990267466b7852cd3de7
4.10.0 b5fb55ee76cd6a742d9bd25b910745a1
4.9.0 afa49524ddceda28ca1648946489a6b0
4.8.20 2f59d0f8db09b92f8261475a1d0807d0
4.8.19 baf8fa419f38de52cef6091de32aca86
4.8.18 3a0641720811a25542449f1927daf13e
4.8.17 3a0641720811a25542449f1927daf13e
4.8.16 501be427b0c2a831e148649131ce3fc0
4.8.15 7b6759a006d72d3a7c78ec80160c3502
4.8.14 bc4facd80958d0600b4d000104e524d9
4.8.13 bc4facd80958d0600b4d000104e524d9
4.8.12 171569002d93fb8d49787b363192973f
4.8.11 4419af159a42e4ee7a218ef8615e2abb
4.8.10 468ad04e4a2088ba7af9c45d42f4ed6d
4.8.9 9a923bbbf3f6c7cc19b900e49644da2c
4.8.8 6dee4814986061a0723cc9f844796e2e
4.8.7 ca13997ccb781a5935e91983b7be81ea
4.8.6 da117a3e9e05df7dd28297df762cfbfa
4.8.5 f8ea07b8a60d664541686ba7064730f5
4.8.4 b10f185c1094cf283b11339810a47c87
4.8.3 7f94ec175b948c5009bfbfe2fb25b2b0
4.8.2 3e34b55e13cd3f8d387b1a33c20105eb
4.8.1 6c2930d2997a7b2b6ab7b3ecf0e3135b
4.8.1 468ad04e4a2088ba7af9c45d42f4ed6d
4.8.1 4419af159a42e4ee7a218ef8615e2abb último
4.8.0 32d67577ce59b2072475e509579baece
4.7.4 7e649e6a1cf8999ca39b05402946b3d6
4.7.3 e30c020f8ee5dd3af274fa94ef414a38
4.7.2 945aaaca554aa8b2f96219f25eed9777
4.7.1 862c349025e4725d4e5044a190c60337
4.7.0 b060ad140ffd0c8f2b3febb26122d173