등록 단계

1. Singular 플랫폼에서 개발자 도구 → 테스트 콘솔로이동합니다.
2. 장치 추가 버튼을 클릭합니다.
3. 드롭다운에서 디바이스 유형을 선택합니다:
   • Android: 구글 광고 ID(GAID/aifa), 앱셋ID(asid), 안드로이드ID(andi) 순으로 선호합니다.
   • iOS: 사용 가능한 경우 IDFA를 사용하고(ATT 동의 필요), 그렇지 않은 경우 IDFV를 사용합니다.
4. 디바이스에서 캡처한 디바이스 ID 입력
5. 쉽게 식별할 수 있도록 고유한 장치 이름을 입력합니다.
6. 장치 저장을 클릭하여 등록을 완료합니다.

안드로이드 기기 식별자

권장 방법: Singular 디바이스 지원 앱(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 기기 지원 앱(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);

목적

크로스 디바이스 사용자 추적 및 분석을 위해 Singular로 전송된 사용자 지정 사용자 ID가 제대로 전송되었는지 검증합니다.

테스트 절차

1. 테스트 콘솔에 디바이스 등록
2. 테스트 기기에서 앱 열기
3. 자동으로 전송되지 않는 경우 사용자 ID(예: 로그인)를 전송하는 액션을 트리거합니다.
4. 테스트 콘솔에서 이벤트 세부 정보를 확장하고 custom_user_id필드에 예상 값이 포함되어 있는지 확인합니다.

문제 해결

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

• 앱 흐름에서 적절한 시점에 실제로 호출된 메서드 설정 사용자 ID를 확인합니다.
• 테스트 콘솔에서 가시성을 위해 "setting_custom_user_id"라는 이름의 Singular SDK 이벤트를 추가합니다.
• 사용자 ID 할당 확인을 위해 SDK 로그 확인

목적

이벤트 추적 구현이 올바른 이름과 속성을 가진 이벤트를 Singular에 전송하는지 확인합니다.

테스트 절차

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

1. 앱에서 이벤트를 트리거하고 테스트 콘솔에 올바른 이름으로 이벤트가 표시되는지 확인합니다.
2. 이벤트 행을 클릭하여 세부 정보를 확장하고 이벤트 데이터섹션에 예상 속성이 포함되어 있는지 확인합니다.

문제 해결

이벤트가 나타나지 않는 경우:

• 디바이스가 테스트 콘솔에 완전히 등록된 후 앱이 열렸는지 확인합니다.
• 이벤트 내보내기 로그를확인합니다(최대 3시간 지연 후 사용 가능).
• 앱에서 이벤트 트리거 코드가 제대로 실행되었는지 확인합니다.

추가 리소스

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

목적

구매 추적 구현이 구매 금액, 통화 및 추가 구매 세부 정보를 올바르게 보고하는지 확인합니다.

테스트 절차

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

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

추가 리소스

• 인앱 구매 유효성 검사 FAQ

목적

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

1. 테스트 대상 설정

1. 설정 → Singular 플랫폼의 앱으로 이동합니다.
2. 앱을 찾아 클릭하여 구성을 엽니다.
3. SDK 연동에서 딥링크 대상과 일치하는 대상 핸들러 코드를 추가하여 인식합니다.

2. 테스트 링크 생성

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

3. 링크 기능 테스트

1. 테스트 디바이스에 앱이 설치되어 있는지 확인합니다.
2. 테스트 기기에 복사된 링크를 이메일로 전송
3. 디바이스에서 이메일을 열고 링크를 클릭합니다. 앱이 의도한 페이지/콘텐츠를 표시하며 열립니다.
4. 테스트 콘솔에서 세션 인수에 딥링크 값이 표시되는지 확인합니다.

안드로이드 테스트 대안

명령줄 유효성 검사를 위해 ADB(안드로이드 디버그 브리지)를 사용하여 안드로이드 딥링크를 테스트합니다.

전제 조건:

• 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"

실행 모드 옵션은 Google의 <활동> 문서를참조하세요.

목적

디퍼드 딥링킹이앱 설치 전에 클릭한 링크를 올바르게 처리하여 첫 실행 시 사용자를 의도한 목적지로 안내하는지 확인합니다.

테스트 절차

1. 테스트 콘솔에서 세션 이벤트를 확인하여 디퍼드 딥링킹이 활성화되었는지 확인합니다.
2. 위의 딥링킹 단계에 따라 테스트 대상과 링크를 설정합니다.
3. 테스트 기기에서 앱 제거
4. 디바이스 광고 식별자 재설정
5. 테스트 콘솔에 새 식별자 추가
6. 디바이스에 딥링크를 이메일로 전송하고 디바이스에서 링크를 클릭합니다.
7. 링크가 앱 스토어로 리디렉션되어야 합니다 - 앱 설치(로컬 빌드의 경우, 스토어 버전 대신 안드로이드 스튜디오 또는 Xcode에서 사이드로드).
8. 설치 후 앱을 열면 딥링크에 지정된 페이지/콘텐츠가 표시되어야 합니다.
9. 테스트 콘솔에서 첫 번째 세션 이벤트에 디퍼드 딥링크값이 표시되는지 확인합니다.

목적

앱 제거 추적 구현이 이탈 분석을 위해 앱 제거를 올바르게 감지하고 보고하는지 검증합니다.

전제 조건

테스트하기 전에 다음을 확인합니다:

• Singular로 전송된 FCM/APNS 토큰( Android SDK: 제거 추적및 iOS SDK: 제거 추적 참조)
• 앱 구성 페이지에 입력한 FCM 서버 키 (안드로이드) 또는 iOS 푸시 인증서

테스트 절차

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

일반적인 원인

디바이스가 등록되어 있는데 이벤트 로그에 이벤트가 표시되지 않는 경우 다음을 확인하세요:

• 실시간 모니터링이 필요합니다: 테스트 콘솔은 디바이스가 선택되어 있고 🟢 라이브 표시기가 표시된 경우에만 이벤트를 실시간으로 표시합니다. 과거 이벤트를 검색하지 않음
• 앱이 열렸습니다: 세션 이벤트를 생성하기 위해 테스트 기기에서 앱이 열려 있는지 확인합니다.
• 이벤트 트리거됨: 특정 이벤트를 테스트하는 경우 앱에서 트리거 작업이 수행되었는지 확인합니다.
• 디바이스 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 디바이스 어시스트 앱(iOS)을 사용합니다.
• Xcode 디버그 콘솔에서 IDFA를 로그합니다.
• "앱 추적 투명성 상태" 필드에서 로그 내보내기(1시간 이상 경과 후) 확인 - 값 0(미정)은 ATT 프롬프트가 표시되지 않음을 의미합니다.

구성 확인

1. 기기 설정: 설정 확인 → 개인정보 → 추적에 "앱의 추적 요청 허용"이 활성화되어 있습니다.
2. ATT 프롬프트: 테스트 중 ATT 프롬프트가 표시되는지 확인 - 표시되지 않으면 IDFA가 추적되지 않는 것입니다.
3. IDFA 재설정: 이전에 사용한 기기인 경우, 설정 → 개인정보 → 추적에서 광고 식별자를 재설정합니다.
4. SDK 버전: 최신 Singular SDK 버전이 올바르게 연동되었는지 확인합니다.
5. SDK 초기화: 문서에 따라 앱디렉티브 또는 씬디렉티브에서 SDK가 초기화되었는지 확인합니다.
6. 오류 확인: Xcode 콘솔에서 SDK 초기화 또는 추적 오류를 검토합니다.

다음 단계를 수행한 후에도 문제가 지속되면 Apple ATT 설명서를참조하거나 Singular 연동 엔지니어에게 문의하세요.

삭제 프로세스

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

참조: 인스톨 어트리뷰션 테스트를 위해 디바이스를 재설정하는 방법

재설정 요구 사항

동일한 디바이스에서 SDK 연동을 다시 테스트하려면, 디바이스에서 로컬로 캐시된 데이터를 제거하고 Singular 플랫폼에서 디바이스의 어트리뷰션을 지웁니다.

안드로이드 재설정 단계

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

iOS 재설정 단계

1. 앱을 닫고 기기에서 제거
2. 테스트 콘솔에서 디바이스를 찾아 편집 아이콘을 클릭한 다음, 디바이스 삭 제를 클릭하여 어트리뷰션을 제거합니다.

이벤트 로그 인터페이스

디바이스를 등록하고 이벤트를 전송하면, 이벤트는 실시간 업데이트와 함께 테스트 콘솔 이벤트 로그에 표시됩니다.

이벤트 세부 정보

이벤트 행을 클릭하면 앱에서 전송된 모든 매개변수 및 속성을 포함한 전체 이벤트 세부 정보를 확장하여 볼 수 있습니다.

해결 우선순위

프로덕션 릴리스 전에 해결해야 함 - 핵심 기능을 방해하는 문제입니다.

일반적인 오류 문제

• 수신된 세션이 없습니다: SDK가 초기화되지 않았거나 Singular로 데이터를 전송하지 않음
• 잘못된 SDK 키: 잘못된 SDK 키 또는 시크릿이 구성됨
• 플랫폼 불일치: 앱이 잘못된 플랫폼 식별자를 보고함

해결 방법

1. 구체적인 지침은 오류 설명을 검토하세요.
2. 해당 플랫폼에 대한 SDK 연동 가이드를 참조하세요.
3. SDK 구성 및 초기화 코드 확인
4. 수정 후 테스트 콘솔을 사용하여 다시 테스트합니다.
5. 새 SDK 감사를 실행하여 해결 확인

해결 우선 순위

모범 사례를 위해 해결해야 함 - 연동 기능이지만 개선이 권장됩니다.

일반적인 중요 문제

• 사용자 지정 사용자 ID가 없습니다: 교차 기기 추적을 위한 사용자 지정 사용자 ID가 구현되지 않았습니다.
• 구매 추적 문제: 모범 사례를 따르지 않는 구매 이벤트
• 누락된 이벤트 속성: 권장 속성 없이 이벤트가 추적됨

해결 접근 방식

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

해결 우선 순위

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

일반적인 정보 문제

• 디퍼드 딥링킹이 비활성화되었습니다: DDL이 마케팅 전략과 관련이 없을 수 있습니다.
• 추적 제거가 구성되지 않았습니다: 요구 사항에 따라 추적 제거 옵션 사용
• 선택적 SDK 기능: 기본 기능에 중요하지 않은 추가 기능

해결 접근 방식

1. 유효성 검사 이름을 검토하여 선택적 기능을 식별합니다.
2. 기능이 비즈니스 요구 사항과 관련이 있는지 확인
3. 관련성이 없는 경우 안전하게 문제 무시
4. 관련성이 있는 경우 다음 SDK 설명서를 구현합니다.