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

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

SDK для iOS V6 

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

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

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
(Устарело)

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 Обслуживание SDK

6.6.0

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

6.5.4

23.03.2022 Обслуживание SDK

6.5.3

02.03.2022

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

6.5.2

26.01.2022 Обслуживание SDK

6.5.1

03.01.2022 Обслуживание SDK

6.5.0

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

6.4.4

12.12.2021 Обслуживание SDK

6.4.3

30.11.2021

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

6.4.2

28.10.2021

Обслуживание SDK

6.4.1

24.10.2021

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

6.4.0

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, даже если пользователь дал на это согласие.
  • Разрешение запуска 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