OneLink™ 딥링킹 가이드 - OneLink Deep Linking Guide – AppsFlyer Support

소개

딥링킹은 사용자에게 맞춤형 콘텐츠를 제공하거나 앱의 특정 액티비티를 보내면서 모바일 앱을 시작하는 동작입니다. 이렇게 함으로써 앱에 대한 사용자의 인게이지먼트를 높이고 더 나은 사용자 경험을 제공할 수 있습니다.

2가지 유형의 딥링킹

사용자가 모바일 앱을 설치했거나 설치하지 않은 각각의 경우가 있기 때문에, 딥링킹은 2가지 유형이 존재합니다.

딥링킹: 이미 모바일 앱을 설치한 기존 사용자에게 맞춤형 콘텐츠를 직접 제공합니다.
지연된 딥링킹: 신규 또는 재방문 사용자가 앱을 설치한 후에 바로 맞춤형 콘텐츠를 제공합니다.

AppsFlyer는 고유의 기기 감지 트래킹 링크인 OneLink™를 사용하여 딥링킹과 지연된 딥링킹 방식을 모두 지원합니다.

이 가이드는 모바일 앱의 딥링킹 설치 및 사용에 관한 모든 내용을 설명합니다.

중요!

딥링킹을 하기 위해서는 OneLink의 올바른 설치가 중요합니다.
OneLink™ 기본 설정 가이드를 먼저 읽으세요.

딥링킹 및 OneLink

OneLink는 광고와 모바일 앱 사이에서 '다리' 역할을 합니다. 앱을 시작할 수 있고 맞춤형 사용자 경험에 필요한 데이터를 모바일 개발자에게 제공할 수 있습니다. 이를 위해서는 딥링킹 기능과 인프라스트럭처를 반드시 포함하면서 모바일 앱을 개발해야 합니다.

딥링킹 및 리타게팅

딥링킹과 OneLink는 리타게팅과 같이 광고주가 기존 사용자나 과거 사용자를 리인게이지할 때 필요한 주요 도구입니다. 이 주제는 딥링킹 가이드 다음에 구현할 리타게팅 가이드에서 설명합니다.

딥링킹 방법

모든 유형의 사용자를 처리하기 위해서 몇 가지 방식의 딥링킹 구현 방법이 있습니다. 방법은 iOS, Android와 같은 모바일 플랫폼과 각 사용자의 OS 버전에 따라 달라집니다.

방법	설명	적용 대상
URI 스킴	직접 앱을 열고 `af_dp` URL 파라미터에서 지정한 액티비티 경로로 리디렉션합니다.	모든 버전의 Android(Android 6 버전 또는 그 이상은 선택적으로 제외) iOS 8 및 그 이하 브라우저를 사용하거나 유니버설 링크를 지원하지 않는 앱을 사용할 경우에 iOS 9 및 그 이상
유니버설 링크	기본 액티비티에서 모바일 앱을 직접 엽니다. 모바일 개발자는 리디렉션하고 맞춤형 콘텐츠를 제공하는 로직을 OneLink URL 파라미터에 기초하여 빌드해야 합니다. 파라미터의 예: `af_dp` 또는 `af_sub1`	iOS 9 및 그 이상
앱 링크		Android 6 및 그 이상

자세한 구현 방법은 아래 상자의 딥링크 방법을 클릭하세요.

URI 스킴

URI 스킴은 기본적으로 URL이며 사용자가 클릭하면 곧장 모바일앱의 기본 액티비티로 사용자를 유도합니다. 예: greatapp://

팁

Apple이나 Google은 앱 스킴에서 이름의 고유성을 강제하지 않습니다. 서로 다른 애플리케이션 간의 스킴 충돌을 막으려면, 해당 브랜드만의 고유한 스킴 이름을 선택해야 합니다.

스킴은 사용자를 특정 액티비티로 자동적으로 딥링크하는 긴 경로를 작성하는데 사용할 수 있습니다. 예: greatapp://vintage_items/cars/flying_delorean

앱의 사용자가 브라우저의 URL 상자에 스킴 경로를 입력하면 앱이 시작되고 사용자는 딥링크됩니다. AppsFlyer는 af_dp 파라미터를 사용하는 OneLink URL을 통해서 동일한 URI 스킴 딥링킹 기능을 제공합니다. 예: http://go.onelink.ly/qwerty?af_dp=greatapp://vintage_items/cars/flying_delorean

중요!

OneLink를 iOS와 Android에서 모두 사용하려면 양쪽 플랫폼에서 같은 스킴을 정의하는 것이 중요합니다. iOS와 Android의 지시사항을 확인하세요.

URI 스킴 설정

URI 스킴 설정은 아래에 보이는 것처럼 앱의 코드에서 처리됩니다. 같은 URI 스킴을 AppsFlyer의 OneLink 템플릿 페이지에서도 정의해야 합니다.

모든 버전의 Android

앱의 매니페스트에서 다음 인텐트 필더를 관련 액티비티에 추가하세요.

<activity android:label="@string/app_name" …..  >
<intent-filter>
   <action   android:name="android.intent.action.VIEW" />
   <category android:name="android.intent.category.DEFAULT" />
   <category android:name="android.intent.category.BROWSABLE" />
   <data     android:scheme="your unique scheme" />
</intent-filter>
</activity>

예

<activity android:label="@string/greatapp" …..  >        
           <intent-filter>
               <action   android:name="android.intent.action.VIEW" />
               <category android:name="android.intent.category.DEFAULT" />
               <category android:name="android.intent.category.BROWSABLE" />
               <data     android:scheme="greatapp" />
           </intent-filter>
</activity>

iOS 8 및 그 이하

Xcode에서 앱 정보 plist 파일을 여세요.
URL types 항목을 추가하세요.
URL type과 “item 0” 행을 펼치고 새로운 행을 추가하세요.
앱의 고유 식별자를 URL identifier의 값으로 추가하세요. 다른 앱에서 사용한 적이 없는 고유 식별자를 선택하는 것이 좋습니다.
URL identifier에서 오른쪽 클릭하고 Add Row를 선택하세요. 그리고 URI Scheme을 선택하고 item 0 값을 고유 스킴으로 설정하세요.

OneLink 템플릿 설정:

AppsFlyer 대시보드의 OneLink 구성 화면에서 딥링킹 사용자정의 URL 스킴(iOS 8/Android 5 및 그 이하)에 정의한 스킴을 입력하세요.(예: "scheme://")

URI 스킴 테스트

기기나 iOS의 iPhone 시뮬레이터에 앱을 설치하고 실행하세요.
기본 브라우저(iOS의 Safari)를 열고, 주소 표시줄에 URL 고유 스킴을 입력하세요.(예: "greatapp://").
모바일 앱이 기본 액티비티에서 시작됩니다.

OneLink 템플릿 구성

OneLink 구성 화면의 '딥링킹 사용자정의 URL 스킴(iOS 8/Android 5 및 그 이하)'에 정의한 스킴을 입력하세요.(예: "greatapp://").

유니버설 링크

iOS 9 및 그 이상 버전부터는 Apple이 기본 딥링킹 방식을 URI 스킴에서 유니버설 링크로 대체했습니다. 다른 앱이 유니버설 링크를 사용할 수 없기 때문에 이 방식은 보안성이 개선되었습니다. 또한 사용자를 브라우저로 먼저 리디렉션하지 않고, iOS 앱을 직접 시작하므로 사용자 경험을 개선합니다.

근본적으로 유니버설 링크 방식은 iOS 모바일 앱과 AppsFlyer OneLink 도메인(xxx.onelink.me)과 같은 연결 웹사이트/도메인을 링크하는 것입니다. 이를 위해서는 다음 작업이 필요합니다.

OneLink 하위 도메인을 설정하고 모바일 앱에 링크하세요.(AppsFlyer가 처리하는 ‘apple-app-site-association’ 파일을 호스팅합니다.)
승인된 도메인을 등록하도록 모바일 앱을 설정하세요.

위 단계가 완료되면 사용자가 인증된 도메인 URL을 클릭할 때마다(앱이 기기에 이미 설치되어 있는 경우) iOS는 기본 액티비티로 연결된 앱을 시작합니다.

팁

일부 브라우저나 앱은 여전히 유니버설 링크를 지원하지 않고 URI 스킴 방식을 대체해서 사용하기 때문에, iOS 9 이상인 경우에도 URI 스킴을 구현하는 것이 여전히 중요합니다.

다음은 OneLink와 유니버설 링크를 사용하는 딥링킹을 활용하기 위해서 필요한 단계입니다.

OneLink 하위 도메인 설정 및 앱 연결

이 단계를 완료하려면 개발자가 앱의 '팀 ID'(또는 다수의 팀 ID인 경우 '앱 프리픽스')를 Apple 개발자 포털(‘View Account >> Account Summary’)에서 획득해야 합니다.
AppsFlyer의 대시보드의 메뉴에서 'OneLink 구성'을 선택하고, 'iOS' 아래의 '딥링킹을 위한 iOS 8 유니버설 링크 사용' 체크박스를 선택한 후에, 1 단계에서 획득한 팀 ID/앱 프리픽스를 입력하세요.

참고

등록 대기 중인 앱은 개발자가 iOS 앱 번들 ID도 함께 제공해야 합니다.

OneLink 하위 도메인을 선택하고 추가 구성 항목 아래의 딥링킹(iOS 9/Android 6 및 그 이상) 하위 도메인 필드에 입력하세요.

참고

하위 도메인은 언제든지 변경될 수 있고, 이 경우에는 원래의 하위 도메인을 사용하는 모든 기존 OneLink URL이 동작하지 않게 됩니다.

승인된 도메인 등록을 위한 모바일 앱 설정

Apple 개발자 포털의 Identifiers >> App ID 아래에서 앱을 선택하고 Associate Domains을 활성화합니다. Xcode에서 앱의 프로비저닝 파일을 생성하여 다운로드한 후, 더블클릭하여 설치합니다.
Xcode의 Capabilities 항목에서 Associated Domains을 활성화하고, “OneLink 구성”에서 설정한 OneLink 도메인을 입력합니다.(AppsFlyer 계정)

참고

도메인은 반드시 "applinks:"로 시작해야 합니다. 예: applinks:mydomain.onelink.me

경고

소셜 네트워크 앱을 포함하여 모든 앱이 유니버설 링크를 지원하는 것은 아닙니다. 자세한 내용은 여기를 확인하세요.

Android 앱 링크

이 방식은 Android 6.0부터 도입되었으며 유니버설 링크와 유사한 장점을 지닌 Google 버전의 방식입니다.
iOS 사용자는 대부분 9 또는 그 이상 버전의 OS를 사용하므로 반드시 유니버설 링크를 사용해야 하지만, Android에서는 약 반 정도의 사용자가 여전히 6.0 이하 버전의 OS를 사용하고 있기 때문에 딥링킹을 위해서 URI 스킴을 사용해야 합니다.
URI 스킴은 모든 Android 사용자의 딥링킹을 처리할 수 있기 때문에 많은 앱 소유자들은 Android 딥링킹을 위해서 이 방식만을 구현합니다.
앱 링크를 구현하려는 광고주는 일반적으로 URI 스킴도 구현할 필요가 있습니다.
어떻게 Android 앱 링크를 구현하는지에 대한 설명은 여기에서 확인하세요.

딥링킹 보고

딥링킹은 리타게팅 캠페인의 중요한 부분입니다. 많은 경우에 있어서 리타겟팅 캠페인은 재방문 사용자에게 크레딧이나 프리미엄 콘텐츠를 제공하는 것과 같이 맞춤형 콘텐츠를 제공하는 방식에 기초합니다.

AppsFlyer가 이러한 리타게팅/딥링킹 활동을 처리하고 어트리뷰트하기 위해서는 딥링킹이 발생할 때마다 앱 개발자가 AppsFlyer SDK에 보고해야 합니다.

이것을 구현하기 위해서 iOS는 여기에서, 그리고 Android는 여기에서 지시를 확인하세요.

딥링킹 Vs. 지연된 딥링킹

현재 사용자가 OneLink를 클릭했을 때, 앱 안의 어떤 콘텐츠로도 사용자를 딥링크하고 리디렉션할 수 있습니다.

아직 앱을 설치하지 않은 잠재적 사용자에게는 어떻게 같은 경험을 제공할 수 있을까요?

잠재적 사용자가 OneLink를 클릭하면, 기기 유형에 맞는 앱스토어로 리디렉션하여 앱을 설치하도록 합니다. 처음으로 앱을 시작할 때는 어떤 광고를 눌렀는지와는 상관없이 기본 액티비티를 엽니다.

기존 사용자와 신규 사용자 모두에게 동일한 딥링킹 경험을 제공하기 위해서 AppsFlyer는 지연된 딥링킹 솔루션을 제공합니다.

위에서 보이는 것처럼 신규 사용자가 앱을 처음으로 시작할 때, AppsFlyer는 딥링킹 데이터를 포함한 어트리뷰션 정보를 앱에 제공합니다. 이 데이터를 이용해서 앱 개발자는 기존 사용자를 직접 딥링킹한 것처럼 신규 사용자에게도 앱 안의 모든 콘텐츠를 보낼 수 있습니다.

지연된 딥링킹을 구현하려면 이 가이드의 지시를 따르세요.

팁

만약 딥링킹 캠페인이 기존 모바일 사용자만을 대상으로 한다면, 지연된 딥링킹을 구현할 필요가 없습니다. 하지만, 상당수의 타겟 오디언스는 앱이 설치되어 있지 않을 수 있습니다(예: 사용자가 최근에 앱을 삭제). 이럴때 딥링킹을 구현하는 것은 사용자 경험을 향상하고 잔존율을 높이는데 매우 중요합니다.

onAppOpenAttribution를 이용한 맞춤형 콘텐츠 제공

유니버설 링크 및 앱 링크 방식은 OneLink의 파라미터와 상관없이 기본 액티비티에서 모바일 앱을 시작합니다. 맞춤형 콘텐츠를 제공하거나 앱의 특정 위치로 기존 사용자를 보내기 위해서는 onAppOpenAttribution SDK 함수를 사용해야합니다.

onAppOpenAttribution 메서드

onAppOpenAttribution 메서드는 데이터를 파싱하고 iOS에서의 NSDictionary <key, value> (해시 맵) 개체나 Android의 Map <key, value> 개체를 통해서 반환합니다. 앱 고유의 트래킹 링크, URL 스킴, 또는 단축 OneLink를 사용할 때 True를 반환합니다.
하지만, 유니버설 링크나 앱 링크를 사용하여 사용자를 직접 딥링크할 때는 AppsFlyer를 경유하지 않고 앱을 직접 열기 때문에 onAppOpenAttribution 메서드가 파싱하지 않은 완전한 링크를 반환합니다.

URL 데이터의 값을 파싱하고, 프로그래밍 방식으로 콘텐츠를 제공하거나 앱 안에서 리디렉션하세요.

onAppOpenAttribution 메서드는 onConversionDataReceived 메서드를 호출한 것과 같은 클래스나 델리게이트에서 호출해야 합니다.

참고

모든 딥링킹 시나리오에서 동일한 로직을 작성하기 위해서 여기서도 af_dp 파라미터 값을 사용할 것을 권장합니다.

두 메서드 모두에 대해서 아래와 같이 AppsFlyer SDK에 대한 트래커 델리게이트를 설정해야 합니다.


AppsFlyerLib.getInstance().registerConversionListener(this, new AppsFlyerConversionListener() {
	@Override
	public void onInstallConversionDataLoaded(Map<String, String> conversionData) {
		for (String attrName : conversionData.keySet()) {
			Log.d(AppsFlyerLib.LOG_TAG, "conversion_attribute: " + attrName + " = " +
					conversionData.get(attrName));
		}
	}

	@Override
	public void onInstallConversionFailure(String errorMessage) {
		Log.d(AppsFlyerLib.LOG_TAG, "error onAttributionFailure : " + errorMessage);
	}

	@Override
	public void onAppOpenAttribution(Map<String, String> conversionData) {
		for (String attrName : conversionData.keySet()) {
			Log.d(AppsFlyerLib.LOG_TAG, "onAppOpen_attribute: " + attrName + " = " +
					conversionData.get(attrName));
		}
	}

	@Override
	public void onAttributionFailure(String errorMessage) {
		Log.d(AppsFlyerLib.LOG_TAG, "error onAttributionFailure : " + errorMessage);
	}
});

다음과 같이 델리게이트 헤더 파일에서 트래커 델리게이트를 전달해야 합니다.


@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, AppsFlyerTrackerDelegate{

// ...


    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        // Override point for customization after application launch.
        AppsFlyerTracker.shared().appsFlyerDevKey = "repLaceWithYourDevKeY"
        AppsFlyerTracker.shared().appleAppID = "123456789"
// ...
        AppsFlyerTracker.shared().delegate = self
}

func onConversionDataReceived(_ installData: [AnyHashable: Any]) {
    //Handle Conversion Data (Deferred Deep Link)
    }
    
    func onConversionDataRequestFailure(_ error: Error?) {
        //        print("\(error)")
    }
    
    func onAppOpenAttribution(_ attributionData: [AnyHashable: Any]) {
        //Handle Deep Link Data
        
    }
    
    func onAppOpenAttributionFailure(_ error: Error?) {
        
}

AppDelegate.h:


@interface AppDelegate : UIResponder <UIApplicationDelegate, AppsFlyerTrackerDelegate>

AppDelegate.m:


- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    
    [AppsFlyerTracker sharedTracker].appsFlyerDevKey = @"repLaceWithYourDevKeY";
    [AppsFlyerTracker sharedTracker].appleAppID = @"123546789";

    [AppsFlyerTracker sharedTracker].delegate = self;
}

-(void)onConversionDataReceived:(NSDictionary*) installData {
    //Handle Conversion Data (Deferred Deep Link)
   
}

-(void)onConversionDataRequestFailure:(NSError *) error {
    
    NSLog(@"%@",error);
}


- (void) onAppOpenAttribution:(NSDictionary*) attributionData {
    
   //Handle Deep Link
}

- (void) onAppOpenAttributionFailure:(NSError *)error {
    NSLog(@"%@",error);
}

SRN 딥링킹

Facebook이나 Twitter와 같은 SRN(Self Reporting Networks)은 외부 어트리뷰션 서비스의 트래킹 URL을 포함하지 않는 자체 딥링킹 방법을 가지고 있습니다.
그럼 어떻게 SRN으로부터 관련 데이터를 얻고 사용자를 딥링크할 수 있을까요?

SRN의 딥링킹

SRN은 딥링킹을 수행할 때 자체 메서드를 사용합니다.
즉, SRN이 사용자 기기에서 딥링킹을 수행할 때 onAppOpenAttribution 메서드를 호출하지 않습니다.
따라서 앱 안에서 데이터를 딥링킹하려면 앱을 시작할 때 SRN의 메서드를 사용해야 합니다.

SRN의 지연된 딥링킹

오히려 SRN의 지연된 딥링킹은 가능합니다.
AppsFlyer는 항상 전환 데이터를 받고, 처음 시작할 때 앱이 이 데이터를 사용할 수 있도록 합니다.
SRN에서의 딥링킹이나 리타게팅 캠페인에서 신규 사용자가 클릭하고 앱을 설치하면, 앱이 시작된 후에 전환 데이터를 사용하여 앱 안에서 리디렉션되도록 할 수 있습니다.

하지만 af_dp와 같은 AppsFlyer의 딥링킹 파라미터는 SRN에서 딥링크 데이터의 일부로 보여지지 않습니다.
이 데이터를 앱 안에서 사용하려면 개발자는 캠페인이나 광고 세트, 단일 광고 이름과 같은 사용 가능한 파라미터를 이용하는 로직을 더 사용해야 합니다.

예

greatapp의 모바일 마케터 Jill은 Facebook에서 일반 오디언스를 대상으로 하는 딥링킹 캠페인을 하기로 결정합니다.
이 캠페인은 클릭한 모든 사용자를 "보너스" 액티비티로 리디렉션하는 것입니다.
모바일 개발자 Jack은 전환 데이터를 획득한 후에 다음 로직을 추가합니다.
1. Facebook에서 시작되었나("is_fb=true")?
2. True이면 광고 그룹 파라미터의 값을 획득한다.
3. 값에 "bonus"라는 단어가 포함되어 있으면 사용자에게 보너스 액티비티를 보낸다.
광고를 클릭한 기존 사용자는 Facebook 메서드를 사용하여 액티비티로 직접 리디렉션하고, 신규 사용자는 AppsFlyer의 전환 데이터를 이용하여 같은 경험을 얻을 수 있도록 한다.

OneLink URL 빌드

이미 설정한 각 OneLink 템플릿을 사용하여 무제한으로 OneLink URL을 빌드하고 사용할 수 있습니다.

관련 앱의 대시보드로 이동합니다(즉, 관련 OneLink 템플릿에서 구성한 앱 중의 하나).
연동 파트너 >> 사용자정의 트래킹 링크를 클릭합니다.
미디어 소스와 캠페인 이름을 입력합니다. pid와 c 파라미터가 창 아래쪽의 트래킹 링크에 추가되었는지 확인합니다.
OneLink™ 사용 체크박스를 선택합니다.
트래킹 링크의 도메인이 특정 앱에서 OneLink 하위 도메인으로 변경되었는지 확인합니다.
기기 감지 및 리디렉션을 위해서 멀티 플랫폼 사용 체크박스를 선택합니다.(기본값으로 선택되어 있습니다.)
리타게팅 어트리뷰션을 활성화하기 위해서 리타게팅 캠페인 체크박스를 선택합니다.
is_retargeting=true가 트래킹 링크에 추가됩니다.
딥링크를 사용하기 위해서 딥링킹 사용 체크박스를 선택합니다.
기본값으로 af_dp와 af_web_dp 파라미터가 OneLink 템플릿에서 구성한 값/대상과 함께 트래킹 링크에 추가됩니다. 관련 필드를 편집하여 수동으로 값/대상을 수정할 수 있습니다.
사용자정의 파라미터를 추가합니다.
단축 링크 버튼을 클릭하여 새로 구성된 OneLink™ URL을 단축해서 복사할 수 있습니다.
링크를 복사한 후 온드 미디어나 다른 관련 미디어 소스에서 사용하세요.

팁

사용자정의 트래킹 링크 창을 OneLink URL을 작성할 때 선택적으로 사용할 수 있습니다. 메모장, Word, 이메일 등에서 오프라인으로 작성할 수 있습니다.

OneLink URL 테스트

다음 방법을 사용하여 딥링킹을 쉽고 빠르게 테스트할 수 있습니다.

Android - AppsFlyer의 SDK 연동 테스트 앱
iOS - 대시보드의 SDK 연동 테스트 페이지

다른 방법으로 또는 추가적으로, 앱에서 수동으로 딥링킹을 테스트할 수 있습니다. 3가지 딥링킹 방법을 아래 설명대로 테스트하세요.

URI 스킴을 사용한 딥링킹 테스트

기기나 iOS의 iPhone 시뮬레이터에 앱을 설치하고 시작합니다.
[앱을 방금 설치했으면 앱을 백그라운드로 보냈다가 다시 전면으로 내놓기를 두세번 반복합니다.]
유효한 스킴 경로와 af_dp 파라미터를 가진 OneLink URL을 준비합니다.(예: "greatapp://cars").
테스트 기기에서 이메일, 메모, SMS, QR 코드 생성기 등에 링크를 붙여넣기합니다.
링크를 클릭합니다.

예상 결과: 앱이af_dp에서 지정한 요청 액티비티에서 열려야 합니다.

URI 스킴을 사용한 지연된 딥링킹 테스트

앱에서 로그아웃합니다.
앱을 삭제합니다.
유효한 스킴 경로와 af_dp 파라미터 또는 다른 파라미터를 가진 OneLink URL을 준비합니다.(예: "greatapp://cars").
테스트 기기에서 이메일, 메모, SMS, QR 코드 생성기 등에 링크를 붙여넣기합니다.
링크를 클릭합니다.
기기나 iOS의 iPhone 시뮬레이터에 앱을 설치하고 시작합니다.

예상 결과: 앱을 처음 시작할 때 링크(전환 데이터)를 가져옵니다. af_dp 파라미터가 추출되고 af_dp 값에 따라 사용자가 앱 안에서 리디렉션됩니다.

유니버설 링크 또는 Android 앱 링크 테스트

기기나 iOS의 iPhone 시뮬레이터에 앱을 설치하고 시작합니다.
[앱을 방금 설치했으면 앱을 백그라운드로 보냈다가 다시 전면으로 내놓기를 두세번 반복합니다.]
유효한 스킴 경로와 af_dp 파라미터 또는 다른 파라미터를 가진 OneLink URL을 준비합니다.(예: "greatapp://cars").
iOS - 링크를 Notes나 iMessage, 또는 이메일(Apple의 메일 클라이언트를 사용)에 붙여넣기 합니다.
Android - 링크를 이메일, Chrome, SMS, QR 코드 생성기 등에 붙여넣기 합니다.링크를 클릭할 때 Slack이나 Facebook, 또는 다른 소셜 앱을 사용하지 않습니다!
링크를 클릭합니다.

예상 결과: 브라우저를 통해서 리디렉션되지 않고, 앱이 즉시 열립니다. af_dp 파라미터가 추출되고 af_dp 값에 따라 사용자가 앱 안에서 리디렉션됩니다.

팁

iOS 기기에서 예상하지 못한 동작이 발생했습니까?

1. 기기를 재시작합니다(껐다가 다시 켜세요). - 기기 재시작만으로 iOS 11에서는 인타이틀먼트 오류가 종종 해결됩니다.

2. Safari로 링크를 붙여넣기 하지 않습니다. - 현재 iOS는 브라우저 주소 표시줄에서 딥링킹하는 것을 막고 있습니다.

3. 그밖의 문제 FAQ와 문제 해결 항목을 확인하세요.

FAQ

OneLink를 사용하지 않고 딥링킹을 할 수 있습니까?

예, 부분적으로 가능합니다. 비록 OneLink가 딥링킹에 있어서 필요한 도구이지만, URI 스킴을 이용하는 보통의 앱 고유 URL로도 사용자를 딥링크할 수 있습니다. 실제로 Android 앱에서 af_dp 파라미터를 보통의 AppsFlyer 트래킹 링크에 추가하는 것만으로 딥링킹을 사용할 수 있습니다.

소셜 네트워크 앱에서 딥링킹을 사용할 때 제한이 있습니까?

예, 유감스럽게도 있습니다.
소셜 앱은 바이럴 포스트로부터의 딥링킹을 다른 방식으로 처리하고, 이로써 사용자 경험이 자주 손상됩니다. AppsFlyer가 권장하는 해결책은 OneLink를 사용하여 바이럴 포스트로부터 방문 페이지로 사용자를 리디렉션하는 것입니다. 방문 페이지가 OneLink를 포함하고 있어서 사용자 경험을 손상시키지 않으면서 부드럽게 전환 데이터를 전송할 수 있습니다.

더 자세한 내용은 기본 OneLink 설정 가이드에서 확인하세요.

af_dp에 파라미터를 추가할 수 있습니까?

추가할 수도 있고 그렇지 않을 수도 있습니다.
af_dp는 URI 값을 포함할 수 있고 URI 경로의 일부분으로 어떤 파라미터라도 전송할 수 있습니다. 예: af_dp=greatapp%3A%2F%2Fparam1%2Fparam2 (greatapp://param1/param2).

쉽게 말하자면, 트래킹 링크의 '?' 문자 뒤에 어떤 파라미터라도 추가할 수 있습니다.

하지만, af_dp 값의 '?' 문자 뒤에 파라미터를 연결하는 것을 권장하지는 않습니다. 파라미터는 전환 데이터 또는, 다른 API에서 무시되거나 사용하지 못할 수 있습니다.
잘못된 예: af_dp=greatapp%3A%2F%2F%3Fparam1%3Da%26param2%3Db (greatapp://?param1=a&param2=b).

문제 해결

iOS 앱이 시작되었지만 onAppOpenAttribution 콜백이 호출되지 않습니다.

이것은 딥링킹을 위한 SDK 연동이 완료되지 않았다는 것입니다. AppDelegate에서 continueUserActivity 메서드가 누락되었고 호출되어야 합니다.

iOS 앱이 시작되었지만 앱스토어로 바로 리디렉션됩니다.

https 링크가 앱을 시작했을때 브라우저로 리디렉션을 수행하는 앱의 코드때문에 보통 발생합니다.

iOS - 링크를 탭하면 항상 앱스토어로 리디렉션됩니다.

iOS 11부터는 삭제되었지만, iOS 9와 10에서는 리디렉션을 무시하는 옵션이 있습니다. 유니버설 링크로 앱을 열었을 때, iOS는 기기의 오른쪽 위에 딥링킹하지 않고 링크를 열도록 설정하는 버튼이 보입니다.

이 설정을 다시 설정하려면 다음 팝업 메뉴가 나타날 때까지 iOS 기기에서 링크를 길게 탭 하세요.

앱에서 열기을 선택하세요.(예: open in LoginBox)
이제 딥링킹이 복구되었습니다.

길게 탭을 했지만, "앱에서 열기" 옵션이 보이지 않습니다.

이 경우에는 유니버설 링크에 대해서 앱이 제대로 설정되지 않은 것입니다. 다음을 확인하세요.

iOS 앱을 프로비저닝 파일과 함께 빌드했는지 확인하세요(라이선스와 유사). 이 파일이 Apple 개발자 콘솔에서 생성되고 유니버설 링크에 대해서 사용할 수 있어야 합니다.
Xcode에서 Capabilities 탭의 Associate Domains이 활성화되어 있는지 확인하고 앱의 OneLink 도메인을 포함시키세요.
앱의 팀 ID가 OneLink 구성 페이지에서 입력한 것과 일치하는 지 확인하세요.

iOS 유니버설 링크 - 앱 대신에 Safari가 열립니다.

앱을 삭제한 후 다시 설치하고 실행하세요. 문제가 계속되면 Associate Domains에 다른 행을 추가하여 변경해보세요. 그리고 앱을 삭제하고 이 과정을 반복하세요. OneLink가 앱에서 설정한 것과 같은 도메인을 가지고 있는지 확인하세요.

iOS 유니버설 링크 - 모두 시도해보았지만 여전히 동작하지 않습니다. 도와주세요!

알겠습니다. 만약 위의 모든 항목을 확인했는데도 문제를 해결하지 못했다면, 앱의 프로비저닝 파일을 다시 생성해보세요. 다시 한번 Xcode에서 다운로드하고 더블클릭하여 설치하세요.
또한 앱을 삭제하고 상위 버전의 앱을 다시 설치해 볼 수도 있습니다.

OneLink™ 딥링킹 가이드 - OneLink Deep Linking Guide

소개