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

Для:

маркетологов разработчиков

Последнее обновление: 17/09/2023 22:27

Краткий обзор. Заметки о релизе 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		Новый API: `setPartnerData`
6.1.4	12.01.2021		Добавлена поддержка DexGuard V9
6.1.3	24.12.2020		Новый API: `addPushNotificationDeepLinkPath` (поддерживает Movable Ink).
6.1.1	03.12.2020		Добавлена поддержка реферера Samsung Galaxy Store Исправление мелких ошибок и улучшение производительности.
6.1.0	09.11.2020		Добавлена поддержка API для унифицированного диплинкинга
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

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


   {
      "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",
  }


   {
      "adgroup": null,
      "campaign": "awesome_campaign",
      "media_source": "super_media_source",
      "adset_id": null,
      "campaign_id": 1234,
      "iscache": true,
      "install_time": "2019-11-11 15:00:59.828",
      "adgroup_id": null,
      "af_sub5": null,
      "click_time": "2019-11-11 15:00:35.102",
      "agency": null,
      "cost_cents_USD": "0",
      "advertising_id": "215d8172-c61e-4d0c-9eb2-aa4d0971ed8",
      "adset": null,
      "af_sub3": null,
      "af_siteid": null,
      "http_referrer": null,
      "orig_cost": "0.0",
      "af_sub4": null,
      "af_cpi": null,
      "af_sub1": "promo",
      "af_click_lookback": "7d",
      "af_sub2": null,
      "af_status": "Non-organic",
      "is_first_launch": "true",
      "retargeting_conversion_type": "none"
  }

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