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

Краткий обзор: Ознакомьтесь с примечаниями к выпуску 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
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
6.13.2 26.03.2024
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 Добавлены дополнительные параметры в обратный вызов UDLdidResolveDeepLink для потока прямого диплинкинга (существующие пользователи). Дополнительная информация.
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
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
  

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

Ответ GCD до SDK V5 Ответ GCD, начиная с 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 возвращает одну и ту же структуру независимо от данных. Если параметр пустой, он включается в 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