딥링크 테스트

캠페인에서 딥링크를 사용하기 전에 딥링크가 올바르게 설정되었는지, 의도한 인앱 콘텐츠가 열리는지, Adjust에서 측정되는지를 테스트하시기 바랍니다. 테스트 과정은 사용자가 이미 앱을 설치했는지, 앱을 처음 설치하는지 또는 리어트리뷰션이 필요한지 등 링크 유형과 사용자 시나리오에 따라 달라집니다.

본 가이드는 다음 항목에 대한 테스트를 설명합니다.

  • Adjust 딥링크
  • 유니버설 링크
  • 다이렉트 딥링킹
  • 디퍼드 딥링킹
  • 리어트리뷰션

테스트 중 문제가 발생한 경우 딥링크 FAQ에서 자세한 내용을 확인하시기 바랍니다.

시작에 앞서

딥링크를 테스트하기 전에 이 체크리스트를 사용하시기 바랍니다.

모든 플랫폼

  • 테스트 중인 환경에 대한 올바른 링크를 생성합니다.
  • 설치 또는 세션이 정상적으로 어트리뷰션되는지 여부를 명확하게 식별할 수 있도록 전용 테스트 링크를 생성합니다.
  • 특히 JSR 링크의 경우 캠페인이 진행될 동일한 환경에서 테스트합니다.

iOS 및 유니버설 링크

  • 링크가 구현된 앱 버전을 테스트합니다.

    • 예를 들어 유니버설 링크가 디버그 빌드에서만 구현된 경우 해당 빌드에서 테스트합니다.

  • iOS 디버그 앱을 테스트하는 중에 Adjust 서포트의 도움이 필요한 경우, TestFlight 버전을 출시하고 팀을 초대하는 것을 고려해 보시기 바랍니다.

참고:

앱이 Adjust의 SDK Signature(SDK 서명)를 사용한다면 실제 기기에서 테스트를 시행합니다. SDK Signature를 사용하지 않는다면 에뮬레이터를 사용하여 테스트할 수 있습니다.

테스트 페이지 제작

테스트를 위해 웹 환경에서 링크를 호스트합니다. 간단한 HTML 페이지에 링크를 추가하고 테스트 기기에서 해당 페이지를 여는 것을 권장합니다.

유니버설 링크는 Safari나 Chrome에서 열어야 하며, 브라우저의 주소창에 링크를 직접 붙여넣기 할 경우 정상적으로 작동하지 않기 때문에 이는 필수입니다.

HTML 예시:

<html lang="en">
   <head>
      <style>
         a {
         font-size: 100px
         }
      </style>
   </head>
   <body>
      <a href="https://app.adjust.com/abc123?deep_link=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion">Deep Link</a>
   </body>
</html>

적절한 링크 형식을 사용하시기 바랍니다.

Adjust 딥링크 예시:

<a href="https://app.adjust.com/abc123?deep_link=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion">Deep Link</a>

유니버설 링크 예시

<a href="https://example.go.link/category/product/67890?adj_t=abc123">Deep Link</a>

테스트 방법

테스트 과정은 사용된 링크의 유형이나 시나리오에 따라 달라집니다. 예를 들어, 이미 앱을 설치한 사용자와 앱을 아직 설치하지 않은 사용자에게 링크는 다르게 작동됩니다.

기존 사용자로 테스트

이 테스트를 사용하여 이미 앱을 설치한 사용자에 대한 다이렉트 딥링킹 을 확인할 수 있습니다.

  1. 테스트 페이지를 제작합니다.
  2. 페이지에 딥링크 또는 유니버설 링크를 추가합니다.
  3. 테스트 기기에 앱을 설치합니다.
  4. 앱을 최소 1회 실행합니다. 앱에 웰컴 스크린이 있는 경우 이를 지웁니다. 필요한 경우 로그인합니다.
  5. 테스트 기기에서 브라우저를 열고 테스트 페이지로 이동합니다.
  6. 링크를 클릭합니다.

예상 결과: 앱이 자동으로 열리고 올바른 인앱 위치로 이동됩니다. 이 과정이 작동하면 이 링크를 사용하여 캠페인을 측정할 준비가 된 것입니다.

트러블슈팅

  • 앱이 열렸으나 올바른 위치에 있지 않은 경우, 앱이 딥링크 경로를 올바르게 처리할 수 있는지 확인합니다.
  • 유니버설 링크의 경우 앱이 열리지 않으면 Raw 유니버설 링크를 테스트합니다. 404 URL not found 오류를 반환하는 경우 유니버설 링크 연동 설정을 다시 확인합니다.

신규 사용자로 테스트

이 테스트를 사용하여 앱을 설치하지 않은 사용자에 대한 디퍼드 딥링킹 을 확인할 수 있습니다. 디퍼드 딥링킹은 사용자가 앱을 설치하기 전에 딥링크를 클릭하는 경우에 사용됩니다. 사용자가 앱을 설치하고 실행하면 Adjust는 앱이 사용자를 의도한 인앱 화면으로 보낼 수 있도록 딥링크 정보를 전송 전달합니다.

  1. 테스트 기기에 앱이 설치되어 있지 않은지 확인합니다. 앱이 설치되어 있다면 삭제합니다.
  2. Adjust 테스팅 콘솔에서 기기를 삭제합니다.
  3. 테스트 기기에서 브라우저를 열고 테스트 페이지로 이동합니다.
  4. 링크를 클릭합니다.
  5. 앱 스토어에서 앱을 다운로드하고 설치합니다.
  6. 앱을 실행합니다.

예상 결과: 앱이 실행되면 딥링크에 정의된 특정 인앱 위치로 이동됩니다.

유니버설 링크의 경우 테스트 전에 관련 광고 ID 파라미터를 포함하여 링크를 생성합니다.

https://example.go.link/category/product/67890?adj_t=abc123&adj_idfa=8C6CBCOD-5F43-4765-A6E6-84DFF3D24707

최적화된 디퍼드 딥링킹 테스트

최적화된 디퍼드 딥링킹을 활성화한 경우 관련 페이지에 표시된 단계를 수행하시기 바랍니다.

트러블슈팅

디퍼드 딥링크가 올바른 페이지를 열지 않는 경우, 우선 동일한 링크를 기존 사용자로 테스트합니다. 기존 사용자 테스트에서 정상적으로 작동한다면 유니버설 링크에서 AppView의 앱 스킴이 올바른지, 또는 Adjust 딥링크에서 딥링크 파라미터가 잘리거나 잘못 암호화되었는지 확인합니다.

신규 사용자 테스트 시 기기 재설정

디퍼드 딥링크 테스트를 여러 번 진행하는 경우, 이전의 클릭이나 설치가 결과에 영향을 미치지 않도록 테스트마다 기기를 재설정하시기 바랍니다.

  1. 테스트 기기에서 앱을 삭제합니다.
  2. Adjust에서 광고 ID를 삭제합니다.
  3. 링크를 클릭하지 않고 앱을 설치합니다.
  4. Adjust 테스팅 콘솔에서 설치가 오가닉으로 표시되는지 확인합니다.
  5. 설치가 오가닉이 아니라면 1~3단계를 반복합니다.
  6. 앱을 다시 삭제합니다.
  7. 광고 ID를 다시 삭제합니다.

리어트리뷰션 테스트

이 테스트를 사용하여 기존 사용자가 딥링크를 통해 리어트리뷰션될 수 있는지 확인할 수 있습니다.

  1. 테스트 링크에서 리어트리뷰션 비활성화 기간을 0일로 설정합니다.
  2. 광고 ID 파라미터가 없는 딥링크를 생성합니다.
  3. Adjust에서 테스트 기기의 광고 ID를 삭제합니다.
  4. 링크를 클릭하지 않고 앱을 설치합니다.
  5. 테스트 기기에서 브라우저를 열고 테스트 페이지로 이동합니다.
  6. 딥링크를 클릭합니다.
  7. Adjust 테스팅 콘솔을 사용하여 기기가 테스트 링크에 어트리뷰션 또는 리어트리뷰션 되었는지 확인합니다.
중요:

앱 레벨에서 비활성화 윈도우를 변경한 경우, 테스트 완료 후에 원하는 설정으로 변경하시기 바랍니다.