안드로이드 초기 설정
요약: 초기 앱 설정을 통해 마케터는 기존 앱 사용자를 바로 앱으로 연결하는 링크를 생성합니다. 또한, 초기 앱 설정은 딥링킹과 디퍼드 딥링킹을 위한 선행 조건이 됩니다.
앱 시작 메서드
사용자 기반 전체를 다루기 위해 구현할 수 두 개의 앱 시작 메서드가 있습니다. 사용하기 위해 선택할 메서드 모바일 플랫폼 버전에 따라 달라집니다.
구현을 위한 두 가지 메서드 및 지침은 다음 섹션에 자세히 설명되어 있습니다.
방법 | 설명 | 안드로이드 버전 | 절차 |
---|---|---|---|
안드로이드 앱 링크 | 기본 액티비티에서 직접 모바일 앱을 엽니다. | 안드로이드 V6 이상 | |
URI 스킴 | URI 스킴에서 지정한 액티비티 경로에 기반하여 직접 앱을 시작합니다. | 모든 버전의 안드로이드 |
안드로이드 앱 링크에 대한 절차
안드로이드 앱 링크는 안드로이드 V6 이상에서 작동합니다. 더 자세히 알아보세요.
Generating a SHA256 fingerprint while in development
- 앱의 키 저장소를 찾습니다.
앱이 아직 개발 중이라면 다음으로 이동합니다:debug.keystore
- 윈도우즈 사용자:
C:\Users\USERNAME\.android\debug.keystore
- 리눅스 또는 맥 OS 사용자:
~/.android/debug.keystore
- 윈도우즈 사용자:
- 명령행을 열고 키스토어 파일이 위치한 폴더로 이동합니다.
- 다음 명령을 실행합니다.
// keytool -list -v -keystore <<KEY_STORE_FILE>>
// For example, the default keystore file
keytool -list -v -keystore ~/.android/debug.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
]
]
- SHA256을 다시 마케터에게 전송합니다.
Generating a SHA256 fingerprint while in production
The SHA256 fingerprint is generated in
- In Google Play console Find the public SHA256 fingerprint in Setup -> App signing (see image below)
- SHA256을 다시 마케터에게 전송합니다.
Adding App Link intent-filter to main activity
- 마케터로부터 자동 생성된 인텐트 필터 코드를 가져옵니다. 인텐트 필터 코드는 AndroidManifest.XML에서 사용됩니다.
- 다음 앱 파일을 실행합니다:
AndroidManifest.xml
file. - 메인 액티비티에 인텐트 필터를 추가합니다.
메인 액티비티에 이미 안드로이드 앱 링크에 대한 인텐트 필터가 있는 경우, 이를 덮어씁니다.
예
<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>
만일
android:autoVerify="true"
은 사용자의 인텐트 필터 중 하나에 존재하며, 안드로이드 6 이상인 디바이스에 앱을 설치하면 시스템이 앱의 모든 인텐트 필터에 있는 URL과 연관된 모든 호스트를 확인하려고 시도합니다.
위의 인텐트 필터에서 찾은 각 고유한 호스트 이름에 대해, 안드로이드는 다음에 있는 디지털 자산 링크 파일에 대한 관련 웹 사이트를 조회합니다:https://hostname/.well-known/assetlinks.json
. Once the redirection logic for existing app users is added to the OneLink template configuration, AppsFlyer creates and hosts this path for you.
Learn more
Github 링크: XML
- 앱 링크 설정이 완료되면 그 사실을 마케터에게 알립니다.
마케터가 링크를 테스트할 때, 링크는 사용자를 앱의 기본 페이지로 안내해야 합니다.
URI 스킴 절차
URI 스킴은 사용자를 모바일 앱의 액티비티로 바로 보내는 URL입니다.
앱 사용자가 브라우저의 주소에 URI 스킴을 입력하면 앱이 시작되고 사용자가 딥링킹됩니다.
앱 링크가 애플리케이션을 열지 못할 때마다 URI 스킴을 폴백으로 사용하여 애플리케이션을 엽니다.
Deciding on a URI scheme
URI 스킴을 결정하는 방법:
-
Contact the marketer.
-
URI 스킴을 하나 선택합니다. 예시:
yourappname://
- URI는 시중에 나온 다른 앱과 겹치지 않고 앱과 브랜드의 고유성을 최대한 표현할 수 있도록 정합니다. 다른 앱과 중복되는 것은 URI 스킴 프로토콜 특성 자체에 내재된 문제입니다.
- URI 스킴은 http나 https로 시작하면 안됩니다.
- URI 스킴은 안드로이드와 iOS에서 서로 유사하게 정의해야 합니다.
-
URI 스킴을 마케터에게 보냅니다. 예시:
afshopapp://mainactivity
Adding URI scheme intent-filter to the main activity
메인 액티비티에 인텐트 필터를 추가하는 방법:
- 다음 앱 파일을 실행합니다:
AndroidManifest.xml
file. - 메인 액티비티에 다음 인텐트 필터를 추가합니다.
다음data
섹션에서host
andscheme
를 선택한 URI 스키마로 교체합니다. 아래의 인텐트 필터 코드에서host="mainactivity"
andscheme="afshopapp"
는 URI 스킴afshopapp://mainactivity
과 매치됩니다.
메인 액티비티에 이미 URI 스킴에 대한 인텐트 필터가 있는 경우, 이를 덮어씁니다.
<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
- 마케터와 함께 URI 스킴을 결정합니다.
Testing URI schemes
선행 조건:
앱을 설치한 안드로이드 디바이스가 필요합니다. 앱 링크 및/또는 URI 스킴을 변경하고 구현한 앱 소스 및 버전인지 확인합니다.
URI 스킴을 테스트하는 방법:
- 마케터에게 마케터가 생성한 사용자정의 링크를 문의하여 제공받습니다.
- 마케터가 제공한 짧은 URL 또는 긴 URL을 휴대폰으로 보냅니다. 다음 중 하나를 수행할 수 있습니다.
- 핸드폰 카메라나 QR 스캐너 앱으로 QR 코드를 스캔합니다.
- 링크를 이메일이나 WhatsApp을 통해 보낸 후 휴대폰으로 엽니다.
- 모바일 디바이스에서 링크를 클릭합니다.
앱이 실행되고 홈 화면에서 열립니다.
최신 데이터 8개월 전