안드로이드 초기 설정

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

앱 시작 메서드

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

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

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

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

안드로이드 앱 링크는 안드로이드 V6 이상에서 작동합니다. 더 자세히 알아보세요.

Generating a SHA256 fingerprint while in development

  1. 앱의 키 저장소를 찾습니다.
    앱이 아직 개발 중이라면 다음으로 이동합니다: debug.keystore
    • 윈도우즈 사용자: C:\Users\USERNAME\.android\debug.keystore
    • 리눅스 또는 맥 OS 사용자: ~/.android/debug.keystore
  2. 명령행을 열고 키스토어 파일이 위치한 폴더로 이동합니다.
  3. 다음 명령을 실행합니다.
// 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                    
 ]
]
  1. SHA256을 다시 마케터에게 전송합니다.

Generating a SHA256 fingerprint while in production

The SHA256 fingerprint is generated in

  1. In Google Play console Find the public SHA256 fingerprint in Setup -> App signing (see image below)

Google Play SHA256 cert!

  1. SHA256을 다시 마케터에게 전송합니다.

Adding App Link intent-filter to main activity

  1. 마케터로부터 자동 생성된 인텐트 필터 코드를 가져옵니다. 인텐트 필터 코드는 AndroidManifest.XML에서 사용됩니다.
  2. 다음 앱 파일을 실행합니다: AndroidManifest.xml file.
  3. 메인 액티비티에 인텐트 필터를 추가합니다.
    메인 액티비티에 이미 안드로이드 앱 링크에 대한 인텐트 필터가 있는 경우, 이를 덮어씁니다.

<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

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

URI 스킴 절차

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

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

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

Deciding on a URI scheme

URI 스킴을 결정하는 방법:

  1. Contact the marketer.

  2. URI 스킴을 하나 선택합니다. 예시: yourappname://

    ℹ️

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

Adding URI scheme intent-filter to the main activity

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

  1. 다음 앱 파일을 실행합니다: AndroidManifest.xml file.
  2. 메인 액티비티에 다음 인텐트 필터를 추가합니다.
    다음 data 섹션에서 host and scheme 를 선택한 URI 스키마로 교체합니다. 아래의 인텐트 필터 코드에서 host="mainactivity" and scheme="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

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

Testing URI schemes

선행 조건:

앱을 설치한 안드로이드 디바이스가 필요합니다. 앱 링크 및/또는 URI 스킴을 변경하고 구현한 앱 소스 및 버전인지 확인합니다.

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

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