딥링크 FAQ
딥링크에는 다양한 요소가 영향을 끼칩니다. 딥링크의 테스트나 프로덕션 단계에서 예기치 못한 결과가 발생한 경우, 본 가이드를 참조하시기 바랍니다. 이후에도 문제가 지속되는 경우, support@adjust.com에 연락주시기 바랍니다.
일반 문제
제 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} 파라미터를 추가하시기 바랍니다.
링크 + deep_link 파라미터를 통한 딥링크 문제 해결
딥링크가 왜 Facebook 포스트에서 작동되지 않나요?
페이스북 포스팅으로 진행되는 캠페인은 deeplink 파라미터가 추가된 Adjust 링크 URL을 사용해야 합니다. 또한, deeplink 파라미터에는 path가 반드시 추가되어야 합니다. path가 추가되지 않은 경우에는 앱이 설치되어 있더라도 스토어로 이동하게 됩니다. 위치 값은 유효하지 않아도 됩니다.
위치 값이 추가된 파라미터 예: https://app.adjust.com/abc123?deeplink=adjust%3A%2F%2Fsuch_path
디퍼드 딥링크 문제 해결
설치 이후 왜 디퍼드 딥링크가 올바른 위치에서 열리지 않나요?
앱 설치 후 디퍼드 딥링크가 앱 내에서 올바르게 작동하지 않는 경우, 우선 해당 경로가 실제로 존재하는지 확인하시기 바랍니다. 웹 환경에서 스킴(myapp://)을 호스트하고, 문제를 야기하는 요인이 링크인지 앱 설정인지를 확인하기 위해 클릭합니다. 개발팀에 연락하여 앱에서의 위치 값이 정확하게 설정됐는지 확인하시기 바랍니다.
기존 유저 테스트에서는 올바른 경로에 이동하였으나 신규 유저 테스트는 제대로 작동하지 않은 경우, 테스팅 콘솔을 통해 기기를 검사하고 클릭에 어트리뷰션 되었는지 확인하시기 바랍니다. 만약 어트리뷰션이 되지 않은 경우, 테스팅 콘솔을 통해 기기를 삭제하고 다시 시도하시기 바랍니다.
클릭에 어트리뷰션이 된 경우, 기기를 검사하고 deeplink 파라미터를 포함하고 있는지 확인하시기 바랍니다. 액세스가 불가능한 경우, deeplink 파라미터 전에 URL 잘림 현상을 야기하는 인코딩 문제나 특수 문자가 있는지 확인하시기 바랍니다.
마지막으로, deeplink 파라미터가 포함되어 있다면, path가 있는지 확인하시기 바랍니다. 위치 값이 없다면 다른 이유에 의해 딥링크 위치 값이 잘린 것입니다. 지원이 필요하신 경우 support@adjust.com 에 연락하시기 바랍니다.