Примечания к выпуску SDK AppsFlyer для iOS

Для:

маркетологов разработчиков

Последнее обновление: 27/04/2025 20:46

Краткий обзор: Ознакомьтесь с примечаниями к выпуску SDK, чтобы получить краткий обзор последних изменений в iOS SDK. Разработчикам, которым нужны более подробные сведения, следует ознакомиться с примечаниями к выпуску iOS в разделе для разработчиков.

SDK для iOS версии 6

Интеграция SDK для iOS для разработчиков

Версия	Дата выпуска	Примечания
6.17.0	23.04.2025	Улучшение стабильности и производительности
6.16.1	18.02.2025	Обновлен API для отправки вручную данных о DMA-согласии в AppsFlyer.
6.16.0	19.01.2025	Добавлена поддержка API StoreKit 2 от Apple для отчётности по подпискам и покупкам в приложении через коннектор покупок. В настоящее время эта функция находится в закрытом бета-тестировании.
6.15.3	23.09.2024	Обслуживание SDK
6.15.2	28.08.2024	Исправлена проблема с передачей событий в Purchase Connector (коннекторе SDK для покупок). Это исправление не затрагивает рабочие версии Purchase Connector и касается его обновленной версии 6.15.x.
6.15.1	19.08.2024	Исправлена проблема с функцией Reinstall Detection (обнаружение повторных установок), возникавшая при установке на устройство двух или более приложений одного поставщика.
6.15.0	06.08.2024	Добавлен `logAdRevenue` API для отправки данных о доходах от рекламы в AppsFlyer. Примечание: Начиная с этой версии, больше не следует использовать AdRevenue Connector; его необходимо заменить данным `logAdRevenue` методом. См. подробные инструкции. Внесены внутренние обновления, связанные с Purchase Connector. Приложения, использующие Purchase Connector и обновленные до этой версии SDK, также должны обновить свой Purchase Connector до версии 6.15.0.
6.14.6	24.07.2024	Исправлена ошибка, из-за которой SDK выполнял избыточные вызовы `getConversionData` API (GCD) при запуске нового сеанса; это не влияет на измерение.
6.14.5	03.07.2024	Исправлена ошибка, из-за которой SDK отправлял данные согласия вручную, установленные приложением, даже если код для отправки согласия вручную был удален.
6.14.4	10.06.2024	Обновленный манифест конфиденциальности для строгого режима SDK.
6.14.3	26.04.2024	Исправлено автоматическое объединение манифеста конфиденциальности для приложений, использующих Cocoapods.
6.14.2	19.04.2024	Обслуживание SDK
6.14.1	18.04.2024	Добавлена поддержка обновленного процесса проверки покупки. В настоящее время эта функция находится в закрытом бета-тестировании. Узнать больше
6.14.0	07.04.2024	Добавлена поддержка манифеста конфиденциальности. Узнайте больше о манифесте конфиденциальности в AppsFlyer. В SDK добавлена подпись xcFramework, позволяющая разработчикам, использующим Xcode 15, проверять происхождение и подлинность SDK.
6.13.2	26.03.2024	Исправлена ошибка, из-за которой не удавалось выпускать приложения, использующие SPM в Xcode 15.3. Дополнительные сведения см. в примечаниях к выпуску для разработчиков.
6.13.1	05.03.2024	Исправлена проблема с отправкой данных о согласии для пользователей, не подпадающих под действие GDPR, в потоке согласия CMP (DMA).
6.13.0 Устарело	08.02.2024	Добавлена поддержка новой политики Google для согласия пользователей из ЕС (DMA)
6.12.3	04.01.2024	Новый параметр `original_link` добавлен в обратный вызов диплинкинга в потоке разрешения поставщика услуг электронной почты (ESP). Все ссылки на iAd Framework удалены.
6.12.2	24.08.2023	Обслуживание SDK
6.12.1	20.07.2023	В SKAdNetwork 4.0 исправлена ошибка, из-за которой приблизительное значение конверсии отображалось как «None» (Отсутствует). Исправлена ошибка в реализации tvOS
6.12.0	28.06.2023	Удалена поддержка биткода из SDK.
6.11.2	13.06.2023	Исправлена проблема, появившаяся в версии 6.11.0, когда при вызове `validateAndLogInAppPurchase` (устаревший API для проверки и регистрации покупок) событие покупки не регистрировалось. Важно: Если вы используете `v6.11.0` или `v6.11.1`, а также API `validateAndLogInAppPurchase`, перейдите на эту версию.
6.11.1	24.05.2023	Обслуживание SDK
6.11.0	25.04.2023	Новое доменное имя AppsFlyer в URL-адресе, используемое SDK для отправки запросов на серверы AppsFlyer. Изменено поведение API setHost при отправке пустых или нулевых значений. Узнать больше
6.10.1	02.04.2023	Добавлен параметр `link` в информационное наполнение UDL для сценариев прямого диплинкинга.
6.10.0	15.02.2023	Поддержка SKAdNetwork 4.0. Подробнее о решении AppsFlyer SKAdNetwork
6.9.2	31.01.2023	Обновлена внутренняя структура запроса на получение данных о конверсиях (GCD). Примечание: Данные ответа не изменяются.
6.9.1	28.11.2022	Обновлена внутренняя структура запроса на получение данных о конверсиях (GCD). Примечание: Данные ответа не изменяются.
6.9.0	06.11.2022	Обновлен внутренний API для отчетности о доходах от рекламы. Начиная с этой версии, поддерживается только общий коннектор SDK дохода от рекламы. Эта версия SDK совместима с коннектором дохода от рекламы `V6.9.0`.
6.8.1	09.08.2022	Обнаружение повторных установок: усовершенствованная функция обнаружения и подачи отчетов о повторных установках приложения с помощью хранилища на устройстве. Этой функцией можно управлять на дэшборде AppsFlyer со страницы настройки приложений.
6.8.0 Дата прекращения поддержки: 03.03.2025	19.07.2022	Для обнаружения повторных установок используйте SDK версии 6.8.1+
6.7.0 Дата прекращения поддержки: 03.03.2025	19.06.2022	Обновите реализацию SKAdNetwork и используйте обновленный API Apple `updatePostbackConversionValue`, представленный в iOS 15.4. Это не влияет на данные, переданные из SKAdNetwork, и не требует изменения кода приложения.
6.6.1 Дата прекращения поддержки: 03.03.2025	16.05.2022	Обслуживание SDK
6.6.0 Дата прекращения поддержки: 03.03.2025	01.05.2022	Добавлены дополнительные параметры в обратный вызов UDL`didResolveDeepLink` для потока прямого диплинкинга (существующие пользователи). Дополнительная информация.
6.5.4 Дата прекращения поддержки: 03.03.2025	23.03.2022	Обслуживание SDK
6.5.3 Дата прекращения поддержки: 03.03.2025	02.03.2022	Исправление: исправлена проблема с двойным запуском `didResolveDeepLink` по ссылкам на основе схемы URI.
6.5.2 Дата прекращения поддержки: 03.03.2025	26.01.2022	Обслуживание SDK
6.5.1 Дата прекращения поддержки: 03.03.2025	03.01.2022	Обслуживание SDK
6.5.0 Дата прекращения поддержки: 03.03.2025	22.12.2021	Реструктуризация и внутренние изменения.
6.4.4 Дата прекращения поддержки: 03.03.2025	12.12.2021	Обслуживание SDK
6.4.3 Дата прекращения поддержки: 03.03.2025	30.11.2021	Повышение стабильности для MacOS 10.14.6 посредством xcframework.
6.4.2 Дата прекращения поддержки: 03.03.2025	28.10.2021	Обслуживание SDK
6.4.1 Дата прекращения поддержки: 03.03.2025	24.10.2021	Решена проблема стабильности в приложениях Unity.
6.4.0 Дата прекращения поддержки: 03.03.2025	12.09.2021	Новый API: `setSharingFilterForPartners` позволяет настроить, каких партнеров SDK должен исключить из предоставления данных. Начиная с данной версии, `setSharingFilter` и `setSharingFilterForAllPartners` являются устаревшими.
6.3.5 Дата прекращения поддержки: 31.08.2024	19.08.2021	Добавлен API: `setCurrentDeviceLanguage` Начиная с этой версии, SDK больше не собирает данные о языке автоматически.
6.3.4 Дата прекращения поддержки: 31.08.2024	21.07.2021	Исправление: Исправлена проблема с запуском SDK на симуляторах XCode 12.5 Незначительные исправления и обновления.
6.3.2 Дата прекращения поддержки: 31.08.2024	17.06.2021	Улучшены журналы отладки.
6.3.1 Дата прекращения поддержки: 31.08.2024	02.06.2021	Обслуживание SDK
6.3.0 Дата прекращения поддержки: 31.08.2024	13.05.2021	Поддержка Apple Silicon: Добавлена поддержка запуска SDK на симуляторе, использующем машины Mac с чипсетом M1 Начиная с этой версии, SDK поддерживает iOS `9`+. iOS `8` больше не поддерживается. Строгий режим SDK iOS Добавлена поддержка менеджера зависимостей Carthage Техническое обновление для API OneLink
6.2.6 Дата прекращения поддержки: 31.08.2024	25.04.2021	Исправлены ошибки: Правила SKAdNetwork не загружались, когда инициализация SDK происходила после `didFinishLaunchingWithOptions` Исправление: `waitForATTUserAuthorization`, в результате которого событие запуска отправлялось без IDFA, даже если пользователь дал на это согласие.waitForATTUserAuthorization Разрешение запуска SDK на устройствах iOS 8 Очистка и удаление неиспользуемого кода и данных
6.2.5 Дата прекращения поддержки: 31.08.2024	06.04.2021	Реструктуризация, очистка, удаление неиспользуемых данных из SDK. Начиная с этой версии: Метод `setShouldCollectDeviceName` устарел и не возвращает имя устройства. Параметр `wifi`, отправленный из SDK, имеет значение `False`
6.2.4 Дата прекращения поддержки: 31.08.2024	15.03.2021	Исправление, связанное с режимом измерения дохода SKAdNetwork и событиями в приложении, содержащими параметр `AF_REVENUE`. Начиная с этой версии, при измерении дохода: любое событие, содержащее `AF_REVENUE`, влияет на значение конверсии. До этого изменения значение конверсии устанавливалось только в том случае, если оно находилось в рамках события `AF_PURCHASE`. Примечание: Если вы используете измерение доходов SKAdNetwork, вы должны перейти на эту версию.
6.2.3 Дата прекращения поддержки: 31.08.2024	07.03.2021	Исправление, связанное с вызовом `updateConversionValue` в SKAdNetwork.
6.2.2 Дата прекращения поддержки: 31.08.2024	18.02.2021	Обслуживание SDK
6.2.1 Дата прекращения поддержки: 31.08.2024	15.02.2021	Поддержка передачи отчетов о событиях S2S
6.2.0 Дата прекращения поддержки: 31.08.2024	07.02.2021	Дополнительный API: setPartnerData
6.1.4 Дата прекращения поддержки: 31.08.2024	12.01.2021	Обслуживание SDK
6.1.3 Дата прекращения поддержки: 31.08.2024	24.12.2020	Дополнительный API: `addPushNotificationDeepLinkPath` (поддерживает Movable Ink) Поддержка Apple AdServices Framework
6.1.2 Дата прекращения поддержки: 31.08.2024	03.12.2020	Обслуживание SDK
6.1.1 Дата прекращения поддержки: 31.08.2024	17.11.2020	Внедрение строгого режима SDK
6.1.0 Дата прекращения поддержки: 31.08.2024	09.11.2020	Поддержка API для унифицированного диплинкинга
6.0.8 Дата прекращения поддержки: 31.08.2024	28.10.2020	Поддержка атрибуции Apple App Clips
6.0.7 Дата прекращения поддержки: 31.08.2024	21.10.2020	Обслуживание SDK
6.0.6 Дата прекращения поддержки: 31.08.2024	20.10.2020	Обслуживание SDK
6.0.5 Дата прекращения поддержки: 31.08.2024	08.10.2020	Обслуживание SDK
6.0.4 Дата прекращения поддержки: 31.08.2024	30.09.2020	Поддержка нескольких переадресаций от ESP
6.0.3 Дата прекращения поддержки: 31.08.2024	06.09.2020	Изменение названия API: waitForAdvertisingIdentifier --> waitForATTUserAuthorization SDK по умолчанию собирает IDFA для iOS 14 (как для более ранних версий iOS)
6.0.2 [устарело]	27.08.2020	Изменение названия API: deviceLoggingDisabled --> anonymizeUser Для сбора IDFA для iOS 14 требуется диалоговое окно AppTrackingTransparency (ATT) Дополнительная поддержка атрибуции кампаний перекрестной рекламы по IDFV
6.0.1 бета [устарело]	06.08.2020	Добавлена поддержка атрибуции SKAdNetwork, которая помогает рекламодателям измерять эффективность кампаний при соблюдении конфиденциальности данных пользователей.
6.0.0 бета [устарело]	04.08.2020	Расширенные функции отладки Значительные изменения в функциональности SDK и API. Подробнее

Примечания о выпуске iOS V6.0.0

Добавленные, удаленные или переименованные методы

Добавленные методы

В SDK добавлены следующие методы:

waitForAdvertisingIdentifier

Методы удалены

Следующие методы были удалены из SDK:

disableAppleAdSupportTracking

Методы переименованы

Название API (до V6)	Текущее название API (V6 и более поздние версии)
AppsFlyerTracker	AppsFlyerLib
disableIAdTracking	disableCollectASA
trackAppLaunchWithCompletionHandler	startWithCompletionHandler
trackLocation	logLocationEvent
trackAppLaunch	start
trackEvent	logEvent
disableAppleAdSupportTracking	disableAdvertiserIdentifier
validateAndTrackInAppPurchase	validateAndLogInAppPurchase
isStopTracking	isStopped
deviceTrackingDisabled	deviceLoggingDisabled
sharedTracker (Objective C)	shared

Поддержка App Tracking Transparency (ATT)

SDK для iOS поддерживает сбор IDFA на iOS 14+ посредством фреймворка App Tracking Transparency. Подробные сведения:

Устаревшие версии

SDK для iOS V5

Версия	Дата выпуска	Примечания
5.4.4	23.08.2020	Исправление ошибок и техническое обслуживание
5.4.3	30.07.2020	Расширенные возможности записей в журнале и отладки Исправление ошибок и техническое обслуживание
5.4.1	30.06.2020	Возможность контроля рекламодателями обмена данными с интегрированными партнерами/сетями. Подробнее Метод onAppOpenAttribution улучшен для длинных URL универсальных ссылок: Параметры ссылки возвращаются уже проанализированными Исправление ошибок и техническое обслуживание
5.4.0	03.06.2020	Поддержка проекта MAC Catalyst
5.3.0	27.04.2020	Доступ к последним данным о конверсиях по прямым диплинкам в любое время с помощью метода onAppOpenAttribution. Дополнительные параметры, доступные для показов перекрестной рекламы Основные приложения и расширения получают одинаковый идентификатор AppsFlyer, поэтому внутренние события приложения группируются аналогичным образом Исправление ошибок и техническое обслуживание
5.2.0	10.03.2020	Расширенные возможности записей в журнале и отладки Исправление ошибок и техническое обслуживание
5.1.0	23.12.2019	Усовершенствованное взаимодействие между Obj-C и Swift Исправление ошибок и техническое обслуживание
5.0.0	12.11.2019	Исправление ошибок и техническое обслуживание Значительные изменения функциональности SDK и API. Подробнее

Примечания о выпуске iOS V5.0.0

Улучшено время отклика SDK

Начиная с SDK V5.0.0 улучшено время отклика GCD для органических установок.

Методы удалены или переименованы

Изменение названия метода

Названия методов получения данных об установках теперь одинаковы для Android и iOS. Это влияет на методы, которые обрабатывают:

Данные о конверсии при установке
Ошибки, если данные недоступны

Название для Android до SDK V5	Название для iOS до SDK V5	Стандартизированное название
`onInstallConversionDataLoaded`	`onConversionDataReceived`	`onConversionDataSuccess`
`onInstallConversionFailure`	`onConversionDataRequestFailure`	`onConversionDataFail`

Методы удалены

Следующие методы устарели в предыдущих версиях SDK. Теперь они удалены из SDK.

Android

setGCMProjectID (строка projectNumber)
setGCMProjectNumber (строка projectNumber)
setGCMProjectNumber (контекст context, строка projectNumber)
enableUninstallTracking (строка senderId)
setAppUserId (строка id)
setUserEmail (строка email)
setCollectFingerPrint (логическое значение isCollect)
getAttributionId (разрешение контента contentResolver)
Класс FirebaseInstanceIdListener (экземпляр FirebaseInstanceIdService)

iOS

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

Изменения в формате получения данных о конверсиях

В этой версии для каждой установки или открытия приложения SDK возвращает объект сопоставления, содержащий данные о конверсии (GCD), такие как медиа-источник и название кампании. В предыдущих версиях SDK GCD возвращал только те параметры, которые имели какое-либо значение

Начиная с этой версии, возвращаются все параметры, включая те, которые не имеют значения. Параметры без фактического значения имеют значение null.

Пример

Установка происходит после клика по следующему URL-адресу:

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

Ответы следующие:

   {
      "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 возвращает одну и ту же структуру независимо от данных. Если параметр пустой, он включается в GCD с нулевым значением (null). Это облегчает разработчикам обработку GCD без необходимости корректировать логику обработки GCD, независимо от того, включены или нет определенные параметры. Подробнее о данных о конверсиях в различных сценариях см. здесь.

Примечания к выпуску iOS 4.0.0

Материалы по теме: Применяемая в AppsFlyer политика управления версиями SDK

Версия	Дата выпуска	Примечания
4.11.2	07.11.2019	Исправление ошибок и техническое обслуживание
4.11.1	31.10.2019	Исправление ошибок и техническое обслуживание
4.11.0	17.10.2019	Прекращена поддержка iOS 7. iOS 8 теперь является минимальной поддерживаемой версией. Усовершенствованная регистрация для улучшения функций отладки, разрешение ESP и брендированных ссылок, а также onInstallConversionData и onAppOpenAttribution. Усовершенствованы функции получения Apple Search Ads.
4.10.4	12.09.2019	Обновление для получения токена push-уведомлений для iOS 13 для измерения удалений Исправление ошибок и техническое обслуживание
4.10.3	16.07.2019	Исправление ошибок и техническое обслуживание
4.10.2	02.07.2019	Исправление ошибок и техническое обслуживание
4.10.1	01.07.2019	Исправление ошибок и техническое обслуживание
4.10.0	14.05.2019	API trackAppLaunchWithCompletionHandler для обработки успешного или неудачного отслеживания запусков приложения API completionHandler для обработки успешной или неудачной записи внутренних событий приложения Исправление ошибок и техническое обслуживание
4.9.0	18.03.2019	API setResolveDeepLinkURLs для разрешения OneLinks, упакованных в другую универсальную ссылку Удалено использование UIPasteboard для атрибуции Meta ads для iOS 7 и ранее Исправление ошибок и техническое обслуживание
4.8.12	13.02.2019	Улучшенные возможности при нулевом рейтинге для провайдеров сотовой связи Улучшенные возможности при нулевом рейтинге для провайдеров сотовой связи Исправление ошибок и техническое обслуживание
4.8.11	09.01.2019	Исправлена ошибка, когда API waitForCustomerUserId() нарушал generateLink
4.8.10	31.10.2018	Исправлена ошибка с состоянием конкурентного доступа к данным, когда continueUserActivity запускался после applicationDidBecomeActive, в результате чего не вызывался onAppOpenAttribution Исправлена ошибка, когда validateAndTrackInAppPurchase игнорирует дополнительные параметры Исправление ошибок и техническое обслуживание
4.8.9	27.08.2018	Новые события SDK: Подписка, Начало пробного периода, Клик по объявлению, Просмотр объявления Исправление ошибок и техническое обслуживание
4.8.8	30.07.2018	Исправлена ошибка, когда JSONSerialiser возвращал is_first_launch в виде целого числа, а не логического значения Исправление ошибок и техническое обслуживание
4.8.7	22.07.2018	Исправление ошибок и техническое обслуживание
4.8.6	18.06.2018	Исправление ошибок и техническое обслуживание
4.8.5	29.05.2018	Исправление ошибок и техническое обслуживание
4.8.4	03.05.2018	Исправление ошибок и техническое обслуживание
4.8.3	25.01.2018	Исправление ошибок и техническое обслуживание API shouldCollectDeviceName Параметр события af_content API shouldCollectDeviceName Параметр события af_content

См. также

Начало работы с iOS 14, ATT и SKAdNetwork