이벤트 설명

고유 디바이스에 대한 앱 설치 및 첫 세션을 나타내며, 기본 설치 어트리뷰션 이벤트로 사용됩니다.

---

추적 트리거

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

---

기술적 세부 정보

이벤트 이름	__START__
이벤트 유형	설치/첫 세션
추적 방법	자동(SDK/S2S 초기화)
구성 필요	없음 - 자동으로 추적
가용성	BI 포스트백만 해당

이벤트 설명

모든 앱 실행과 사용자 세션을 추적하여 참여도 및 리텐션 지표의 토대를 제공합니다.

---

추적 트리거

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

---

세션 정의

세션은 앱을 포그라운드로 가져올 때 시작되며, 앱이 백그라운드에서 구성 가능한 시간 제한 기간(기본값: 60초) 후에 종료됩니다.

---

기술적 세부 정보

이벤트 이름	__SESSION__
이벤트 유형	세션/앱 실행
추적 방법	자동(SDK 세션 관리)
구성 필요	없음 - 자동으로 추적
가용성	모든 보고 위치

---

애널리틱스에서의 사용

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

• 일일 활성 사용자(DAU): 특정 날짜에 세션이 있는 고유 사용자 수
• 리텐션율: 후속 세션을 위해 재방문하는 사용자의 비율
• 세션 빈도: 일정 기간 동안 사용자당 평균 세션 수
• 리인게이지먼트 어트리뷰션: 리인게이지먼트 캠페인에서 발생한 세션

이벤트 설명

사용자 지정 이벤트 이름 없이 SDK 구매 방법을 통해 보고된 인앱 구매 및 구매 이벤트를 추적합니다.

---

추적 트리거

SDK/S2S 연동이 구매 방식을 통해 구매 이벤트를 보고할 때 추적하며, 구매 이벤트에 SDK 설정에 사용자 지정 이름이 없는 경우 추적합니다.

---

기술 세부 정보

이벤트 이름	__iap__
이벤트 유형	구매/인앱 구매
추적 방법	SDK 구매 방식 또는 S2S 구매 파라미터
구성 필요	앱 코드에서 구매 추적 구현
가용성	모든 보고 위치

---

구현 예시

iOS SDK:

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

안드로이드 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는 사용자 지정 이벤트 이름(예: "구매")으로 구매을 보고합니다.
• "환불" 또는 "오프라인_구매"와 같은 기타 구매 이벤트 보고

---

포스트백 구성 중요

---

기술적 세부 정보

이벤트 이름	__REVENUE__
이벤트 유형	총 구매(모든 소스)
추적 방법	자동(모든 구매 이벤트에 의해 트리거됨)
구성 필요	없음 - 구매 이벤트가 있을 때 자동
가용성	모든 보고 위치

---

사용 사례

사용 시기 __REVENUE__:

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

특정 구매 이벤트 사용 시기:

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

이벤트 설명

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

---

추적 트리거

iOS 또는 Android 앱에서 앱 제거 추적이 활성화되어 있고 최소 한 번의 제거가 감지되면 자동으로 추적됩니다. 기기에서 앱 제거가 감지되면 재설치 또는 데이터 보존 제한이 발생할 때까지 매일 한 번씩 이벤트가 트리거됩니다.

---

전제 조건

__UNINSTALL__ 이벤트가 나타나기 전에 Singular 플랫폼에서 제거 추적을 명시적으로 사용 설정해야 합니다.

플랫폼별 설정:

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

---

기술적 세부 사항

이벤트 이름	__UNINSTALL__
이벤트 유형	제거/탈퇴
추적 방법	자동(제거 추적 활성화 필요)
구성 필요	Singular 플랫폼에서 제거 추적 활성화
빈도	제거한 디바이스당 매일 1회
가용성	모든 보고 위치(활성화 후)

---

제거 감지 방법

iOS: 무음 푸시 알림 확인

Android: FCM(Firebase 클라우드 메시징) 확인

이벤트 설명

이전 제거 후 앱 재설치를 추적하여 윈백 캠페인 측정 및 사용자 라이프사이클 분석을 가능하게 합니다.

---

추적 트리거

SDK/S2S를 통해 앱 제거 추적이 활성화된 경우 자동으로 추적됩니다. __UNINSTALL__ 디바이스 추적 후 __SESSION__ 트리거가 발생하면 __REINSTALL__이벤트가 자동으로 실행됩니다.

---

트리거 시퀀스

1. 최초 설치: 사용자가 앱 설치, __START__및 __SESSION__ 추적
2. 앱 사용: 사용자가 앱에 참여, 여러 __SESSION__이벤트 추적
3. 삭제: 사용자가 앱 제거, __UNINSTALL__감지 및 추적됨
4. 재설치: 사용자가 앱을 재설치하고 실행
5. 재설치 감지: __UNINSTALL__ 이후 첫 번째 __SESSION__, __REINSTALL__이벤트 트리거

---

기술적 세부 정보

이벤트 이름	__REINSTALL__
이벤트 유형	재설치/복귀
추적 방법	자동(제거 추적 필요)
구성 필요	Singular 플랫폼에서 제거 추적 활성화
전제 조건	디바이스에 대한 이전 __UNINSTALL__ 이벤트
가용성	모든 보고 위치

---

어트리뷰션 고려 사항

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

지표 정의

신규 앱 설치 및 기본 어트리뷰션 지표를 나타내는 고유 디바이스에 대한 첫 번째 세션을 추적합니다.

---

계산 방법

보고 기간에 첫 번째 __SESSION__이벤트가 발생한 고유 기기 식별자 수입니다.

---

보고에서 사용

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

지표 정의

리인게이지먼트 캠페인에 의해 트리거된 세션을 추적하여 기존 사용자를 타겟팅하는 캠페인의 효과를 측정합니다.

---

구성 종속성

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

---

계산 방법

사용자의 첫 번째 세션이든 후속 세션이든 상관없이 구성된 어트리뷰션 윈도우 내에서 리인게이지먼트 캠페인에 어트리뷰션된 세션입니다.

---

리포팅에서의 사용

• 리인게이지먼트 캠페인 ROI 측정
• 휴면 사용자 활성화율
• 크로스 채널 리인게이지먼트 성과
• 사용자 라이프사이클 단계 전환

지표 정의

특정 날짜에 세션을 한 번 이상 진행한 순 사용자의 일일 수로, 활성 사용자 기반 규모를 측정합니다.

---

계산 방법

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

---

관련 지표

• WAU: 주간 활성 사용자 수(7일간 고유 사용자 수)
• MAU: 월간 활성 사용자 수(30일 고유 사용자 수)
• DAU/MAU 비율: 고착성 지표(DAU를 MAU로 나눈 값)

---

리포팅에서의 사용

• 앱 인게이지먼트 트렌드 분석
• 사용자 기반 성장 측정
• 계절별 사용 패턴 파악
• 플랫폼 상태 모니터링

지표 정의

앱을 설치하고(첫 번째 세션) 지정된 기간 내에 추가 세션을 위해 재방문한 사용자의 백분율입니다.

---

계산 방법

(설치 후 N일차에 세션이 있는 사용자 / 0일차에 설치한 총 사용자 수) × 100

---

리텐션 유형

리텐션 유형	설명
1일차 리텐션	설치 후 다음 날 재방문한 사용자의 비율
7일차 리텐션	설치 후 7일 후 재방문하는 사용자의 비율
30일차 리텐션	설치 후 30일이 지난 후 재방문하는 사용자의 비율
롤링 리텐션	N일차 이후 재방문한 사용자 비율(누적)

---

리포팅에서 사용

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

지표 정의

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

---

포함된 구매 소스

• __iap__ 이벤트(기본 구매 이벤트)
• 사용자 지정 구매 이벤트(구매, 구독 등)
• 정기구독 갱신 및 업그레이드
• 일회성 구매 및 소모품

---

제외된 구매원

• 광고 구매 창출 구매(광고 월 구매에서 별도로 추적)

---

리포팅에서 사용

• 캠페인 ROI 및 ROAS 계산
• 사용자 생애 가치(LTV) 측정
• 구매화 퍼널 분석
• 소스별 구매 어트리뷰션

측정 지표 정의

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

---

포함된 구매 소스

• 배너 광고 노출 수
• 전면 광고 조회수
• 보상형 동영상 완료
• 네이티브 광고 참여
• 오퍼월 완료

---

구현 요구 사항

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

---

보고에 사용

• 광고 구매화 전략 최적화
• 하이브리드 구매화 모델 분석
• 사용자 세그먼트 구매성(IAP 대 광고 구매)
• 게재율 및 eCPM 성과

지표 정의

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

---

계산 방법

총 구매 = 구매 + 광고 월 구매

---

포함된 구매 소스

• 모든 IAP 및 구매 구매
• 구독 구매
• 광고 구매화 구매
• 사용자 지정 구매 이벤트(환불, 오프라인 구매 등)

---

리포팅에서 사용

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