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

Краткий обзор. Примечания о выпуске SDK для iOS версии 4+.

Материалы по теме: Начало работы с iOS 14, ATT и SKAdNetwork

SDK для iOS V6 

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

Версия Дата выпуска Только обслуживание  Примечания

6.12.2

24.08.2023 Да  

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 для проверки и регистрации покупки) не регистрирует событие покупки.

Важно: если вы используете версию 6.11.0или 6.11.1 и API validateAndLogInAppPurchase, перейдите на эту версию.

6.11.1

24.05.2023 Да

 

6.11.0

25.04.2023  
  • Новое доменное имя AppsFlyer в URL-адресе, используемое SDK для отправки запросов на серверы AppsFlyer.

  • Изменено поведение API setHost при отправке пустых или нулевых значений. Узнать больше

6.10.1

02.04.2023  

В полезную нагрузку 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
(Устарело)

19.07.2022   Для обнаружения повторных установок используйте SDK версии 6.8.1+

6.7.0

19.06.2022  

Обновите реализацию SKAdNetwork и используйте обновленный API Apple updatePostbackConversionValue, представленный в iOS 15.4.

Это не влияет на данные, переданные из SKAdNetwork, и не требует изменения кода приложения.

6.6.1

16.05.2022 Да  

6.6.0

01.05.2022   Добавлено больше параметров в обратный вызов UDL didResolveDeepLink для потока прямого диплинкинга (существующие пользователи). Подробнее.

6.5.4

23.03.2022 Да  

6.5.3

2.03.2022  

Исправление: исправлена проблема с двойным запуском didResolveDeepLink по ссылкам на основании схемы URI.

6.5.2

26.01.2022 Да  

6.5.1

03.01.2022 Да  

6.5.0

22.12.2021   Реструктуризация и внутренние изменения.

6.4.4

12.12.2021 Да  

6.4.3

30.11.2021  

Повышение стабильности для MacOS 10.14.6 посредством xcframework.

6.4.2

28.10.2021 Да

 

6.4.1

24.10.2021  

Решена проблема стабильности в приложениях Unity.

6.4.0

12.09.2021  

Дополнительный API: setSharingFilterForPartners позволяет настроить, каких партнеров SDK должен исключить из предоставления данных.

Начиная с этой версии, setSharingFilter и setSharingFilterForAllPartners устарели.

6.3.5

19.08.2021  

Дополнительный API: setCurrentDeviceLanguage

Начиная с этой версии, SDK больше не собирает данные о языке автоматически.

6.3.4

21.07.2021  
  • Исправление: исправлена проблема с запуском SDK на симуляторах XCode 12.5.
  • Незначительные исправления и обновления.

6.3.2

2021-06-17   Улучшены журналы отладки.

6.3.1

2021-06-02 Да Повышенная стабильность в плагине Unity.

6.3.0

13.05.2021  
  • Поддержка Apple Silicon: дополнительная поддержка для запуска SDK на симуляторе, использующем машины Mac с чипсетом M1
  • Начиная с этой версии, SDK поддерживает iOS 9+. iOS 8 больше не поддерживается.
  • Строгий режим для iOS Strict Mode SDK: дополнительная поддержка для менеджера зависимостей Carthage
  • Техническое обновление для API OneLink

6.2.6

25.04.2021  
  • Исправление: правила SKAdNetwork не загружались при инициализации SDK после didFinishLaunchingWithOptions
  • Исправление: пограничный случай waitForATTUserAuthorization, вызывающий событие запуска для передачи без IDFA, даже если пользователем дано согласие на сбор данных.
  • Разрешение запуска SDK на устройствах iOS 8
  • Очистка и удаление неиспользуемого кода и данных

6.2.5

06.04.2021  

Реструктуризация, очистка, удаление неиспользуемых данных из SDK.

Начиная с этой версии:

  • Метод setShouldCollectDeviceName устарел и не возвращает имя устройства
  • Для параметра wifi, переданного из SDK, устанавливается значение False

6.2.4

15.03.2021  

Исправление, связанное с режимом измерения дохода SKAdNetwork и внутренними событиями приложения, которые содержат параметр AF_REVENUE

Начиная с этой версии, в случае измерения дохода: любое событие, содержащее AF_REVENUE, влияет на значение конверсии. До этого изменения значение конверсии было установлено, только если оно возникало в рамках события AF_PURCHASE

Примечание. Если вы внедряете измерение дохода SKAdNetwork, необходимо перейти на эту версию.

6.2.3

07.03.2021  

Исправление, связанное с вызовом функции updateConversionValue SKAdNetwork.

 

6.2.2

18.02.2021 Да

 

6.2.1

15.02.2021  

Поддержка передачи отчетов о событиях S2S

6.2.0

07.02.2021  

Дополнительный API: setPartnerData

6.1.4

12.01.2021 Да

 

6.1.3

24.12.2020  

6.1.2

03.12.2020 Да

 

6.1.1

17.11.2020  

Внедрение строгого режима SDK

6.1.0

09.11.2020  

Поддержка API для унифицированного диплинкинга

6.0.8

28.10.2020  

Поддержка атрибуции Apple App Clips

6.0.7

21.10.2020 Да  

6.0.6

20.10.2020 Да

 

6.0.5

08.10.2020 Да

 

6.0.4

30.09.2020  

Поддержка нескольких переадресаций от ESP

6.0.3

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 beta

[устарело]

06.08.2020  
  • Добавлена поддержка атрибуции SKAdNetwork, которая помогает рекламодателям измерять эффективность кампаний при соблюдении конфиденциальности данных пользователей

6.0.0 beta

[устарело]

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

начать

trackEvent

logEvent

disableAppleAdSupportTracking

disableAdvertiserIdentifier

validateAndTrackInAppPurchase

validateAndLogInAppPurchase

isStopTracking

isStopped

deviceTrackingDisabled

deviceLoggingDisabled

sharedTracker (Objective C) Общий

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

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

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

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

Версия Дата выпуска Примечания

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
  • Исправление ошибок и техническое обслуживание

Примечания о выпуске 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, независимо от того, включены или нет определенные параметры. Подробнее о данных о конверсиях в различных сценариях см. здесь.

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

Материал по теме: Применяемая AppsFlyer политика управления версиями
Версия Дата выпуска Примечания
5.0.0 12.11.2019
  • Исправление ошибок и техническое обслуживание
  • Значительные изменения функциональности SDK и API. Узнать больше
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 18.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
  • Исправлена ошибка, связанная с повреждением generateLink в API waitForCustomerUserId()
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
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

Контрольные суммы SDK для iOS

AppsFlyer использует контрольные суммы md5:

Контрольные суммы V6

Версия SDK для iOS Static Lib Static Framework
6.6.1 ff41a3dfeb9fe7579f8f706f3c62bbbc 7acf1f10de7602b363a70d4a710b050d
6.6.0 ba2d2d0b64f3b0f6476b818c1b8faf5f 544c7c7e4af29afa4100b6c43affcf8f
6.5.4 5a1146a95abc84b20940b43cacc8b42a 3a0a22a28b4082a5b2f0931104b0a9c8
6.5.3 b33008f83f5eafa864902db97c003c06 3ff6754c8c238dd13e4c6251ffb4aedf
6.5.2 3083df065d14553fb1b4e34f3f7fb381 3ce0ea75e4fe3cf6313fde27d57d20ed
6.5.1 8d91f52cc2df073d1bca9919b44aeeeb c9353bdfa71ff9b4acc9097eee83d35e
6.5.0 4b72dcf125430d3d374967df5e084c6a 5d6ac0e9f7a1430e106685da117a7716
6.4.4 86586acda674d95f5661a613dccea3dd 7f4c431de13b84fd0926132c2154f0a8
6.4.3 dd5fcf42065ba2ad28f6311153fd4752 178274e63a6aa604682a3095ddf59ac5
6.4.2 2341911e4f34d17560b85409b86528c4 46df5badc29ee983a872d7859cedd59a
6.4.1 4ef6e6d424bc9b95a1ee8ebda0d5c639 0efc4140b47cbaf65b24a9087c61c434
6.4.0 9210f7064a7692c8dff7a779043e97fc f103763da687fef88db60ca6b395dc41
6.3.5 b61193ab28a601ec0dfaf4aa641a7834 9fbbf0f4cb865c95d919396d2af9a053
6.3.4 9cca998fde11c473e60bee3854f0c0da c47a02177c28290ed8c934a6428dc0dc
6.3.2 c563e2b8ee4bf6647e496d1b0ad31285 5c474247d3ce607fca43af9c9faf1fbc
6.3.1 e04a567680676b3784079d35ca32b5fe 36b808db3952803c929188ca57fe88c6
6.3.0 baa5e6d82a363e636740d6c5494e107d f2ebe86a93a2fd5122ad11224f17736c
6.2.6 9b989e131fe596b51223b6f47efac3c6 6396371abf0f66f0e6aeccd8303eeb0a
6.2.5 5b23262cb4b15230e262005b648aff0d 85ec7457b36de4402ce2c4b591fa87ab
6.2.4 f61648cd99d94c05d50a6e3213329779 3b20d45695f5e196e78d3db6c2bd738d
6.2.3 51eaa0654ec83db7da31511092312f00 d540bdc543a06ff5ccd40f90b2078557
6.2.2 9e5ceb08a3121f42b3315da87c698af3
08917804e4fe48bcb797f391d5a111f6
6.2.1 cbfe915e31bc06bb28227cb33ed22304
abfa9d9dc81fd90b0ca65de973fb1ab8
6.2.0 652ee1362af8c93119335a337deba1a5
91bb64493b344b010ebc277c849e9234
6.1.4 7e2e74d3cc186807d73c1fcf57f8b117 6c9b4ed760c9c1139681f61e6a508c8e
6.1.3 749e6c3de91afdfcddec91d290c46807 ab5884cb0c1ea00c3b3fe9a1d26a4511
6.1.2 940da06a6f8f7e3931a2a80f4e8defc9 4d39c9e6d46c49b5bde2c5ff19781957
6.1.1 7d259bd1cc5e5d2c3fea4909953375ba 09a273cf0300656ed995405e41eced58
6.1.0 e95e509d48e7b87e0213c7f12ea253e4 2c87f3a79c9318a4ed49ad8c377b007f
6.0.8 d903e6c145492488e126e46b3a233444
3237e91d12ee0871ceb0f6a0829dd43b
6.0.7 2d83f856d8d34c4f2e0e4e8561ddee05 bbb742ded1e49eae0622deb40c3becc3
6.0.6 1dd3bfc9919db8ccb7c0de8cf6505d47 5d5e5fe1624123f8316c6bdc020aa47b
6.0.5 e8afac7ef0bc7e38432bf5187fcbde7d 41966239e783ce0bbba852471a439caa
6.0.4 a88278fdb8c2f504ecb4406b8fbc1fe4 a7bba01c6484baf721f5be51242c492b
6.0.3 9f0cfed3c889ba3e334857c6d81e26be
13b07e2da8316759a8f84efb2476e854
6.0.2   13936cb4e05221e134ae1539971b9317
6.0.1 beta   6167276b56ac3b1fbdad2a4858b17bf3

Контрольные суммы V5

Версия SDK для iOS Static Lib Static Framework
5.4.4 47d90cbc4ed48dd1c5d6f42a8d419e8b
93716e13258fce87c81c0fc604bfd6fd
5.4.3 e5691c3ae1f20726168b4eb221937d98
dbfa30607f44fa2819191c7a8d7a3fe4
5.4.1 61564250f26ab0693255e002873d1674
fc86776f0ffcdf65cc49f33f7d943258
5.4.0 fa835b3577f389a12ef635eea0b000bb
0bd6a7b4441dc8f397831533e719a833
5.3.0 e787da7334e6c68e0098fd53ebea285e
2f160176b1c011f9aca558543cd63190
5.2.0 057c18bb7485e1c06f2b452d80ee5b22
736b50840b8c08093401f3bba2c4389b
5.1.0 f39819c11b06f98ff24e39cbd0f0f6ce 39889a253dafcfb2d53151523c1c1d80
5.0.0 5ac9e35af65fbfcaf81c1f63a36542b9 1727be9fa19906f0c1e1907b4b160086

Контрольные суммы V4

Версия SDK для iOS Static Lib Static Framework
4.11.2 f5415c2014402a03b8ca2c9901ddf12d 3fcf5afd6a20f353f7f88f1fbb4d4410
4.11.1 716394142df4d8e7a98e2c11cfe92ed1 e6521d8216d3aa8d681ac74e279dab34
4.11.0 e7238410372dfa7ca65e5839a31b1c2e
c6d3283bf69adb75aa9ed6c43195a3d6
4.10.0 4d5c01129b80d7ad182e32cf3b47faa4 da926eeb09d61f68f2076a9b31c30d7a
4.9.0 d283ace3237479d1aabc2a81271ea5ba bad6d9b8c627d7450e7acc8165b05618
4.8.9 e9640a7f95257a89c3e99215df79f1df fb0975064d2b93cedb71ce248cf3afb9
4.8.4 b7748ea6b86afbc295e17bac3d5bdda6 4cd7a95f49cfb79ecd9a0ce0c73750a3
4.8.3 51d38c4b77f39c75c5fc5734165fedc2 23096a32726a9def3e215a761bf7ad30
4.8.2 0908336d4e9bcf4de1d5f4f2e37ad0cb a386cfadd76fd783e6a10d0cd8fcb685
4.8.1   3b8a7d70b96bd7c5718feafeb31296b9
4.8.0 bb1358226bd3ca70d70f4717b62ca38b 3d81144bb653e91cb624778c87641051
4.7.9 e9183f23954a3f42a9fa6ae3eeebb6df 03905309048e26e9be7ee02895532d11
4.7.8 5595fa7dfc4c13b4a955638ba1da062e 61c30629f3dcb5ae48da10a458e80d28
4.7.7 3a8d0be3b304de5e81c967ab8a465de3 b8dd0ee60c75aa30884f56569068f32e
4.7.6 6cc80a31cf9daae5709a22258f434c6d 3d4607b13b6f138264db703e36f5452e
4.7.3 73db4e0173fcfdb758644b08fdbbd7bf 06572392afe0ae28a814601642963469
4.7.2 14a79e4ecffad264bc62b307d2db23a7 0aae1d0ace09e5b092f9906747119cfd
4.7.11 27e228c921f560205c0ad2c7962e83b2 d94cdab5734a88598cfcc078573e5b21
4.7.10 5cb1275b488369fee4713d21812186a0  
4.7.1 b121dfdf8d0dc53d031481114eba0c18 74ac06d17f167a0e22c361e06f4a2554
4.7.0 c3c0a453caa9971492ef8acd8bee04ae cadeab0479c4a723173943d77d253051