인앱 이벤트 추적
인앱 이벤트는 게임 앱에서 로그인, 등록, 튜토리얼 완료, 레벨 업 등의 사용자 행동을 추적하여 캠페인 성과와 핵심 성과 지표(KPI)를 측정하는 데 도움이 됩니다. Singular는 이러한 이벤트를 수집하여 사용자 행동에 대한 인사이트를 제공하고 마케팅 활동을 최적화합니다.
표준 이벤트와 맞춤 이벤트
Singular는 두 가지 유형의 이벤트를 지원합니다:
- 표준 이벤트: 사전 정의된 이벤트(예: sngLogin, sngContentView)는 Singular에서 인식하고 보고 및 최적화를 위해 애드 네트워크에서 지원하는 경우가 많습니다. 표준 이벤트를 사용하면 수동으로 정의하지 않아도 자동으로 이벤트 목록에 추가되므로 설정이 간단해집니다. 권장 사항: 호환성과 사용 편의성을 위해 가능하면 표준 이벤트를 사용하세요. 표준 이벤트 이름과 권장 속성은 표준 이벤트 및 속성 목록을 참조하세요.
-
사용자 지정 이벤트: Singular의 표준 이벤트와 일치하지 않는 앱 고유의 이벤트(예: Signup, AchievementUnlocked)입니다.
사용자 지정 이벤트 제한:
- 타사 파트너 및 분석 솔루션과의 호환성을 보장하기 위해이벤트 이름과 속성을 영문으로 전달할 것을 적극 권장합니다.
- 이벤트 이름은 32개의 ASCII 문자로 제한됩니다. ASCII가 아닌 문자로 된 문자열은 UTF-8로 변환한 후 32바이트 미만이어야 합니다.
- 속성 및 값은 500자로 제한됩니다.
UA, 마케팅 또는 비즈니스 팀과 협력하여 앱의 마케팅 KPI를 기반으로 이벤트 및 속성 목록을 컴파일하세요. 인앱 이벤트 추적 방법을 참조하세요 : 이벤트 선택에 대한 지침은 Singular 어트리뷰션 고객을 위한 가이드를 참조하세요.
이벤트 보내기
- 이벤트 메서드를 사용하여 Singular의 SDK로 간단한 사용자 지정 이벤트를 추적할 수 있습니다.
- Singular의 SDK로 추가 어트리뷰트가 있는 커스텀 이벤트를 추적하려면 eventWithArgs 메서드를 사용합니다.
모범 사례
- 표준 이벤트 사용: 애드 네트워크와의 호환성 및 Singular의 이벤트 목록에서 자동 인식을 위해 표준 이벤트를 선호합니다.
- 속성 유효성 검사: 속성이 예상 형식과 일치하는지 확인합니다.
- 이벤트 디버그: 개발 중에 SDK 로깅을 활성화하여 이벤트가 올바르게 전송되고 앱 라이프사이클의 적절한 순간(예: 사용자가 로그인한 후)에 트리거되는지 확인합니다.
참고: UA/마케팅 팀과 협력하여 추적된 이벤트가 앱의 KPI와 일치하는지 확인하세요. 프로덕션 환경에 배포하기 전에 개발 환경에서 이벤트를 테스트하여 Singular 대시보드의 데이터 정확도를 확인하세요.
구매 추적
Singular의 React Native SDK를 사용하면 인앱 구매 이벤트를 추적하여 캠페인 성과와 ROI를 분석할 수 있습니다. 구매 데이터는 Singular의 보고서, 로그 내보내기, 포스트백에서 확인할 수 있으며 앱의 구매화에 대한 실행 가능한 인사이트를 제공합니다.
왜 구매 이벤트를 추적해야 하나요?
- 풍부한 분석: 상세한 거래 데이터를 캡처하여 Singular 보고서를 개선하세요.
- 사기 방지: 거래 영수증(예: 구글 플레이 또는 애플 앱스토어)을 포함시켜 구매를 검증하고 인앱 사기를 방지하세요.
- 캠페인 최적화: 구매을 마케팅 활동과 연결하여 ROI를 측정하세요.
모범 사례: 전체 구매 개체 전달
안드로이드(구글 플레이 청구) 또는 iOS(스토어키트)의 인앱 구매(IAP) 프로세스에서 반환된 구매 객체를 전달할 것을 강력히 권장합니다. 이렇게 하면 Singular가 다음과 같은 포괄적인 거래 세부 정보를 수신할 수 있습니다:
- 제품 ID
- 가격
- 통화
- 거래 ID
- 영수증 데이터(유효성 검사용)
전체 구매 객체를 전달하면 더욱 풍부한 리포팅이 가능하며, 특히 구글 플레이 거래에 대한 Singular의 사기 탐지 기능을 활용할 수 있습니다.
IAP 구매 개체 캡처
Flutter IAP 패키지를 사용하여 앱의 트랜잭션을 관리하고 구매 객체를 검색할 수 있습니다.
IAP 구매 전송
- 인앱 구매 메서드를 사용하여 구매 세부 정보가 포함된 인앱 구매 이벤트를 추적합니다.
- 구매 세부 정보 및 추가 사용자 지정 속성이 포함된 인앱 구매 이벤트를 추적하려면 inAppPurchaseWithAttributes 메서드를 사용합니다.
구매 개체 없이 구매 전송
구매 유효성 검사를 위해 inAppPurchase 메서드를 사용하여 구매 이벤트를 보고하는 것이 좋지만, 통화와 거래 금액만 전달하여 Singular로 구매 이벤트를 전송할 수도 있습니다.
중요: 유효한 구매 개체 없이 구매 이벤트를 전송하는 경우, Singular는 거래를 검증하지 않습니다.
요구 사항
참고: 통화를 세 글자로 된 ISO 4217 통화 코드(예: "USD," "EUR", "INR")로 전달합니다.
- customRevenue 메서드를 사용하여 지정된 이벤트 이름, 통화 및 금액으로 사용자 지정 구매 이벤트를 추적합니다.
- 지정된 이벤트 이름, 통화, 금액 및 추가 사용자 지정 속성이 있는 사용자 지정 구매 이벤트를 추적하려면 customRevenueWithAllAttributes 메서드를 사용합니다.
- 지정한 이벤트 이름, 통화, 금액 및 추가 사용자 지정 속성이 있는 사용자 지정 구매 이벤트를 맵 개체로 추적하려면 customRevenueWithAttributes 메서드를 사용합니다.
구독 구매 보내기
Singular는 Singular SDK를 사용하여 구독 이벤트를 구현하는 방법에 대한 포괄적인 가이드를 제공합니다. 다양한 플랫폼에서 인앱 구독 이벤트 추적을 다룹니다.
- 구독 구매을 추적하려면 구독 이벤트 기술 구현 가이드를 읽어보세요.
광고 구매 전송
광고 구매 어트리뷰션은 사용자를 앱으로 유도한 특정 캠페인에 광고 구매을 연결할 수 있도록 도와줍니다. 이를 통해 캠페인 비용, 인앱 구매, 광고 구매을 한 곳에서 모두 표시하여 광고 실적을 명확하게 파악할 수 있습니다. 또한 이 기능을 사용하면 광고 구매 데이터를 광고 네트워크에 다시 전송하여 광고 실적을 개선할 수 있습니다.
- 광고 구매 메서드를 사용하여 자세한 광고 데이터 정보로 광고 구매 이벤트를 추적할 수 있습니다.
- 미디에이션 파트너와 함께 광고 구매 어트리뷰션 구현에 대한 자세한 가이드를 읽어보세요.
하이브리드 이벤트 추적
Singular는 앱에 연동된 Singular SDK를 통해 모든 이벤트와 구매을 전송할 것을 권장합니다. 하지만, Singular는 다른 출처에서 이벤트와 구매을 수집할 수 있습니다.
Singular SDK에서 전송되지 않은 모든 이벤트는 Singular의 서버 간 이벤트 문서 요구사항을 준수해야 하며, 이벤트 어트리뷰션을 올바르게 하기 위해 일치하는 기기 식별자를 제공해야 합니다.
중요:
서버 간 이벤트 요청에 사용된 디바이스 식별자가 Singular에 일치하는 디바이스 식별자가 없는 경우 불일치가 발생할 수 있습니다. 다음과 같은 가능성에 유의하세요:
- 이벤트 요청이 앱 세션에서 Singular SDK가 디바이스 식별자를 기록하기 '전에' 수신된 경우, 이벤트 요청은 알 수 없는 디바이스에 대한 '첫 번째 세션'으로 간주되며, Singular는 해당 디바이스를 오가닉 어트리뷰션으로 어트리뷰션할 것입니다.
- Singular SDK가 디바이스 식별자를 기록했지만, Singular SDK 식별자가 서버 간 이벤트 요청에 지정된 디바이스 식별자와 다른 경우 이벤트는 잘못 어트리뷰션됩니다.
하이브리드 이벤트 추적 가이드
Singular는 서버에서 구매에 대한 데이터를 수집하여 캠페인의 성과와 ROI를 분석하는 데 도움을 줄 수 있습니다.
요구 사항:
- 인앱 등록 또는 로그인 이벤트에서 디바이스 식별자를 캡처하여 전달하고 이 데이터를 서버에 사용자 ID와 함께 저장하세요. 디바이스 식별자는 사용자에 따라 변경될 수 있으므로 사용자가 앱 세션을 생성할 때 반드시 식별자를 업데이트해야 합니다. 이렇게 하면 서버 측 이벤트가 올바른 디바이스에 어트리뷰션되도록 보장할 수 있습니다.
- 서버 측 이벤트는 플랫폼별로 다르므로 디바이스 플랫폼과 일치하는 디바이스 식별자(예: iOS 디바이스의 경우 IDFA 또는 IDFV)로만 전송해야 합니다.
- Singular 내부 BI 포스트백 메커니즘을 사용하여 이벤트를 내부 엔드포인트에 실시간으로 푸시하여 서버 측의 데이터 집합을 업데이트할 수 있습니다. 내부 BI 포스트백 FAQ를 참조하세요.
- 자세한 내용은 서버 간 연동 가이드의 구매 추적 섹션을 참조하세요.
이러한 파트너를 활성화하는 방법에 대한 자세한 내용은 아래 링크를 참조하세요.
- RevenueCat 문서에서 자세히 알아보세요.
- 어댑티브 문서에서 자세히 알아보세요.