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

Para:

Marketers Desarrolladores

Última actualización: 21 de marzo de 2024 14:50

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 Dev Hub.

SDK de iOS V6

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

Versión	Fecha de lanzamiento	Notas
6.13.1	2024-03-05	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)	2024-02-08	Se agregó soporte para la nueva política de consentimiento de la UE de Google.
6.12.3	2024-01-04	Se ha agregado un nuevo `original_link` parámetro 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 "Ninguno" 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	Se solucionó un problema introducido en v6.11.0, al realizar la llamada `validateAndLogInAppPurchase`(la API antigua para la validación y el 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 la carga UDL de escenarios de Direct Deep Linkinig
6.10.0	15-02-2023	Soporte para SKAdNetwork 4.0. Saber más sobre la solución SKAdNetwork de AppsFlyer
6.9.2	31-01-2023	Se actualizó la estructura de solicitud interna para Get Conversion Data (GCD). Nota: Los datos de respuesta siguen siendo los mismos.
6.9.1	28-11-2022	Se actualizó la estructura de solicitud interna para Get Conversion Data (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 de Configuración de Aplicaciones.
6.8.0 (Obsoleto)	19-07-2022	Para la detección de reinstalaciones, utiliza el SDK V6.8.1+
6.7.0	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	16-05-2022	Mantenimiento del SDK
6.6.0	01-05-2022	Se agregaron más parámetros al callback `didResolveDeepLink` de UDL para el flujo de Direct Deep Linking (usuarios existentes). Más información.
6.5.4	23-03-2022	Mantenimiento del SDK
6.5.3	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	26-01-2022	Mantenimiento del SDK
6.5.1	03-01-2022	Mantenimiento del SDK
6.5.0	22-12-2021	Refactorización y cambios internos.
6.4.4	12-12-2021	Mantenimiento del SDK
6.4.3	30-11-2021	Corrección de estabilidad para MacOS 10.14.6 con xcframework.
6.4.2	28-10-2021	Mantenimiento del SDK
6.4.1	24-10-2021	Se resolvió la estabilidad en las aplicaciones de Unity.
6.4.0	12-09-2021	API agregada:`setSharingFilterForPartners` te 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 `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 adicional: setPartnerData
6.1.4 Desuso: 31/08/2024	12-01-2021	Mantenimiento del SDK
6.1.3 Desuso: 31/08/2024	24-12-2020	API adicional: `addPushNotificationDeepLinkPath` (admite Movable Ink) Soporte paraApple AdServices Framework
6.1.2 Desuso: 31/08/2024	03-12-2020	Mantenimiento del SDK
6.1.1 Desuso: 31/08/2024	17-11-2020	Presentando el 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	Admite múltiples redirecciones 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)	Compartido

Soporte de la Transparencia de seguimiento de aplicaciones (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	2020-07-30	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/networks. Aprender 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 para el proyecto MAC Catalyst
5.3.0	27-04-2020	Acceso a los datos de conversión de direct deep linking más recientes 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	2020-03-10	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. Aprender 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 (cadena projectNumber)
setGCMProjectNumber (cadena projectNumber)
setGCMProjectNumber (contexto context, cadena projectNumber)
enableUninstallTracking (cadena senderId)
setAppUserId (cadena id)
setUserEmail (cadena email)
setCollectFingerPrint (boolean 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 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:


   {
      "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",
  }


   {
      "adgroup": null,
      "campaign": "awesome_campaign",
      "media_source": "super_media_source",
      "adset_id": null,
      "campaign_id": 1234,
      "iscache": true,
      "install_time": "2019-11-11 15:00:59.828",
      "adgroup_id": null,
      "af_sub5": null,
      "click_time": "2019-11-11 15:00:35.102",
      "agency": null,
      "cost_cents_USD": "0",
      "advertising_id": "215d8172-c61e-4d0c-9eb2-aa4d0971ed8",
      "adset": null,
      "af_sub3": null,
      "af_siteid": null,
      "http_referrer": null,
      "orig_cost": "0.0",
      "af_sub4": null,
      "af_cpi": null,
      "af_sub1": "promo",
      "af_click_lookback": "7d",
      "af_sub2": null,
      "af_status": "Non-organic",
      "is_first_launch": true,
      "retargeting_conversion_type": "none"
  }

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 enlace universal 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 telefonía celular Capacidades mejoradas de calificación cero para proveedores de telefonía celular 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

Consulta también

Guía de inicio rápido de iOS 14, ATT y SKAdNetwork