인앱 이벤트 트래킹 방법 – 도움말 센터

단일 이벤트 학습 경로

2. 이벤트 추적 방법
단계별 가이드

앱에서 올바른 인앱 이벤트를 추적하면 중요한 KPI를 통해 조직의 마케팅 활동의 성공 여부를 측정할 수 있습니다.

이 가이드는 신규 성장 플랜 고객에게 적용됩니다. 다른 고객의 경우 이벤트가 이벤트 페이지에 자동으로 추가되지 않으므로 프로세스가 약간 다릅니다(아래 5단계 참조). 이 기능은 모든 고객에게 배포되고 있습니다.

다음 사용자를 위한 가이드	마케팅 및 사용자 확보 팀
전제조건	어트리뷰션 파트너(MMP)로 싱귤러를 사용해야 합니다.

이벤트를 추적하려면 다음을 수행해야 합니다:

추적할 이벤트를 선택합니다.
개발자에게 앱에서 선택한 이벤트가 발생할 때 이를 전송할 수 있도록 싱귤러 SDK 또는 S2S 통합에 코드를 포함하도록 요청합니다.
이벤트가 Singular 플랫폼의 설정 > 이벤트 페이지에 표시되는지 확인하세요.

자세한 지침은 아래 가이드를 참조하세요.

이벤트 목록 정의

측정하려는 KPI를 생각하고 이를 측정하는 데 도움이 될 인앱 이벤트를 나열합니다.

시작하는 데 도움이 되도록 업종별로 일반적으로 사용되는 이벤트 목록과 전달할 권장 속성을 정리했습니다.이러한 표준 이벤트는 Singular에서 자동으로 가져오기 때문에 가급적 사용하는 것이 좋습니다.

예를 들어 전자상거래 앱의 경우 제품 보기, 카트에 추가, 결제 등의 이벤트를 구현하는 것이 좋습니다.

(선택 사항) 필요한 경우 사용자 지정 이벤트 추가

앱의 콘텐츠와 마케팅 니즈에 따라 싱귤러 표준 이벤트에 쉽게 매핑되지 않는 인앱 이벤트를 추적하고 싶을 수 있습니다. 이 경우 사용자 지정 이벤트를 직접 정의할 수 있습니다.

사용자 지정 이벤트는 싱귤러 리포트에서 측정하려면 싱귤러에서 수동으로 구성해야 합니다. 광고 네트워크에 따라 최적화에 사용할 수 있거나 사용할 수 없을 수도 있습니다.

참고: 사용자 지정 이벤트를 정의하더라도 이벤트와 함께 데이터를 전달할 때는 가능한 한 표준 어트리뷰트를 사용하는 것이 좋습니다. 이렇게 하면 애드 네트워크에서 속성을 보고하는 데 도움이 됩니다. 표준 어트리뷰트도 조만간 Singular에서 보고할 예정입니다.

SDK 연동에서 이벤트 구현하기

개발팀에 싱귤러 SDK 통합에 통합할 이벤트 및 어트리뷰트 목록을 제공하세요.

목표는 앱에서 선택한 모든 이벤트가 Singular 서버에 발생하는 대로 보고하도록 하는 것입니다:

싱귤러가 정보를 집계하고 분석할 수 있습니다.
싱귤러는 앱의 이벤트에 대한 자동 포스트백을애드 네트워크에 전송합니다. 포스트백 FAQ를 참조하세요.

어떤 이벤트가 기본 제공되며 항상 구현되나요?

앱에 Singular SDK 또는 S2S를 통합하면, 여러 유형의 인앱 이벤트가 발생할 때 코드를 추가할 필요 없이 Singular가 자동으로 추적하여 이를 Singular로 전송합니다.

이러한 기본 제공 이벤트는 다음과 같이 나타날 수 있습니다:

사용자 레벨 어트리뷰션 로그( 로그 내보내기 및 사용자 레벨 데이터 FAQ 참조)
파트너 포스트백(파트너가 자동 생성된 이벤트 이름을 수신하는 경우)
내부 BI 포스트백

지원되는 내장 이벤트

이벤트 이름	설명	추적되는 시기
__START__	설치	SDK/S2S 연동을 통해 첫번째 세션이 전송될 때 자동으로 추적됩니다.
__SESSION__	세션	SDK/S2S 연동을 통해 세션이 전송될 때 자동으로 추적됩니다.
__iap__	SDK 수익	SDK/S2S 연동이 수익 메소드를 통해 수익 이벤트를 보고하는 경우 추적됩니다.
__REVENUE__	모든 수익	예를 들어 수익이 보고되는 경우 추적됩니다: IAP__ 이벤트가 트리거된 경우 SDK가 광고 수익 이벤트를 보고하는 경우 "구매"와 같은 이벤트 이름으로 S2S를 통해 수익을보고하는 경우. '환불' 또는 '오프라인 구매'와 같은 기타 수익 이벤트를 보고하는 경우 참고: 이미 __iap__ 또는 다른 수익 이벤트에 대한 포스트백을 전송하고 있는 경우, 중복 수익이 보고될 수 있으므로 이 이벤트에 대한 포스트백을 전송하지 않는 것이 좋습니다.
__UNINSTALL__	Uninstall	iOS또는 Android앱에서 제거가 활성화되어 있고 제거가 한 번 이상 추적된 경우 자동으로 추적됩니다. 기기에서 제거가 감지되면 하루에 한 번 트리거됩니다.
__재설치__	재설치	SDK/S2S를 통해 제거가 활성화된 경우 자동으로 추적됩니다. 장치에 대한 __UNINSTALL__이 추적된 후 후속 __SESSION__이 트리거되면 __REINSTALL__ 이벤트도 트리거됩니다.

이벤트 구현 가이드에서는 표준 이벤트와 사용자 지정 이벤트를 모두 구현하는 방법을 설명합니다(사용하는 경우).

SDK별 이벤트 구현 가이드:

iOS SDK 연동	단일 S2S 통합: 이벤트 추적하기
안드로이드 SDK: 이벤트 및 수익 추적	Flutter 통합
유니티 SDK: 이벤트 및 수익 추적	엠파티클 통합
리액트 네이티브 SDK: 이벤트 및 수익 추적	세그먼트 SDK 통합
언리얼 엔진 SDK: 이벤트 및 수익 추적	세그먼트 S2S 통합

참고: 표준 이벤트/어트리뷰트 이름은 플랫폼의 엔티티 이름 가이드라인에 따라 플랫폼마다 약간씩 다를 수 있습니다(예: sng_login 대신 sngLogin). 각 SDK의 가이드에서 특정 플랫폼에서 사용할 수 있는 표준 이벤트의 최신 목록과 코드에 표시해야 하는 이름을 확인할 수 있습니다.

단일 플랫폼에서 이벤트 확인

설정 > 이벤트 페이지에서 이벤트를 정의하여 집계된 보고서에서 이벤트를확인합니다.

앱이 표준 이벤트를 Singular로 전송하기 시작하면 이벤트 페이지에 자동으로 추가됩니다. SDK의 각 이벤트에 대해 Singular는 UI에서 고유이벤트와 비고유 이벤트를 생성합니다. 아래 이벤트 UI 이해를 참조하세요.

참고: 이벤트를 제거하면 Singular가 자동으로 다시 추가하지 않지만 언제든지 수동으로 다시 추가할 수 있습니다.

이벤트 페이지 탐색하기

설정 > 이벤트로 이동하면 여러 탭이 표시됩니다.

코호트 이벤트: 이 탭에서는 단일 또는 MMP의이벤트를 구성할 수 있습니다.
글로벌 이벤트: 여러 앱이 Singular에 추가된 경우 모든 앱에서 동일한 이벤트를 집계하고 싶을 수 있습니다. 이러한 이벤트를 보거나 만들려면 글로벌 이벤트를 선택합니다.
앱별 이벤트: 특정 앱에 대한 이벤트만 추적하는 경우 앱별 이벤트를 선택합니다.
전환 이벤트: 이 탭에서는 애드 네트워크 파트너의 이벤트를 구성할 수 있습니다.
SKAN 이벤트: 이 이벤트는 SKAN 전환 모델이 있는 경우 해당 모델에 의해 자동으로 생성됩니다.

다양한 유형의 이벤트에 대해 자세히 알아보려면 이벤트 FAQ를참조하세요.

이벤트 페이지에는 자동으로 추가된 이벤트의 축소된 목록이 표시됩니다. 이벤트를 확장하면 해당 속성을 볼 수 있습니다.

코호트 이벤트 UI 이해하기

코호트 이벤트 탭에는 자동으로 추가된 이벤트의 축소된 목록이 표시됩니다. 이벤트를 펼치면 해당 속성이 표시됩니다.

이름 및 접기 아이콘: 여기에 입력한 이름이 보고서 UI에 표시됩니다.
고유 이벤트 필터: 이 토글을 통해 MMP의 고유 이벤트와 비고유 이벤트를 집계할 수 있는지 여부를 변경할 수 있습니다. 이벤트 측정 이해 - 고유 이벤트를 참조하세요.
데이터 소스: 싱글 또는 광고 네트워크에서 이 이벤트로 집계할 이벤트를 선택합니다. 여러 이벤트를 하나로 집계할 수 있습니다. 이벤트가 저장되면 잠깁니다.
계산된 지표를 추가합니다: CPE및 ECVR에 대한 FAQ를 참조하세요.
이벤트 삭제하기: 이벤트를 삭제합니다. 이벤트 페이지는 12개의 이벤트*로 제한됩니다.
변경 사항 저장 및 변경 사항 취소버튼
이벤트 내역

* 참고: 12개 이벤트 제한으로 인해 Singular는 SDK 이벤트의 고유 버전 6개와 비고유 버전 6개를 자동으로 추가합니다. 기업 고객은 12개 이벤트로 제한되지 않습니다.

코호트 이벤트가 저장되면 추가된 SDK 이벤트는 편집할 수 없습니다. 이벤트 옆에 있는 자물쇠 아이콘을 확인하세요. 동일한 코호트 이벤트로 집계하기 위해 더 많은 SDK 이벤트를 추가할 수 있습니다.

전환 이벤트 UI 이해하기

전환 이벤트 탭에는 광고 파트너의 이벤트가 축소된 목록이 표시됩니다. 이벤트를 확장하면 해당 속성을 볼 수 있습니다.

이름 및 접기 아이콘: 여기에 입력한 이름이 보고서 UI에 표시됩니다.
데이터 소스: 이 이벤트에 집계할 광고 네트워크의 이벤트를 선택합니다. 여러 이벤트를 하나로 집계할 수 있습니다. 이러한 이벤트는 자유롭게 편집할 수 있습니다.*
계산된 지표를 추가합니다: CPE및 ECVR에 대한 FAQ를 참조하세요.
이벤트 삭제: 이벤트를 삭제합니다. 전환 이벤트 페이지에는 무제한의 이벤트가 있을 수 있습니다*.
변경 사항 저장 및 변경 사항 취소버튼
이벤트 기록

* 참고: 코호트 이벤트와 달리 구성된 전환 이벤트는 제한이 없으며 이벤트를 자유롭게 편집할 수 있습니다. 각 이벤트 옆에 있는 "X" 아이콘을 확인하세요.

수동으로 사용자 지정 이벤트 추가

SDK가 사용자 지정 이벤트를 Singular로 전송하는 경우 이벤트 페이지에 자동으로 추가되지 않습니다. 새 이벤트를클릭하고 이벤트 세부 정보를 정의하여 수동으로 추가해야 합니다.