Adjust - AppWillapps/KnowledgeBase GitHub Wiki

ВАЖНО ⚠️ Перед началом интеграций SDK Adjust в проекте обязательно нужно полностью
снести SDK Applovin и все ее следы. В противном случае - могут быть ошибки!

  1. Добавьте SDK Adjust в ваш Unity проект. Настройте инициализацию Adjust SDK

⚠️ Для версий плагина выше SDK v5 следующий шаг выполнять не нужно. Библиотека SDK Signature по умолчанию включена в SDK v5.

  1. Скачайте последнюю версию плагина Signature V3 в ваш Unity проект.

Для Android:
Скачайте файл формата .aar (adjust-android-signature-X.XX.X.aar)
Разместите файл по следующему пути: Assets/Adjust/Android
Для iOS: Скачайте файл формата .a (AdjustSigSdk-iOS-Static-X.XX.X.a.zip)
Разместите файл по следующему пути: Assets/Adjust/iOS
Если у вас есть какие-то вопросы по поводу плагина, можно посмотреть подробную инструкцию.

  1. Для Android добавьте следующие API:

Для iOS добавьте следующие фреймворки:

  • AdServices.framework – для отслеживания поисковой рекламы Apple.
  • AdSupport.framework – для считывания идентификатора устройства.
  • AppTrackingTransparency.framework – для запроса согласия пользователя на отслеживание.
  • StoreKit.framework – для взаимодействия с платформой SKAdNetwork.
  1. Настройте окно AppTrackingTransparency (Только для iOS)

4.1 - Интеграция ATT
4.2 - Настройка ATT
⚠️ Начиная с iOS 14.5 приложение обязано показывать ATT запрос. После запроса, нужно подождать ответа пользователя, далее можно инициализировать Adjust SDK.
Так, если пользователь нажмет "Разрешить", Adjust SDK получит IDFA на установке.
Если пользователь нажмет "Попросить приложение не отслеживать", SDK также сможет отслеживать активность пользователя, но без IDFA.

  1. Настройте трекинг событий после установки в SDK

⚠️ Adjust SDK автоматически отслеживает события установки (первое открытие) и сессии (открытие приложения), поэтому не рекомендуется создавать дубликаты этих событий.
Для событий покупки передавайте либо валовый, либо чистый доход, но убедитесь, что вы передаете его неизменно по всем продуктам / приложениям для отчетности.

  1. Настройте трекинг удалений и переустановок

Adjust поддерживает отслеживание удалений только для Android.
Отслеживание удаления на устройствах iOS15+ может быть ненадежным из-за ограничений со стороны Apple.

  1. Настройте передачу рекламного ревенью в Firebase. Для этого можно использовать следующий код
  2. Отправка рекламного дохода в Adjust
  3. Если в проекте используется кастомный файл Proguard - модифицируйте файл Proguard согласно инструкции Adjust
  4. Протестируйте интеграцию SDK. Подробно процесс тестирования описан в данной документации. Используйте консоль для тестов Adjust
  5. Протестируйте корректно ли работает подпись Signature V3
  6. Подключите Purchase Verification в SDK
    ⚠️ОБНОВЛЕНО ДЛЯ V5: Используйте методы верификации покупок для App Store и Google Play.
  7. Во избежание дубликации платежей добавьте setTransactionId в код
  8. Добавьте бекграунд трекинг в код
  9. Если в вашем проекте используется AppMetrica для аналитики то нужно прокидывать In-App Revenue и Ad Revenue согласно данной инструкции

✅ Поздравляем! Adjust интегрирован :)

Adjust + Applovin

  1. Интегрируйте Adjust SDK по инструкции выше.
  2. Настройте AppLovin SDK-To-SDK трекинг рекламного дохода
  3. Также вам понадобится интегрировать Firebase SDK-To-SDK

✅ Поздравляем! Интеграция Applovin завершена :)

Adjust + IronSource

  1. Интегрируйте Adjust SDK по инструкции выше.
  2. Интегрируйте IronSource SDK в ваш Unity проект.
  3. Интегрируйте передачу рекламного ревенью из IronSource в Appmetrica

✅ Поздравляем! Интеграция IronSource завершена :)

Пример реализации:

image_2024-09-11_16-52-33

Проверка валидации:

photo_2024-09-14_10-25-25

Бывает, что пурчи трекаются в аджаст, но по статусам валидации нули. Это говорит, о том, что валидация не работает и аджаст трекает все подряд.

photo_2024-09-14_10-27-17