OneLink™ 딥링킹 가이드

1. 앱 대시보드에서 OneLink 구성을 클릭합니다.
2. 기존 OneLink 템플릿을 선택하거나 새로 템플릿을 만듭니다.
3. iOS 및 Android 항목 아래에서 해당 앱을 선택합니다.
4. 스크롤을 내려서 추가 구성까지 이동합니다.
5. Android 앱 링크 또는 iOS 유니버설 링크를 URI 스킴과 함께 사용하는 경우는 딥링킹(iOS9/Android 6 이상의 OneLink 하위 도메인을 설정합니다.
6. 딥링킹 사용자정의 URL 스킴에서 URI 스킴을 설정합니다.
7. 스크롤을 내려서 구성 저장을 클릭합니다.

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

<activity android:name="com.appsflyer.sample.Activity">    
      <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>

Android - 특정 액티비티로 딥링킹하기

딥링킹하려는 각각의 액티비티에서 사용자정의 URI 스킴을 추가합니다.

greatapp://activity1

<activity android:name="com.appsflyer.sample.Activity1">    
      <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" />
        <data android:host="activity1" />
      </intent-filter>
</activity>

greatapp://activity2

<activity android:name="com.appsflyer.sample.Activity2">    
      <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" />
        <data android:host="activity2" />
      </intent-filter>
</activity>

1. Xcode에서 앱 정보 plist 파일을 여세요.
2. URL types 항목을 추가하세요.
3. URL Type과 Item 0 행을 펼칩니다.
4. 앱의 고유 식별자를 URL identifier의 값으로 추가하세요. 다른 앱에서 사용한 적이 없는 고유 식별자를 선택하는 것이 좋습니다.
5. URL identifier를 오른쪽 클릭하고 Add Row를 선택한 후, URI Schemes을 선택하고 Item 0 값을 고유 스킴으로 설정합니다.
   
   

   

1. Apple 개발자 계정으로 로그인합니다.
2. 왼쪽 메뉴에서 Certificates, Identifiers & Profiles를 선택합니다.
3. Identifiers 아래의 App IDs를 선택합니다.
4. 해당 앱을 클릭합니다.
5. 프리픽스와 ID를 복사합니다.
   
   

   

6. 프리픽스와 iD를 마케팅 담당자에게 전달합니다.

이 단계는 1단계와 같은 화면에서 실시합니다.

1. 스크롤을 내려서 애플리케이션 서비스 목록까지 이동합니다.
2. Edit를 클릭합니다.
3. Associated Domains를 활성화합니다.
   

   

4. 스크롤을 내린 후 Done을 클릭합니다.

이 작업은 Xcode에서 실시합니다. 아래의 OneLink 템플릿 구성하기에서 마케팅 담당자가 생성한 OneLink 하위 도메인이 필요합니다. 시작하기 전에 마케팅 담당자가 OneLink 하위 도메인을 생성했는지 여부를 확인하세요.

1. Xcode에서 프로젝트를 클릭합니다.
2. 프로젝트의 타겟을 클릭합니다. 아래 화면을 참고하세요.
3. Capabilities 탭으로 이동합니다.
4. Associated Domain을 활성화합니다.
5. 이 가이드의 첫 부분에서 생성한 하위 도메인을 추가합니다.
   형식은 applinks:sudbomain.onelink.me입니다.

시작하기 전에 개발자에게 다음을 확인하세요.

• 앱 ID 프리픽스
• iOS 앱 번들 ID

이 항목은 개발자가 위의 1단계에서 획득한 것입니다.

1. 앱의 대시보드에서  OneLink 구성을 클릭합니다.
2. 기존 OneLink 템플릿을 선택하거나 새로 템플릿을 만듭니다.
3. iOS 항목에서 해당 앱을 선택합니다.
4.  딥링킹용 유니버설 링크를 활성화합니다.
5. 앱 ID 프리픽스와 iOS 앱 번들 ID를 해당 필드에 붙여넣습니다.
   
   

   

6. 스크롤을 내려서 추가 구성으로 이동하고 OneLink 하위 도메인을 설정합니다.
   
   

   

7. 구성 저장을 클릭합니다.
8. OneLink를 복사하고 개발자에게 전달합니다.

유니버설 링크는 클릭했을 경우에만 동작합니다. 예를 들어, 웹 페이지나 이메일에서 링크를 클릭하는 경우입니다. 브라우저의 주소 창에 링크를 붙여넣는 경우에는 앱으로 딥링크하지 않습니다.

Android 앱 링크와 다르게 유니버설 링크는 기본 액티비티만 열 수 있습니다. 특정 액티비티로 연결하려면 onAppOpenAttribution API 메서드를 사용하세요.

OneLink 하위 도메인은 언제나 변경할 수 있지만, 변경할 경우는 이전 하위 도메인을 사용하는 기존 OneLink URL의 동작이 멈추게 됩니다.

소셜 네트워크 앱을 포함하여 모든 앱이 유니버설 링크를 완벽하게 지원하는 것은 아닙니다. 자세한 내용은 이 가이드를 참조하세요.

유니버설 링크에는 기타 다른 제한 사항이 있을 수 있습니다. 자세한 내용은 OneLink 문제 해결 항목을 참조하세요.

1. 앱의 키스토어로 이동합니다. 앱이 아직 개발 중이라면 debug.keystore로 이동합니다.

   • Windows 사용자: C:AME\.android\debug.keystore

   • Linux 또는 Mac OS 사용자: ~/.android/debug.keystore

2. 키스토어 파일이 위치한 폴더로 이동합니다.
3. 다음 명령을 실행합니다.

   keytool -list -v -keystore apk-key.keystore

   debug.keystore의 암호는 일반적으로 "android"입니다.
   
   

   다음과 같이 출력됩니다.

   Alias name: test
   Creation date: Sep 27, 2017
   Entry type: PrivateKeyEntry
   Certificate chain length: 1
   Certificate[1]:
   Owner: CN=myname
   Issuer: CN=myname
   Serial number: 365ead6d
   Valid from: Wed Sep 27 17:53:32 IDT 2017 until: Sun Sep 21 17:53:32 IDT 2042
   Certificate fingerprints:
   MD5: DB:71:C3:FC:1A:42:ED:06:AC:45:2B:6D:23:F9:F1:24
   SHA1: AE:4F:5F:24:AC:F9:49:07:8D:56:54:F0:33:56:48:F7:FE:3C:E1:60
   SHA256: A9:EA:2F:A7:F1:12:AC:02:31:C3:7A:90:7C:CA:4B:CF:C3:21:6E:A7:F0:0D:60:64:4F:4B:5B:2A:D3:E1:86:C9
   Signature algorithm name: SHA256withRSA
   Version: 3
   Extensions:
   #1: ObjectId: 2.5.29.14 Criticality=false
   SubjectKeyIdentifier [
     KeyIdentifier [
      0000: 34 58 91 8C 02 7F 1A 0F  0D 3B 9F 65 66 D8 E8 65 
      0010: 74 42 2D 44                    
    ]
   ]
   

4. 마케팅 담당자가 설정 2단계에서 사용할 수 있도록 SHA256 핑거프린트를 전달합니다.

1. 마케팅 담당자가 설정 3단계의 OneLink 구성에서 하위 도메인을 추가하면, 인텐트 필터 코드가 생성됩니다.
2. 마케팅 담당자에게 인텐트 필터 코드를 확인합니다.
   
3. 앱의 AndroidManifest.xml 파일을 엽니다.
4. 딥링크하려는 액티비티에 <intent-filter>를 추가합니다.

   <activity android:name="com.king.candycrushsaga.DeepLink">
       <intent-filter>
           <category android:name="android.intent.category.LAUNCHER" />
       </intent-filter>
       <intent-filter  android:autoVerify="true">
           <action android:name="android.intent.action.VIEW" />
           <category android:name="android.intent.category.DEFAULT" />
           <category android:name="android.intent.category.BROWSABLE" />
           <data android:scheme="https"
               android:host="demo.onelink.me"
               android:pathPrefix="/ST6c" />
       </intent-filter>
   </activity>

1. 앱 대시보드에서 OneLink 구성을 클릭합니다.
2. 기존의 OneLink를 선택하거나 새로 생성합니다.
3. Android 항목에서 해당 앱을 선택합니다.
4. 딥링킹용 앱 링크를 활성화합니다.

   

1. 개발자가 설정 1단계에서 생성한 앱의 SHA256 핑거프린트를 개발자에게 확인합니다.
2. SAH256 핑거프린트 추가를 클릭합니다.
3. SHA256을 붙여 넣습니다.
   
   

1. OneLink 하위 도메인을 선택하고, 추가 구성 항목의 딥링킹(iOS 9/Android 6 및 그 이상) 하위 도메인 필드를 입력하세요.
2. OneLink 구성에서 하위 도메인을 추가하면 인텐트 필터 코드가 생성됩니다.
3. 앱 링크 항목의 마지막에 있는 XML 코드를 복사하여 개발자가 설정 2단계에서 사용할 수 있도록 개발자에게 전달합니다.

다음 가이드에 따라 사용자정의 어트리뷰션 링크를 만듭니다.

예를 들어, 다음 링크를 만든다고 가정해 보세요.

• demo.onelink.me/ST6c/c0aae4f
• demo.onelink.me/ST6c/6f0b5993
• demo.onelink.me/ST6c/b40bder4

링크하려는 각 액티비티에 대해, 각 링크에 맞는 인텐트 필터를 설정합니다.

<activity android:name="com.king.candycrushsaga.DeepLink">
    <intent-filter>
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <intent-filter  android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="https"
            android:host="demo.onelink.me"
            android:pathPrefix="/ST6c/c0aae4f" />
    </intent-filter>
</activity>

<activity android:name="com.appsflyersmaple.guide.DeepLink2">
    <intent-filter>
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <intent-filter  android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="https"
            android:host="demo.onelink.me"
            android:pathPrefix="/ST6c/6f0b5993" />
    </intent-filter>
</activity>

<activity android:name="com.king.candycrushsaga.DeepLink3">
    <intent-filter>
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <intent-filter  android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="https"
            android:host="demo.onelink.me"
            android:pathPrefix="ST6c/b40bder4" />
    </intent-filter>
</activity>
      

앱 링크는 클릭했을 경우에만 동작합니다. 예를 들어, 웹 페이지나 이메일에서 링크를 클릭하는 경우입니다. 브라우저의 주소 창에 링크를 붙여넣는 경우에는 앱으로 딥링크하지 않습니다.

OneLink 하위 도메인은 언제나 변경할 수 있지만, 변경할 경우는 이전 하위 도메인을 사용하는 기존 OneLink URL의 동작이 멈추게 됩니다.

소셜 네트워크 앱을 포함하여 모든 앱이 앱 링크를 완벽하게 지원하는 것은 아닙니다. 자세한 내용은 이 가이드를 참조하세요.

앱 링크에는 기타 다른 제한 사항이 있을 수 있습니다. 자세한 내용은 OneLink 문제 해결 항목을 참조하세요.

If you see the app selection dialog when testing your OneLinks, make sure to sign your app even if it's a debug app. The certificate that you use to sign the app with, is the same certificate that you use to generate the SHA256 fingerprint when configuring OneLink for App Links.