인앱 이벤트 추적

인앱 이벤트를 추적하여 캠페인 성과를 분석하고 유저 로그인, 회원 가입, 튜토리얼 완료, 진행 단계 마일스톤과 같은 핵심 성과 지표(KPI)를 측정하세요.

표준 이벤트 및 속성

표준 이벤트 사용하기

Singular은 광고 네트워크가 리포팅 및 최적화를 위해 인식하는 표준 이벤트 를 지원합니다. 자동 인식과 간소화된 설정을 위해 가능하면 항상 표준 이벤트 이름을 사용하세요.

UA, 마케팅 또는 비즈니스 팀은 조직의 마케팅 KPI를 기반으로 이벤트 목록을 작성해야 합니다. 계획 수립에 관한 자세한 내용은 인앱 이벤트 추적 방법: Singular 어트리뷰션 고객을 위한 가이드 를 참고하세요.

각 이벤트는 다양한 속성을 지원합니다. 구현 세부 정보는 이벤트별 권장 표준 속성 을 참고하세요.

이벤트 전송

이벤트 구현 가이드라인

데이터를 보강하기 위한 선택적 속성과 함께 Event() 메서드를 사용하여 Singular에 이벤트를 전송하세요.

• 표준 이벤트: 표준 이벤트 목록에서 이벤트의 Unity 이름 을 사용하세요. 예: Events.sngLogin
• 커스텀 이벤트: 표준 이벤트와 일치하지 않는 앱 고유의 이벤트의 경우, 문자 제한을 준수하는 설명적인 문자열을 자유롭게 사용하세요

Event 메서드

가변 인수 또는 Dictionary 형식을 사용하여 추가 정보와 함께 또는 추가 정보 없이 유저 이벤트를 보고하세요.

메서드 시그니처:

public static void Event(string name)
public static void Event(string name, params object[] args)
public static void Event(Dictionary<string, object> args, string name)

사용 예시

// Example 1: Standard event without attributes
SingularSDK.Event(Events.sngLogin);

// Example 2: Standard event with recommended attributes (key-value pairs)
SingularSDK.Event(Events.sngTutorialComplete,
    Attributes.sngAttrContent, "Unity Basics",
    Attributes.sngAttrContentId, 32,
    Attributes.sngAttrContentType, "video",
    Attributes.sngAttrSuccess, "yes"
);

// Example 3: Standard event with attributes using Dictionary
Dictionary<string, object> attributes = new Dictionary<string, object>()
{
    [Attributes.sngAttrContent] = "Unity Basics",
    [Attributes.sngAttrContentId] = 32,
    [Attributes.sngAttrContentType] = "video",
    [Attributes.sngAttrSuccess] = "yes"
};
SingularSDK.Event(attributes, Events.sngTutorialComplete);

// Example 4: Custom event without attributes
SingularSDK.Event("SignUp");

// Example 5: Custom event with custom attributes
SingularSDK.Event("Bonus Points Earned", "Points", 500, "Level", 5);

인앱 매출 추적

인앱 구매(IAP), 구독 및 커스텀 매출 소스에서 발생하는 매출을 추적하여 캠페인 성과와 광고 비용 대비 수익률(ROAS)을 측정하세요.

매출 데이터는 세 가지 채널을 통해 흐릅니다:

• 인터랙티브 리포트: Singular 대시보드에서 매출 지표를 확인하세요
• 익스포트 로그: 커스텀 분석을 위한 상세 ETL 데이터에 액세스하세요
• 실시간 포스트백: 외부 플랫폼으로 매출 이벤트를 전송하세요

모범 사례

Unity IAP 연동

Unity IAP를 사용한 인앱 구매

데이터를 보강한 리포팅과 트랜잭션 검증을 위해 Unity의 IAP Purchase 또는 Order 객체를 InAppPurchase() 메서드에 전달하세요.

이점:

• 풍부한 데이터: Singular은 종합적인 리포트를 위해 완전한 트랜잭션 세부 정보를 수신합니다
• 사기 방지: 트랜잭션 영수증을 통해 검증이 가능하여 인앱 사기에 대응할 수 있습니다

InAppPurchase 메서드 (Unity IAP v5)

자동 검증과 데이터 보강을 위해 Unity IAP v5의 Order 객체를 사용하여 IAP 이벤트를 전송하세요.

메서드 시그니처:

public static void InAppPurchase(Order order)
public static void InAppPurchase(Order order, Dictionary<string, object> attributes)
public static void InAppPurchase(Order order, bool isRestored)
public static void InAppPurchase(Order order, string eventName, Dictionary<string, object> attributes)

사용 예시

// Example 1: IAP with order object only
SingularSDK.InAppPurchase(order);

// Example 2: IAP with order and additional attributes
Dictionary<string, object> attr = new Dictionary<string, object>()
{
    ["promo_code"] = "SUMMER2025",
    ["user_tier"] = "premium"
};
SingularSDK.InAppPurchase(order, attr);

// Example 3: IAP with restored transaction flag
SingularSDK.InAppPurchase(order, true);

// Example 4: IAP with custom event name and attributes
Dictionary<string, object> attr = new Dictionary<string, object>()
{
    ["subscription_tier"] = "gold",
    ["billing_period"] = "monthly"
};
SingularSDK.InAppPurchase(order, "PremiumSubscription", attr);

InAppPurchase 메서드 (Unity IAP v4)

자동 검증과 데이터 보강을 위해 Unity IAP v4의 Product 객체를 사용하여 IAP 이벤트를 전송하세요.

메서드 시그니처:

public static void InAppPurchase(Product product, Dictionary<string, object> attributes, bool isRestored = false)
public static void InAppPurchase(string eventName, Product product, Dictionary<string, object> attributes, bool isRestored = false)
public static void InAppPurchase(IEnumerable<Product> products, Dictionary<string, object> attributes, bool isRestored = false)
public static void InAppPurchase(string eventName, IEnumerable<Product> products, Dictionary<string, object> attributes, bool isRestored = false)

사용 예시

// Example 1: IAP with single product, no extra attributes
SingularSDK.InAppPurchase(myProduct, null);

// Example 2: IAP with single product and attributes
Dictionary<string, object> attr = new Dictionary<string, object>()
{
    ["promo_code"] = "SUMMER2025",
    ["user_tier"] = "premium"
};
SingularSDK.InAppPurchase(myProduct, attr);

// Example 3: IAP with custom event name
SingularSDK.InAppPurchase("PremiumUpgrade", myProduct, null);

// Example 4: IAP with list of products
SingularSDK.InAppPurchase(myProductList, null);

// Example 5: IAP with list of products and custom event name
SingularSDK.InAppPurchase("BundlePurchase", myProductList, null);

구매 검증 없는 커스텀 매출

수동 매출 추적

Purchase 또는 Order 객체 없이 통화, 금액 및 선택적 제품 세부 정보를 전달하여 매출을 추적하세요. 이 방식은 검증을 위한 트랜잭션 영수증을 제공하지 않는다는 점에 유의하세요.

Revenue 메서드

통화, 금액 및 선택적 제품 세부 정보와 함께 매출 이벤트를 전송하세요.

메서드 시그니처:

public static void Revenue(string currency, double amount)
public static void Revenue(string currency, double amount, string productSKU, string productName, string productCategory, int productQuantity, double productPrice)
public static void Revenue(string currency, double amount, Dictionary<string, object> attributes)

사용 예시

// Example 1: Revenue without product details
SingularSDK.Revenue("USD", 1.99);

// Example 2: Revenue with product details
SingularSDK.Revenue("USD", 4.99, "coin_package_abc123", "Coin Pack 5", "Bundles", 1, 4.99);

// Example 3: Revenue with attributes dictionary
Dictionary<string, object> attributes = new Dictionary<string, object>()
{
    ["productSKU"] = "coin_package_abc123",
    ["productName"] = "Coin Pack 5",
    ["productCategory"] = "Bundles",
    ["productQuantity"] = 2,
    ["productPrice"] = 4.99,
    ["transaction_id"] = "T12345"
};
SingularSDK.Revenue("USD", 9.98, attributes);

CustomRevenue 메서드

지정된 이벤트 이름, 통화, 금액 및 선택적 트랜잭션 속성과 함께 커스텀 매출 이벤트를 전송하세요.

메서드 시그니처:

public static void CustomRevenue(string eventName, string currency, double amount)
public static void CustomRevenue(string eventName, string currency, double amount, string productSKU, string productName, string productCategory, int productQuantity, double productPrice)
public static void CustomRevenue(string eventName, string currency, double amount, Dictionary<string, object> attributes)

사용 예시

// Example 1: Custom revenue without product details
SingularSDK.CustomRevenue("MyCustomRevenue", "USD", 9.99);

// Example 2: Custom revenue with product details
SingularSDK.CustomRevenue("MyCustomRevenue", "USD", 50.50, "abc123", "Premium Item", "Virtual Goods", 2, 25.50);

// Example 3: Custom revenue with attributes dictionary
Dictionary<string, object> attributes = new Dictionary<string, object>()
{
    ["productSKU"] = "premium_bundle_xyz",
    ["productName"] = "Premium Bundle",
    ["productCategory"] = "Bundles",
    ["productQuantity"] = 1,
    ["productPrice"] = 99.99,
    ["discount_applied"] = true
};
SingularSDK.CustomRevenue("PremiumBundlePurchase", "USD", 99.99, attributes);

StoreKit2 지원

하이브리드 이벤트 추적 (고급)

최적의 어트리뷰션을 위해 모든 이벤트와 매출을 앱에 연동된 Singular SDK를 통해 전송하세요. 다만, 필요한 경우 Singular은 다른 소스에서 이벤트를 수집할 수 있습니다.

Singular SDK 외부에서 전송되는 이벤트는 Singular의 서버 간(Server-to-Server) 이벤트 문서 를 준수해야 하며 정확한 어트리뷰션을 위해 일치하는 디바이스 식별자를 제공해야 합니다.

하이브리드 이벤트 추적 가이드

내부 서버에서 이벤트 전송

내부 서버에서 매출 데이터를 수집하여 캠페인 성과와 ROI를 분석하세요.

요구사항:

• 디바이스 식별자 캡처: 인앱 회원 가입 또는 로그인 이벤트 중에 디바이스 식별자를 캡처하여 전달한 다음, 이 데이터를 User ID와 함께 서버에 저장하세요. 정확한 어트리뷰션을 보장하기 위해 유저가 새로운 앱 세션을 생성할 때 식별자를 업데이트하세요
• 플랫폼별 식별자: 플랫폼에 일치하는 디바이스 식별자와 함께 서버 측 이벤트를 전송하세요 (예: iOS 디바이스의 경우 IDFA 또는 IDFV, Android 디바이스의 경우 GAID)
• 실시간 업데이트: Singular Internal BI 포스트백 메커니즘을 사용하여 이벤트를 실시간으로 엔드포인트에 푸시하세요. Internal BI Postback FAQ 를 참고하세요
• 구현 세부 정보: 서버 간(Server-to-Server) 연동 가이드의 "매출 추적(Tracking Revenue)" 섹션을 검토하세요

매출 제공업체에서 이벤트 전송

RevenueCat 또는 adapty와 같은 서드파티 매출 제공업체를 연동하여 구매 및 구독 매출을 Singular에 전송하세요.

지원되는 제공업체:

• RevenueCat: 자세한 내용은 RevenueCat 문서 에서 확인하세요
• adapty: 자세한 내용은 adapty 문서 에서 확인하세요
• Superwall: 자세한 내용은 Superwall 문서 에서 확인하세요
• Xsolla: 자세한 내용은 Xsolla 문서 에서 확인하세요

Segment에서 이벤트 전송

Segment에 "Cloud-Mode" 대상을 추가하여 Segment가 Singular SDK와 병렬로 Singular에 이벤트를 전송하도록 설정하세요.

자세한 설정 방법은 구현 가이드 Singular-Segment 연동 을 참고하세요.