[UPDATED] SDK 콘솔 FAQ와 트러블슈팅

SDK 콘솔은 Singular에서 올바르게 SDK/S2S 연동을 구현했는지 테스트하기 위한 도구입니다.  

테스트 디바이스의 ID를 제공하여 테스트 디바이스를 콘솔에 추가하면, 해당 콘솔은 귀사의 앱이 Singular가 인스톨, 추적 이벤트 등 어트리뷰션을 위해 필요한 정보들을 보내고 있는지를 나타냅니다.   

SDK 콘솔을 사용하는 연동 테스트에 관한 상세 정보를 원한다면, How to Test Your Singular SDK Integration를 참고하세요.

 

트러블슈팅

이벤트 로그에 왜 이벤트가 보이지 않나요? 

테스트 디바이스를 등록하고 테스트를 위한 SDK 연동 절차를 잘 따랐는데도 이벤트 로그에 열들이 보이지 않는다면, 다음을 확인하세요.   

  • 유저 세션 확인을 위해 테스트 디바이스에서 앱을 오픈했는지 확인하세요.
  • 이벤트 테스트를 원한다면, 인 앱 이벤트들을 생성했는지 확인하세요.
  • SDK 콘솔은 라이브 이벤트들만 표시합니다. (디바이스의 이전 이벤트들을 찾지 않습니다).
  • 해당 디바이스가 Tracked Devices list 내 활성화되어있는지 (눈 아이콘이 비활성화되어 있지는 않은지) 확인하세요. 

screenshot-app.singular.net-2020.02.14-19-23-49.png

  • 이벤트 로그 위에 나타나는 COLLECTING REAL TIME DATA 메시지를 찾으세요. 만약 해당 메시지가 표기된다면, Singular가 적어도 현재 한 디바이스 이상으로부터 이벤트들을 확인하고 있다는 의미입니다. 로그 내 이벤트가 나타나지 않는다면, 앱 내 SDK가 올바르게 이벤트들을 전송하고 있지 않다는 의미가 될 수 있습니다.  

FAQ

연동을 테스트하기 위해 어떻게 SDK 콘솔을 사용해야 하나요?

SDK 콘솔을 사용한 연동 테스트를 위한 가이드가 필요하다면, How to Test Your Singular SDK Integration을 참고하세요.

테스트를 위해 모바일 디바이스를 등록하려면 어떻게 해야 할까요?

콘솔에 디바이스를 등록하려면 다음 절차를 따르세요.

  • 싱귤러 대시보드 페이지 내 Settings > SDK Console로 가세요.
  • Add Device를 클릭하세요.

  • 추가하려는 디바이스의 플랫폼을 선택하시고, keyspace (광고 ID 종류)를 선택하세요. 예를 들어, IDFA 또는 Google 광고 ID.   

  • 디바이스로부터 해당 ID를 기재하시고 Add를 클릭하세요.

    image11.png

    참고:

    • iOS 디바이스들에 대해서는, 접근 권한이 있다면 IDFV사용을 권장합니다. IDFA를 사용할 수도 있지만, 이 경우 디바이스 데이터를 콘솔에서 "forget" 할 수 없습니다. (다섯 번째 절차를 참고하세요) 
    • 디바이스의 GAID 또는 IDFA는 디바이스 내 Settings 메뉴에서 확인할 수 있습니다. 또한 Singular는 디바이스 ID를 획득할 수 있도록 귀사가 테스트 디바이스에 설치할 수 있는 Device Assist 앱을 제공하고 있습니다. iOS 또는 Android를 클릭하여 해당 앱을 다운로드하세요.
    • 추가 자료: Types of Device IDs.

중요: Tracked Devices 리스트에 해당 디바이스가 표시되는지 확인하세요.

이벤트 로그에 나타나는 디바이스로부터 오는 어떤 이벤트에 대해서도 해당 디바이스는 활성화 모드가 되어야 합니다 (눈 아이콘이 비활성화되지 않도록 주의하세요.)  

Device Name 칼럼 내 해당 디바이스에 서술적인 이름을 명명하여 추적하는 다른 디바이스들과 혼동하지 않도록 합니다.  

image12.png

Events Log는 어떻게 읽어야 할까요? 

팁: 연동 테스트를 위해 사용하는 SDK 콘솔 사용에 대한 상세가이드는, How to Test Your Singular SDK Integration을 참고하세요.

디바이스 등록 후, 몇몇 이벤트들을 전송하고, 약 1분 정도 기다리면, 해당 이벤트들이 SDK Console 페이지 내 이벤트 로그에 표시되기 시작합니다. 

image8.png

해당 앱으로부터 전송된 이벤트의 세부사항들을 확인하려면 열을 클릭하세요. 

image9.png

너무 오래 걸린다면 Clear Log를 클릭하여 이벤트 로그를 비우세요. 

팁: Clear Log를 클릭하지 않으면, 해당 로그는 각 추적된 디바이스로부터 지난 500건의 이벤트만 보관합니다. 

디바이스를 Console에서 지우거나 삭제하려면 어떻게 해야 할까요?

디바이스 삭제

Tracking List로부터 디바이스를 삭제하려면, 디바이스 ID에 커서를 올려서 Delete 버튼을 클릭하세요. 스크린으로부터는 모든 이벤트 로그가 지워지지만, Singular는 여전히 해당 디바이스가 특정 소스에 어트리뷰션 된 것을 기억할 것입니다.  

디바이스 잊기

디바이스를 잊기(forget) 위해서는, 해당 디바이스 ID에 커서를 올려서 Forget을 클릭하세요. 이 작업은 Singular 내부 데이터에서도 해당 디바이스의 어트리뷰션을 잊게 합니다. 이 작업은 다른 어트리뷰션 테스트를 위해 사용할 테스트 디바이스를 초기화하는 작업입니다. (다음 구문을 참고하세요)  

추가 자료: 어떻게 디바이스와 어트리뷰션 정보를 초기화하고 다시 인스톨 어트리뷰션 테스트에 사용할 수 있을까요?

어떻게 디바이스를 초기화하고 어트리뷰션 정보를 초기화하여 다시 인스톨 어트리뷰션 테스트에 사용할 수 있을까요?  

만약 같은 디바이스로 SDK 연동을 다시 테스트하고 싶다면, 디바이스로부터 모든 로컬 캐시 데이터를 삭제하고, Singular 플랫폼 내 해당 디바이스의 어트리뷰션 내역을 지워야 합니다. 

안드로이드 디바이스 절차

  1. 해당 앱을 닫고 앱이 작동하지 않는지 확인하세요. (Settings 메뉴에서 Force Stop 옵션이 있는 경우 사용하세요.)
  2. 알림 윈도우나 애플리케이션(Apps) 메뉴 내 톱니바퀴 아이콘 터치하여 Settings 메뉴로 가세요.  
  3. 애플리케이션(Apps)로 가서, 테스트하려는 앱을 선택하시고, 해당 앱을 오래 누른 후 앱 정보(App Info)를 선택하세요. 
  4. Select 스토리지(Storage)를 선택하고 Clear Cache 와 Clear Data를 선택하세요.
  5. Singular SDK 콘솔 내, 해당 디바이스 열에 커서를 올린 후 Forget을 클릭하여 Singular가 해당 디바이스 어트리뷰션을 잊게 하세요.

    image5.png

팁: Google Play는 이 기능을 수행하는 앱을 제공 합니다. (예시).

iOS 디바이스 절차

  1. 해당 앱을 닫고 삭제하세요.
  2. SDK Console 를 열고 Forget을 클릭하여 Singular가 해당 디바이스의 어트리뷰션을 잊게 하세요.

    image5.png

팁: 리인게이지먼트 비활성화 윈도우로 테스트

비활성화 윈도우(inactivity window)는 해당 유저가 얼마나 오래 비활성화되어야 리인게이지먼트 어트리뷰션에 적합한지 결정하는 설정입니다. 캠페인 런칭 전에 리인게이지먼트 어트리뷰션을 테스트하기 위해, 비활성화 윈도우(inactivity window)에서 이를 설정하게 되면 더욱 복잡할 수 있습니다. 이런 이유로 테스트 디바이스 (SDK console에 추가된 디바이스들인 동시 눈 아이콘이 활성화된 디바이스)는 비활성화 윈도우에서 제외되었습니다.   

도움이 되었습니까?