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

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

SDK Android V6  

Руководство по интеграции Android SDK для разработчиков

Версия Дата выпуска Примечания
6.15.2 10.10.2024
  • Улучшение стабильности и исправления
  • Внутренние обновления, связанные с Attribution API Privacy Sandbox
6.15.1 28.08.2024 Обновление версий:
  • targetSDKVersion: v34
  • Gradle: v8.7
  • Java: v17
6.15.0 31.07.2024
  • Добавлен метод logAdRevenue отправки данных о доходах от рекламы в AppsFlyer. Примечание: Начиная с этой версии, AdRevenue Connector больше не должен использоваться. Он должен быть заменен на методlogAdRevenue. Узнать больше
6.14.2 10.06.2024
  • Исправлена проблема с получением Meta Install Referrer в приложениях, созданных с помощью Unity.
6.14.1 29.05.2024 Обслуживание SDK
6.14.0 18.04.2024
  • Добавлена поддержка обновленного процесса валидации покупки. В настоящее время эта функция находится в стадии закрытого бета-тестирования. Узнать больше
  • Обновлена интеграция с Huawei Referrer. Подробнее.
6.13.1 03.04.2024 Обслуживание SDK
6.13.0 08.02.2024
  • Добавлена поддержка новой политики Google для согласия пользователей из ЕС (DMA)
6.12.6 29.01.2024 Обслуживание SDK
6.12.5 18.12.2023
  • Добавлен параметр original_link в обратный вызов диплинкинга в потоке разрешения ESP.
6.12.4 25.10.2023
  • Dexguard обновлен до версии 9.4.16 для повышения стабильности работы SDK.
6.12.3 31.08.2023 Обслуживание SDK
6.12.2 02.08.2023
  • Исправлена ошибка, которая могла привести к аварийному завершению работы приложения на некоторых устройствах под управлением Android 8.1.0 и Android 11.
6.12.1 29.06.2023
  • Исправлена проблема, из-за которой запуск Play Store задерживался при перекрестной рекламе.
  • Исправлена ошибка, приводившая к аварийному завершению работы приложения на некоторых устройствах.
6.12.0 28.06.2023
  • Версия устарела, используйте версию 6.12.1.
6.11.2 29.06.2023
  • Исправлена ошибка, приводившая к аварийному завершению работы приложения на некоторых устройствах.
6.11.1 06.06.2023
  • Версия устарела, используйте версию 6.12.1.
  • Исправлена ошибка, при которой приложение иногда аварийно завершало работу после инициализации SDK.
6.11.0 16.05.2023
  • Исправлена проблема, которая иногда приводила к зависанию приложения на некоторых устройствах, когда SDK пытался получить Google Play Referrer.
6.10.3 25.04.2023 Обслуживание SDK
6.10.1 01.03.2023
  • Исправлена проблема, из-за которой приложения на устройствах Samsung иногда закрывались при инициализации SDK. Эта проблема затрагивала приложения с SDK V6.6.0 и выше.
6.10.0 13.02.2023
  • Новый домен AppsFlyer для связи между SDK и серверами AppsFlyer.
  • Изменен API setHost при отправке пустых или нулевых значений (null). Узнать больше
6.9.4 06.12.2022
  • Исправлена проблема, при которой отправка события дохода от рекламы из коннектора SDK дохода от рекламы вызывала вызов слушателя конверсии.
  • Исправлена проблема, которая иногда приводила к зависанию приложений при отправке события дохода от рекламы из коннектора SDK дохода от рекламы.
6.9.3 28.11.2022
  • Обновлена внутренняя структура запроса на получение данных о конверсиях (GCD). Примечание: Данные ответа не изменяются.
  • Исправлена проблема, при которой SDK вызывал запрос GCD, когда в приложении для ConversionListener было установлено значение null.
6.9.2 02.10.2022
  • Исправлена проблема, связанная с задержкой запроса на проверку покупки с помощью API validateAndLogInAppPurchase.
6.9.1 19.09.2022 Обслуживание SDK
6.9.0 12.09.2022
  • Добавлена поддержка Xiaomi GetApps Store Referrer.
  • Обновлен внутренний API для отчетности о доходах от рекламы. Начиная с этой версии, поддерживается только общий коннектор SDK дохода от рекламы.
6.8.2 29.08.2022
  • Исправлена критическая проблема с механизмом кэширования SDK, появившаяся в V6.7.0, из-за которой кэшированные события отправлялись несколько раз.
6.8.1
(Устарело)
24.08.2022
  • Устарело. Используйте V6.8.2.
6.8.0
(Устарело)
18.07.2022
  • Устарело. Используйте V6.8.2.
  • Из SDK удален API enableLocationCollection. Приложение по-прежнему может сообщать данные о местоположении пользователя, передавая их SDK напрямую через logLocationAPI.
  • Добавлено com.google.android.gms.permission.AD_IDразрешение в SDKAndroidManifest.xml. Больше информации здесь.
  • Исправлена проблема, связанная с оптимизацией и обфускацией при использовании R8.
6.7.0
(Устарело)
19.06.2022
  • Устарело. Используйте V6.8.2.
  • Изменен способ обработки в SDK запросов к серверам AppsFlyer. После этого изменения запрос на отчет о первом открытии приложения (конверсии) будет приоритетным по сравнению с событиями в приложении и другими типами запросов. Подробнее об этом читайте здесь.
  • Новый API: setDisableNetworkDataдля отказа от сбора информации о сотовой сети (название оператора, название сети).
6.6.1 16.05.2022 Обслуживание SDK
6.6.0 01.05.2022
  • Добавлены дополнительные параметры в обратный вызов UDLonDeepLinking для потока прямого диплинкинга (существующие пользователи). Дополнительная информация.
6.5.4 23.03.2022 Обслуживание SDK
6.5.3 09.03.2022
  • Исправление: Исправлена проблема с созданием ссылок для приглашения пользователей, содержащих неанглийские символы.
6.5.2 26.01.2022
  • Исправлена проблема при разрешении URL для отложенного диплинкинга в UDL.
  • Обновлено до DexGuard 9.2
  • Реструктуризация и внутренние изменения.
6.5.1 29.12.2021
  • Разрешение диплинков с UDL для приложений, использующих опцию Out-of-Store with Channel (Внемагазинное с каналом).
6.5.0 07.12.2021
  • Реструктуризация и внутренние изменения.
6.4.3 14.11.2021
  • Исправлена ошибка, возникшая в V6.4.2 с LinkGenerator, из-за которой создавались ссылки с отсутствующими параметрами URL.
6.4.2 24.10.2021 Исправлено следующее:
  • Параметр pid дважды добавлялся к настраиваемым URL, сгенерированным LinkGenerator.
  • Дополнительный символ / был добавлен к значению af_dp при использовании LinkGenerator для создания пользовательских схем URI.
  • Собирались и IMEI, и AndroidID, если приложение инициировало сбор только одного из них.
6.4.1 17.10.2021 Решена ошибка компиляции при использовании Gradle версии ранее V3.5.4.
6.4.0 12.09.2021

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

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

6.3.2

Устареет: 31.08.2024

06.06.2021 Новый API: setDisableAdvertisingIdentifiers

6.3.1

Устареет: 31.08.2024

26.05.2021
  • Новый API: performOnDeepLinking
  • Добавлена возможность запускать API приглашения пользователя до вызова start/ после вызоваstop
  • Исправление: Исправлена проблема, при которой вызов waitForCustomerUserId не производился даже после вызова setCustomerUserId

6.3.0

Устареет: 31.08.2024

29.04.2021
  • Исправление: Неправильное обращение к onConversionDataFail при сбое запроса на отправку события в приложении
  • Исправление: сбор метрик от датчиков движения (для обнаружения мошенничества)
  • Исправление: Исправление UDL, связанное с обфускацией
  • Техническое обновление API OneLink
6.2.3
Устареет: 31.08.2024
04.03.2021 Обслуживание SDK
6.2.0
Устареет: 31.08.2024
07.02.2021
6.1.4
Устареет: 31.08.2024
12.01.2021
  • Добавлена поддержка DexGuard V9
6.1.3
Устареет: 31.08.2024
24.12.2020
6.1.1
Устареет: 31.08.2024
03.12.2020
  • Добавлена поддержка реферера Samsung Galaxy Store
  • Исправление мелких ошибок и улучшение производительности.
6.1.0
Устареет: 31.08.2024
09.11.2020
6.0.1
Устареет: 31.08.2024
28.10.2020 Обслуживание SDK
6.0.0
Устареет: 31.08.2024
14.10.2020
  • Существенные изменения в функциональности SDK и API, включая устаревание и изменение имен методов. Узнать больше

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

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

Методы удалены/устарели

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

  • sendDeepLinkData
  • trackAppLaunch
  • setPluginDeepLinkData
  • setConsumeAFDeepLinks
  • setHostName

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

Название API (до V6) Текущее название API (V6 и более поздние версии)
stopTracking stop
setCustomerIdAndTrack setCustomerIdAndLogSession
startTracking начать
trackLocation logLocation
reportTrackSession logSession
trackEvent logEvent
setDeviceTrackingDisabled anonymizeUser
validateAndTrackInAppPurchase validateAndLogInAppPurchase
isStopTracking isStopped
trackAndOpenStore logAndOpenStore
trackCrossPromoteImpression logCrossPromoteImpression
trackInvite logInvite

Переименованные интерфейсы

Название интерфейса (до V6) Текущее название интерфейса (V6 и более поздние версии)
AppsFlyerTrackingRequestListener AppsFlyerRequestListener

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

Примечания к выпуску SDK Android V5

Версия Дата выпуска Только обслуживание Примечания
5.4.6 09.11.2020  
  • Добавлена поддержка реферера Huawei AppGallery.
5.4.4 01.10.2020  
  • Добавлена поддержка SDK для обработки нескольких переадресаций от ESP
  • Исправление ошибок и техническое обслуживание
5.4.3 30.07.2020  
  • Расширенные возможности записей в журнале и отладки
  • Исправление ошибок и техническое обслуживание
  • Поддержка реферера установки Google V2
5.4.1 30.06.2020  
  • Возможность рекламодателям контролировать обмен данными с интегрированными партнерами/сетями. Узнать больше
  • Исправление ошибок и техническое обслуживание
5.4.0 03.06.2020  
  • Полная поддержка автоматического сбора OAID
  • Поддержка нескольких рефереров: SDK может собирать рефереры Huawei и Google
  • Улучшение производительности SDK
  • Исправление ошибок и техническое обслуживание
5.3.0 27.04.2020   
  • Доступ к последним данным о конверсиях по диплинкам в любое время с помощью метода onAppOpenAttribution
  • Дополнительные параметры, доступные для показов перекрестной рекламы
  • Исправление ошибок: исправлены проблемы с именами файлов a. и b. в Windows
  • Метод sendDeepLinkData для получения данных атрибуции, даже если пользователь перенаправлен по диплинку на определенную активность, устарел и заменен на метод startTracking()
5.2.0 10.03.2020   
  • Инициализация SDK в любой активности
  • Расширенные возможности безопасности, записей в журнале и отладки
  • Исправление ошибок и техническое обслуживание
5.1.2 19.02.2020 Да  
5.1.1 23.01.2020    Да  
5.1.0 06.01.2020      
  • Переход на Android 9 (уровень API 28) в соответствии с требованиями Google к целевому уровню API
  • Улучшения защиты от мошенничества — для клиентов Protect360
  • Дополнительный модуль для сбора OAID (актуально для внутреннего использования в Китае) — Xiaomi и Huawei (см. https://github.com/AppsFlyerSDK/appsflyer-oaid).
  • Улучшение стабильности при использовании setOneLinkCustomDomain для ESP
5.0.2 23.12.2019     
5.0.1 12.12.2019     
5.0.0 12.11.2019
  • Исправление ошибок и техническое обслуживание
  • Существенные изменения в функциональности SDK и API, включая устаревание и изменение имен методов. Узнать больше

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

Примечания к выпуску Android V4.0.0

Версия Дата выпуска Примечания
4.11.0 22.10.2019
  • Улучшено ведение журнала и возможности отладки для следующего:
    • ESP
    • Разрешение брендированных ссылок
    • onInstallConversionData и onAppOpenAttribution.
  • Исправление ошибок и техническое обслуживание
4.10.3 15.09.2019
  • Исправление ошибок и техническое обслуживание
  • Поддержка открытого идентификатора рекламодателя (OAID) 
4.10.2
4.10.1 01.07.2019 Исправление ошибок и техническое обслуживание
4.10.0 14.05.2019
  • Улучшения SDK для разработчиков, использующих ProGuard.
  • Исправление ошибок и техническое обслуживание
4.9.0 17.03.2019
  • API setResolveDeepLinkURLs для разрешения OneLinks, упакованных в другую универсальную ссылку
  • Исправление записи push-уведомления, когда отмененная запись push-уведомления предыдущей полезной нагрузки содержала тот же pid и все еще находилась в памяти.
  • Исправление опечатки с af_county на af_country
  • Исправление ошибок и техническое обслуживание
4.8.20 13.02.2019
  • Улучшенные возможности при нулевом рейтинге для провайдеров сотовой связи
  • Исправление ошибок и техническое обслуживание
4.8.19 26.12.2018
  • Исправлена проблема, при которой метод waitForCustomerUserId() нарушал generateLink
  • Исправление ошибок и техническое обслуживание
4.8.18 11.11.2018
  • Исправлены проблемы с диплинками для активности, выступающей как «трамплин»
  • Улучшена точность повторного вовлечения при переходе в приложении с заднего плана на передний
  • Исправление ошибок и техническое обслуживание
4.8.17 02.11.2018 Устранение проблемы, связанной с конфликтами в ProGuard, которые в некоторых случаях приводили к потере данных о запуске приложений. Эта проблема затрагивает только SDK версии 4.8.16
4.8.16 31.10.2018 Исправление ошибок и техническое обслуживание
4.8.15 27.08.2018
  • Новые события SDK: Подписка, Начало пробного периода, Клик по объявлению, Просмотр объявления
  • Исправление ошибок и техническое обслуживание
4.8.14 31.07.2018
  • Добавлены API setOutOfStore и getOutOfStore для динамической установки значения AF_STORE
  • Добавлены API onTrackingRequestFailure и onTrackingRequestSuccess для получения подтверждения того, что AppsFlyer успешно получил серверы запроса отслеживания.
4.8.13 20.06.2018
  • Исправлена ошибка в пограничном случае, когда IMEI отсутствовал при явной передаче через API setImeiData
  • Исправление ошибок и техническое обслуживание
4.8.12 27.05.2018
  • Исправлено аварийное завершение работы приложения при использовании теста JUnit, использующего Robolectric
  • Исправление ошибок и техническое обслуживание
4.8.11 02.05.2018 Исправление ошибок и техническое обслуживание
4.8.10 26.04.2018
  • Добавлен API setPreinstallAttribution
  • Исправление ошибок и техническое обслуживание
4.8.9 02.04.2018
  • Сбор IMEI только в том случае, если GooglePlayServices нет на устройстве, и невозможно получить GAID на этом устройстве
  • Исправление ошибок и техническое обслуживание
4.8.8 11.03.2018
  • Добавлен API для отсрочки инициализации SDK до тех пор, пока не будет предоставлен идентификатор пользователя customerUserID
  • Исправление ошибок и техническое обслуживание
4.8.7 25.01.2018
  • API isStopTracking для прекращения всех действий SDK
  • Параметр события af_content
4.8.5 29.11.2017
  • Поддержка нового API реферера Google
  • Новый метод init, который получает контекст
4.8.4 14.11.2017
  • В getConversionData добавлен флаг is_first_launch, который указывает, является ли это первым запуском приложения. Этот флаг позволяет разработчикам легко определить первый запуск приложения в ответе обратного вызова getConversionData, который возвращается при каждом запуске. Возможные значения для is_first_launch: true или false.
  • Исправление ошибок и техническое обслуживание
4.8.3 27.09.2017 Добавлена поддержка данных реферера HTTP в getConversionData
4.8.2 19.09.2017 Исправление в sendDeepLinkData(this) для приложений с диплинками на несколько активностей
4.8.1 17.09.2017 Улучшенная защита от событий внутри приложения, вызываемых до инициализации SDK
4.8.0 03.09.2017
  • API для приглашения пользователей
  • API для перекрестной рекламы
  • Настройка временного интервала между сеансами
  • Поддержка нулевого рейтинга для сотовых операторов
  • Дополнительный параметр события af_projected_revenue
  • Исправление ошибок и техническое обслуживание
  • Введен дополнительный метод инициализации — AppsFlyerLib.getInstance().init(AF_DEV_KEY,conversionDataListener);
4.7.4 28.06.2017 Улучшена обработка множественных отключений ScheduledExecutorSerice
4.7.3 06.06.2017 Усовершенствования для интеграции mParticle
4.7.2 22.05.2017
  • Исправлена незначительная проблема утечки памяти
  • Улучшена точность измерения удалений
  • Исправлено предупреждение ProGaurd, которое влияло на измерение удалений
  • Исправление ошибок и техническое обслуживание
4.7.1 22.02.2017 Исправлено предупреждение, вызываемое ProGuard
4.7.0 13.02.2017
  • Дополнительные параметры событий
  • Поддержка измерения удалений на основе Firebase
  • Исправление ошибок и техническое обслуживание