테스팅 콘솔 (Developer Tools > Testing Console)에서는 Singular에 SDK/S2S 연동이 올바르게 구현되었는지 확인할 수 있습니다.
테스트 디바이스의 ID를 제공하여 테스트 디바이스를 콘솔에 추가하면, 콘솔은 앱에서 Singular가 인스톨, 추적 이벤트 등을 어트리뷰션하기 위해 필요한 정보들을 보내고 있는지를 나타냅니다.
SDK 콘솔을 사용하여 연동을 테스트하기 위한 상세 가이드는, Singular SDK 연동을 테스트하는 방법을 참고하세요.
트러블슈팅
테스트 디바이스를 등록하고 테스트를 위한 SDK 연동 절차를 잘 따랐는데도 이벤트 로그에 행들이 보이지 않는다면, 다음을 확인하세요.
- 유저 세션 확인을 위해 테스트 디바이스에서 앱을 오픈했는지 확인하세요.
- 이벤트 테스트를 원한다면, 인 앱 이벤트들을 진행했는지 확인하세요.
- SDK 콘솔은 라이브 이벤트들만 표시합니다. (디바이스의 과거 이벤트들은 찾지 않습니다).
- 드롭다운에 나타나는 디바이스를 선택하세요.
- 이벤트 로그 위에 나타나는 COLLECTING REAL TIME DATA 메시지를 확인하세요. 만약 해당 메시지가 표시된다면, 현재 Singular가 적어도 한 디바이스 이상에서 이벤트들을 확인하고 있다는 의미입니다. 로그에 이벤트가 나타나지 않는다면, 앱 내 SDK가 올바르게 이벤트들을 전송하고 있지 않을 수 있습니다.
Singular SDK 12.0.0 이상의 버전부터, _InstallReferrer 이벤트를 테스트할 필요가 없습니다. 앱이 스토어에 출시되면, Singular SDK는 첫 세션에 _InstallReferrer 데이터를 나타냅니다. 해당 세션이 테스팅 콘솔에 나타나는지 확인만 하면 됩니다.
Android SDK 구버전을 사용하고 있는 경우에는, 테스팅 콘솔에서 _InstallReferrer 이벤트를 테스트해야 합니다.
FAQ
SDK 콘솔을 통하여 연동을 테스트 방법에 대한 가이드가 필요하다면, Singular SDK 연동을 테스트하는 방법을 참고하세요.
콘솔에 디바이스를 등록하려면 다음 절차를 따르세요.
- 싱귤러 대시보드 페이지 내 Developer Tools > Testing Console로 가세요.
-
Add Device를 클릭하세요.
-
추가하려는 디바이스의 플랫폼을 선택하시고, keyspace (광고 ID 종류)를 선택하세요. 예를 들어, IDFA 또는 Google 광고 ID.
-
디바이스로부터 해당 ID를 입력하고 Add를 클릭하세요.
참고:
- 디바이스의 GAID 또는 IDFA는 디바이스 내 Settings 메뉴에서 확인할 수 있습니다. 또한 Singular는 디바이스 ID를 획득할 수 있도록 테스트 디바이스에 설치할 수 있는 Device Assist 앱을 제공하고 있습니다. iOS 또는 Android를 클릭하여 해당 앱을 다운로드하세요.
- 참고: Device ID 유형.
- 디바이스의 GAID 또는 IDFA는 디바이스 내 Settings 메뉴에서 확인할 수 있습니다. 또한 Singular는 디바이스 ID를 획득할 수 있도록 테스트 디바이스에 설치할 수 있는 Device Assist 앱을 제공하고 있습니다. iOS 또는 Android를 클릭하여 해당 앱을 다운로드하세요.
중요: 추적된 디바이스(Tracked Device) 리스트에 해당 디바이스가 표시되는지 확인하세요.
이벤트 로그에 표시되는 디바이스로부터 오는 어떤 이벤트에 대해서도 해당 디바이스는 활성화 모드가 되어야 합니다. (눈동자 아이콘이 비활성화되지 않도록 주의하세요)
Device Name 행 내 해당 디바이스에 서술적인 이름을 명명하여 추적하는 다른 디바이스들과 혼동하지 않도록 하세요.
팁: 연동을 테스팅 콘솔에 테스트하는 방법에 대한 자세한 가이드는, Singular SDK 연동을 테스트하는 방법을 참고하세요.
디바이스를 등록한 후, 몇몇 이벤트를 실행하시고 약 1분 정도 기다리세요. 테스팅 콘솔 페이지의 이벤트 로그에 해당 이벤트들이 표시되기 시작합니다.
해당 행을 클릭하여 앱에서 전송한 이벤트의 전체 세부 사항들을 표시할 수 있습니다.
이벤트 로그가 너무 길어진다면 Clear Log를 클릭하여 이벤트 로그를 정리하세요.
팁: Clear Log를 클릭하지 않으면, 로그는 각 추적 디바이스당 과거 500건의 이벤트까지 보관합니다.
디바이스 제거하기
디바이스를 트래킹 목록에서 지우기 위해서는, 수정 아이콘(연필 아이콘)을 클릭하면 나타나는 창에서 Delete Device를 클릭하세요. 이를 통해 해당 스크린으로부터 모든 이벤트 로그를 정리할 수 있고, Singular는 해당 디바이스 어트리뷰션에 대한 내부 데이터를 삭제합니다.
만약 같은 디바이스로 SDK 연동을 다시 테스트하고 싶다면, 디바이스로부터 모든 로컬 캐시 데이터를 삭제하고, Singular 플랫폼 내 해당 디바이스의 어트리뷰션 내역을 정리해야 합니다.
Android 디바이스에 대한 단계
- 앱을 종료하여 앱 작동을 완전히 중지하세요. (Settings 메뉴에서 Force stop 옵션이 있다면 이 옵션을 사용하세요)
- 알림 윈도우 내 톱니바퀴 아이콘을 클릭하여 Settings 메뉴에 가거나 앱 메뉴로 가세요.
- 앱(Apps)에 가서 테스트 중인 앱을 선택하고, 해당 앱을 길게 눌러 앱 정보(App info)를 선택하세요.
- 스토리지를 선택하고 캐시 정리하기와 데이터 정리하기를 선택하세요.
-
Singular 테스팅 콘솔에서, 드롭 다운의 디바이스를 선택하여 수정(연필) 아이콘을 클릭하세요. 해당 창이 오픈되면, Delete Device 버튼을 눌러 Singular 시스템에서 이 디바이스에 대한 어트리뷰션을 삭제하세요.
팁: Google Play에서는 해당 기능을 수행할 수 있는 앱을 제공합니다 (예시).
iOS 디바이스에 대한 단계
- 앱을 닫고 삭제합니다.
-
Testing Console을 오픈하여 해당하는 디바이스를 드롭다운에서 찾고, 수정(연필) 아이콘을 클릭합니다. 해당 창이 오픈되면 Delete Device 버튼을 클릭하여 Singular 시스템에서 해당 디바이스 어트리뷰션에 대한 정보를 삭제합니다.
팁: 리인게이지먼트 비활성화 윈도우로 테스트
비활성화 윈도우(inactivity window)는 해당 유저가 얼마나 오래 비활성화되어야 리인게이지먼트 어트리뷰션에 적합한지 결정하는 설정입니다. 캠페인 출시 전에 리인게이지먼트 어트리뷰션을 테스트하기 위해, 비활성화 윈도우(inactivity window)에서 이를 설정하게 되면 더욱 복잡할 수 있습니다. 이런 이유로 비활성화 윈도우에서 테스트 디바이스 (SDK console에 추가된 디바이스들인 동시 눈동자 아이콘이 활성화된 디바이스)는 포함되어있지 않습니다.