요약: 이 가이드는 기존 앱 사용자를 리타겟팅하여 앱 내 특정 페이지로 리디렉션하는 링크를 만드는 법을 설명합니다. 앱을 이미 설치한 사람은 이 링크를 클릭하면 앱스토어나 앱 홈 화면이 아니라 바로 특정 화면을 보게 됩니다. 기존 사용자가 링크를 클릭하면 리타겟팅 어트리뷰션이 됩니다.
![]() |
![]() |
![]() |
![]() |
작업 범위
직무별 작업
일러두기: 이 가이드는 마케터가 개발자와 협력하는 경우와 방법에 대해 설명합니다. |
선행 조건
|
소요 시간 마케터와 모바일 개발자가 협업하여 약 3시간 (지원되는 활용 사례에 따라 상이) |
작업 결과 In OneLink 2/4 you created a custom link, that sends existing users to open your app. OneLink 3/4 covers how to send existing app users who click your link directly to specific content in your app. To do this, you will use the deep linking data from AppsFlyer's SDK. |
예시
마케터인 철수는 페이스북 포스트(이전 가이드 예시 참조)로 기존 앱 사용자가 앱으로 돌아오는 성과를 약간 냈습니다. 그러나 페이스북에 게재된 링크를 클릭한 사람들 중에서, 구매로 전환하는 사람들은 별로 없었습니다.
철수는 전환율을 높이기 위해 앱으로 구매를 할 때마다 복숭아, 사과, 아보카도 꾸러미를 무료로 주는 행사를 하기로 했습니다. 이 행사를 알리기 위해, 기존 앱 사용자를 위한 딥링크를 만들었습니다. 그리고 기존 모바일 앱 사용자에게 앱으로 구매하면 3가지 몸에 좋은 과일을 무료로 제공한다는 프로모션 메일을 보냅니다.
메일에 언급된 각 과일마다 (앱 개발팀의 도움을 받아) 원링크로 작동하는 딥링크를 걸어,
- (모바일 OS에 상관없이) 앱을 설치한 기존 사용자는 해당 과일 페이지에 바로 이동하도록 합니다.
- 앱이 없는 신규 사용자는 사용하는 디바이스에 따라 적절한 앱스토어나 랜딩 페이지로 이동합니다.
철수는 추가 개발 작업 없이 더 많은 링크를 만들어 다른 상품 페이지로 딥링킹할 수 있습니다.
절차
커스텀 링크를 만드려면, 파라미터와 파라미터 값을 정해야 합니다. 모바일 사용자가 커스텀 링크를 클릭하면, 앱스플라이어는 그 파라미터와 파라미터 값을 앱의 내부 코드에 전달합니다.
모바일 개발자가 작성한 앱 코드는 앱과 (연동되어 있으면) 연동되어 있는 앱스플라이어 SDK를 통해 파라미터 정보를 수신하고 앱이 특정 동작을 하도록 합니다. 예를 들어, 특정 페이지로 이동하도록 합니다.
다음 절차에 따라 파라미터와 파라미터 값으로 앱을 설치한 iOS 혹은 안드로이드 앱 사용자를 앱 내 특정 콘텐츠로 이동시키는 커스텀 링크를 만드십시오.
1. 커스텀 딥링크 만들기
커스텀 딥링크 만들기
- Contact your iOS and Android developers to plan the deep_link_value to set on your links.
- The deep_link_value is the value name for the specific in-app content that users will be directed to. The developers implement the desired behavior of the deep_link_value in the code.
-
Share this guide with the developers to understand the technical flow and see examples.
Tip
The marketer and developers need to decide together on the best long term system for the deep_link_value (and any other parameters/values) to minimize additional app updates.
The deep_link_value can be based on a SKU, post ID, path, or anything else. We strongly recommend agreeing with your developers on a system that allows for you to enter dynamic values on your chosen parameter, so you can generate many different deep links that go to different content within the app, without any further changes to the app code by the developers.
See the following URL examples. The deep_link_value of a fruit type was chosen by the marketer and developer together. And the developers made the values dynamic, so the marketer could enter any fruit without the need for further work by the dev team.
https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=apples...
https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=bananas...
https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=peaches...
- After receiving confirmation from the developers that the app behaves according to the selected parameters and values, in the AppsFlyer dashboard, go to Engagement & deep linking > OneLink Custom Links.
- Click the link you created in the previous guide.
The Custom attribution link page opens. - In the Redirecting & deep linking tab, enter the deep_link_value according to what you decided with the developers.
- [Optional] If your deep linking requires more than one in-app experience (for example, you want to direct users to a product, and separately offer them a discount), you can add or customize other parameters and values to set on your links. This will add those parameters to the deep linking data payload.
- Contact your iOS and Android developers to plan the parameter names and values.
- The developers implement the desired behavior in the code. Share this guide with the developers to understand the technical flow and see examples.
- In the Attribution tab, enter the parameters and values according to what you decided with the developers.
- Click Update link.
참고
개발자가 파라미터와 동적 값을 구현하면, 마케터는 원링크 API를 사용하여 커스텀 링크를 수천 개 자동 생성할 수 있습니다. 더 알아보기
2. 테스트하기
선행 조건:
앱을 설치한 안드로이드 및/또는 iOS 디바이스 개발자가 변경 작업을 한 앱 소스와 앱 버전의 앱이 설치되어 있는지 확인합니다.
링크 테스트하기
- 앱스플라이어 대시보드에서 인게이지먼트 & 딥링킹 < 원링크 커스텀 링크로 갑니다.
- 테스트하고자 하는 링크의 액션 아이콘을 클릭하고 URL얻기를 클릭합니다.
- 핸드폰으로 숏링크 URL이나 롱링크 URL을 보냅니다. QR 코드를 확인합니다.
- 핸드폰 카메라나 QR 스캐너 앱으로 QR 코드를 스캔합니다.
-
링크를 이메일이나 WhatsApp으로 보내고 핸드폰으로 링크를 엽니다.
주의: iOS 노트로 붙여넣기를 하거나 모바일 브라우저에 바로 붙여넣지 마십시오. 이런 경우, 모바일 OS가 의도적으로 앱을 열지 않을 수 있습니다.
-
모바일 디바이스에서 링크를 클릭합니다.
앱이 실행되고 링크 파라미터에서 설정한 특정 콘텐츠가 보여야 합니다. - Go to the AppsFlyer Retargeting dashboard.
Look for a new click and re-engagement (app open) under your link's media source (e.g. test) and the campaign name you put in the URL.
Link not behaving as expected? Check out our troubleshooting guide.
이 문서에 있는 절차를 모두 완료하셨다면, 축하합니다! 지금 만든 링크를 앱을 설치한 기존 앱 사용자가 클릭하면, 앱 내 특정 콘텐츠로 바로 이동하며 리타겟팅 어트리뷰션 데이터를 받아보실 수 있습니다.
- 다음 단계로 넘어가기
딥링킹 FAQ
What app-launching methods should be implemented?
링크 템플릿에 안드로이드와 iOS 앱이 둘 다 있다면, 다음 세 가지 방식을 모두 구현하는 것이 좋습니다.
- 유니버설 링크: iOS 사용자를 거의 100% 지원합니다. 원링크 템플릿에 iOS 앱이 있다면, 유니버설 링크를 구현하십시오.
- 안드로이드 앱 링크: 안드로이드 사용자의 85% 이상을 지원하며, 안드로이드 6.0부터 사용할 수 있습니다. 원링크 템플릿에 안드로이드 앱이 있다면, 안드로이드 앱 링크를 구현하십시오.
-
URI 스킴:
- 안드로이드 OS 버전이 6.0 아래여서 안드로이드 앱 링크를 사용할 수 없는 안드로이드 유저의 15% 이하를 지원합니다.
- 유니버설 링크와 안드로이드 앱 링크가 작동하지 않을 경우 대체 옵션으로, 안드로이드 6.0 아래 사용자를 위해 구현해야 합니다.
- 안드로이드 앱 링크가 구현되지 않은 경우, 모든 안드로이드 사용자를 위해 사용될 수 있습니다. 그러나 보안과 속도 문제로 권장하지 않습니다.
이 세 방식 모두 앱이 설치된 경우 앱을 바로 실행할 수 있도록 하지만 앱 내 특정 콘텐츠로 이동시키는 딥링킹을 하지는 않습니다.
What deep linking methods should be implemented?
모바일 앱 개발자는 OS에 따라 딥링킹 메서드를 하나씩 구현해야 합니다.
Universal Links and Android App Links are app-launching methods, which don't actually deep link users (sending them to specific content within the app). The URI scheme method can launch the app and deep link users (via the af_dp custom link parameter), but it should only be configured for app-launching. Its main usage is as a fallback method for UL and AAL, and for app-launching users with Android OS versions prior to 6.0.
위 세 가지 메서드 중 하나로 앱이 실행되면, 앱스플라이어 SDK는 커스텀 어트리뷰션 링크에 명시된 딥링킹 값을 제공합니다. 이 값은 모바일 앱 개발자들이 구현한 싱글 딥링킹 메서드(method)로 전달됩니다.
URI 스킴 예
URI 스킴 값은 커스텀 링크의 af_db 파라미터에 배치됩니다. URI 스킴 값은 앱 실행에 필요한 기본 URI만 포함해야 합니다. 딥링킹 값에는 af_sub1 같은 다른 파라미터가 있어야 합니다.
좋은 예: af_dp=greatapp%3A%2F%2F&af_sub1=param1%2Fparam2 (af=greatapp://&af_sub1=param1/param2)
나쁜 예: af_dp=greatapp%3A%2F%2Fparam1%2Fparam2 (af=greatapp://param1/param2)
Can URI scheme (af_dp parameter) be used for deep linking?
Ideally, you should use the deep_link_value for deep linking, and the URI scheme as a fallback method to launch the app (via the af_dp custom link parameter) without deep linking. However, if you already have the URI scheme set up to deep link, there is no need to change your existing configuration or code; it will work.
다음 단계
앱을 처음 설치하는 신규 사용자가 커스터 링크를 클릭하면 어떤 경험을 하게 될까요?
원링크 가이드 4부에서는 디퍼드 딥링킹(deferred deep linking)을 이용해 앱을 처음 설치하는 사용자에게 기존 앱 사용자와 동일한 딥링킹 경험을 제공하는 방법을 배웁니다. 디퍼드 딥링킹은 앱이 없는 사람이 원링크를 클릭했을 때 앱스토어로 이동시키고 앱을 다운받으면 바로 앱 내 특정 콘텐츠를 보여주는 기술입니다.