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