SDK Audit 리포트 작동하세요.

Settings > SDK Console에 가서 우측 상단 코너의 Audit your SDK integration를 클릭하세요.  

리포트를 다운로드하여 참조하세요.

리포트 작동이 끝나면, CSV 형식으로 다운로드할 수 있습니다. 

해당 리포트는 SDK와 S2S 연동 내 발견된 문제 리스트입니다. 모든 문제가 치명적이지는 않으며, 그중 몇몇은 귀사와 관련이 없을 수도 있습니다 (왜냐하면 귀사가 구현하기로 선택하지 않은 SDK 기능들하고도 관련이 있기 때문입니다). 해당 리포트가 어떻게 빌드되었는지 알고 싶다면, How do I read the SDK audit report? 를 참고하세요.

관련 문제들을 해결하세요.

리포트 내 문제들을 점검하고 Error Description field의 팁에 따라 문제를 해결하세요. 

참고: 경고/정보 관련 이슈들에 대해서는, Validation Name을 확인하고 해당 사항이 선택사항인 SDK 기능이고, 구현하지 않아도 되는 기능인지 확인하세요. 예를 들면, 디퍼드 딥링크(DDL)가 이에 해당할 수 있습니다. 만약 그렇다면, 해당 에러 메시지를 무시하세요.   

테스트 디바이스 추가

디바이스를 console에 추가하려면 다음을 따르세요.

• Singular 홈페이지 내, Settings > SDK Console에 가세요.

• Add Device를 클릭하세요.

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

• 디바이스 ID를 기재한 후, Add를 클릭하세요.

  

디바이스가 Tracked Devices 리스트에 표시되는지 확인

SDK가 잘 구현되었는지 확인하기 위해 디바이스 내 이벤트들을 확인하려면, Tracked Devices에 표기된 해당 디바이스 옆에 위치한 눈 아이콘을 클릭하여 활성화하세요.

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

테스트 초기화와 세션

처음 테스트할 항목은 귀사의 연동이 초기화 설정이 되고 Singular로 정보를 전송하는지에 관해서 입니다. 이는 Singular로 하여금 해당 앱에 대한 어트리뷰션 추적을 허락합니다! 확인을 위해서는, 이벤트 로그 내 유저 세션(user sessions)을 찾으세요. 

초기화 테스트를 위해서는 다음을 따르세요.

1. 디바이스에서, 해당 앱을 오픈합니다.
2. 1~2분 정도 기다립니다.

3. SDK Console 내 이벤트 로그를 통해 디바이스의 세션 열을 표시하는지 확인하세요.

   

만약 이 열이 표시되지 않는다면, user-level 로그를 통해 세션 이벤트를 확인하세요. 귀사가 SDK Console이 새 디바이스의 등록 작업을 마치기 전에 앱을 오픈했을 수도 있습니다. 

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__” 이벤트가 표시되는지 확인하세요.

Custom User ID 테스트

귀사의 SDK 연동이 custom user ID를 Singular에 전송한다면, 다음 절차에 따라 테스트하세요.

1. SDK console에 디바이스를 등록하세요.
2. 앱을 오픈하세요.
3. 필요하다면, 앱에서 user ID (로그인과 같은)를 전송하도록 트리거 하세요. 이 동작은 본질적으로 구현사항에 기반합니다.   

4. Singular에 다음 이벤트가 전송된 후, SDK console 내 이벤트 디테일을 펼쳐 세부사항(details)에 "custom_user_id"에 대한 값이 포함되어 있는지 확인하세요.

   

만약 user ID가 표시되지 않는다면 다음 절차를 따르세요.

• 해당 메서드를 확인하여 귀사가 원하는 때 user ID가 앱에서 호출될 수 있도록 설정하세요. 
• SDK console에 이벤트가 표시되도록 Singular SDK 이벤트를 추가하고 이를 "Custom user id 설정"으로 명명할 수 있습니다.

Event 테스트

SDK 연동 내 이벤트 추적이나 매출 트래킹을 구현했다면, 다음 설명을 따라 테스트하세요.  

이벤트들에 대한 추가 정보는 다음을 참고하세요.

• Events Configuration FAQ
• In-App Purchase Validation FAQ
• Ways of Measuring Events (Cohort vs. Actual, Unique, First)
  

SDK 연동 내 구현한 모든 이벤트에 대하여:

1. 앱에서 이벤트를 트리거하고 명명한 해당 이벤트가 이벤트 로그 내 표시되는지 확인하세요. 

   

2. 만약 이벤트와 함께 추가 데이터를 전송한다면, SDK console 내 이벤트 열을 클릭하여 이벤트 세부사항(event details)을 펼치고, 해당 데이터가 "event_data"에 포함되어 있는지 확인하세요.

   

만약 이벤트가 표시되지 않는다면, SDK console 내 디바이스가 온전히 등록되기 전에 앱이 오픈됐을 수 있습니다. 해당 이벤트에 대해 어트리뷰션 로그를 확인하세요.

매출 테스트

SDK 연동 내 구현한 각 매출 이벤트 타입에 대해:

1. 앱 내 매출 이벤트를 트리거하고 이벤트 로그를 확인하세요. 해당 이벤트 명으로 열에 표시되어야합니다. 

   참고: 만약 해당 이벤트의 커스텀 명을 지정하지 않았다면, 해당 매출 이벤트는 "__iap__"와 같은 기본 설정 명으로 표시됩니다.

2. 해당 열을 클릭하여 펼친 후 해당 통화 ("pcc"), 액수 ("r"), 또는 수신된 해당 이벤트의 다른 세부사항들을 확인하세요. 

   

딥링크 테스트

SDK 연동 내 딥링크를 구현했다면, 다음 설명을 따라 딥링크 기능을 테스트하세요.

1. 테스트 목적지 설정

Singular 홈페이지에서, Settings > Apps로 가시어, 해당 앱을 찾고 딥링크 목적지를 추가하세요. 

해당 목적지는 SDK 연동의 핸들러 코드(handler code)가 인지하고 처리할 수 있는 딥링크 목적지 중 하나여야 합니다. 

2. 링크 생성 후 테스트

이제 링크를 연결할 목적지가 있으니, 딥링크를 생성할 수 있습니다. 

1. Attribution > Manage Links에 가서 사이드바에서 앱을 선택하세요.
2. Create Link를 클릭하세요.
3. Link Type 하위에, "Custom Source"를 선택하고, Source Name 하위에, "Email"을 선택하세요.
4. 링크 이름을 명명하세요.
5. Link Settings 과 Redirects 구간을 클릭하여 펼치세요.
6. Deep Link 드롭다운 리스트 내 방금 생성한 목적지를 선택하세요.
7. Fallback Destination for Other Platforms 텍스트 박스 내, 웹 사이트 URL을 기재하세요.

8. Generate를 클릭하시고 Click-Through Tracking Link 필드로부터 링크를 복사하세요.

   

3. 링크 테스트

링크를 테스트하려면 다음 절차를 따르세요.

1. 해당 앱이 테스트 디바이스 내 인스톨 되어있어야 합니다.
2. 이메일로 복사된 링크를 테스트 디바이스에 전송합니다. 
3. 디바이스에서, 해당 이메일을 열고 링크를 클릭하세요. 해당 앱이 오픈되고 의도한 페이지나 내용이 표시되어야합니다. 

트러블 슈팅

내 앱이 이미 작동 중이라면, 딥링크는 기존의 것을 맞바꾸는 대신 해당 앱의 새 사례[new instance]를 오픈합니다. 

이런 현상을 피하려면, 매니페스트 파일을 수정하고 다음을 귀사의 활동에 추가하세요.

android:launchMode="singleTask"

Google's <activity> 문서를 통해 launchMode 옵션에 대한 정보를 참고하세요.

디퍼드 딥링크 테스트

1. 디퍼드 딥링크가 활성화되었는지 확인하려면, SDK console 내 세션 이벤트를 확인하세요.

   

2. 상단에 위치한 "딥링크 테스트"의 설명처럼 테스트 목적지와 링크를 설정하세요.
3. 테스트 디바이스로부터 앱을 언인스톨 하세요.

4. 이메일로 딥링크를 디바이스에 전송하고 디바이스에서 해당 딥링크를 오픈하세요. 해당 링크는 앱 스토어로 데려갈 것입니다. 해당 앱을 인스톨하고 오픈한 후, 원하는 페이지나 내용을 볼 수 있습니다. 

   

언인스톨 추적 테스트

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를 재확인하세요.

언인스톨 트래킹을 테스트하려면 다음 절차를 따르세요.

1. 실제 디바이스(에뮬레이터가 아닌)를 사용하여, 디바이스에서 앱을 인스톨하세요.
2. 앱을 오픈하여 인스톨이 등록되게 하세요.
3. 해당 앱을 삭제하세요. 

4. Singular가 해당 언인스톨 이벤트를 수신했는지 확인하려면, 다음 옵션 중 선택하세요.  

   • 어트리뷰션 로그를 추출(이벤트 로그)하고 해당 언인스톨 이벤트를 확인하세요. 로그 내 표시되기 전까지 며칠 정도 걸릴 수 있습니다.
   • 귀사의 내부 BI에 전송되도록 포스트 백을 설정했다면, 해당 언인스톨에 대한 포스트 백을 수신할 수 있습니다. 
   • Singular 서포트에 문의하거나 귀사의 성공 매니저에게 문의하여 언인스톨 추적을 확인할 수 있습니다.