초기 앱 설정하기

요약: 초기 앱 설정을 통해 마케터는 기존 앱 사용자를 바로 앱으로 연결하는 링크를 생성할 수 있습니다. 또한, 초기 앱 설정은 딥링킹과 디퍼드 딥링킹을 위한 선행 조건이 됩니다.

앱 시작 메서드

사용자 기반 전체를 다루기 위해 구현해야 하는 두 개의 앱 시작 메서드가 있습니다. 사용하기 위해 선택할 메서드 모바일 플랫폼 버전에 따라 달라집니다.

구현을 위한 두 가지 메서드 및 지침은 다음 섹션에 자세히 설명되어 있습니다.

방법설명안드로이드 버전절차
안드로이드 앱 링크기본 액티비티에서 직접 모바일 앱을 엽니다.안드로이드 6 이상1. SHA256 핑거프린팅을 생성합니다.
2. 메인 액티비티에 인텐트 필터를 추가합니다.
URI 스킴URI 스킴에서 지정한 액티비티 경로에 기반하여 직접 앱을 시작합니다.모든 버전의 안드로이드1. 마케터와 함께 URI 스키마를 결정합니다.
2. 메인 액티비티에 인텐트 필터를 추가합니다.
3. 테스트하기

안드로이드 앱 링크에 대한 절차

안드로이드 앱 링크는 안드로이드 6.0 이상에서 작동합니다. 더 알아보기.

Generating a SHA256 fingerprint

SHA256 핑거프린팅을 생성하는 방법:

  1. Locate your app's keystore.
    If the app is in still in development, locate the debug.keystore
    • 윈도우즈 사용자: C:\Users\USERNAME\.android\debug.keystore
    • 리눅스 또는 맥 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                    
 ]
]
  1. SHA256을 다시 마케터에게 전송합니다.

Adding App Link intent-filter to main activity

📘

마케터가 자동 생성된 인텐트 필터 코드를 줄 것입니다.

인텐트 필터 코드는 AndroidManifest.XML에서 사용됩니다.

메인 액티비티에 인텐트 필터를 추가하는 방법:

  1. Open the app's AndroidManifest.xml file.
  2. 메인 액티비티에 인텐트 필터를 추가합니다.
    메인 액티비티에 이미 안드로이드 앱 링크에 대한 인텐트 필터가 있는 경우, 이를 덮어씁니다.

📘

<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:host="onelink-basic-app.onelink.me"
        android:scheme="https" />
</intent-filter>

📘

When android:autoVerify="true" is present on any one of your intent filters, installing your app on devices with Android 6.0 and higher causes the system to attempt to verify all hosts associated with the URLs in any of your app's intent filters.

For each unique host name found in the above intent filters, Android queries the corresponding websites for the Digital Asset Links file at https://hostname/.well-known/assetlinks.json. Once the OneLink is created, AppsFlyer creates and hosts this path for you. You can test the App Links configuration using the AppsFlyer link validator.

더 알아보기

Github 링크: XML

  1. 앱 링크 설정이 완료되면 그 사실을 마케터에게 알립니다.
    마케터가 링크를 테스트할 때, 링크는 사용자를 앱의 기본 페이지로 안내해야 합니다.

URI 스킴 절차

URI 스킴은 사용자를 모바일 앱의 액티비티로 바로 보내는 URL입니다.

앱 사용자가 브라우저의 주소 창에 URI 스킴을 입력하면 앱이 시작되고 사용자가 딥링킹됩니다.

앱 링크가 애플리케이션을 열지 못할 때마다 URI 스킴을 폴백으로 사용하여 애플리케이션을 엽니다.

Deciding on a URI scheme

URI 스킴을 결정하는 방법:

  1. 마케터 및 iOS 개발자와 협업합니다.
  2. URI 스킴을 하나 선택합니다. 예시: yourappname://

📘

  • URI는 시중에 나온 다른 앱과 겹치지 않고 앱과 브랜드의 고유성을 최대한 표현할 수 있도록 정합니다. 다른 앱과 중복되는 것은 URI 스킴 프로토콜 특성 자체에 내재된 문제입니다.
  • URI 스킴은 httphttps로 시작하면 안됩니다.
  • URI 스킴은 안드로이드와 iOS에서 서로 유사하게 정의해야 합니다.

👍

URI 스킴은 마케터에게 제공해야 합니다.

마케터에게 URI 스킴을 보냅니다. 예시: afshopapp://mainactivity

Adding URI scheme intent-filter to main activity

메인 액티비티에 인텐트 필터를 추가하는 방법:

  1. Open the app's AndroidManifest.xml file.
  2. Add the following intent-filter to the main activity.
    In the data section, replace host and scheme with the URI scheme you chose. In the intent-filter code below, host="mainactivity" and scheme="afshopapp", matching the URI scheme afshopapp://mainactivity.
    If there already is an intent-filter for the URI scheme in the main activity, overwrite it.
<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:host="mainactivity"
        android:scheme="afshopapp" />
</intent-filter>

Github 링크: XML

  1. 마케터와 함께 URI 스킴을 결정합니다.

Testing URI schemes

선행 조건:

앱을 설치한 안드로이드 디바이스가 필요합니다. 개발팀이 이미 앱 링크 및 URI 스킴 작업을 한 앱 소스와 앱 버전이 설치되었는지 확인합니다.

URI 스킴을 테스트하는 방법:

  1. 마케터에게 마케터가 생성한 사용자정의 링크를 문의하여 제공받습니다.
  2. 마케터가 제공한 짧은 URL 또는 긴 URL을 휴대폰으로 보냅니다. 다음 중 하나를 수행할 수 있습니다.
    • 핸드폰 카메라나 QR 스캐너 앱으로 QR 코드를 스캔합니다.
    • 링크를 이메일이나 WhatsApp을 통해 보낸 후 휴대폰으로 엽니다.
  3. 모바일 디바이스에서 링크를 클릭합니다.
    앱이 실행되고 홈 화면에서 열립니다.