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

Краткий обзор. Заметки о релизе SDK Android, начиная с версии V4.x.

SDK Android V6 

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

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

6.12.3

31.08.2023 Да  

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.

6.10.3

25.04.2023 Да  

6.10.1

01.03.2023  
  • Исправлена проблема, из-за которой приложения на устройствах Samsung иногда закрывались при инициализации SDK. Эта проблема затрагивала приложения с SDK V6.6.0 и выше.

6.10.0

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

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 Да  

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 напрямую через API logLocation.
  • Добавлено разрешение com.google.android.gms.permission.AD_ID в файл SDK AndroidManifest.xml. Больше информации здесь.
  • Исправлена проблема, связанная с оптимизацией и обфускацией при использовании R8.

6.7.0
(Устарело)

19.06.2022  
  • Устарело. Используйте V6.8.2.
  • Изменен способ обработки SDK запросов к серверам AppsFlyer. После этого изменения запрос на отчет о первом открытии приложения (конверсии) будет приоритетным по сравнению с событиями в приложении и другими типами запросов. Больше информации здесь.
  • Новый API: setDisableNetworkData для отказа от сбора информации о сотовой сети (название оператора).

6.6.1

16.05.2022 Да  

6.6.0

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

6.5.4

23.03.2022 Да  

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 06.06.2021  

Новый API: setDisableAdvertisingIdentifiers

6.3.1 26.05.2021  
  • Новый API: performOnDeepLinking
  • Добавлена возможность запуска API для приглашения пользователей до вызова start/после вызова stop
  • Исправление: исправлена проблема, при которой вызов waitForCustomerUserId не проводился даже после вызова setCustomerUserId
6.3.0 29.04.2021  
  • Исправление: неправильный вызов onConversionDataFail при сбое запроса отправки события в приложении
  • Исправление: сбор метрик от датчиков движения (для обнаружения мошенничества)
  • Исправление: исправление, связанное с обфускацией, в UDL
  • Техническое обновление API OneLink
6.2.3 04.03.2021 Да  
6.2.0 07.02.2021  
6.1.4 12.01.2021  
  • Добавлена поддержка DexGuard V9
6.1.3 24.12.2020  
6.1.1 03.12.2020  
  • Добавлена поддержка реферера Samsung Galaxy Store
  • Исправление мелких ошибок и улучшение производительности.
6.1.0 09.11.2020  
6.0.1 28.10.2020 Да

 

6.0.0 14.10.2020  
  • Существенные изменения в функциональности SDK и API, включая устаревание и изменение имен методов. Узнать больше

Примечания к релизу Android V6.0.0

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

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

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

  • sendDeepLinkData

  • trackAppLaunch

  • setPluginDeepLinkData

  • setConsumeAFDeepLinks

  • setHostName

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

Название API (до V6) Текущее название API (V6 и более поздние версии)

stopTracking

завершить

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 

Примечания к релизу 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

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

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

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

Версия Дата выпуска Примечания
5.0.2 23.12.2019    
5.0.1 12.12.2019   
5.0.0 12.11.2019
  • Исправление ошибок и техническое обслуживание
  • Существенные изменения в функциональности SDK и API, включая устаревание и изменение имен методов. Узнать больше
4.11.0 22.10.2019
  • Улучшено ведение журнала и возможности отладки для следующего:
    • Провайдер электронной почты
    • Разрешение брендированных ссылок
    • 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
  • Added setOutOfStore and getOutOfStore APIs for dynamically setting the AF_STORE value
  • Добавлены 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
  • Исправление ошибок и техническое обслуживание

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

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

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

Версия SDK Android Контрольные суммы
6.6.1 1ec98047f8cb4145137f3c97459d052c
6.6.0 6f5aef27ea407c7fc1691b52ff800c61
6.5.4 c71aacbf201449dd5ef1158b55bd2ad0
6.5.3 7db44f0852be1c94fe36cc535b7c61f7
6.5.2 71e3a16c4278f857cd86b7b05aedd066
6.5.1 261928cfc55b27a6c2ab19cf9081d705
6.5.0 2a6d500fd4939a8faa47bbbba97288b6
6.4.3 c62f9359d6b5497d54e248c526c5f547
6.4.2 dc385fb62eaf68aff2e7f9c1c0ed19ea
6.4.1 94945db2c0e81baab79535393f210f1b
6.4.0 d7910a35901d4299b54259f1c1bbe2d6
6.3.2 46bc92bb2eed1416de28ccccb3a28620
6.3.1 ca47af77ffbcd7525e82d0bdaaef5b91
6.3.0 f969bb5a62885e8084794d5334787275
6.2.3 bab1309f77acd1f0453372150c82694a
6.2.0 fc727698c7b8bfb1ca448726492931b4
6.1.4 983785b1c30a15e8fac029e370bb3b73
6.1.3 c0392a091659dc445a1014e14da6a31a
6.1.1 0a18fafb2826c90b3388b371a3cbdeec
6.1.0 e8d6df04ac2642b2d7b16efb57f315e9
6.0.1 9ebeb6f4f49476667c07d0e8eb1aa2e8
6.0.0 cff3d453ea94e67182f5b1b023aeb1c1

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

Версия SDK Android Контрольные суммы
5.4.6 4f1bdc33ac0d6dd3f9b75411c3c0a06c
5.4.4 13a04913cf61276238f54e5e2d73e88d
5.4.3 7b1caef46942c70edcd2e59cad69e439
5.4.1 e4eb21c0030f376857b53e2e30022fc8
5.4.0 8c0270f6c3e7e58b1db42be82cc341d8
5.3.0 d602dd28d9ee807855e5426d6a9b7ebf
5.2.0 64fe94447def6d99549d3274ce908f09
5.1.2 1a7dbb23aad32d697835f3ec29337ca9
5.1.1 dfea6a49e6ae57fc2c700f6dcd904bc1
5.1.0 89cc7e08a0430180e64f3cccf955768f
5.0.2 c113618ea379531cba6ce42bc4c79d72
5.0.1 db0502faa5b02102dd99ac6cec666d04
5.0.0 98f1f78ae5f63cb4f40ba838d3d1be22

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

Версия SDK Android Контрольные суммы
4.10.3 855186d68912810fa47897262a9ba0a0
4.10.2 13ed5716d5a8583eeee527f01bd2a69d
4.10.1 ab3e49bb4640990267466b7852cd3de7
4.10.0 b5fb55ee76cd6a742d9bd25b910745a1
4.9.0 afa49524ddceda28ca1648946489a6b0
4.8.20 2f59d0f8db09b92f8261475a1d0807d0
4.8.19 baf8fa419f38de52cef6091de32aca86
4.8.18 3a0641720811a25542449f1927daf13e
4.8.17 3a0641720811a25542449f1927daf13e
4.8.16 501be427b0c2a831e148649131ce3fc0
4.8.15 7b6759a006d72d3a7c78ec80160c3502
4.8.14 bc4facd80958d0600b4d000104e524d9
4.8.13 bc4facd80958d0600b4d000104e524d9
4.8.12 171569002d93fb8d49787b363192973f
4.8.11 4419af159a42e4ee7a218ef8615e2abb
4.8.10 468ad04e4a2088ba7af9c45d42f4ed6d
4.8.9 9a923bbbf3f6c7cc19b900e49644da2c
4.8.8 6dee4814986061a0723cc9f844796e2e
4.8.7 ca13997ccb781a5935e91983b7be81ea
4.8.6 da117a3e9e05df7dd28297df762cfbfa
4.8.5 f8ea07b8a60d664541686ba7064730f5
4.8.4 b10f185c1094cf283b11339810a47c87
4.8.3 7f94ec175b948c5009bfbfe2fb25b2b0
4.8.2 3e34b55e13cd3f8d387b1a33c20105eb
4.8.1 6c2930d2997a7b2b6ab7b3ecf0e3135b
4.8.1 468ad04e4a2088ba7af9c45d42f4ed6d
4.8.1 4419af159a42e4ee7a218ef8615e2abb latest
4.8.0 32d67577ce59b2072475e509579baece
4.7.4 7e649e6a1cf8999ca39b05402946b3d6
4.7.3 e30c020f8ee5dd3af274fa94ef414a38
4.7.2 945aaaca554aa8b2f96219f25eed9777
4.7.1 862c349025e4725d4e5044a190c60337
4.7.0 b060ad140ffd0c8f2b3febb26122d173