iOS initial setup

At a glance: The initial app setup enables the marketer to create links that send existing app users directly into the app. The initial setup is also a prerequisite for deep linking and deferred deep linking.

앱 시작 메서드

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

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

방법설명iOS 버전절차
유니버설 링크Directly opens the mobile app at the default activity. Universal Links take the format of regular web links (e.g. https://yourbrand.onelink.me or 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. On the left-hand menu, select Certificates, Identifiers & Profiles.
  3. Under Identifiers, select App IDs.
  4. 해당하는 앱을 클릭합니다.
  5. 접두사 ID와 앱 번들 ID를 복사합니다.
  6. Give the prefix ID and app bundle ID to your marketer.
    The marketer will use it in the AppsFlyer dashboard to register the app.
    certs_apple_info!

Enabling associated domains

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

Follow the iOS instructions for associated domains.

Configuring mobile apps to register approved domains

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

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

  1. 마케터로부터 원링크 서브도메인을 가져옵니다.
  2. Xcode에서 프로젝트를 클릭합니다.
  3. Click on the project target (see the screenshot that follows).
  4. Switch to the Capabilities tab.
  5. Turn on Associated Domain.
  6. Add the subdomain that you got from your marketer.
    The format is 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 OneLink is created, AppsFlyer hosts the apple-app-site-association file. You can test the Universal Links configuration using the [AppsFlyer link validator].(https://www.appsflyer.com/tools/link-validator/).
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. 마케터 및 안드로이드 개발자와 협업합니다.
  2. URI 스킴을 하나 선택합니다. 예시: yourappname://

📘

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

Adding URI scheme

URI 스킴을 추가하는 방법:

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

info_list_uri_schemes!

Prerequisites:

An iOS device with the app installed. Make sure it is the app source and version where you made changes and implemented Universal Links and URI schemes.

Testing the URI scheme:

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

If the link doesn't open the app, add the parameter af_force_deeplink=true to the custom attribution link. For example:

https://demo.onelink.me/1aBC/123ab45c?af_force_deeplink=true

URI scheme limitations

Neither Apple nor Google enforces unique naming for app schemes. Choose a scheme name unique to your brand to avoid conflicting schemes across different applications. A good scheme name could be your app bundle ID, for example: com.company.app.

To enable OneLink to serve both iOS and Android, it's important that the same scheme be defined for both platforms.

When a OneLink that has af_force_deeplink=true is opened in iOS 12.3.1, the following logic applies:

  • 사용자에게 앱 설치 여부를 묻는 대화상자가 나타납니다.
    • If the user chooses OK (app is installed), AppsFlyer attempts to open the app using URI scheme.
    • If the user chooses Cancel (app is not installed), AppsFlyer redirects the user to the app store.
    • 사용자가 OK를 선택했지만 앱이 설치되지 않은 경우, 오류 메시지가 표시됩니다.

uri_cannot_open_page!