iOS 초기 설정
요약: 초기 앱 설정을 통해 마케터는 기존 앱 사용자를 바로 앱으로 연결하는 링크를 생성합니다. 또한, 초기 앱 설정은 딥링킹과 디퍼드 딥링킹을 위한 선행 조건이 됩니다.
앱 시작 메서드
사용자 기반 전체를 다루기 위해 구현해야 하는 두 개의 앱 시작 메서드가 있습니다. 사용하기 위해 선택할 메서드 모바일 플랫폼 버전에 따라 달라집니다.
구현을 위한 두 가지 메서드 및 지침은 다음 섹션에 자세히 설명되어 있습니다.
방법 | 설명 | iOS 버전 | 절차 |
---|---|---|---|
유니버설 링크 | 기본 액티비티에서 직접 모바일 앱을 엽니다. 유니버설 링크는 일반 웹링크 형식입니다(예: https://yourbrand.onelink.me 또는 https://www.yourbrand.com) | iOS 9 및 그 이상 | |
URI 스킴 | URI 스킴에서 지정한 액티비티 경로에 기반하여 직접 앱을 시작합니다. | 모든 iOS 버전 |
iOS 유니버설 링크 절차
Getting the app bundle ID and prefix ID
- Apple 개발자 계정으로 로그인합니다.
- 왼쪽 메뉴에서 인증서, 식별자 및 프로필을 선택합니다.
- 식별자 아래에서 앱 ID를 선택합니다.
- 해당하는 앱을 클릭합니다.
- 접두사 ID와 앱 번들 ID를 복사합니다.
- 접두사 ID와 앱 번들 ID를 마케터에게 전달합니다.
마케터가 앱스플라이어 대시보드에서 사용해 앱을 등록합니다.
Enabling associated domains
앱에서 연결된 도메인을 지원하는 방법:
연관 도메인에 대한 iOS 지침을 따르십시오.
Configuring mobile apps to register approved domains
승인 도메인을 등록하기 위한 모바일 앱 구성은 Xcode 내에서 진행됩니다. 마케터가 생성한 원링크 하위 도메인이 필요합니다.
승인 도메인을 등록할 모바일 앱 구성 방법:
- 마케터로부터 원링크 서브도메인을 가져옵니다.
- Xcode에서 프로젝트를 클릭합니다.
- 프로젝트 대상을 클릭합니다(다음 스크린샷 참조).
- 역량(Capabilities) 탭으로 전환합니다.
- 연관 도메인을 활성화합니다.
- 마케터로부터 받은 하위 도메인을 추가합니다.
형식applinks:subdomain.onelink.me
.
도메인을 앱과 연결하려면 도메인에는 연결된 도메인 파일을 가지고 있어야 하며 앱에서는 적절한 자격을 가지고 있어야 합니다. 원링크가 생성되면 앱스플라이어가
apple-app-site-association file
.
When a user installs your app, the system attempts to download the associated domain file and verify the domains in yourAssociated Domains Entitlement
.
Universal Link limitations
브라우저에서 앱 열기
유니버설 링크는 클릭했을 경우에만 동작합니다. 예를 들어, 웹 페이지나 이메일에서 링크를 클릭하는 경우입니다. 브라우저의 주소 창에 링크를 붙여넣는 경우에는 앱으로 딥링크하지 않습니다.
원링크 서브 도메인
OneLink 하위 도메인은 언제나 변경할 수 있지만, 변경할 경우는 이전 하위 도메인을 사용하는 기존 OneLink URL의 동작이 멈추게 됩니다.
소셜 네트워크 앱에서의 OneLink
소셜 네트워크 앱을 포함한 모든 앱이 유니버설 링크를 완벽하게 지원하는 것은 아닙니다. 자세한 내용은 이 가이드를 참조하세요.
기타 제한 사항 및 문제
유니버설 링크에는 기타 다른 제한 사항이 있을 수 있습니다. 자세한 내용은 원링크 문제 해결하기를 참조하세요.
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
URI 스킴을 추가하는 방법:
- Xcode에서 앱 정보 plist 파일을 엽니다.
- URL type 항목을 추가합니다.
- URL type과 Item 0 행을 펼칩니다.
- 앱의 고유 식별자를 URL identifier의 값으로 추가합니다.
다른 앱에서 사용한 적이 없는 고유 식별자를 선택하는 것이 좋습니다. - URL 식별자를 마우스로 오른쪽 클릭하고, 행 추가 > URI 스킴을 선택합니다.
- 항목 0 값을 고유한 스킴으로 설정합니다.
Prerequisites:
앱을 설치한 iOS 기기입니다. 유니버설 링크 및 URI 스킴을 변경하고 구현한 앱 소스 및 버전인지 확인합니다.
Testing the URI scheme:
- 마케터에게 마케터가 생성한 사용자정의 링크를 문의하여 제공받습니다.
- 마케터가 제공한 짧은 URL 또는 긴 URL을 휴대폰으로 보냅니다. 다음 중 하나를 수행할 수 있습니다.
- 핸드폰 카메라나 QR 스캐너 앱으로 QR 코드를 스캔합니다.
- 링크를 이메일이나 WhatsApp을 통해 보낸 후 휴대폰으로 엽니다.
- 모바일 기기에서 링크를 클릭합니다. 앱이 실행되고 홈 화면에서 열립니다.
링크를 통해 앱을 열 수 없으면 파라미터 af_force_deeplink=true
를 커스텀 어트리뷰션 링크에 추가합니다. 예시:
https://demo.onelink.me/1aBC/123ab45c?af_force_deeplink=true
URI scheme limitations
Apple이나 Google에서는 앱 스킴에 대해 꼭 고유한 이름을 사용하도록 요구하지 않습니다. 다른 앱의 스킴 이름과 겹치는 것을 방지하려면 브랜드에 맞는 고유한 이름의 스킴을 선택하세요. 좋은 스킴 이름은 com.company.app과 같은 앱 번들 ID입니다.
원링크를 iOS와 안드로이드에서 모두 사용하려면 양쪽 플랫폼에서 같은 스킴을 정의하는 것이 중요합니다.
다음 af_force_deeplink=true
을 가진 원링크가 iOS 12.3.1에서 열리면 다음 논리가 적용됩니다.
- 사용자에게 앱 설치 여부를 묻는 대화상자가 나타납니다.
- 사용자가 확인(앱이 설치되어 있음)을 선택하면, 앱스플라이어는 URI 스킴을 사용하여 앱을 열려고 시도합니다.
- 사용자가 취소(앱이 설치되지 않음)를 선택하면, 앱스플라이어는 사용자를 앱 스토어로 리디렉션합니다.
- 사용자가 OK를 선택했지만 앱이 설치되지 않은 경우, 오류 메시지가 표시됩니다.
최신 데이터 약 1개월 전