등록 단계

1. Singular 플랫폼에서 Developer Tools → 테스팅 콘솔 로 이동하세요.
2. 기기 추가 버튼을 클릭하세요.
3. 드롭다운에서 기기 유형 을 선택하세요:
   • Android: 우선순위에 따라 Google 광고 ID(GAID/aifa), AppSetID(asid), 또는 AndroidID(andi)를 사용하세요.
   • iOS: 가능한 경우 IDFA를 사용하세요(ATT 동의 필요). 그렇지 않으면 IDFV를 사용하세요.
4. 기기에서 캡처한 기기 ID 를 입력하세요.
5. 쉬운 식별을 위해 구분하기 쉬운 기기 이름 을 입력하세요.
6. 기기 저장 을 클릭하여 등록을 완료하세요.

Android 기기 식별자

권장 방법: Singular Device Assist 앱( Android )을 사용하여 GAID/aifa를 가져오세요.

대체 방법: Singular SDK 로깅을 활성화하고 Android LogCat에서 식별자를 캡처하세요:

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 기기 식별자

IDFA 캡처: ATT 프레임워크가 구현되어 있고 추적이 허가된 경우에 사용하세요.

방법 1: Singular Device Assist 앱( iOS ) - 프롬프트 표시 시 추적 권한을 허가하세요.

방법 2: Xcode 디버그 콘솔에서 IDFA를 로깅하세요:

// Example in Swift
print("IDFA", ASIdentifierManager.shared().advertisingIdentifier.uuidString)

// Example in Objective-C
NSString *IDFA = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
NSLog(@"IDFA: %@", IDFA);

IDFV 캡처: ATT가 구현되지 않았거나 추적이 허가되지 않은 경우에 사용하세요.

// Example in Swift
print("IDFV", UIDevice.current.identifierForVendor!.uuidString)

// Example in Objective-C
NSString *IDFV = [[[UIDevice currentDevice] identifierForVendor] UUIDString];
NSLog(@"IDFV: %@", IDFV);

목적

크로스 디바이스 유저 추적 및 분석을 위해 커스텀 유저 ID가 올바르게 Singular로 전송되는지 검증합니다.

테스트 절차

1. 테스팅 콘솔에 기기를 등록하세요.
2. 테스트 기기에서 앱을 실행하세요.
3. 자동으로 전송되지 않는 경우 유저 ID를 전송하는 액션(예: 로그인)을 트리거하세요.
4. 테스팅 콘솔에서 이벤트 상세 정보를 펼쳐 custom_user_id 필드에 예상값이 포함되어 있는지 확인하세요.

문제 해결

커스텀 유저 ID가 표시되지 않는 경우:

• 유저 ID를 설정하는 메서드가 앱 흐름의 적절한 시점에 실제로 호출되는지 확인하세요.
• 테스팅 콘솔에서 가시성을 높이기 위해 "setting_custom_user_id"라는 Singular SDK 이벤트를 추가하세요.
• SDK 로그에서 유저 ID 할당 확인 메시지를 확인하세요.

목적

이벤트 추적 구현이 올바른 이름과 속성으로 이벤트를 Singular에 전송하는지 검증합니다.

테스트 절차

SDK 연동에서 구현된 각 이벤트에 대해:

1. 앱에서 이벤트를 트리거하고 테스팅 콘솔에 올바른 이름으로 이벤트가 표시되는지 확인하세요.
2. 이벤트 행을 클릭하여 상세 정보를 펼치고 Event Data 섹션에 예상 속성이 포함되어 있는지 확인하세요.

문제 해결

이벤트가 표시되지 않는 경우:

• 테스팅 콘솔에 기기가 완전히 등록된 후 앱을 실행했는지 확인하세요.
• Export Logs 에서 이벤트를 확인하세요 (약 3시간 지연 후 이용 가능).
• 앱에서 이벤트 트리거 코드가 올바르게 실행되었는지 확인하세요.

추가 리소스

• 이벤트 측정 이해하기
• Singular 표준 이벤트 참조

목적

매출 추적 구현이 구매 금액, 통화 및 추가 매출 세부 정보를 올바르게 리포트하는지 검증합니다.

테스트 절차

구현된 각 매출 이벤트 유형에 대해:

1. 앱에서 매출 이벤트를 트리거하고 테스팅 콘솔에 이벤트가 표시되는지 확인하세요.
2. 이벤트 행을 펼쳐 다음 필드가 존재하는지 확인하세요:
   • pcc - 통화 코드(예: USD, EUR)
   • r - 매출 금액
   • 구현된 경우 추가 매출 이벤트 속성

추가 리소스

• 인앱 구매 검증 FAQ

목적

딥링크 구현이 Singular Links를 올바르게 처리하고 사용자를 앱 내 의도한 목적지로 안내하는지 검증합니다.

1. 테스트 목적지 설정

1. Singular 플랫폼에서 Settings → Apps 로 이동하세요.
2. 앱을 찾아 클릭하여 구성을 여세요.
3. SDK 연동의 목적지 핸들러 코드가 인식하는 딥링크 목적지를 추가하세요.

2. 테스트 링크 생성

1. Attribution → Manage Links 로 이동하여 앱을 선택하세요.
2. Create Link 를 클릭하세요.
3. Link Type 에서 "Custom Source"를 선택하고 Source Name 에서 "Email"을 선택하세요.
4. 링크 이름을 입력하세요.
5. Link Settings and Redirects 섹션을 펼치세요.
6. Deep Link 드롭다운에서 테스트 목적지를 선택하세요.
7. Fallback Destination for Other Platforms 필드에 웹사이트 URL을 입력하세요.
8. Generate 를 클릭하고 Click-Through Tracking Link 필드에서 링크를 복사하세요.

3. 링크 기능 테스트

1. 테스트 기기에 앱이 설치되어 있는지 확인하세요.
2. 복사한 링크를 테스트 기기로 이메일로 보내세요.
3. 기기에서 이메일을 열고 링크를 클릭하면 앱이 의도한 페이지/콘텐츠를 표시하며 열려야 합니다.
4. 테스팅 콘솔에서 Session 인수에 딥링크 값이 표시되는지 확인하세요.

Android 테스트 대안

커맨드라인 검증을 위해 ADB(Android Debug Bridge) 를 사용하여 Android 딥링크를 테스트하세요.

사전 요구사항:

• ADB 설치(Android SDK 플랫폼 도구에 포함)
• 기기에서 개발자 옵션 및 USB 디버깅 활성화
• USB로 기기를 컴퓨터에 연결

테스트 명령어:

adb shell am start -W -a android.intent.action.VIEW -d "https://yourdomain.sng.link/xxxxx?_dl=yourapp://deeplink"

문제 해결

문제: 딥링크가 기존 인스턴스로 전환되지 않고 새 앱 인스턴스를 여는 경우.

해결 방법: AndroidManifest.xml의 액티비티에 다음을 추가하세요:

android:launchMode="singleTask"

launchMode 옵션에 대해서는 Google의 <activity> 문서 를 참조하세요.

목적

지연 딥링크 가 앱 설치 전에 클릭된 링크를 올바르게 처리하여 첫 번째 실행 시 사용자를 의도한 목적지로 안내하는지 검증합니다.

테스트 절차

1. 테스팅 콘솔에서 세션 이벤트를 확인하여 지연 딥링크가 활성화되어 있는지 확인하세요.
2. 위의 딥링크 단계에 따라 테스트 목적지와 링크를 설정하세요.
3. 테스트 기기에서 앱을 제거하세요.
4. 기기 광고 식별자를 초기화하세요.
5. 테스팅 콘솔에 새 식별자를 추가하세요.
6. 딥링크를 기기로 이메일로 보내고 기기에서 링크를 클릭하세요.
7. 링크가 앱 스토어로 리디렉션되어야 합니다. 앱을 설치하세요 (로컬 빌드의 경우 스토어 버전 대신 Android Studio 또는 Xcode에서 사이드로드하세요).
8. 설치 후 앱을 열면 딥링크에 지정된 의도한 페이지/콘텐츠가 표시되어야 합니다.
9. 테스팅 콘솔에서 첫 번째 세션 이벤트에 지연 딥링크 값이 표시되는지 확인하세요.

목적

앱 삭제 추적 구현이 이탈 분석을 위한 앱 삭제를 올바르게 감지하고 리포트하는지 검증합니다.

사전 요구사항

테스트 전에 다음을 확인하세요:

• FCM/APNS 토큰이 Singular에 전송되었는지 확인하세요 ( Android SDK: 앱 삭제 추적 및 iOS SDK: 앱 삭제 추적 참조).
• 앱 구성 페이지에 FCM Server Key (Android) 또는 iOS Push Certificate 가 입력되어 있는지 확인하세요.

테스트 절차

1. 실제 기기 (에뮬레이터 아님)에 앱을 설치하세요.
2. 앱을 열어 Singular에 설치가 등록되도록 하세요.
3. 기기에서 앱을 제거하세요.
4. 다음 방법 중 하나를 사용하여 앱 삭제 이벤트를 확인하세요:
   • 어트리뷰션 로그를 내보내고 앱 삭제 이벤트를 찾으세요 (나타나는 데 며칠이 걸릴 수 있습니다).
   • 내부 BI 시스템으로 포스트백 이 구성된 경우, 앱 삭제에 대한 포스트백을 수신하세요.
   • 검증 지원을 위해 Singular 지원팀 또는 고객 성공 매니저에게 문의하세요.

일반적인 원인

기기가 등록되었는데도 Events Log에 이벤트가 표시되지 않는 경우 다음을 확인하세요:

• 실시간 모니터링 필요: 테스팅 콘솔은 기기가 선택되고 🟢 라이브 표시가 활성화된 경우에만 이벤트를 실시간으로 표시합니다. 과거 이벤트는 가져오지 않습니다.
• 앱 실행: 세션 이벤트를 생성하기 위해 테스트 기기에서 앱이 실행되었는지 확인하세요.
• 이벤트 트리거: 특정 이벤트를 테스트하는 경우 앱에서 트리거 액션이 수행되었는지 확인하세요.
• 기기 ID 정확성: 테스팅 콘솔에 입력된 기기 ID가 올바른지 다시 확인하세요.
• 기기 ID 유형: ATT 프롬프트 없는 iOS의 경우 IDFA를 사용할 수 없으며 대신 IDFV를 사용해야 합니다.

SDK 버전 12.0.0 이상

Singular SDK 12.0.0부터는 _InstallReferrer 이벤트를 테스트할 필요가 없습니다. 앱이 스토어에 업로드되면 SDK가 첫 번째 세션에 자동으로 _InstallReferrer 데이터를 포함시킵니다. 테스팅 콘솔에 세션이 표시되는지만 확인하면 됩니다.

SDK 버전 <12.0.0>

이전 Android SDK 버전의 경우, 올바른 설치 어트리뷰션을 위해 테스팅 콘솔에서 _InstallReferrer 이벤트를 여전히 확인해야 합니다.

확인 단계

IDFA 정확성 재확인:

• 추적 권한이 부여된 Singular Device Assist 앱(iOS) 사용
• Xcode 디버그 콘솔에서 IDFA 로깅
• "App Tracking Transparency status" 필드로 Export Logs 확인(1시간+ 후) - 값이 0(미확인)이면 ATT 프롬프트가 표시되지 않은 것입니다.

구성 확인

1. 기기 설정: Settings → Privacy → Tracking에서 "Allow Apps to Request to Track"이 활성화되어 있는지 확인하세요.
2. ATT 프롬프트: 테스팅 중 ATT 프롬프트가 표시되었는지 확인하세요. 표시되지 않은 경우 IDFA가 추적되지 않습니다.
3. IDFA 초기화: 기기가 이전에 사용된 경우 Settings → Privacy → Tracking에서 광고 식별자를 초기화하세요.
4. SDK 버전: 최신 Singular SDK 버전이 올바르게 연동되었는지 확인하세요.
5. SDK 초기화: SDK가 문서에 따라 AppDelegate 또는 SceneDelegate에서 초기화되었는지 확인하세요.
6. 오류 확인: SDK 초기화 또는 추적 오류에 대해 Xcode 콘솔을 검토하세요.

단계를 따른 후에도 문제가 지속되면 Apple ATT 문서 를 참조하거나 Singular 연동 엔지니어에게 문의하세요.

삭제 절차

1. 테스팅 콘솔의 기기 옆에 있는 편집 아이콘을 클릭하세요.
2. 표시되는 사이드바에서 기기 삭제 를 클릭하세요.
3. 삭제하면 모든 이벤트 로그가 지워지고 Singular에서 기기의 어트리뷰션 데이터가 제거됩니다.

참조: 설치 어트리뷰션 테스트를 위한 기기 초기화 방법

초기화 요구사항

동일한 기기로 SDK 연동을 재테스트하려면 기기에서 로컬 캐시 데이터를 제거하고 Singular 플랫폼에서 기기의 어트리뷰션을 지워야 합니다.

Android 초기화 단계

1. 앱을 닫고 실행 중이 아닌지 확인하세요 (가능한 경우 강제 종료 사용).
2. 설정 메뉴로 이동하세요.
3. 앱 으로 이동하여 앱을 길게 누르고 앱 정보 를 선택하세요.
4. 저장소 를 선택하고 캐시 지우기 와 데이터 지우기 를 클릭하세요.
5. 테스팅 콘솔에서 기기를 선택하고 편집 아이콘을 클릭한 후 기기 삭제 를 클릭하여 어트리뷰션을 제거하세요.

iOS 초기화 단계

1. 앱을 닫고 기기에서 제거하세요.
2. 테스팅 콘솔에서 기기를 찾아 편집 아이콘을 클릭한 후 기기 삭제 를 클릭하여 어트리뷰션을 제거하세요.

Events Log 인터페이스

기기를 등록하고 이벤트를 전송한 후, 이벤트는 실시간 업데이트와 함께 테스팅 콘솔 Events Log에 표시됩니다.

이벤트 상세 정보

이벤트 행을 클릭하여 펼치면 모든 파라미터 및 속성을 포함하여 앱에서 전송된 완전한 이벤트 상세 정보를 볼 수 있습니다.

해결 우선순위

프로덕션 출시 전 반드시 해결해야 합니다 - 이 문제들은 핵심 기능을 방해합니다.

일반적인 오류 문제

• 세션 미수신: SDK가 초기화되지 않았거나 Singular에 데이터를 전송하지 않는 경우
• 잘못된 SDK 키: 잘못된 SDK 키 또는 시크릿이 구성된 경우
• 플랫폼 불일치: 앱이 잘못된 플랫폼 식별자를 리포트하는 경우

해결 방법

1. 구체적인 안내를 위해 Error Description을 검토하세요.
2. 영향받는 플랫폼의 SDK 연동 가이드를 참조하세요.
3. SDK 구성 및 초기화 코드를 검증하세요.
4. 수정 후 테스팅 콘솔을 사용하여 재테스트하세요.
5. 새 SDK Audit을 실행하여 해결을 확인하세요.

해결 우선순위

모범 사례를 위해 해결을 권장합니다 - 연동은 작동하지만 개선이 권장됩니다.

일반적인 중요 문제

• 커스텀 유저 ID 없음: 크로스 디바이스 추적을 위한 커스텀 유저 ID가 구현되지 않은 경우
• 매출 추적 문제: 매출 이벤트가 모범 사례를 따르지 않는 경우
• 이벤트 속성 누락: 권장 속성 없이 이벤트가 추적되는 경우

해결 방법

1. 누락된 기능의 비즈니스 영향을 평가하세요.
2. 기능에 대한 구현 문서를 검토하세요.
3. 기능이 요구사항에 부합하는 경우 구현하세요.
4. 테스팅 콘솔을 사용하여 구현을 테스트하세요.

해결 우선순위

검토 후 결정하세요 - 특정 사용 사례에 적용되지 않을 수 있는 선택적 기능입니다.

일반적인 정보 문제

• 지연 딥링크 비활성화: DDL이 마케팅 전략에 관련이 없을 수 있는 경우
• 앱 삭제 추적 미구성: 요구사항에 따라 앱 삭제 추적이 선택적인 경우
• 선택적 SDK 기능: 기본 기능에 중요하지 않은 추가 기능

해결 방법

1. Validation Name을 검토하여 선택적 기능을 식별하세요.
2. 기능이 비즈니스 요구사항과 관련이 있는지 확인하세요.
3. 관련이 없는 경우 문제를 안전하게 무시하세요.
4. 관련이 있는 경우 SDK 문서를 따라 구현하세요.