Singular SDK 통합을 테스트하는 방법

Singular SDK를 앱에 연동하거나 서버 간 연동을 구축한 후에는 새 버전을 출시하기 전에 Singular가 데이터를 수신하는지 반드시 확인해야 합니다.

다음 사용자를 위한 가이드 개발자 가이드
전제 조건
  • Singular SDK를 구현하거나 앱의 서버 간(S2S) 연동을 설정합니다.
  • 테스트 콘솔을 사용하려는 경우 테스트용 모바일 디바이스가 있는지 확인하세요.

싱귤러는 연동 테스트를 위한 세 가지 주요 도구를 제공합니다:

  • 테스트 콘솔: 기능을 구현하면서 실시간으로 기능을 테스트할 수 있습니다.
  • 로그 내보내기: 최소 1시간 지연된 사용자 수준 데이터를 다운로드합니다.
  • 감사 보고서: 연동의 모든 문제를 자동으로 식별합니다.

 

테스트 콘솔 사용

테스트 콘솔에서는 테스트 기기를 추가하고 선택하여 실시간 데이터를 스트리밍할 수 있습니다. 과거 보고서는 제공하지 않는다는 점에 유의하세요. 시작하려면 다음이 준비되어 있는지 확인하세요:

  • 깨끗한 테스트 기기: 테스트 애플리케이션이 설치된 적이 없는 기기를 사용하세요.
  • 테스트할 이벤트 및 속성 목록: 확인하려는 이벤트 및 속성을 준비합니다.
  • iOS의 경우: 테스트에 IDFV 또는 IDFA 식별자를 사용할지 여부가 결정되므로 ATT(앱 추적 투명성) 프롬프트가 표시되는지 여부에 유의하세요.

 

1

테스트 기기 추가하기

테스트 콘솔에 기기를 추가하려면 다음과 같이 하세요:

  1. Singular 플랫폼에서 개발자 도구 > 테스트 콘솔로 이동합니다.
  2. 장치 추가를 클릭합니다.

  3. 기기 유형을 입력합니다. Android의 경우, 사용 가능한 경우 Google 광고 ID (GAID/aifa), AppSetID (asid) 또는 AndroidID (andi)를 순서대로 사용하는 것을 권장합니다. iOS 디바이스의 경우 사용 가능한 경우 IDFA를 사용하는 것이 좋습니다.
  4. 디바이스 ID를 입력합니다.

    디바이스 ID 캡처하기

    Android의 경우 Google 광고 ID (GAID/aifa)를 사용하는 것이 좋습니다. 싱귤러 디바이스 어시스트 앱(Android)을 통해 찾을 수 있습니다.

    싱귤러 설정에 대한 로깅이 활성화된 경우 Android LogCat에서도 aifa를 찾을 수 있습니다.

    SingularConfig config = new SingularConfig(SdkKey, SdkSecret)
    .withLoggingEnabled()
    .withLogLevel(1);

    LogCat 출력 샘플:

    2023-06-01 15:48:32.224 27442-27560/com.singular.test D/Singular: DeviceInfo [worker] - andi : 8868adc2f7ffffff
    2023-06-01 15:48:32.224 27442-27560/com.singular.test D/Singular: DeviceInfo [worker] - asid : 12dc3652-5e46-f2bb-a93a-b3c092ffffff
    2023-06-01 15:48:32.224 27442-27560/com.singular.test D/Singular: DeviceInfo [worker] - aifa : 3bbc76b0-cebb-4a9f-b6ec-10ca1affffff

    iOS의 경우 ATT 프레임워크가 마련되어 있고 추적이 허용되는 경우 IDFA를 사용할 수 있습니다. 시간 초과 간격으로 추적 권한 부여 대기도 구현되어 있는지 확인하세요. 그 외의 모든 경우에는 IDFV를 사용합니다.

    IDFA는 아래 나열된 방법 중 하나를 사용하여 캡처할 수 있습니다:

    • 앱 스토어에서 Singular 디바이스 지원 앱(iOS)을 사용합니다. 추적 권한을 부여해야 합니다.
    • Xcode의 디버그 콘솔에서 IDFA 로깅하기
    //Example in Swift
    print("IDFA", ASIdentifierManager.shared().advertisingIdentifier.uuidString)
                    
    //Example in Objective-C
    NSString *IDFA = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
    NSLog(@"IDFA: %@", IDFA);

    Xcode의 디버그 콘솔에서IDFV를 캡처할 수 있습니다.

    //Example in Swift
    print("IDFV", UIDevice.current.identifierForVendor!.uuidString)
                    
    //Example in Objective-C
    NSString *IDFV = [[[UIDevice currentDevice] identifierForVendor] UUIDString];
    NSLog(@"IDFV: %@", IDFV);
  5. 고유한 장치 이름을 추가하고 장치 저장을 클릭합니다.

    tc_01.png

2

초기화 테스트

가장 먼저 테스트해야 할 것은 SDK 연동이 성공적으로 초기화되고 Singular에 정보를 전송할 수 있는지 여부입니다(예: 찾고자 하는 이벤트는 세션). 이렇게 하면 싱귤러가 이 앱에 대한 어트리뷰션 추적을 시작할 수 있습니다!

초기화를 테스트하려면:

  1. 이벤트 로그의 디바이스 드롭다운에서 디바이스 이름을 선택합니다. 🟢 라이브 표시기를 찾습니다.

  2. 테스트 플랫폼에서 앱을 초기화하거나 앱을 엽니다.
  3. 세션 이벤트가 표시되면 Singular SDK를 성공적으로 초기화한 것입니다.

    tc_02.png

테스트 콘솔에서 이벤트 로그를 읽으려면 어떻게 하나요?

기기를 등록하고 일부 이벤트를 전송하면 테스트 콘솔 페이지의 이벤트 로그에 이벤트가 나타나기 시작합니다.

tc_04.png

행을 클릭하면 앱에서 전송된 이벤트의 전체 세부 정보가 표시됩니다.

events_details.png

테스트 콘솔 이벤트 로그에 이벤트가 표시되지 않는 이유는 무엇인가요?

테스트 기기를 등록하고 가이드에 따라 SDK 연동을 테스트하고 있지만 이벤트 로그에 행이 표시되지 않는 경우 다음을 다시 확인하세요:

  • 테스트 콘솔은 선택한 디바이스와 🟢 라이브 표시기가 있는 페이지에 있을 때, 즉 라이브 이벤트만 표시합니다. 디바이스에서 과거 이벤트를 찾지 않습니다. 디바이스를 선택하기 전에 이벤트를 실행하면 콘솔에 표시되지 않습니다.
  • 테스트 디바이스에서 앱을 열었는지 확인하세요(사용자 세션을 보기 위해).
  • 이벤트를 테스트하려는 경우 인앱 이벤트를 생성했는지 확인합니다.
  • 올바른 디바이스 ID를 입력했는지 다시 한 번 확인합니다.
  • 올바른 디바이스 ID 유형을 사용하고 있는지 다시 확인합니다(iOS의 경우, ATT 프롬프트가 표시되지 않으면 IDFA를 사용할 수 없습니다).

 

Singular SDK 12.0.0 이상에서 앱을 테스트할 때 _InstallReferrer 이벤트가 누락되는 이유는 무엇인가요?

Singular SDK 12.0.0부터는 _InstallReferrer 이벤트를 테스트할 필요가 없습니다. 앱이 스토어에 푸시되면 SDK가 첫 번째 세션에 _InstallReferrer 데이터를 배치합니다. 테스트 콘솔에서 세션이 표시되는지 확인하기만 하면 됩니다.

이전 버전의 Android SDK를 사용하는 경우에도 테스트 콘솔에서 _InstallReferrer 이벤트를 확인해야 합니다.

콘솔에서 기기를 삭제/제거하려면 어떻게 하나요?

디바이스 삭제하기

추적 목록에서 디바이스를 삭제하려면 편집 아이콘을 클릭하고 표시되는 선반에서 디바이스 삭제를 클릭합니다. 이렇게 하면 페이지에서 모든 이벤트 로그가 삭제되고 Singular는 디바이스의 어트리뷰션에 대한 내부 데이터를 삭제합니다.

참조하세요: 디바이스를 재설정하고 어트리뷰션 정보를 지워 인스톨 어트리뷰션을 다시 테스트하는 데 사용하려면 어떻게 해야 하나요?

기기를 재설정하고 어트리뷰션 정보를 삭제하여 인스톨 어트리뷰션을 다시 테스트하는 데 사용하려면 어떻게 해야 하나요?

동일한 디바이스에서 SDK 연동을 다시 테스트하려면 Singular 플랫폼에서 디바이스의 어트리뷰션을 지우는 것 외에도 디바이스에서 로컬로 캐시된 모든 데이터를 제거해야 합니다.

Android 디바이스용 단계

  1. 앱을 닫고 앱이 실행되고 있지 않은지 확인합니다(옵션이 있는 경우 설정 메뉴에서 강제 중지를 사용).
  2. 알림 창 또는 앱 메뉴에서 휠 아이콘을 탭하여 설정 메뉴로 이동합니다.
  3. 앱으로 이동하여 테스트 중인 앱을 선택하고 앱을 길게 누른 다음 앱 정보를 선택합니다.
  4. 저장소를 선택한 다음 캐시 지우기데이터 지우기를 선택합니다.
  5. Singular 테스트 콘솔의 드롭다운에서 디바이스를 선택하고 편집(연필) 아이콘을 클릭합니다. 열리는 선반에서 디바이스 삭제를 클릭하여 시스템에서 이 디바이스 어트리뷰션을 삭제하도록 합니다.

     

    device_dropdown.png

    device_delete.png

iOS 디바이스용 단계

  1. 앱을 닫은 다음 제거합니다.
  2. 테스트 콘솔을 열고 드롭다운에서 디바이스를 찾은 다음 편집 아이콘을 클릭합니다. 열리는 선반에서 Delete Device를 클릭하여 시스템에서 이 디바이스 어트리뷰션을 삭제하도록 합니다.

     

팁: 재참여 비활성 창으로 테스트하기

Inactivity Window는 사용자가 비활성 상태여야 리인게이지먼트 어트리뷰션을 받을 수 있는 기간을 결정하는 설정입니다. 캠페인을 시작하기 전에 리인게이지먼트 어트리뷰션을 테스트하는 경우, 비활성 기간으로 인해 테스트가 더 어려워질 수 있습니다. 그렇기 때문에 테스트 기기(테스트 콘솔에 추가되고 눈 아이콘이 활성화된 기기)는 비활성 창에서 제외됩니다.

IDFA로 테스트 중인데 iOS가 테스트 콘솔에 표시되지 않습니다. 어떻게 해야 하나요?

IDFA가 올바른지 다시 확인하세요. 여러 가지 방법으로 확인할 수 있습니다:

  • 앱 스토어에서 Singular 디바이스 어시스트 앱 (iOS)을 사용합니다. 추적 권한을 부여해야 합니다.
  • Xcode의 디버그 콘솔에서 IDFA 로깅하기
  • 이미 한 시간 이상 전에 테스트를 수행한 경우 로그 내보내기로 이동하여 캡처된 이벤트가 있는지 확인할 수 있습니다. 내보내기 로그에서 IDFA/IDFV를 가져올 수 있습니다. 내보내기 로그에서 가져올 때 '앱 추적 투명성 상태'도 보고서에 추가해 보세요. 0 - 미정, ATT 프롬프트가 표시되지 않았음을 의미합니다(일반적으로 일반 설정이 이를 차단하거나 시간 초과가 발생했기 때문). 자세한 내용은 여기에서 확인할 수 있습니다.

기타 확인할 수 있는 사항

  1. 디바이스 설정을 확인합니다: 디바이스의 광고 식별자(IDFA)가 제한되지 않았는지 확인하세요. 디바이스에서 개인정보 추적 설정으로 이동하여 '앱의 추적 요청 허용' 옵션이 활성화되어 있는지 확인합니다. 테스트하는 동안 ATT 프롬프트가 표시되었는지 확인하세요. 표시되지 않았다면 IDFA를 추적하지 않는 것입니다.
  2. 광고 식별자를 재설정합니다: 이전에 테스트에 사용한 적이 있는 디바이스라면 광고 식별자를 재설정하세요. 설정 개인정보 추적으로 이동하여 IDFA를 재설정합니다.
  3. 올바른 구현: Singular SDK가 앱에 올바르게 연동되었는지, 최신 버전의 SDK를 사용하고 있는지 확인합니다.
  4. 데이터가 나타날 때까지 기다립니다: 테스트 콘솔에 데이터가 표시되는 데 지연이 없어야 합니다. 1분 이상 기다리는 경우 설정이 올바르게 이루어지지 않은 것입니다.
  5. SDK 초기화를 검토합니다: 앱의 코드, 특히 앱의 아키텍처에 따라 앱 델리게이트 또는 씬 델리게이트에서 Singular SDK가 올바르게 초기화되었는지 확인합니다.
  6. 오류를 확인합니다: Xcode 콘솔에서 SDK 초기화 또는 이벤트 추적과 관련된 문제를 나타낼 수 있는 오류를 찾아보세요.

이러한 단계를 수행했는데도 문제가 지속되는 경우 자세한 연동 가이드를 검토하거나 Singular 연동 엔지니어에게 추가 지원을 요청해야 할 수 있습니다.

3

특정 기능 테스트

사용자 지정 사용자 아이디 테스트

SDK 연동에서 사용자 지정 사용자 ID를 Singular로 전송하는 경우 테스트하는 방법은 다음과 같습니다.

  1. 테스트 콘솔에 기기를 등록합니다.
  2. 앱을 엽니다.
  3. 필요한 경우 앱에서 사용자 ID를 전송하는 액션(예: 로그인)을 트리거합니다. 액션의 성격은 구현에 따라 다릅니다.
  4. Singular로 전송되는 다음 이벤트에서 테스트 콘솔에서 이벤트 세부 정보를 확장하고 세부 정보에 "custom_user_id" 값이 포함되어 있는지 확인합니다.

    customUserID.png

사용자 ID가 표시되지 않는 경우:

  • 사용자 ID를 설정하는 메서드가 앱에서 원하는 시점에 실제로 호출되고 있는지 확인하세요.
  • 테스트 콘솔에 이벤트가 표시되도록 Singular SDK 이벤트를 추가하고 "사용자 지정 사용자 ID 설정"이라고 호출할 수 있습니다.
테스트 이벤트

SDK 연동에서 이벤트 추적 또는 구매 추적을 구현한 경우 아래 지침에 따라 테스트하세요.

이벤트에 대한 자세한 내용은 다음을 참조하세요:

SDK 연동에서 구현한 모든 이벤트에 대해:

  1. 앱에서 이벤트를 트리거하고 이벤트에 지정한 이름으로 테스트 콘솔 로그에 이벤트가 표시되는지 확인합니다.

    Events.png

  2. 이벤트와 함께 추가 데이터를 전송하는 경우 테스트 콘솔에서 이벤트 행을 클릭하여 이벤트 세부 정보를 확장하고 데이터가'이벤트 데이터'에 포함되어 있는지 확인합니다.

    EventData.png

이벤트가 표시되지 않으면 디바이스가 테스트 콘솔에 완전히 등록되기 전에 앱이 열렸을 수 있습니다. 이벤트 내보내기 로그를 확인하세요.

테스트 구매

SDK 연동에서 구현한 각 유형의 구매 이벤트에 대해:

  1. 앱에서 구매 이벤트를 트리거하고 이벤트 로그를 확인합니다. 이벤트 이름과 함께 행이 표시되어야 합니다.

    참고: 이벤트에 사용자 지정 이름을 지정하지 않은 경우 구매 이벤트의 기본 이름인 "__iap__"를 받습니다.

  2. 행을 클릭하여 행을 확장하고 통화("pcc"), 금액("r") 및 이벤트의 기타 세부 정보가 수신되었는지 확인합니다.

    revenue.png

딥링킹 테스트

SDK 연동에서 딥링킹을 구현한 경우 아래 지침에 따라 딥링킹 기능을 테스트하세요.

참고: 이 문서에서는 조직에서 Singular 링크를 사용한다고 가정합니다.

1. 테스트 대상 설정

싱귤러 플랫폼에서 설정 > 앱으로 이동하여 앱을 찾은 다음 딥링크 대상을 추가합니다.

대상은 SDK 연동에서 핸들러 코드가 인식하고 처리할 수 있는 딥링크 대상 중 하나이어야 합니다.

 test12.png

2. 테스트할 링크 만들기

이제 연결할 대상이 생겼으니 딥링크를 만들 수 있습니다.

  1. 어트리뷰션 > 링크 관리로 이동하여 사이드바에서 앱을 선택합니다.
  2. 링크 생성을 클릭합니다.
  3. 링크 유형에서"커스텀 소스"를 선택하고 소스 이름에서 "이메일"을 선택합니다.
  4. 링크에 이름을 지정합니다.
  5. 링크 설정 및 리디렉션 섹션을 클릭하여 확장합니다.
  6. 딥 링크 드롭다운 목록에서 방금 만든 대상을 선택합니다.
  7. 다른 플랫폼용 대체 목적지 텍스트 상자에 웹사이트 URL을 입력합니다.
  8. 생성을 클릭하고 클릭-스루 추적 링크 필드에서 링크를 복사합니다.

     test13.gif

3. 링크 테스트

링크를 테스트합니다:

  1. 테스트 기기에 앱이 설치되어 있는지 확인합니다.
  2. 복사한 링크를 테스트 장치로 이메일로 보냅니다.
  3. 기기에서 이메일을 열고 링크를 클릭합니다. 앱이 열리고 의도한 페이지 또는 콘텐츠가 표시되어야 합니다.
  4. 테스트 중에 SDK 테스트 콘솔을 사용하는 경우 세션 인수에 딥 링크가 표시되어야 합니다:

    deeplink.png

링크를 테스트하는 다른 방법(Android 전용):

앱이 딥링크를 올바르게 처리하는지 확인하기 위해 ADB(안드로이드 디버그 브리지)를 사용하여 안드로이드 딥링크를 테스트하는 것이 일반적입니다. 다음은 딥링크 테스트를 위해 ADB를 설정하고 사용하는 방법에 대한 단계별 가이드입니다:

전제 조건

  • ADB 설치: ADB가 설치되어 있는지 확인합니다. 이 도구는 Android 개발자 웹사이트에서 다운로드할 수 있는 Android SDK 플랫폼 도구에 포함되어 있습니다.
  • 개발자 옵션을 활성화합니다: Android 디바이스에서 개발자 옵션 및 USB 디버깅을 활성화합니다.
  • 설정 > 휴대폰 정보로 이동하여 빌드 번호를 7번 탭하여 개발자 옵션을 활성화합니다.
  • 설정 > 개발자 옵션으로 이동하여 USB 디버깅을 활성화합니다.
  • 장치 연결하기: USB를 통해 Android 디바이스를 컴퓨터에 연결합니다. 실행하여 ADB에서 인식되는지 확인합니다:

    컴퓨터의 터미널에서 실행합니다:

    adb devices

    이 명령은 장치를 나열해야 합니다.

ADB로 딥 링크 테스트하기

  • ADB를 사용하여 딥링크를 전송합니다: 딥링크를 테스트하려면 adb 셸 am start 명령을 사용합니다. 이 명령은 브라우저나 다른 앱에서 딥링크를 클릭하는 것을 시뮬레이션합니다.

    일반적인 구문은 다음과 같습니다:

    adb shell am start -W -a android.intent.action.VIEW -d "your_deep_link_url"
  • 컴퓨터의 터미널에서 링크를 트리거합니다:

    adb shell am start -W -a android.intent.action.VIEW -d "https://seteam.sng.link/Bnuq6/i428?_dl=androidkotlinapplication%3A%2F%2Fmy_deeplink"

문제 해결

"내 앱이 이미 실행 중일 때 딥링크를 클릭하면 기존 앱으로 전환되는 대신 앱의 새 인스턴스가 열립니다." 이 문제를 방지하려면 매니페스트 파일을 편집하고 활동에 다음을 추가하세요:

android:launchMode="singleTask"

런치모드 옵션에 대한 자세한 내용은 Google의 <활동> 문서를 참조하세요.

디퍼드 딥링킹 테스트

디퍼드 딥링킹이 활성화되어 있는지 확인합니다:

  1. 테스트 콘솔에서 세션 이벤트를 확인합니다.

    ddlEnabled.png

  2. 위의 딥링킹 테스트에 설명된 대로 테스트 대상과 링크를 설정합니다.
  3. 테스트 기기에서 앱을 제거합니다.
  4. 디바이스 광고 식별자를 재설정합니다.
  5. 테스트 콘솔에 새 식별자를 추가합니다.
  6. 디바이스에 딥링크를 이메일로 전송하고 링크를 클릭합니다.

  7. 링크를 클릭하면 앱 스토어로 이동합니다. 참고: 로컬 빌드에서 테스트하는 경우 스토어 버전을 설치하지 말고 Android Studio 또는 Xcode에서 앱을 사이드로드하세요. 앱을 설치하고 앱을 열면 원하는 페이지 또는 콘텐츠가 표시됩니다.

  8. 테스트에 SDK 콘솔을 사용하는 경우 첫 번째 세션 이벤트에서 디퍼드 딥링크 값을 찾아야 합니다.
    deferreddeeplink.png

     

     

제거 추적 테스트

SDK 연동에서 제거 추적을 구현한 경우 아래 지침에 따라 테스트하세요.

제거 추적 테스트는 다른 SDK 기능 테스트보다 더 복잡합니다. Singular는 제거를 보고하기 위해 Google/iOS 서비스에 의존하고 프로세스에 시간이 걸리기 때문입니다. Singular 플랫폼에서는 제거 이벤트를 실시간으로 확인할 수 없으며 테스트 콘솔을 사용할 수 없습니다.

테스트하기 전에 FCM/APNS 토큰을 Singular로 전송하고 있는지 확인하세요( Android SDK: 제거 추적iOS SDK: 제거 추적 참조).

또한 앱 구성 페이지에서 FCM 서버 키 (Android용) 또는 iOS 푸시 인증서를 입력했는지 다시 확인하세요.

제거 추적 테스트하기:

  1. 에뮬레이터가 아닌 실제 디바이스를 사용하여 디바이스에 앱을 설치합니다.
  2. 앱을 열어 설치가 등록되도록 합니다.
  3. 앱을 삭제합니다.
  4. Singular가 제거 이벤트를 수신했는지 확인하려면 몇 가지 옵션이 있습니다:

참고: 제거 이벤트의 유효성 검사를 기다리는 동안 디바이스 ID를 재설정하거나 앱을 다시 설치하지 마세요.

참고: 테스트 콘솔은 iOS TestFlight 앱을 지원하지 않습니다. 테스트 플라이트 빌드는 앱을 실행할 때마다 IDFV를 재설정하므로 라이브 이벤트를 캡처할 수 없습니다.

로그 내보내기 사용

어트리뷰션 > 로그 내보내기를 사용하여 지연된 테스트 결과를 확인할 수도 있습니다. 로그 내보내기 기능을 사용하면 전환(인스톨), 이벤트 등과 같은 사용자 수준 데이터를 수동으로 다운로드할 수 있습니다.

모범 사례

  • 데이터를 가져오기 전에 날짜, 앱, 사이트가 적절하게 선택되었는지 다시 확인하세요.
  • 내보내기 로그의 데이터는 최대 3시간 뒤의 데이터입니다.
  • 자세한 도움말은 이 자주 묻는 질문을 참조하세요.

SDK 감사 실행하기

Singular는 SDK 및 S2S 연동이 올바르게 구현되었는지 테스트하는 SDK 감사 보고서를 제공합니다. 감사는 발견한 모든 문제의 목록과 해결 방법에 대한 팁을 출력합니다. SDK 감사 보고서를 사용하려면 다음과 같이 하세요:

1

SDK 감사 보고서 실행하기

개발자 도구 > 테스트 콘솔로 이동하여 오른쪽 상단 모서리에 있는 감사 실행을 클릭합니다.

tc_03.png

2

보고서를 다운로드하고 관련 문제를 수정합니다.

보고서 실행이 완료되면 CSV 형식으로 다운로드할 수 있습니다.

보고서는 SDK 및 S2S 연동에서 발견된 이슈의 목록입니다. 구현한 기능에 따라 모든 문제가 중요하거나 관련성이 있는 것은 아닙니다.

보고서의 문제를 검토하고 오류 설명 필드의 팁에 따라 문제를 해결하세요.

경고/정보 유형 문제의 경우: 유효성 검사 이름을 확인하여 이 문제가 디퍼드 딥링킹(DDL)과 같이 구현하지 않기로 선택한 선택적 SDK 기능인지 확인합니다. 그렇다면 오류 메시지를 무시해도 됩니다.

SDK 감사는 어떻게 작동하며 어떤 데이터를 대상으로 실행되나요?

SDK 감사는 지난 3일 동안 앱에서 수신한 데이터를 살펴봅니다. 예를 들어 데이터가 예상대로 표시되는지 여부를 확인합니다:

  • 앱이 사용자 세션을 보고하는지 여부(이는 SDK/S2S 연동의 가장 기본적인 기능이며, 싱귤러가 어트리뷰션을 추적할 수 있게 해주는 기능입니다).
  • 앱이 인앱 이벤트 및 구매을 보고하는지 여부
  • 구매이 모범 사례를 사용하여 보고되는지 여부
  • 디퍼드 딥링킹이 활성화되어 있는지 여부
SDK 감사 보고서는 어떻게 읽나요?

 Screen_Shot_2021-11-11_at_18.28.27.png

이 보고서는 SDK 및 S2S 연동에서 발견된 문제 목록입니다.

설명
앱 이름 싱귤러에 구성된 앱의 이름입니다.
앱 번들 Singular에 구성된 앱 번들(예: com.example.appname)입니다.
플랫폼 iOS, Android 또는 Amazon입니다.
앱 버전 앱 버전 번호(있는 경우)입니다.
유효성 검사 이름 문제가 발견된 연동 영역(예: '사용자 지정 사용자 ID' 또는 '구매 이벤트')입니다.
유형

문제의 심각도입니다:

  • 오류: 이 문제로 인해 연동이 작동하지 않으므로 앱을 출시하기 전에 문제를 해결해야 합니다. 예를 들어, Singular가 앱에서 사용자 세션을 수신하지 않습니다. 사용자 세션이 없으면 어트리뷰션을 수행할 수 없습니다.
  • 경고: 이 문제 없이도 연동이 작동할 수 있지만, 모범 사례를 따르고 싱귤러 어트리뷰션 트래커를 최대한 활용하려면 이 문제를 해결해야 합니다. 예를 들어, 앱에서 사용자 지정 사용자 ID를 전송하지 않는 경우입니다. 사용자 지정 사용자 ID는 선택적 기능이지만 적극 권장됩니다.
  • 정보: 이 문제는 연동에서 구현하지 않기로 선택한 선택적 기능과 관련이 있습니다. 예를 들어 앱에서 디퍼드 딥링킹(DDL)이 활성화되어 있지 않습니다. DDL이 마케팅 전략과 관련이 없을 수도 있습니다.
오류 설명 문제와 해결 방법에 대한 자세한 정보입니다.