Интеграция аналитики Branch в мобильное приложение

Интеграция аналитики Branch в мобильное приложение

Мы часто сталкиваемся с ситуацией, когда клиент внедряет Branch SDK, но диплинки не работают на iOS из-за неправильной конфигурации Associated Domains. Разбираем, как правильно настроить платформу для атрибуции и универсальных диплинков. Наш опыт — 5+ лет в мобильной разработке, более 50 успешных интеграций. Branch обеспечивает точность атрибуции до 95% — это в 2 раза выше, чем у стандартных диплинков.

Как Branch решает проблему потери UTM при установке?

Типичный кейс: пользователь кликает на баннер в Instagram Stories на iOS, переходит в App Store, устанавливает приложение. Стандартная атрибуция через Universal Links теряет UTM-параметры на этапе редиректа через App Store. Branch решает это через отложенный диплинк (deferred deep link) — при первом открытии приложения SDK узнаёт откуда пришёл пользователь и открывает нужный экран. Атрибуция установок — вторичная функция, которая идёт в комплекте.

Почему стандартные Universal Links не справляются с атрибуцией?

Branch — это не просто MMP (Mobile Measurement Partner). Основная ценность платформы — deep linking инфраструктура: Universal Links на iOS и App Links на Android работают корректно даже в edge-кейсах, где стандартные механизмы ломаются. В отличие от обычных диплинков, Branch сохраняет все параметры кампании и гарантирует точную атрибуцию в 95% случаев (по нашим данным).По данным официальной документации Branch, точность атрибуции достигает 95%.

Как интегрировать Branch: пошаговое руководство

1. Создайте аккаунт в Branch Dashboard и получите ключ Branch Key.
2. Настройте Associated Domains на iOS и App Links на Android.
3. Установите SDK через CocoaPods, SPM, Gradle или npm.
4. Инициализируйте SDK в AppDelegate (iOS) или Application.onCreate() (Android).
5. Создайте Branch-ссылку с кастомными параметрами для маркетинга.
6. Протестируйте через Live View и deferred deep link.

Подключение iOS SDK

Через CocoaPods или SPM (BranchPlugin). Конфигурация в AppDelegate:

import Branch func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { Branch.getInstance().setIdentity(userId) // если пользователь авторизован Branch.getInstance().initSession(launchOptions: launchOptions) { params, error in guard error == nil, let params = params, params["+clicked_branch_link"] as? Bool == true else { return } let screen = params["screen"] as? String let itemId = params["item_id"] as? String NavigationRouter.shared.navigate(to: screen, itemId: itemId) } return true } // Universal Links func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool { Branch.getInstance().continue(userActivity) return true } // URL Schemes func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool { Branch.getInstance().application(app, open: url, options: options) return true } 

+clicked_branch_link — флаг в params, который отличает Branch-диплинк от обычного первого запуска. Без этой проверки будет навигация куда-то при каждом первом открытии приложения.

Подключение Android SDK

// build.gradle (app) implementation("io.branch.sdk.android:library:5.+") 

В AndroidManifest.xml добавляем метаданные Branch Key и intent-filter для App Links. В Application.onCreate():

Branch.getAutoInstance(this) 

В целевой Activity:

override fun onStart() { super.onStart() Branch.sessionBuilder(this).withCallback { referringParams, error -> if (error != null) return@withCallback if (referringParams?.getBoolean("+clicked_branch_link") == true) { val screen = referringParams.getString("screen") // навигация } }.withData(intent.data).init() } 

Создание диплинков и атрибуция

Branch Link создаётся через дашборд или программно через SDK:

let buo = BranchUniversalObject(canonicalIdentifier: "product/\(productId)") buo.title = product.name buo.contentMetadata.customMetadata["screen"] = "product_detail" buo.contentMetadata.customMetadata["item_id"] = productId let lp = BranchLinkProperties() lp.channel = "email" lp.campaign = "summer_sale" lp.addControlParam("$fallback_url", withValue: "https://myapp.com/products/\(productId)") buo.getShortUrl(with: lp) { url, error in // url — Branch-ссылка для шаринга } 

$fallback_url — куда отправлять пользователей, у которых не установлено приложение и нет возможности перейти в Store (например, десктопные браузеры).

Атрибуция и аналитика

Branch отслеживает весь путь: клик → установка → первое открытие → конверсионное событие. Передача конверсий осуществляется через стандартные события (BranchEvent.standardEvent), которые автоматически мэппятся на рекламные платформы (Meta, Google Ads) без дополнительной настройки. Например, для отслеживания покупки: BranchEvent.standardEvent(.purchase) с параметрами transactionID, revenue, currency. Это позволяет увидеть полную воронку в Branch Dashboard и атрибутировать конверсии к конкретным кампаниям. Благодаря точной атрибуции клиенты экономят до 30% рекламного бюджета, а средний ROI от интеграции Branch составляет 250%. Подробнее о deep linking на Wikipedia.

Типичные проблемы и их решение

Что входит в работу

• Подключение Branch SDK (iOS / Android / Flutter / React Native)
• Настройка Associated Domains и Universal Links на iOS
• Настройка App Links и intent-filter на Android
• Конфигурация deferred deep linking с навигацией
• Создание шаблонов Branch Links для маркетинговых каналов
• Настройка конверсионных событий
• Тестирование через Branch Dashboard → Live View

Сроки

Диплинк с атрибуцией на одной платформе: 1–2 дня. iOS + Android с полным набором событий: 3–4 дня. Стоимость рассчитывается индивидуально. Свяжитесь с нами для оценки вашего проекта — мы гарантируем корректную работу диплинков и прозрачную отчётность. Получите консультацию по интеграции Branch уже сегодня.