유니버설 링크 FAQ
유니버설 링크에는 다양한 요소가 영향을 끼칩니다. 유니버설 링크의 테스트나 프로덕션 단계에서 예기치 못한 결과가 발생한 경우, 본 가이드를 참조하시기 바랍니다. 이후에도 문제가 지속되는 경우 연락주시기 바랍니다.
일반 문제
제 URL 신택스와 암호화가 정확한가요?
딥링크가 특정 목적지로 이동되지 않거나, HTTP 404 오류로 이어진다면 우선 URL 신택스와 인코딩을 확인하시기 바랍니다.
URL은 일반적으로 다음의 신택스를 사용합니다: scheme://host:port/path?query-string#fragment-id
URL의 모든 요소는 각기 다른 기능을 수행하며, 특정 문자를 사용해 값을 확인 및 구분합니다. 스킴과 호스트는 대소문자를 구별하지 않으나, path와 쿼리 문자열은 대소문자를 구별합니다. URL에 오류가 있으면 원하는 목적지로의 이동을 수행할 수 없게 됩니다.
딥링크를 설정할 때 아래의 요소에 주의하시기 바랍니다.
- Adjust 파라미터에 쿼리 파라미터를 포함한 URL 쿼리 문자열을 이미 추가한 경우,
&를 사용합니다. 그렇지 않은 경우, URL에서 두 번째?이후의 모든 정보가 삭제됩니다.- 올바른 예:
https://abcd.adj.st/my?path=location&client=name&adjust_t=klm012 - 올바르지 않은 예시:
https://z9pm.adj.st/my?path=location&client=name?adjust_t=klm012
- 올바른 예:
- 쿼리 문자열이 인코딩되어 있다면
/로 시작하거나,deeplink파라미터의 일부로 사용되도록 하시기 바랍니다.
앱이 아직 설치되지 않았고 이러한 요건이 충족되지 않은 경우, 브라우저에 의해 파라미터 adjust_t 가 포함되지 않습니다. Adjust가 클릭의 소스 위치를 파악하기 위해 본 파라미터가 필요합니다. 그렇지 않으면 HTTP 404 오류 URL not found 를 반환할 것입니다.
예시
URL의 설정 방식에 따라 설정된 딥링크는 다음의 행동 양식을 가질 수 있습니다.
| 딥링크 설정 | 링크 URL 예시 | 행동 |
|---|---|---|
링크 URL + deep_link 파라미터 | https://app.adjust.com/r40ncx7?deep_link=adjust%3A%2F%2F%3Fpath | 특정 인앱 페이지에서 앱을 실행합니다. |
| Universal link | https://abcd.adj.st/%3Fpath?adjust_t=r40ncx7 | 특정 인앱 페이지에서 앱을 실행합니다. |
| Universal link | https://abcd.adj.st/?path&adjust_t=r40ncx7 | 앱이 이미 설치되어 있으나 특정 인앱 페이지에 도달할 수 없는 경우 앱을 실행합니다. |
| Universal link | https://abcd.adj.st%3Fpath?adjust_t=r40ncx7 | 유효하지 않기 때문에 오류를 반환합니다. |
어트리뷰션 데이터 및 캠페인 레벨이 표시되지 않는 이유는 무엇인가요?
딥링크 URL에서 어트리뷰션 데이터나 캠페인 레벨을 사용할 수 없다면 설정 문제일 확률이 높습니다. 폴백이나 콜백의 인코딩 에러로 인하여 기기 ID 파라미터와 캠페인 파라미터(가능한 경우)에 잘림 현상이 발생하지 않았는지 확인하시기 바랍니다. 예를 들어, URL에 공백이 없거나 유효하지 않은 문자가 포함되어 있습니다.
앱이 설치되었는데도 왜 앱 스토어로 이동되나요?
일반적으로 이러한 상황은 딥링크가 앱을 여는 데 실패하여, 폴백으로서 스토어로 재이동한 경우입니다. 이를 테스트하기 위해서는 다음의 단계를 수행하시기 바랍니다.
유니버설 링크 와 deep_link 파라미터가 있는 링크에 대해서는 기존 사용자로 테스트한 설명서를 참조하시기 바랍니다.
테스트가 성공적이고 앱이 열린다면, 딥링크가 실패했을 때 어떠한 환경에서 딥링크가 클릭 되었는지 확인합니다. 그리고 해당 환경에 추가적인 파라미터가 필요한지 확인합니다.
- 예: Slack에서 JSR 유니버설 링크가 클릭된 경우
adjust_deeplink_js=1플래그가 있어야 합니다. 이는 스토어로 리다이렉트하기 전에 스킴을 로딩할 수 있도록 도와줍니다.adjust_deeplink_js플래그가 있는데도 링크가 작동하지 않는다면, 앱 스킴이 Campaign Lab에 올바르지 않게 입력된 경우입니다.
- 예: Slack에서 JSR 유니버설 링크가 클릭된 경우
링크 URL에서 폴백이나 콜백의 잘림 현상을 야기하는 인코딩 오류 가 없는지 확인하시기 바랍니다. 파라미터가 누락되면 전체 링크가 의도한 대로 작동하지 않을 것입니다.
왜 딥링크가 앱의 올바른 위치에서 열리지 않나요?
링크가 앱을 열었으나 정확한 목적지로 이동되지 않은 경우 문제의 원인이 링크인지 앱 설정과 관련된 것인지 확인하시기 바랍니다.
- 유니버설 링크 도메인(
https://abcd.adj.st/) 또는 스킴(myapp://)을 웹 환경에서 호스트하고 클릭합니다. - 개발팀에 연락하여 앱에서의 위치 값이 정확하게 설정됐는지 확인하시기 바랍니다.
Adjust는 Adjust 링크나 Adjust 파라미터가 추가된 딥링크에 대한 클릭 데이터를 수신합니다. 앱에 특화된 도메인으로만 구성된 다이렉트 딥링크는 Adjust에 그 어떤 데이터도 전송하지 않습니다.
클릭 데이터 전송:
myapp://welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1
https://z9pm.adj.st/welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1클릭 데이터 전송 안 함:
myapp://welcome이미 설치된 앱과 딥링크 리어트리뷰션에 대한 클릭 데이터를 수신하려면, Adjust SDK (iOS; Android)내에서 SDK 클릭을 구현하시기 바랍니다.
SDK 클릭을 트리거한 딥링크는 Datascape에서 클릭으로 보고됩니다. 이는 또한 click 콜백을 사용하여 로데이터에서 확인할 수 있습니다. 딥링크 SDK 클릭으로부터 어느 클릭이 발생했는지에 대해 보다 세분화된 정보를 확인하고 싶다면, {is_deeplink_click} 파라미터를 추가하시기 바랍니다.
유니버설 링크 관련 문제
유니버설 링크가 왜 설치된 앱을 열지 않나요?
유니버설 링크 설정이 올바르게 되었는지 확인하시기 바랍니다.
Apple이 링크를 여는 환경을 확인하시기 바랍니다. Apple에서는 Safari 외 환경에서 유니버설 링크로의 재이동이 허용되지 않습니다. 따라서, 웹 환경에서 로 유니버설 링크나 스킴을 호스트해야 합니다. 예:
https://abcd.adj.st/또는myapp://앱이 설치된 테스트용 기기에서 로 유니버설 링크나 스킴을 호스트한 페이지를 방문한 뒤 링크를 선택합니다.
앱 이 열리지 않는 경우:
- Safari에서 테스트용 HTML 페이지를 연 뒤 공유 아이콘을 선택합니다. "공유..." 메뉴에서 옵션 중 하나로 앱이 나타나야 합니다. 만약 앱이 목록에 있다면 Associated Domains 설정이 올바르게 되었으며, Apple App Site Association (AASA) 파일이 올바르게 다운로드된 것입니다. 만약 옵션에서 앱이 나타나지 않으면 앱을 삭제한 뒤 재설치하시기 바랍니다.
- 테스트와 프로덕션 환경에서 번들 ID가 동일한지 확인하시기 바랍니다.
- AppView에서 앱의 iOS 번들 ID와 App Prefix 가 올바른지 확인합니다. 올바른 설정 이후에도 앱이 열리지 않는 경우 개발자에게 연락하여 유니버설 링크 또는 스킴과 앱의 연결 상태를 검사하시기 바랍니다.
target=“_blank”속성이 링크의 일부인지 확인합니다.
이 경우 테스트 환경에서는 앱이 열리지만, 프로덕션 환경에서는 앱이 열리지 않을 수 있습니다.
예를 들어, target=“_blank” 속성을 사용하는 HTML 코드는 다음과 같이 나타납니다.
<a href="[https://abcd.adj.st](https://abcd.adj.st/)" target="_blank">Universal Link to App</a>
이러한 경우 다음과 같이 속성(attribute)값을 삭제하시기 바랍니다.
<a href="[https://abcd.adj.st](https://abcd.adj.st/)">Universal Link to App</a>
앱이 설치되었는데도 왜 앱 스토어로 이동되나요?
- 유니버설 링크 테스트 가이드를 확인하시기 바랍니다. 또한 상기 "유니버설 링크가 왜 설치된 앱을 열지 않나요?"에 나온 과정을 수행하시기 바랍니다.
- 유니버설 링크가 실패했을 때 어떠한 환경에서 클릭 되었는지 확인하시기 바랍니다. 그리고 해당 환경에 추가적인 파라미터가 필요한지 확인합니다.
- 예: Slack에서 JSR 유니버설 링크가 클릭된 경우
adjust_deeplink_js=1플래그가 있어야 합니다. 이는 스토어로 재이동하기 전에 스킴을 로딩할 수 있도록 도와줍니다.adjust_deeplink_js플래그가 있는데도 링크가 작동하지 않는다면, 앱 스킴이 AppView에서의 앱 설정에 올바르지 않게 입력될 수 있습니다.
- 예: Slack에서 JSR 유니버설 링크가 클릭된 경우
설치 이후 왜 딥링크와 디퍼드 딥링크가 올바른 위치에서 열리지 않나요?
링크가 앱을 열었으나 정확한 목적지로 이동되지 않은 경우 문제의 원인이 링크인지 앱 설정과 관련된 것인지 확인하시기 바랍니다.
- 유니버설 링크 도메인(
https://abcd.adj.st/) 또는 스킴(myapp://)을 웹 환경에서 호스트하고 클릭합니다. - 개발팀에 연락하여 앱에서의 위치 값이 정확하게 설정됐는지 확인하시기 바랍니다.
기존 유저 테스트에서는 올바른 경로에 이동하였으나 신규 유저 테스트는 제대로 작동하지 않은 경우, 테스팅 콘솔을 통해 기기를 검사하고 클릭에 어트리뷰션 되었는지 확인하시기 바랍니다. 만약 어트리뷰션이 되지 않은 경우, 테스팅 콘솔을 통해 기기를 삭제하고 다시 시도하시기 바랍니다.
클릭에 어트리뷰션이 된 경우, 사용자의 디바이스를 검사하고 deeplink 파라미터가 포함되어 있는지 확인하시기 바랍니다. 만약 액세스할 수 없는 경우, deeplink 파라미터 전에 URL 잘림 현상을 야기하는 인코딩 문제나 특수 문자가 있는지 확인하시기 바랍니다.
마지막으로, deeplink 파라미터가 포함되어 있다면, path이 보이는지 확인하시기 바랍니다. 위치 값이 보이지 않는다면 다른 이유에 의해 딥링크 위치 값이 잘린 것입니다. 추가 지원이 필요하신 경우 support@adjust.com 에 연락하시기 바랍니다.
유니버설 링크가 왜 Facebook이나 Instagram 포스트에서 작동되지 않나요?
유니버설 링크에 위치 값이 추가됐는지 확인하시기 바랍니다. 그렇지 않은 경우라면 앱이 설치되었더라도 유저는 스토어로 이동될 것입니다. 위치 값은 유효하지 않아도 됩니다.
위치 값이 추가된 파라미터 예: https://abcd.adj.st/path?adjust_t=abc123
이메일 캠페인에 유니버설 링크를 사용할 수 있나요?
대부분의 경우 iOS는 Safari 외 환경에서 유니버설 링크로의 리디렉션을 허용하지 않습니다. 즉, SFSafariViewController를 사용하는 모든 환경이 영향을 받게 됩니다.
유니버설 링크를 지원하지 않는 브라우저나 기타 이메일 앱 등 이메일이 열릴 수 있는 환경은 매우 다양합니다. 따라서 JSR 링크를 사용하거나, 더 이상적으로는 Adjust의 ESP 연동을 사용하는 것이 좋습니다.
어트리뷰션 데이터 및 캠페인 레벨이 왜 안 보이나요?
Adjust 파라미터의 접두사가 adj_ 또는 adjust_ 인지 확인하시기 바랍니다. adj_ 나 adjust_ 접두사가 없는 Adjust 파라미터는 모두 포함되지 않으며, 해당 파라미터로부터의 데이터를 확인하지 못할 수 있습니다.
설치가 올바르게 어트리뷰션 되었는데도 왜 파트너가 어트리뷰션된 콜백을 수신하지 못하나요?
- 유니버설 링크에 클릭 ID 파라미터를 추가했는지 확인하시기 바랍니다.
- 링크 URL에서 폴백이나 콜백의 잘림 현상을 야기하는 인코딩 오류 가 없는지
- 클릭 ID 파라미터가
adj_또는adjust_를 접두사로 사용하는지 확인하시기 바랍니다.
iOS 12.2와 12.3 Safari에서 왜 JSR 유니버설 링크 문제가 발생하나요?
iOS 12.2와 12.3의 경우 JSR 유니버설 링크가 Sarafi 환경에서 클릭 되었을 때 링크가 잘 열리지 않는 상황이 발생할 수 있습니다. 이는 특히 incognito 모드의 사용과 같이 리퍼러 HTTP 헤더를 읽을 수 없는 경우 발생합니다.
따라서 Safari 캠페인의 경우 로(raw) 유니버설 링크를 사용하는 것을 권고합니다. 그러나 이 방식은 래핑된 URL이 있는 이메일 캠페인에서는 작동하지 않습니다.
iOS 13+부터는 스킴에 폴백을 적용할 수 있기 때문에 이 문제가 발생하지 않습니다. 하지만 이는 추가적인 팝업을 야기합니다.