OneLink: co to jest, technologia deep linkingu i atrybucja instalacji

Czym jest OneLink?

OneLink to technologia tworzenia inteligentnych deep linków od AppsFlyer, która umożliwia przesyłanie parametrów atrybucji przez link i przypisywanie działań użytkownika do konkretnego źródła reklamowego. Rozwiązuje kluczowy problem marketingu mobilnego: połączenie między kliknięciem w reklamę a instalacją aplikacji.

Zwykły deep link otwiera aplikację i może przekazać podstawowe parametry, ale traci informacje o źródle ruchu przy przejściu przez sklep z aplikacjami. OneLink używa kombinacji parametrów URL, identyfikatora urządzenia i technologii fingerprintingu do odtworzenia atrybucji po instalacji. Pozwala to marketerom zobaczyć, która kampania, kreacja i kanał doprowadziły do konwersji — rejestracji, zakupu lub innego docelowego zdarzenia.

OneLink działa na wszystkich platformach: iOS (Universal Links), Android (App Links), przeglądarkach internetowych, a nawet w aplikacjach desktopowych. Linki są generowane przez panel zarządzania AppsFlyer lub programowo przez REST API, co umożliwia dynamiczne podstawianie parametrów dla każdej kampanii w czasie rzeczywistym.

Jak działa OneLink?

Zasada działania OneLink opiera się na trzech kolejnych etapach: przejście przez link, instalacja aplikacji i dopasowanie zdarzeń. Na każdym etapie OneLink zachowuje i przekazuje dane atrybucyjne, używając kombinacji metod do dokładnego określenia źródła ruchu.

Struktura linku OneLink

Link OneLink ma specjalny format, który obejmuje domenę AppsFlyer, identyfikator aplikacji i parametry kampanii. Standardowy szablon wygląda jak https://app.onelink.me/{app-id}?pid={source}&c={campaign}&af_dp={deeplink}. Parametr pid (media source) określa źródło ruchu, c — nazwę kampanii, af_dp — deep link wewnątrz aplikacji.

https://app.onelink.me/A1b2C3d4?pid=facebook&c=summer_campaign&af_dp=myapp://promo/summer2026&af_click_lookback=7d

Parametr af_dp określa deep link, do którego przejdzie użytkownik, jeśli aplikacja jest już zainstalowana. Dla nowych użytkowników uruchamiany jest mechanizm deferred deep linkingu: po instalacji i pierwszym uruchomieniu SDK określa zapisane parametry i kieruje użytkownika na odpowiedni ekran. Parametr af_click_lookback określa okno atrybucji — okres, w którym kliknięcie jest uznawane za prowadzące do instalacji.

Mechanizm atrybucji

Po przejściu przez link OneLink AppsFlyer rejestruje kliknięcie i wiąże je z unikalnym identyfikatorem kliknięcia. Gdy użytkownik instaluje i otwiera aplikację, SDK AppsFlyer wysyła do serwera zapytanie z identyfikatorem urządzenia (IDFA na iOS, GAID na Androidzie). Serwer dopasowuje identyfikator kliknięcia do instalacji i określa źródło ruchu.

Jeśli dokładne dopasowanie po ID nie zostanie znalezione (np. użytkownik wyłączył identyfikator reklamowy), stosowany jest fingerprinting — analiza adresu IP, modelu urządzenia, wersji systemu operacyjnego i znacznika czasu. Według danych AppsFlyer, fingerprinting zapewnia dokładność atrybucji na poziomie 92–95% na iOS i 95–97% na Androidzie nawet bez ID reklamowego. Kombinacja metod deterministycznych (IDFA/GAID) i probabilistycznych (fingerprinting) daje najpełniejszy obraz źródeł ruchu.

OneLink a zwykły deep link

Kluczowa różnica między OneLink a zwykłym deep linkiem polega na możliwości zachowania atrybucji na całej ścieżce użytkownika. Zwykły deep link (np. myapp://screen) otwiera aplikację, ale nie może określić, skąd przyszedł użytkownik, jeśli dopiero co zainstalował aplikację ze sklepu.

OneLink używa własnego SDK do śledzenia zdarzeń wewnątrz aplikacji i automatycznego przypisywania ich do danych atrybucyjnych. Umożliwia to tworzenie raportów na całym lejku: od wyświetlenia reklamy do zakupu, zwrotu środków lub utrzymania użytkownika w 7. dniu. Zwykłe deep linki nie zapewniają takiej możliwości — działają wyłącznie jako mechanizm nawigacji, bez warstwy analityki i atrybucji marketingowej.

Gdzie stosuje się OneLink

OneLink jest używany w szerokim spektrum scenariuszy marketingowych, gdzie wymagane jest precyzyjne przypisanie działań użytkownika do źródeł reklamowych. Główne obszary zastosowania obejmują pozyskiwanie nowych użytkowników, ponowne zaangażowanie istniejących i pomiar efektywności każdego kanału.

Kampanie reklamowe instalacji

Przy uruchamianiu reklam na instalacje (kampanie UA) linki OneLink są wstawiane w reklamy na Facebook Ads, Google Ads, TikTok, Snapchat i innych platformach. Parametr pid jednoznacznie identyfikuje platformę, a dodatkowy parametr c (campaign) — konkretną kampanię. AppsFlyer automatycznie dopasowuje kliknięcia do instalacji i wyświetla raport CPI (cost per install), CR (conversion rate) i ROAS (return on ad spend) dla każdego źródła.

Retargeting i ponowne zaangażowanie

Dla użytkowników, którzy już zainstalowali aplikację, OneLink obsługuje kampanie retargetingowe. Gdy istniejący użytkownik przechodzi przez link, OneLink otwiera aplikację i przekazuje parametry promocyjne, takie jak rabat osobisty lub bonus. AppsFlyer odróżnia nowych użytkowników od powracających na podstawie flagi is_retargeting i tworzy osobne raporty dla każdego typu ruchu — ważne dla prawidłowego obliczenia LTV (lifetime value).

Deferred deep linking dla ruchu organicznego

OneLink jest używany nie tylko w płatnych kampaniach, ale także dla ruchu organicznego: linki w newsletterach email, SMS, kodach QR i mediach społecznościowych. Jeśli użytkownik nie ma zainstalowanej aplikacji, OneLink kieruje go do App Store lub Google Play, a po instalacji — na docelowy ekran: stronę produktu, artykuł, profil lub ofertę promocyjną. Deferred deep linking jest krytyczny dla konwersji, ponieważ eliminuje tarcie między chęcią wykonania działania a koniecznością ręcznego szukania odpowiedniej sekcji.

Programy partnerskie i influencer marketing

OneLink obsługuje generowanie unikalnych linków dla każdego partnera lub influencera. Parametr af_sub1 może zawierać ID partnera, af_sub2 — nazwę posta lub wideo. Pozwala to marketerom zobaczyć, które treści przynoszą najwięcej instalacji i konwersji, oraz optymalizować budżet w oparciu o dane, a nie domysły.

Konfiguracja OneLink w projekcie

Do poprawnego działania OneLink wymagana jest integracja SDK AppsFlyer w aplikacji mobilnej. Proces obejmuje instalację SDK, konfigurację domeny OneLink i obsługę przychodzących deep linków przez mechanizmy systemowe platformy — Universal Links na iOS i App Links na Androidzie.

Integracja SDK AppsFlyer

Instalacja SDK odbywa się przez standardowe menedżery zależności. Na Androidzie dodaje się zależność w Gradle, na iOS — przez CocoaPods lub Swift Package Manager. Po instalacji SDK jest inicjalizowane z dev key uzyskanym w panelu zarządzania AppsFlyer i automatycznie rozpoczyna śledzenie instalacji i zdarzeń.

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        AppsFlyerLib.getInstance()
            .start(this, "YOUR_DEV_KEY")
    }

    override fun onNewIntent(intent: Intent?) {
        super.onNewIntent(intent)
        AppsFlyerLib.getInstance()
            .onNewIntent(this, intent)
    }
}

W powyższym przykładzie SDK jest inicjalizowane w metodzie onCreate głównej Activity z użyciem dev key. Metoda onNewIntent jest obowiązkowa do obsługi deep linków, jeśli aplikacja jest już uruchomiona. Bez tego wywołania atrybucja dla ponownych otwarć z linków OneLink nie zostanie zarejestrowana, co zniekształci statystyki kampanii retargetingowych.

Konfiguracja Universal Links (iOS)

Dla iOS należy skonfigurować Universal Links: dodać entitlements z domeną OneLink (app.onelink.me) i umieścić plik apple-app-site-association na serwerze. AppsFlyer automatycznie generuje ten plik podczas konfiguracji OneLink w panelu, programista musi tylko dodać entitlement i obsłużyć przychodzące linki w AppDelegate.

import AppsFlyerLib

class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        continue userActivity: NSUserActivity,
        restorationHandler: Any?
    ) -> Bool {
        AppsFlyerLib.shared()
            .continue(userActivity, restorationHandler: nil)
        return true
    }
}

Metoda continue userActivity jest wywoływana przez system przy przejściu przez Universal Link. Wewnątrz niej wywoływana jest metoda AppsFlyerLib.shared().continue, która wyodrębnia parametry atrybucyjne z linku i wysyła je na serwer. Analogiczne podejście jest stosowane na Androidzie przez Intent Filter z auto-verify dla App Links.

Po zakończeniu integracji linki OneLink można generować przez panel AppsFlyer lub API dla każdej kampanii reklamowej. Ważne jest przetestowanie linków na wszystkich platformach: w świeżo zainstalowanej aplikacji (deferred), w już zainstalowanej (direct) i na stronie internetowej, jeśli aplikacja nie jest zainstalowana. Testowanie odbywa się przez narzędzie AppsFlyer Test Link, które symuluje zachowanie na wszystkich platformach bez konieczności publikacji w sklepach.

Przy pracy z OneLink należy uwzględnić ograniczenia platform: na iOS po wprowadzeniu App Tracking Transparency (ATT) dostęp do IDFA wymaga wyraźnej zgody użytkownika, co obniża dokładność atrybucji deterministycznej. Google również ogranicza użycie GAID na Androidzie 14+ i wyżej, wymagając potwierdzenia od użytkownika. W takich warunkach fingerprinting staje się główną metodą atrybucji, a jego dokładność zależy bezpośrednio od jakości danych — im więcej sygnatur zbiera SDK, tym większe prawdopodobieństwo poprawnego dopasowania kliknięcia do instalacji.