OneLink: 개념, 딥링킹 기술 및 설치 속성

OneLink란?

OneLink는 AppsFlyer의 스마트 딥링크 기술로, 링크를 통해 속성 매개변수를 전달하고 사용자 액션을 특정 광고 소스에 연결할 수 있습니다. 이것은 모바일 마케팅의 핵심 문제를 해결합니다: 광고 클릭을 앱 설치에 연결하는 것입니다.

일반 딥링크는 앱을 열고 기본 매개변수를 전달할 수 있지만 앱 스토어를 통과할 때 트래픽 소스 정보를 잃습니다. OneLink는 URL 매개변수, 기기 ID 및 핑거프린팅 기술의 조합을 사용하여 설치 후 속성을 복원합니다. 이를 통해 마케터는 어떤 캠페인, 크리에이티브 및 채널이 전환(등록, 구매 또는 기타 목표 이벤트)으로 이어졌는지 확인할 수 있습니다.

OneLink는 모든 플랫폼에서 작동합니다: iOS (Universal Links), Android (App Links), 웹 브라우저 및 데스크톱 앱에서도 가능합니다. 링크는 AppsFlyer 대시보드 또는 프로그래밍 방식으로 REST API를 통해 생성되며, 각 캠페인에 대해 실시간으로 동적으로 매개변수를 설정할 수 있습니다.

OneLink 작동 방식

OneLink 작동 원리는 세 가지 순차적 단계에 기반합니다: 링크 클릭, 앱 설치 및 이벤트 매칭. 각 단계에서 OneLink는 트래픽 소스를 정확하게 결정하기 위해 방법의 조합을 사용하여 속성 데이터를 보존하고 전송합니다.

OneLink 링크 구조

OneLink 링크에는 AppsFlyer 도메인, 앱 ID 및 캠페인 매개변수가 포함된 특수 형식이 있습니다. 표준 템플릿은 https://app.onelink.me/{app-id}?pid={source}&c={campaign}&af_dp={deeplink}와 같습니다. pid 매개변수(미디어 소스)는 트래픽 소스를 나타내고, c는 캠페인 이름, af_dp는 앱 내 딥링크입니다.

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)
    }
}

af_dp 매개변수는 앱이 이미 설치된 경우 사용자가 따라갈 딥링크를 지정합니다. 새 사용자의 경우 지연 딥링킹 메커니즘이 활성화됩니다: 설치 및 첫 실행 후 SDK가 저장된 매개변수를 확인하고 사용자를 원하는 화면으로 안내합니다. af_click_lookback 매개변수는 속성 창을 설정합니다 — 클릭이 설치로 이어진 것으로 간주되는 기간입니다.

속성 메커니즘

OneLink 링크를 클릭하면 AppsFlyer가 클릭을 기록하고 고유한 클릭 ID와 연결합니다. 사용자가 앱을 설치하고 열면 AppsFlyer SDK가 기기 ID(iOS의 IDFA, Android의 GAID)와 함께 서버에 요청을 보냅니다. 서버는 클릭 ID를 설치와 매칭하고 트래픽 소스를 결정합니다.

정확한 ID 일치가 발견되지 않으면(예: 사용자가 광고 ID를 비활성화한 경우) 핑거프린팅이 사용됩니다 — IP 주소, 기기 모델, OS 버전 및 타임스탬프 분석. AppsFlyer에 따르면 핑거프린팅은 광고 ID 없이도 iOS에서 92~95%, Android에서 95~97%의 속성 정확도를 제공합니다. 결정론적(IDFA/GAID) 및 확률론적(핑거프린팅) 방법의 조합은 트래픽 소스의 가장 완전한 그림을 제공합니다.

OneLink vs 일반 딥링크

OneLink와 일반 딥링크의 주요 차이점은 사용자 여정 전체에서 속성을 유지하는 능력에 있습니다. 일반 딥링크(예: myapp://screen)는 앱을 열지만 사용자가 스토어에서 방금 앱을 설치한 경우 어디에서 왔는지 확인할 수 없습니다.

OneLink는 자체 SDK를 사용하여 앱 내 이벤트를 추적하고 이를 자동으로 속성 데이터에 연결합니다. 이를 통해 광고 노출부터 구매, 환불 또는 7일차 사용자 유지까지 전체 퍼널에 걸친 보고서를 작성할 수 있습니다. 일반 딥링크는 이러한 기능을 제공하지 않습니다 — 분석 및 마케팅 속성 레이어 없이 단순한 탐색 메커니즘으로만 작동합니다.

OneLink 사용처

OneLink는 사용자 액션을 광고 소스에 정확하게 연결해야 하는 광범위한 마케팅 시나리오에서 사용됩니다. 주요 영역에는 신규 사용자 획득, 기존 사용자 재참여 및 각 채널의 효과 측정이 포함됩니다.

설치 광고 캠페인

설치 광고(UA 캠페인)를 실행할 때 OneLink 링크는 Facebook Ads, Google Ads, TikTok, Snapchat 및 기타 플랫폼의 광고에 배치됩니다. pid 매개변수는 플랫폼을 고유하게 식별하고, 추가 c(캠페인) 매개변수는 특정 캠페인을 식별합니다. AppsFlyer는 자동으로 클릭을 설치와 매칭하고 각 소스에 대한 CPI(설치당 비용), CR(전환율) 및 ROAS(광고 지출 수익) 보고서를 표시합니다.

리타겟팅 및 재참여

이미 앱이 설치된 사용자의 경우 OneLink는 리타겟팅 캠페인을 지원합니다. 기존 사용자가 링크를 클릭하면 OneLink가 앱을 열고 개인 할인 또는 보너스와 같은 프로모션 매개변수를 전달합니다. AppsFlyer는 is_retargeting 플래그를 사용하여 신규 사용자와 복귀 사용자를 구분하고 각 트래픽 유형에 대해 별도의 보고서를 작성합니다 — 이는 LTV(생애 가치)의 정확한 계산에 중요합니다.

오가닉 트래픽을 위한 지연 딥링킹

OneLink는 유료 캠페인뿐만 아니라 오가닉 트래픽에도 사용됩니다: 이메일 뉴스레터, SMS, QR 코드 및 소셜 네트워크의 링크. 사용자가 앱을 설치하지 않은 경우 OneLink는 App Store 또는 Google Play로 안내하고, 설치 후에는 대상 화면(제품 페이지, 기사, 프로필 또는 프로모션 오퍼)으로 안내합니다. 지연 딥링킹은 전환에 중요합니다. 사용자의 액션 의지와 수동으로 올바른 섹션을 찾아야 하는 필요성 사이의 마찰을 제거하기 때문입니다.

파트너 프로그램 및 인플루언서 마케팅

OneLink는 각 파트너 또는 인플루언서에 대한 고유 링크 생성을 지원합니다. af_sub1 매개변수에는 파트너 ID, af_sub2에는 게시물 또는 동영상 이름이 포함될 수 있습니다. 이를 통해 마케터는 어떤 콘텐츠가 가장 많은 설치와 전환을 생성하는지 확인하고 추측이 아닌 데이터에 기반하여 예산을 최적화할 수 있습니다.

프로젝트에서 OneLink 설정

OneLink가 올바르게 작동하려면 AppsFlyer SDK를 모바일 앱에 통합해야 합니다. 프로세스에는 SDK 설치, OneLink 도메인 구성 및 플랫폼의 시스템 메커니즘(iOS의 Universal Links 및 Android의 App Links)을 통해 수신 딥링크 처리가 포함됩니다.

AppsFlyer SDK 통합

SDK는 표준 종속성 관리자를 통해 설치됩니다. Android에서는 Gradle에 종속성이 추가되고 iOS에서는 CocoaPods 또는 Swift Package Manager를 통해 설치됩니다. 설치 후 SDK는 AppsFlyer 대시보드에서 얻은 개발자 키로 초기화되고 자동으로 설치 및 이벤트 추적을 시작합니다.

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

위 예제에서 SDK는 기본 Activity의 onCreate 메서드에서 개발자 키를 사용하여 초기화됩니다. onNewIntent 메서드는 앱이 이미 실행 중인 경우 딥링크를 처리하는 데 필수적입니다. 이 호출이 없으면 OneLink 링크에서 반복 열기에 대한 속성이 기록되지 않아 리타겟팅 캠페인 통계가 왜곡됩니다.

Universal Links 설정 (iOS)

iOS의 경우 Universal Links를 구성해야 합니다: OneLink 도메인(app.onelink.me)으로 entitlements를 추가하고 서버에 apple-app-site-association 파일을 배치합니다. 대시보드에서 OneLink를 설정할 때 AppsFlyer가 자동으로 이 파일을 생성합니다; 개발자는 entitlement를 추가하고 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
    }
}

continue userActivity 메서드는 Universal Link를 따라갈 때 시스템에 의해 호출됩니다. 그 안에서 AppsFlyerLib.shared().continue가 호출되어 링크에서 속성 매개변수를 추출하고 서버로 전송합니다. Android에서도 App Links에 대해 Intent Filter 및 auto-verify와 유사한 접근 방식이 사용됩니다.

통합이 완료된 후 각 광고 캠페인에 대해 AppsFlyer 대시보드 또는 API를 통해 OneLink 링크를 생성할 수 있습니다. 모든 플랫폼에서 링크를 테스트하는 것이 중요합니다: 새로 설치된 앱(지연), 이미 설치된 앱(직접), 앱이 설치되지 않은 경우 웹 페이지에서. 테스트는 AppsFlyer Test Link 도구를 통해 수행되며, 스토어에 게시하지 않고도 모든 플랫폼에서 동작을 시뮬레이션합니다.

OneLink로 작업할 때 플랫폼 제한 사항을 고려하는 것이 중요합니다: iOS에서 App Tracking Transparency(ATT) 도입 후 IDFA에 대한 액세스는 명시적인 사용자 동의가 필요하며, 이는 결정론적 속성의 정확도를 낮춥니다. Google도 Android 14+ 이상에서 GAID 사용을 제한하고 사용자 확인을 요구합니다. 이러한 조건에서 핑거프린팅이 주요 속성 방법이 되며, 그 정확도는 데이터 품질에 직접적으로 의존합니다 — SDK가 더 많은 신호를 수집할수록 클릭을 설치에 올바르게 매칭할 확률이 높아집니다.