딥링크 FAQ
테스트 또는 프로덕션 단계에서는 다양한 요소가 딥링크의 작동 방식에 영향을 줄 수 있습니다. 본 페이지를 통해 Adjust 딥링크, 유니버설 링크, 디퍼드 딥링크에서 자주 발생하는 문제를 해결하시기 바랍니다. 이후에도 문제가 지속되는 경우, support@adjust.com에 연락주시기 바랍니다.
일반적인 딥링크 문제
딥링크가 원하는 목적지로 이동하지 않거나 HTTP 404 URL을 찾을 수 없음 오류를 반환하는 경우, 우선 URL 신택스와 암호화를 확인하시기 바랍니다.
URL은 일반적으로 다음의 구조를 사용합니다: scheme://host:port/path?query-string#fragment-id
URL의 각 부분은 특정 기능을 갖고 있습니다. 스킴과 호스트는 대소문자를 구별하지 않으나, path와 쿼리 문자열은 대소문자를 구별합니다. URL 구조에 오류가 있으면 링크가 제대로 열리지 않을 수 있습니다.
딥링크 설정 시:
- Adjust 파라미터에 쿼리 파라미터를 포함한 URL 쿼리 문자열을 이미 추가한 경우,
&를 사용하시기 바랍니다. 두 번째?이후의 정보는 누락될 수 있으므로 두 번째?를 추가하지 마시기 바랍니다. - 쿼리 문자열이 인코딩되어 있다면
/로 시작하거나,deeplink파라미터의 일부로 사용되도록 하시기 바랍니다. - 폴백, 콜백, 기기 ID 파라미터, 캠페인 파라미터에 공백이나 유효하지 않은 문자가 포함되지 않았는지 확인하시기 바랍니다. 인코딩 문제로 인해 파라미터가 잘릴 수 있습니다.
올바른 예:
https://example.go.link/my?path=location&client=name&adjust_t=klm012
잘못된 예시:
https://example.go.link/my?path=location&client=name?adjust_t=klm012
앱이 설치되지 않았고 URL의 구조가 올바르지 않은 경우, 브라우저가 adjust_t 파라미터를 삭제할 수 있습니다. Adjust는 클릭 소스 식별을 위해 이 파라미터가 필요합니다. 값이 없는 경우 Adjust는 404 URL not found를 반환합니다.
이는 일반적으로 딥링크가 앱을 여는 데 실패하여 사용자가 폴백으로서 스토어로 리디렉션되었음을 의미합니다.
문제 해결 방법:
- 기존 사용자로 링크를 테스트합니다.
- 테스트 중 앱이 열리면, 링크가 처음에 실패한 환경을 확인하시기 바랍니다.
- 유니버설 링크/Android 앱 링크/커스텀 앱 스킴 설정이 올바른지 확인합니다.
- 폴백이나 콜백에 파라미터가 누락되거나 링크가 깨질 수 있는 인코딩 오류가 없는지 확인하시기 바랍니다.
링크가 앱은 열리지만 올바른 인앱 화면은 열리지 않는 경우, 문제의 원인이 링크 설정인지 앱 설정인지 확인하시기 바랍니다.
딥링크를 웹 환경에서 호스트하고 테스트 기기에서 엽니다. 브랜드 도메인을 사용하는 경우 브랜드 링크를 직접 테스트하시기 바랍니다. 레거시 Adjust adj.st 링크를 사용하는 경우, 유니버설 링크 도메인(예: https://abcd.adj.st/ 또는 앱 스킴(예: myapp://을 테스트할 수 있습니다.
앱이 열렸지만 경로가 잘못된 경우 개발자에게 인앱 경로가 올바르게 구성되었는지 확인하도록 요청하시기 바랍니다.
참고: adj.st 유니버설 링크는 기존 방식입니다. Adjust는 신규 도입 시 브랜드 도메인을 사용하는 것을 권장합니다.
어트리뷰션 리포트 과정
아니요. 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설치된 앱과 딥링크 리어트리뷰션에 대한 클릭 데이터를 수신하려면 iOS 또는 Android용 Adjust SDK에서 SDK 클릭을 구현하시기 바랍니다. SDK 클릭을 트리거하는 딥링크는 Datascape에서 클릭으로 보고되며, 클릭 콜백을 통해 로데이터에서 볼 수 있습니다.
딥링크 SDK 클릭에서 발생한 클릭을 식별하려면 {is_deeplink_click} 플레이스홀더를 포함합니다.
딥링크 URL에서 어트리뷰션 데이터나 캠페인 레벨을 사용할 수 없다면 설정 문제일 확률이 높습니다. 폴백이나 콜백의 인코딩 에러로 인하여 기기 ID 파라미터와 캠페인 파라미터(가능한 경우)에 잘림 현상이 발생하지 않았는지 확인하시기 바랍니다. 예를 들어, URL에 공백이 없거나 유효하지 않은 문자가 포함되어 있습니다.
유니버설 링크 문제
설치가 올바르게 어트리뷰션 되었으나 파트너가 어트리뷰션된 콜백을 수신하지 못하는 경우, 유니버설 링크 설정을 확인하시기 바랍니다.
다음을 확인하시기 바랍니다.
클릭 ID 파라미터가 유니버설 링크에 추가됩니다. 폴백이나 콜백에는 암호화 오류가 없습니다. 클릭 ID 파라미터가 adj_ 또는 adjust_ 접두사를 사용하는지 확인하시기 바랍니다.
클릭 ID가 없거나, 형식이 잘못되었거나, 인코딩 문제로 인해 잘린 경우, Adjust는 설치를 어트리뷰션하지만 필요한 파트너 콜백 데이터를 전송하지 못할 수 있습니다.
우선 유니버설 링크가 올바르게 설정되었는지 확인합니다.
그런 다음 Apple이 링크를 여는 위치를 확인합니다. Apple은 Safari 외부의 유니버설 링크로의 리다이렉트를 허용하지 않기 때문에, 웹 환경에서 미가공 유니버설 링크나 스킴을 호스트하고 이를 클릭해야 합니다.
앱이 여전히 열리지 않는 경우:
- Safari에서 테스트용 HTML 페이지를 연 뒤 공유 아이콘을 선택합니다. 앱 목록에 "Open in..." 옵션이 표시되면 연결된 도메인 구성이 올바르고 Apple 앱 사이트 연결 파일이 다운로드된 것입니다.
- 앱이 목록에 없다면 앱을 삭제하고 재설치하시기 바랍니다.
- 번들 ID가 테스트 및 프로덕션 환경에서 동일한지 확인합니다.
- AppView에서 iOS 번들 ID와 App Prefix가 올바른지 확인합니다.
- 여전히 앱이 열리지 않는 경우, 개발자에게 유니버설 링크 또는 스킴 앱 연결을 조사하도록 요청하시기 바랍니다.
또한 링크가 target="_blank" 를 포함하는지 확인하시기 바랍니다. 테스트에서는 효과가 있으나 프로덕션 환경에서는 작동하지 않을 수 있습니다. 링크에서 어트리뷰션을 삭제합니다.
유니버설 링크가 path를 포함하는지 확인하시기 바랍니다. 경로가 추가되지 않은 경우, 앱이 설치된 경우에도 사용자는 스토어로 이동될 수 있습니다. 경로가 유효하지 않아도 됩니다.
대부분의 경우 iOS는 Safari 외 환경에서 유니버설 링크로의 리디렉션을 허용하지 않습니다. 즉, SFSafariViewController를 사용하는 모든 환경이 영향을 받게 됩니다.
이메일 링크는 유니버설 링크를 지원하지 않는 브라우저나 이메일 앱 등 다양한 환경에서 열릴 수 있기 때문에, JSR 링크 또는 Adjust ESP 연동 사용을 권장합니다.
딥링크 파라미터가 있는 딥링크
페이스북 포스팅으로 진행되는 캠페인은 deeplink 파라미터가 추가된 Adjust 링크 URL을 사용해야 합니다. 딥링크 파라미터는 반드시 path를 포함해야 합니다. 그렇지 않은 경우라면 앱이 설치되었더라도 유저는 스토어로 이동될 것입니다. 경로가 유효하지 않아도 됩니다.
예시: https://app.adjust.com/abc123?deeplink=adjust%3A%2F%2Fsuch_path
디퍼드(Deferred) 딥링크
디퍼드 딥링크는 사용자가 앱을 설치하기 전에 딥링크를 클릭하는 경우 사용됩니다. 설치 이후 앱은 의도된 인앱 위치로 열립니다.
디퍼드 딥링크가 올바른 위치로 열리지 않는 경우:
- 앱에 path가 존재하는지 확인합니다.
- 웹 환경에서 앱 스킴(예:
myapp://)을 호스트하고 클릭합니다. - 기존 사용자에 대한 경로가 작동하지 않는 경우 개발자에게 인앱 경로가 올바르게 설정되었는지 확인하도록 요청하시기 바랍니다.
- 기존 사용자에 대해서는 경로가 작동하지만 신규 사용자에 대해서는 작동하지 않는 경우, 테스팅 콘솔 에서 기기를 검사하여 클릭에 어트리뷰션되었는지 확인하시기 바랍니다.
- 기기가 어트리뷰션되지 않은 경우, 테스팅 콘솔에서 기기를 삭제하고 다시 테스트하시기 바랍니다.
- 디바이스가 어트리뷰션된 경우, 디바이스가
deeplink파라미터를 포함하는지 확인합니다. deeplink파라미터가 없는 경우, 인코딩 문제나 URL 잘림 현상으로 인한 특수 문자가 있는지 확인하시기 바랍니다.deeplink파라미터가 있으나 경로가 없는 경우 Adjust 서포트에 연락하시기 바랍니다.
테스트 시, 때때로 디퍼드 딥링크가 클릭 후 잠시 동안 유지될 수 있으며, 이는 심지어 테스팅 콘솔에서 기기를 삭제한 이후에도 마찬가지입니다.
이는 다음의 경우에 발생합니다.
- 딥링크를 클릭하고, 앱을 설치하고, 앱을 열었음.
- 앱을 삭제합니다.
- 테스팅 콘솔에서 기기를 삭제합니다.
- 다른 테스트를 실행한 결과 디퍼드 딥링크가 작동하지 않습니다.
이 문제를 해결하려면 앱을 다시 삭제하고, 테스팅 콘솔에서 기기를 삭제한 뒤 다시 테스트를 수행하시기 바랍니다.