Singular SDK/S2S를 앱에 연동한 후, 새 버전의 앱을 라이브 하기 전에 잘 작동하는지 확인하는 것이 중요합니다.
Singular에는 연동 테스트를 위한 두 주요 툴이 있습니다. Audit report는 연동 내 모든 문제를 자동으로 감지하는 툴이고, Testing Console은 여러 기능을 구현할 때 구현된 기능들을 수동으로 테스트할 수 있는 툴입니다.
다음 가이드는 두 툴에 대한 설명입니다.
가이드 대상 | 개발자 |
필수 조건 | 앱에 Singular SDK 또는 S2S 구현. Testing Console 사용을 위한 테스트용 모바일 디바이스. |
자동 테스트: SDK Audit 작동
Singular가 제공하는 audit 리포트에서는 SDK와 S2S 연동을 테스트하여 두 연동이 올바르게 구현되었는지 확인할 수 있습니다. Audit에서는 발견한 모든 이슈들의 리스트와 해결 팁을 함께 출력합니다. SDK audit 리포트를 사용하려면 다음을 참고하세요.
1 |
SDK Audit 리포트를 작동하세요Developer Tools > Testing Console에 가서 우측 상단의 Run Audit를 클릭하세요. |
2 |
리포트를 다운로드하여 참조하세요.리포트 작동이 끝나면, CSV 형식으로 다운로드할 수 있습니다. 해당 리포트는 SDK와 S2S 연동 내 발견된 이슈들의 리스트입니다. 모든 문제가 치명적이지는 않으며, 그중 몇몇은 관련이 없을 수도 있습니다. (구현하기로 선택하지 않은 SDK 기능들하고도 관련이 있기 때문입니다.) 해당 리포트가 어떻게 빌드되었는지 알고 싶다면, 오딧 리포트를 읽는 방법은? 을 참고하세요. |
3 |
관련 문제를 해결하세요.리포트 내 문제들을 점검하고 Error Description 필드의 팁에 따라 문제를 해결하세요. 참고: 경고/정보 관련 이슈들에 대해서는, Validation Name을 확인하고 해당 사항이 선택사항인 SDK 기능이며 구현하지 않아도 되는 기능인지 확인하세요. 예를 들어, 디퍼드 딥링크(DDL)가 이에 해당할 수 있습니다. 이 경우, 해당 에러 메시지는 무시하세요. |
추가 자료: Auditing Tool for SDK/S2S Integrations: FAQ
SDK 콘솔을 통한 수동 테스트
팁:
- SDK 감사 도구와 같이 테스트 단계들을 진행하여 SDK/S2S 구현이 올바르게 작동하는지 확인하세요.
- 연동을 모두 끝마치기 전 기능들을 구현하면서 Testing Console을 통해 기능을 하나씩 테스트할 수 있습니다.
Testing Console에 대한 일반적인 질문은 Testing Console FAQ를 참고하세요.
1 |
테스트 디바이스 추가디바이스를 console에 추가하려면 다음을 따르세요.
주의:
|
2 |
디바이스가 디바이스 드롭다운에 표시되는지 확인디바이스 드롭다운에서 디바이스를 선택하세요. 이후, Event Log에서 디바이스로부터 발생한 이벤트를 볼 수 있습니다. Device Name 칼럼에서 디바이스를 묘사하는 이름으로 명명할 수 있으며, 이 작업을 통해 추적에 다른 디바이스들과 혼동하지 않도록 하세요. |
3 |
테스트 초기화와 세션처음 테스트할 항목은 연동이 초기화 설정이 되고 Singular로 정보를 전송하는지에 대해서입니다. 이는 Singular가 해당 앱에 대한 어트리뷰션 추적을 할 수 있도록 허락합니다. 확인을 위해서는, 이벤트 로그 내 유저 세션(user sessions)을 찾으세요. 초기화 테스트를 위해서는 다음을 따르세요.
만약 이 열이 표시되지 않는다면, 유저 레벨 로그를 통해 세션 이벤트를 확인하세요. Testing Console이 새 디바이스에 대한 등록 작업을 완료하기 전에 앱을 오픈했을 수 있습니다. |
4 |
[iOS] Apple iAd 리퍼러 테스트iOS 디바이스에서, Singular는 iAd 어트리뷰션 데이터를 수신해야 합니다. 확인을 위해서는, console에 디바이스를 추가하여 앱을 다운로드한 후, SDK console을 확인하여 “__iAd_Attribution__” 이벤트가 표시되는지 확인하세요. 참고:
|
5 |
커스텀 유저 ID 테스트SDK 연동에서 커스텀 유저 ID가 Singular에 전송된다면, 다음 절차에 따라 테스트하세요.
만약 user ID가 표시되지 않는다면 다음 절차를 따르세요.
|
6 |
Event 테스트SDK 연동에서 이벤트 추적이나 매출 트래킹을 구현했다면, 다음 설명을 따라 테스트하세요. 이벤트들에 대한 추가 정보는 다음을 참고하세요. SDK 연동에서 구현한 모든 이벤트에 대하여:
만약 이벤트가 표시되지 않는다면, SDK console 내 디바이스가 온전히 등록되기 전에 앱이 오픈됐을 수 있습니다. 해당 이벤트에 대해 어트리뷰션 로그를 확인하세요. |
7 |
매출 테스트SDK 연동에서 구현한 각 매출 이벤트 유형에 대해:
|
8 |
딥링크 테스트SDK 연동 내 딥링크를 구현했다면, 다음 설명을 따라 딥링크 기능을 테스트하세요. 참고: 이 문서는 Singular 링크를 사용한다고 가정하여 설명합니다 - Singular 링크는 Singular의 새 트래킹 링크 기술로, 2019년에 출시되었습니다. 기존 Singular 사용자들은 Singular의 이전 트래킹 링크 (레거시 링크)를 사용하고 있을 수도 있습니다. 1. 테스트 목적지 설정Singular 플랫폼의 Settings > Apps로 가서, 해당 앱을 찾고 딥링크 목적지를 추가하세요. 해당 목적지는 SDK 연동의 핸들러 코드(handler code)가 인지하고 처리할 수 있는 딥링크 목적지 중 하나여야 합니다. 2. 링크 생성 후 테스트이제 링크를 연결할 목적지가 있으니, 딥링크를 생성할 수 있습니다.
3. 링크 테스트링크를 테스트하려면 다음 절차를 따르세요.
링크 테스트를 위한 다른 방법 (안드로이드에 해당): 딥링크를 발생시키기 위해 컴퓨터 내 커멘드 라인 터미널을 오픈하세요. 트러블 슈팅내 앱이 이미 작동 중이라면, 딥링크는 기존의 것을 맞바꾸는 대신 해당 앱의 새 사례[new instance]를 오픈합니다. 이런 현상을 피하려면, 매니페스트 파일을 수정하고 다음을 액티비티(activity)에 추가하세요.
Google's <activity> 문서를 통해 launchMode 옵션에 대한 정보를 참고하세요. |
9 |
디퍼드 딥링크 테스트 |
10 |
언인스톨 추적 테스트SDK 연동 내 언인스톨 추적을 구현했다면, 다음 서명에 따라 테스트하세요. 언인스톨 추적이 다른 SDK 기능 테스트보다 더 복잡한 이유는 Singular가 Google/iOS 서비스에 의존하여 언인스톨을 보고하고, 해당 과정에 시간이 걸리기 때문입니다. 해당 언인스톨 이벤트는 실시간으로 Singular 홈페이지에서 볼 수 없으며, 해당 작업을 위해 Testing console을 사용할 수도 없습니다. 테스트 전에, FCM/APNS 토큰을 Singular로 보내세요. (Android SDK: 언인스톨 추적과 iOS SDK: 언인스톨 추적을 참고). 또한, App Configuration 페이지 내 FCM Server Key (Android) 또는 iOS Push Certificate를 입력했는지 다시 확인하세요. 언인스톨 트래킹을 테스트하려면 다음 절차를 따르세요.
주의: 언인스톨 이벤트 확인을 위해 기다리는 동안, 디바이스 ID를 초기화하거나 앱을 다시 설치하지 마세요. |