이벤트 설명

고유 기기의 앱 설치 및 첫 번째 세션을 나타내며, 기본 설치 어트리뷰션 이벤트로 사용됩니다.

추적 트리거

자동 추적 — 고유 기기 식별자에 대해 SDK/S2S 연동을 통해 첫 번째 세션이 전송될 때 추적됩니다.

기술 세부 정보

이벤트 설명

모든 앱 실행 및 유저 세션을 추적하며, 인게이지먼트 및 리텐션 지표의 기반을 제공합니다.

추적 트리거

자동 추적 — SDK/S2S 연동을 통해 세션이 전송될 때 추적됩니다. 첫 번째 세션(설치)과 이후 모든 앱 실행을 포함합니다.

세션 정의

세션은 앱이 포그라운드로 전환될 때 시작되며, 앱이 백그라운드로 전환된 후 설정 가능한 타임아웃 기간(기본값: 60초)이 지나면 종료됩니다.

기술 세부 정보

분석에서의 활용

세션 이벤트는 여러 파생 지표를 구동합니다:

• 일별 활성 유저(DAU): 특정 날에 세션이 있는 고유 유저 수
• 리텐션율: 이후 세션에 복귀하는 유저의 비율
• 세션 빈도: 일정 기간 동안 유저당 평균 세션 수
• 리인게이지먼트 어트리뷰션: 리인게이지먼트 캠페인에서 발생한 세션

이벤트 설명

맞춤 이벤트 이름 없이 SDK 매출 메서드를 통해 보고된 인앱 구매 및 매출 이벤트를 추적합니다.

추적 트리거

SDK/S2S 연동이 매출 메서드 를 통해 매출 이벤트를 보고할 때 추적됩니다. 단, SDK 설정에서 매출 이벤트에 맞춤 이름이 없어야 합니다.

기술 세부 정보

구현 예시

iOS SDK:

// Track revenue without custom event name (appears as __iap__)
Singular.revenue(withAmount: 9.99, currency: "USD")

Android SDK:

// Track revenue without custom event name (appears as __iap__)
Singular.revenue("USD", 9.99);

S2S 매출:

amt=9.99&cur=USD&is_revenue_event=true

이벤트 설명

매출 소스나 이벤트 이름에 관계없이 어떤 유형의 매출이든 보고될 때마다 자동으로 트리거되는 집계 매출 이벤트입니다.

추적 트리거

자동 추적 — 어떤 방법으로든 매출이 보고될 경우 추적됩니다:

• __iap__ 이벤트 트리거 시(기본 매출 이벤트)
• SDK가 광고 구매화 매출 이벤트를 보고할 때
• S2S가 맞춤 이벤트 이름(예: "purchase")으로 매출을 보고할 때
• "refund" 또는 "offline_purchase"와 같은 기타 매출 이벤트가 보고될 때

포스트백 설정 주의사항

기술 세부 정보

활용 사례

__REVENUE__ 를 사용해야 할 경우:

• 파트너 플랫폼에 모든 매출 유형에 대한 Singular 포스트백 전송
• 이벤트별 분류 없이 집계 매출 보고
• 하나의 매출 이벤트로 파트너 설정 간소화

특정 매출 이벤트를 사용해야 할 경우:

• IAP, 구독, 광고 구매화의 별도 추적
• 파트너 플랫폼에서 이벤트별 최적화
• 이벤트 유형별 상세 매출 어트리뷰션

이벤트 설명

앱 삭제를 추적하여 이탈 분석 및 리인게이지먼트 캠페인 타겟팅을 지원합니다.

추적 트리거

자동 추적 — iOS 또는 Android 앱에 대해 앱 삭제 추적이 활성화되고, 하나 이상의 앱 삭제가 감지될 경우 추적됩니다. 기기에서 앱 삭제가 감지되면, 재설치 또는 데이터 보존 한도에 도달할 때까지 하루에 한 번 이벤트가 트리거됩니다.

전제 조건

__UNINSTALL__ 이벤트가 표시되려면 Singular 플랫폼에서 앱 삭제 추적을 명시적으로 활성화해야 합니다.

플랫폼별 설정:

• iOS 앱 삭제 추적 시작하기
• Android 앱 삭제 추적 시작하기

기술 세부 정보

앱 삭제 감지 방법

iOS: 사일런트 푸시 알림 검증

Android: FCM (Firebase Cloud Messaging) 검증

이벤트 설명

이전 삭제 후 앱 재설치를 추적하여 윈백 캠페인 측정 및 유저 라이프사이클 분석을 지원합니다.

추적 트리거

자동 추적 — SDK/S2S를 통해 앱 삭제 추적이 활성화된 경우 추적됩니다. 기기에 대해 __UNINSTALL__ 이 추적된 후 이어서 __SESSION__ 이 트리거되면 __REINSTALL__ 이벤트가 자동으로 발생합니다.

트리거 순서

1. 최초 설치: 유저가 앱을 설치하면 __START__ 및 __SESSION__ 이 추적됩니다
2. 앱 사용: 유저가 앱을 사용하며 여러 __SESSION__ 이벤트가 추적됩니다
3. 앱 삭제: 유저가 앱을 삭제하면 __UNINSTALL__ 이 감지 및 추적됩니다
4. 재설치: 유저가 앱을 재설치하고 실행합니다
5. 재설치 감지: __UNINSTALL__ 이후 첫 번째 __SESSION__ 이 __REINSTALL__ 이벤트를 트리거합니다

기술 세부 정보

어트리뷰션 고려사항

재설치 전 유저가 캠페인 링크를 클릭한 경우 리인게이지먼트 캠페인에 어트리뷰션될 수 있습니다. 어트리뷰션 기간 설정은 최초 설치 어트리뷰션과 동일하게 재설치 어트리뷰션에도 적용됩니다.

지표 정의

고유 기기의 첫 번째 세션을 추적하며, 새로운 앱 설치 및 기본 어트리뷰션 지표를 나타냅니다.

계산 방법

보고 기간 내 첫 번째 __SESSION__ 이벤트가 있는 고유 기기 식별자 수입니다.

보고에서의 활용

• 캠페인 성과 측정
• 소스 및 채널별 설치 어트리뷰션
• 설치당 비용(CPI) 계산
• 설치 퍼널 분석

지표 정의

리인게이지먼트 캠페인으로 트리거된 세션을 추적하여 기존 유저를 대상으로 하는 캠페인의 효과를 측정합니다.

설정 의존성

리인게이지먼트 추적은 리인게이지먼트 어트리뷰션 기간 및 캠페인 파라미터를 정의하는 파트너 설정에 따라 달라집니다.

계산 방법

유저의 첫 번째 또는 이후 세션 여부에 관계없이, 설정된 어트리뷰션 기간 내 리인게이지먼트 캠페인에 어트리뷰션된 세션 수입니다.

보고에서의 활용

• 리인게이지먼트 캠페인 ROI 측정
• 휴면 유저 활성화율
• 채널 간 리인게이지먼트 성과
• 유저 라이프사이클 단계 전환

지표 정의

특정 날에 하나 이상의 세션이 있는 고유 유저의 일별 수로, 활성 유저 기반의 규모를 측정합니다.

계산 방법

특정 날짜에 하나 이상의 __SESSION__ 이벤트가 있는 고유 기기 식별자 수입니다.

관련 지표

• WAU: 주별 활성 유저 (7일 고유 유저 수)
• MAU: 월별 활성 유저 (30일 고유 유저 수)
• DAU/MAU 비율: 스티키니스 지표 (DAU를 MAU로 나눈 값)

보고에서의 활용

• 앱 인게이지먼트 추세 분석
• 유저 기반 성장 측정
• 계절적 사용 패턴 파악
• 플랫폼 건전성 모니터링

지표 정의

앱을 설치(첫 번째 세션)한 후 지정된 기간 내에 추가 세션을 위해 복귀한 유저의 비율입니다.

계산 방법

(설치 후 N일차에 세션이 있는 유저 수 / Day 0에 설치한 총 유저 수) × 100

리텐션 유형

보고에서의 활용

• 제품-시장 적합성 평가
• 온보딩 효과 측정
• 캠페인 품질 비교 (높은/낮은 리텐션 소스)
• 이탈 예측 및 방지

지표 정의

광고 구매화를 제외한 IAP(인앱 구매), 맞춤 매출 이벤트, 구독 매출을 추적합니다.

포함 매출 소스

• __iap__ 이벤트 (기본 매출 이벤트)
• 맞춤 매출 이벤트 (purchase, subscription 등)
• 구독 갱신 및 업그레이드
• 일회성 구매 및 소모성 아이템

제외 매출 소스

• 광고 구매화 매출 (Ad Mon Revenue에서 별도 추적)

보고에서의 활용

• 캠페인 ROI 및 ROAS 계산
• 유저 LTV 측정
• 구매화 퍼널 분석
• 소스별 매출 어트리뷰션

지표 정의

광고 구매화 이벤트에서 발생한 매출만을 추적하며, 광고 수입을 구매 매출과 분리합니다.

포함 매출 소스

• 배너 광고 노출
• 전면 광고 조회
• 보상형 동영상 완료
• 네이티브 광고 인게이지먼트
• 오퍼월 완료

구현 요구사항

광고 구매화 SDK 연동 또는 적절한 이벤트 유형 지정을 통한 S2S 광고 매출 보고가 필요합니다.

보고에서의 활용

• 광고 구매화 전략 최적화
• 하이브리드 구매화 모델 분석
• 유저 세그먼트 구매성 (IAP vs 광고 매출)
• 채우기율 및 eCPM 성과

지표 정의

IAP, 구독, 광고 매출을 포함한 모든 소스의 매출 이벤트를 추적하여 완전한 구매화 현황을 제공합니다.

계산 방법

총 매출 = 매출 + Ad Mon 매출

포함 매출 소스

• 모든 IAP 및 구매 매출
• 구독 매출
• 광고 구매화 매출
• 맞춤 매출 이벤트 (환불, 오프라인 구매 등)

보고에서의 활용

• 완전한 캠페인 ROI 측정
• 구매화 유형 전반의 혼합 LTV 계산
• 전체 비즈니스 성과 추적
• 채널 간 구매성 비교