가이드

iOS 초기 설정

수정 제안하기

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

앱 시작 메서드

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

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

방법설명iOS 버전절차
유니버설 링크기본 액티비티에서 직접 모바일 앱을 엽니다. 유니버설 링크는 일반 웹링크 형식입니다(예: https://yourbrand.onelink.me 또는 https://www.yourbrand.com)iOS 9 및 그 이상
  1. 앱 번들 ID와 접두사 ID를 받기.
  2. 연관 도메인을 활성화합니다.
URI 스킴URI 스킴에서 지정한 액티비티 경로에 기반하여 직접 앱을 시작합니다.모든 iOS 버전
  1. 마케터와 함께 URI 스킴을 결정합니다.
  2. 연관 도메인을 활성화합니다.
  3. 테스트

iOS 유니버설 링크 절차

Getting the app bundle ID and prefix ID

  1. Apple 개발자 계정으로 로그인합니다.
  2. 왼쪽 메뉴에서 인증서, 식별자 및 프로필을 선택합니다.
  3. 식별자 아래에서 앱 ID를 선택합니다.
  4. 해당하는 앱을 클릭합니다.
  5. 접두사 ID와 앱 번들 ID를 복사합니다.
  6. 접두사 ID와 앱 번들 ID를 마케터에게 전달합니다.
    마케터가 앱스플라이어 대시보드에서 사용해 앱을 등록합니다.
    certs_apple_info!

Enabling associated domains

앱에서 연결된 도메인을 지원하는 방법:

Follow the iOS instructions to add the associated domains entitlement to your app.

Configuring mobile apps to register approved domains

승인 도메인을 등록하기 위한 모바일 앱 구성은 Xcode 내에서 진행됩니다. 마케터가 생성한 원링크 하위 도메인이 필요합니다.

승인 도메인을 등록할 모바일 앱 구성 방법:

  1. 마케터로부터 원링크 서브도메인을 가져옵니다.
  2. Xcode에서 프로젝트를 클릭합니다.
  3. 프로젝트 대상을 클릭합니다(다음 스크린샷 참조).
  4. 역량(Capabilities) 탭으로 전환합니다.
  5. 연관 도메인을 활성화합니다.
  6. 마케터로부터 받은 하위 도메인을 추가합니다.
    형식 applinks:subdomain.onelink.me.

xcode-associated-domains!

📘

To associate a domain with your app, you need to have the associated domain file on your domain and the appropriate entitlement in your app. Once the redirection logic for existing app users is added to the OneLink template configuration, AppsFlyer hosts the 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 your Associated Domains Entitlement.

Universal Link limitations

브라우저에서 앱 열기

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

원링크 서브 도메인

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

소셜 네트워크 앱에서의 OneLink

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

기타 제한 사항 및 문제

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

URI 스킴 절차

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

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

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

Deciding on a URI scheme

URI 스킴을 결정하는 방법:

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

📘

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

Adding URI scheme

URI 스킴을 추가하는 방법:

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

info_list_uri_schemes!

Prerequisites:

앱을 설치한 iOS 기기입니다. 유니버설 링크 및 URI 스킴을 변경하고 구현한 앱 소스 및 버전인지 확인합니다.

Testing the URI scheme:

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

링크를 통해 앱을 열 수 없으면 파라미터 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를 선택했지만 앱이 설치되지 않은 경우, 오류 메시지가 표시됩니다.

uri_cannot_open_page!

최신 데이터 5개월 전