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

En resumen: Consulta las notas de la versión del SDK para obtener una descripción general rápida de los últimos cambios en el SDK de iOS. Los desarrolladores que busquen detalles más completos deben revisar las notas de la versión de iOS en el Dev Hub.

iOS SDK V6 

Guías para desarrolladores sobre la integración con el SDK para iOS

Versión Fecha de lanzamiento Notas
6.16.1 18-02-2025
  • Se actualizó la API para enviar manualmente los datos de consentimiento de la DMA a AppsFlyer.
6.16.0 19-01-2025
  • Se agregó soporte para las APIs StoreKit 2 de Apple para reportes de suscripciones y compras in-app a través del conector de compras. Esta función se encuentra actualmente en beta cerrada.
6.15.3 23-09-2024 Mantenimiento del SDK
6.15.2 28-08-2024
  • Se ha corregido un problema con la transmisión de eventos en el conector de compra. Esta corrección no afecta a ninguna versión de producción del conector de compra y está relacionada con su actualización a la versión 6.15.x.
6.15.1 19-08-2024
  • Se ha corregido un problema con la detección de reinstalación que se producía cuando se instalaban dos o más aplicaciones del mismo proveedor en el dispositivo.
6.15.0 06-08-2024
  • Se agregó el método de API 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. Para más información, consulta aquí.
  • Se han realizado actualizaciones internas relacionadas con el conector de compras. Las aplicaciones que usan el conector de compra y se actualizan a esta versión del SDK también deben actualizar su conector de compra a la versión 6.15.0.
6.14.6 24-07-2024
  • Se ha corregido un problema por el que el SDK realizaba llamadas redundantes a la función de API getConversionData (GCD) al iniciar una nueva sesión; Esto no afecta a la medición.
6.14.5 03-07-2024
  • Se ha corregido un problema por el que el SDK enviaba los datos de consentimiento manual establecidos por la aplicación, incluso si se había eliminado el código para enviar el consentimiento manual.
6.14.4 10-06-2024
6.14.3 26-04-2024
  • Se corrigió la fusión automática del manifiesto de privacidad para las aplicaciones que utilizan Cocoapods.
6.14.2 19-04-2024 Mantenimiento del SDK
6.14.1 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
6.14.0 07-04-2024
6.13.2 26-03-2024
6.13.1 05-03-2024
  • Se solucionó un problema con el envío de datos de consentimiento para usuarios que no pertenecen al GDPR en un flujo de consentimiento de CMP (DMA).
6.13.0 
Obsoleto
08-02-2024
  • Se agregó soporte para la nueva política de consentimiento de la UE de Google. 
6.12.3 04-01-2024
  • Se ha agregado un nuevo parámetro original_link al callback de Deep Linking dentro del flujo de resolución del Proveedor de Servicios de Correo electrónico (ESP).
  • Se han eliminado todas las referencias a iAd Framework.
6.12.2 24-08-2023 Mantenimiento del SDK
6.12.1 20-07-2023
  • Se corrigió un problema en SKAdNetwork 4.0 que provocaba que el valor de conversión aproximado se reportara como "None"
  • Se corrigió un bloqueo en la implementación de tvOS
6.12.0 28-06-2023 Se eliminó el soporte de código de bits del SDK
6.11.2 13-06-2023 validateAndLogInAppPurchaseSe solucionó un problema introducido en v6.11.0, al realizar la llamada (la antigua API para validación y registro de compras) no registra el evento de compra. 

Importante: Si estas usando v6.11.0 o v6.11.1, y la API validateAndLogInAppPurchase, actualiza a esta versión.
6.11.1 24-05-2023 Mantenimiento del SDK
6.11.0 25-04-2023
  • Un nuevo nombre de dominio de AppsFlyer en la URL utilizada por el SDK para enviar solicitudes a los servidores de AppsFlyer.
  • Se modificó el comportamiento de la API setHost cuando se envían valores vacíos o nulos. Aprender más
6.10.1 02-04-2023 Se agregó el parámetro link para el payload UDL de escenarios de Direct Deep Linkinig
6.10.0 15-02-2023 Soporte de SKAdNetwork 4.0. Saber más sobre la solución SKAdNetwork de AppsFlyer
6.9.2 31-01-2023 Se actualizó la estructura interna de las solicitudes para obtener datos de conversión (GCD). Nota: Los datos de respuesta siguen siendo los mismos.
6.9.1 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.
6.9.0 06-11-2022

Se actualizó la API interna para la generación de reportes de ingresos por publicidad. A partir de esta versión, solo se admite el Conector genérico de ingresos por publicidad.

Esta versión del SDK es compatible con AdRevenue Connector V6.9.0.

6.8.1 09-08-2022 Detección de reinstalaciones: Se mejoró la capacidad de detectar y reportar reinstalaciones de la aplicación utilizando el almacenamiento en el dispositivo. Esta capacidad se puede controlar en el dashboard de AppsFlyer desde la página Configuración de aplicaciones.
6.8.0
Desuso:
03-03-2025
19-07-2022 Para la detección de reinstalaciones, utiliza el SDK V6.8.1+
6.7.0
Desuso:
03-03-2025
19-06-2022

Actualiza la implementación del SKAdNetwork para usar la API de Apple actualizada updatePostbackConversionValue, introducido en iOS 15.4.

Esto no tiene ningún efecto sobre los datos enviados desde SKAdNetwork y no requiere ningún cambio en el código de la aplicación.

6.6.1
Desuso:
03-03-2025
16-05-2022 Mantenimiento del SDK
6.6.0
Desuso:
03-03-2025
01-05-2022 Se agregaron más parámetros a los UDL callback didResolveDeepLink para el flujo de deep linking directos (usuarios existentes). Saber más.
6.5.4
Desuso:
03-03-2025
23-03-2022 Mantenimiento del SDK
6.5.3
Desuso:
03-03-2025
02-03-2022 Corrección de errores: Se solucionó un problema con una doble llamada a didResolveDeepLink en enlaces basados ​​en el esquema URI.
6.5.2
Desuso:
03-03-2025
26-01-2022 Mantenimiento del SDK
6.5.1
Desuso:
03-03-2025
03-01-2022 Mantenimiento del SDK
6.5.0
Desuso:
03-03-2025
22-12-2021 Refactorización y cambios internos.
6.4.4
Desuso:
03-03-2025
12-12-2021 Mantenimiento del SDK
6.4.3
Desuso:
03-03-2025
30-11-2021 Corrección de estabilidad para MacOS 10.14.6 con xcframework.
6.4.2
Desuso:
03-03-2025
28-10-2021 Mantenimiento del SDK
6.4.1
Desuso:
03-03-2025
24-10-2021 Se resolvió la estabilidad en las aplicaciones de Unity.
6.4.0
Desuso:
03-03-2025
12-09-2021

API agregada: setSharingFilterForPartnerste permite configurar qué partners el SDK debe excluir del intercambio de datos.

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

6.3.5
Desuso: 31-08-2024
19-08-2021

API agregada: setCurrentDeviceLanguage

A partir de esta versión el idioma ya no es recopilado automáticamente por el SDK.

6.3.4
Desuso: 31-08-2024
21-07-2021
  • Corrección de errores: Se solucionó el problema con la ejecución del SDK en simuladores XCode 12.5
  • Correcciones y actualizaciones menores.
6.3.2
Desuso: 31-08-2024
2021-06-17 Registros de depuración mejorados.
6.3.1
Desuso: 31-08-2024
02-06-2021 Mantenimiento del SDK
6.3.0
Desuso: 31-08-2024
13-05-2021
  • Soporte de Apple Silicon: Se agregó soporte para ejecutar el SDK en un simulador usando máquinas Mac con el chipset M1
  • A partir de esta versión, el SDK es compatible con iOS 9+. iOS 8 ya no es compatible.
  • iOS Strict Mode SDK: Se agregó soporte para el administrador de dependencias de Carthage.
  • Actualización técnica de la API de OneLink
6.2.6
Desuso: 31-08-2024
25-04-2021
  • Corrección de errores: Las reglas de SKAdNetwork no se cargaban cuando se iniciaba el SDK después de didFinishLaunchingWithOptions
  • Corrección de errores: waitForATTUserAuthorization caso extremo que provoca que el evento de apertura se envíe sin el IDFA, incluso si se otorga el consentimiento del usuario
  • Permitir que el SDK se ejecute en dispositivos iOS 8
  • Limpieza y eliminación de código y datos no utilizados
6.2.5
Desuso: 31-08-2024
06-04-2021

Refactorización, limpieza, eliminación de datos no utilizados del SDK.

A partir de esta versión:

  • El método setShouldCollectDeviceName ya no está disponible y no devolverá el nombre del dispositivo.
  • El parámetro wifi enviado desde el SDK está configurado en False
6.2.4
Desuso: 31-08-2024
15-03-2023

Corrección de errores relacionados con el modo de medición de ingresos de SKAdNetwork y los eventos in-app que contienen el parámetro AF_REVENUE.

A partir de esta versión, en el caso de la medición de ingresos: cualquier evento que contenga AF_REVENUE afecta el valor de conversión. Antes de este cambio, el valor de conversión se establecía sólo si estaba en el framework del evento AF_PURCHASE.  

Nota: Si implementas la medición de ingresos de SKAdNetwork, debes actualizar a esta versión.

6.2.3
Desuso: 31-08-2024
07-03-2021

Corrección de errores relacionados con la llamada al SKAdNetwork updateConversionValue.

 

6.2.2
Desuso: 31-08-2024
18-02-2021 Mantenimiento del SDK
6.2.1
Desuso: 31-08-2024
15-02-2021 Soporte para reportes de eventos por S2S
6.2.0
Desuso: 31-08-2024
07-02-2021 API agregada: setPartnerData
6.1.4
Desuso: 31-08-2024
12-01-2021 Mantenimiento del SDK
6.1.3
Desuso: 31-08-2024
24-12-2020
6.1.2
Desuso: 31-08-2024
03-12-2020 Mantenimiento del SDK
6.1.1
Desuso: 31-08-2024
17-11-2020 Presentando Strict mode SDK
6.1.0
Desuso: 31-08-2024
09-11-2020 Soporte para Unified deep linking API
6.0.8
Desuso: 31-08-2024
28-10-2020 Soporte para la atribución Apple App Clips
6.0.7
Desuso: 31-08-2024
21-10-2020 Mantenimiento del SDK
6.0.6
Desuso: 31-08-2024
20-10-2020 Mantenimiento del SDK
6.0.5
Desuso: 31-08-2024
08-10-2020 Mantenimiento del SDK
6.0.4
Desuso: 31-08-2024
30-09-2020 Soporte para múltiples redireccionamientos desde ESPs
6.0.3
Desuso: 31-08-2024
06-09-2020
  • Cambio de nombre de API:
    waitForAdvertisingIdentifier --> waitForATTUserAuthorization
  • El SDK recopila el IDFA de forma predeterminada para iOS 14 (y versiones anteriores de iOS)
6.0.2 [obsoleto] 27-08-2020
  • Cambio de nombre de API:
    deviceLoggingDisabled --> anonymizeUser
  • Se requiere el diálogo AppTrackingTransparency (ATT) para recopilar el IDFA para iOS 14
  • Se agregó soporte para la atribución de promoción cruzada del IDFV

6.0.1 beta

[en desuso]

06-08-2020
  • Se agregó soporte para la atribución de SKAdNetwork, para ayudar a los anunciantes a medir el éxito de la campaña mientras se mantiene la privacidad del usuario

6.0.0 beta

[en desuso]

04-08-2020
  • Capacidades de depuración extendidas
  • Cambios importantes en la funcionalidad del SDK y la API. Saber más

Notas de la versión de iOS V6.0.0

Métodos agregados, eliminados o renombrados

Métodos agregados

Los siguientes métodos se agregaron al SDK:

  • waitForAdvertisingIdentifier

Métodos eliminados

Los siguientes métodos se han eliminado del SDK:

  • disableAppleAdSupportTracking

Se cambió el nombre de los métodos

Nombre de la API (antes de V6) Nombre de la API actual (V6 y posteriores)
AppsFlyerTracker AppsFlyerLib
disableIAdTracking disableCollectASA
trackAppLaunchWithCompletionHandler startWithCompletionHandler
trackLocation logLocationEvent
trackAppLaunch start
trackEvent logEvent
disableAppleAdSupportTracking disableAdvertiserIdentifier
validateAndTrackInAppPurchase validateAndLogInAppPurchase
isStopTracking isStopped
deviceTrackingDisabled deviceLoggingDisabled
sharedTracker (Objective C) shared

Soporte para App Tracking Transparency (ATT)

El SDK de iOS es compatible con la recopilación del IDFA en iOS 14+ a través del marco de Transparencia de seguimiento de aplicaciones. Para más detalles:

Versiones obsoletas

SDK de iOS V5

Versión Fecha de lanzamiento Notas
5.4.4 23-08-2020 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
5.4.1 30-06-2020
  • Permite que los anunciantes controlen el intercambio de datos con partners/redes integrados. Saber más
  • Método onAppOpenAttribution mejorado para URLs largas de Universal Links: Los parámetros del enlace se devuelven ya analizados
  • Corrección de errores y mantenimiento
5.4.0 03-06-2020 Soporte de proyectos MAC Catalyst
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
  • Las aplicaciones principales y las extensiones de aplicaciones obtienen el mismo ID de AppsFlyer, por lo que los eventos in-app se agrupan de manera similar
  • Corrección de errores y mantenimiento
5.2.0 10-03-2020 
  • Capacidades extendidas de registro y depuración
  • Corrección de errores y mantenimiento
5.1.0 23-12-2019
  • Obj-C mejorado: interoperabilidad Swift
  • Corrección de errores y mantenimiento
5.0.0 12-11-2019
  • Corrección de errores y mantenimiento
  • Cambios importantes en la funcionalidad del SDK y la API. Saber más

Notas de la versión de iOS 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 de iOS 4.0.0

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

Versión Fecha de lanzamiento Notas
4.11.2 07-11-2019 Corrección de errores y mantenimiento
4.11.1 31-10-2019 Corrección de errores y mantenimiento
4.11.0 17-10-2019
  • Se eliminó el soporte para iOS 7. iOS 8 es la versión mínima soportada ahora.
  • Registro mejorado para mejores capacidades de depuración, resolución de ESP y Branded Links, así como para onInstallConversionData y onAppOpenAttribution.
  • Mejora de la búsqueda de Apple Search Ads.
4.10.4 12-09-2019
  • Se necesita una actualización para la recuperación del token push de iOS 13 para la medición de desinstalaciones
  • Corrección de errores y mantenimiento
4.10.3 16-07-2019 Corrección de errores y mantenimiento
4.10.2 07-02-2019 Corrección de errores y mantenimiento
4.10.1 01-07-2019 Corrección de errores y mantenimiento
4.10.0 14-05-2019
  • API trackAppLaunchWithCompletionHandler para manejar el éxito o el fracaso del inicio de la aplicación de seguimiento
  • API completionHandler para manejar el éxito o el fracaso del registro de eventos in-app
  • Corrección de errores y mantenimiento
4.9.0 18-03-2019
  • API setResolveDeepLinkURLs para resolver OneLinks encapsulados con otro Universal Link
  • Se eliminó el uso de UIPasteboard para la atribución de Anuncios de Meta para iOS 7 y versiones inferiores
  • Corrección de errores y mantenimiento
4.8.12 13-02-2019
  • Capacidades mejoradas de calificación cero para proveedores de teléfonos móviles
  • Capacidades mejoradas de calificación cero para proveedores de teléfonos móviles
  • Corrección de errores y mantenimiento
4.8.11 09-01-2019
  • Se corrigió el error de la API waitForCustomerUserId() que afectaba generateLink
4.8.10 31-10-2018
  • Se corrigió una condición de carrera cuando se invocaba continueUserActivity después de applicationDidBecomeActive que provocaba que no se llamara a onAppOpenAttribution
  • validateAndTrackInAppPurchase ignora la corrección de parámetros adicionales
  • Corrección de errores y mantenimiento
4.8.9 27-08-2018
  • Nuevos eventos del SDK: Suscribirse, Iniciar Prueba, Clic en Anuncio, Ver Anuncio
  • Corrección de errores y mantenimiento
4.8.8 30-07-2018
  • Se corrigió un problema cuando al usar is_first_launch a través de JSONSerialiser se devolvía como un entero en lugar de booleano
  • Corrección de errores y mantenimiento 4.8.7
4.8.7 22-07-2018 Corrección de errores y mantenimiento
4.8.6 18-06-2018 Corrección de errores y mantenimiento
4.8.5 29-05-2018 Corrección de errores y mantenimiento
4.8.4 05-03-2018 Corrección de errores y mantenimiento
4.8.3 25-01-2018
  • Corrección de errores y mantenimiento
  • API shouldCollectDeviceName
  • Parámetro de evento af_content
  • API shouldCollectDeviceName
  • Parámetro de evento af_content