인앱 이벤트 추적

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

표준 이벤트 및 속성

이벤트 유형 이해하기

Singular은 범용 추적 요구사항과 앱별 추적 요구사항을 모두 충족하기 위해 두 가지 유형의 이벤트를 지원합니다.

• 표준 이벤트: Singular이 인식하고 광고 네트워크가 리포팅 및 최적화에 지원하는 사전 정의된 이벤트입니다(예: sngLogin , sngContentView ). 표준 이벤트를 사용하면 Singular이 수동 정의 없이 이벤트 목록에 자동으로 추가하므로 설정이 간단해집니다. 전체 이벤트 이름과 권장 속성은 표준 이벤트 및 속성 목록 을 참조하세요.
• 커스텀 이벤트: Singular의 표준 이벤트와 일치하지 않는, 앱에 고유한 이벤트입니다(예: Signup , AchievementUnlocked ).

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

커스텀 이벤트 제한 사항

커스텀 이벤트에는 서드파티 파트너 및 분석 솔루션과의 호환성을 보장하기 위한 문자 및 인코딩 제한이 있습니다.

이벤트 전송

event 메서드

추가 속성이 없는 간단한 이벤트를 추적하려면 event() 메서드를 사용하세요.

// Track a simple custom event
cordova.plugins.SingularCordovaSdk.event('SignUp');

// Track a standard event
cordova.plugins.SingularCordovaSdk.event('sngLogin');

메서드 시그니처:

event(eventName: string): void

전체 메서드 목록은 event 메서드 레퍼런스 를 참조하세요.

eventWithArgs 메서드

추가 커스텀 속성과 함께 이벤트를 추적하여 더 풍부한 컨텍스트를 제공하고 리포트에서 상세한 세분화를 사용할 수 있습니다.

// Track custom event with attributes
cordova.plugins.SingularCordovaSdk.eventWithArgs('LevelComplete', {
  level: 5,
  score: 1250,
  time_spent: 45.3
});

// Track standard event with recommended attributes
cordova.plugins.SingularCordovaSdk.eventWithArgs('sngTutorialComplete', {
  sngAttrContent: 'Cordova Basics',
  sngAttrContentId: '32',
  sngAttrContentType: 'video',
  sngAttrSuccess: 'yes'
});

메서드 시그니처:

eventWithArgs(eventName: string, args: Object): void

전체 메서드 목록은 eventWithArgs 메서드 레퍼런스 를 참조하세요.

모범 사례

인앱 구매 추적

인앱 구매(IAP), 구독, 커스텀 구매원의 구매을 추적하여 캠페인 성과와 광고 투자 구매률(ROAS)을 측정할 수 있습니다.

구매 데이터는 세 가지 채널을 통해 전달됩니다:

• 인터랙티브 보고서: Singular 대시보드에서 구매 지표를 볼 수 있습니다.
• 로그 내보내기: 사용자 지정 분석을 위해 상세한 ETL 데이터에 액세스
• 실시간 포스트백: 구매 이벤트를 외부 플랫폼으로 전송

왜 구매 이벤트를 추적해야 하나요?

• 풍부한 분석: 상세한 거래 데이터를 캡처하여 Singular 리포트 강화
• 사기 방지: 거래 영수증(예: 구글 플레이 또는 애플 앱스토어)을 포함시켜 구매를 검증하고 인앱 사기를 방지합니다.
• 캠페인 최적화: 구매을 마케팅 활동과 연결하여 ROI 측정

인앱 구매 연동

IAP 구매 개체 캡처

Cordova IAP 플러그인을 사용하면 플랫폼 스토어에서 전체 거래 세부 정보가 포함된 구매 개체를 검색할 수 있습니다.

• iOS: 코드바-플러그인-구매 또는 이와 유사한 코드를 사용하여 스토어키트 구매 세부 정보에 액세스합니다.
• Android: 코드바-플러그인-구매 또는 유사 플러그인을 사용하여 Google Play 청구 구매 세부 정보를 가져옵니다.

SingularIAP 생성자

플랫폼별 영수증 유효성 검사 및 사기 방지를 통해 구매을 추적하기 위한 인앱 구매 객체를 생성합니다.

생성자 서명 :

function SingularIAP(product: Object): SingularIAP

전체 생성자 참조는 SingularIAP 생성자 참조를 참조하세요.

전체 IAP 구현 예시

플랫폼별 구매 객체를 사용하여 IAP 이벤트를 캡처하고 이를 Singular로 전송하는 전체 구매 리스너를 구현합니다.

// Import Singular SDK and SingularIAP constructor
var Singular = cordova.plugins.SingularCordovaSdk;
var SingularIAP = cordova.plugins.SingularCordovaSdk.SingularIAP;

// iOS App Store purchase example
function handleiOSPurchase(purchase) {
  // Create iOS product object
  var iosProduct = {
    currency: 'USD',
    price: '$4.99',
    id: 'com.app.premiumgems',
    transaction: {
      type: 'ios-appstore',
      appStoreReceipt: purchase.receipt, // Base64 receipt from StoreKit
      id: purchase.transactionId // Transaction identifier
    }
  };

  // Create SingularIAP object
  var iosIAP = new SingularIAP(iosProduct);

  // Track the purchase with Singular
  // The SingularIAP object is passed as additional args
  cordova.plugins.SingularCordovaSdk.eventWithArgs('iap_purchase', iosIAP);
}

// Android Play Store purchase example
function handleAndroidPurchase(purchase) {
  // Create Android product object
  var androidProduct = {
    currency: 'USD',
    price: '$4.99',
    id: 'com.app.premiumgems',
    transaction: {
      type: 'android-playstore',
      receipt: purchase.receipt, // JSON receipt from Google Play
      signature: purchase.signature // Signature from Google Play
    }
  };

  // Create SingularIAP object
  var androidIAP = new SingularIAP(androidProduct);

  // Track the purchase with Singular
  cordova.plugins.SingularCordovaSdk.eventWithArgs('iap_purchase', androidIAP);
}

// Example integration with cordova-plugin-purchase
document.addEventListener('deviceready', function() {
  // Initialize the store
  store.register({
    id: 'com.app.premiumgems',
    type: store.CONSUMABLE
  });

  // Handle purchase approved
  store.when('com.app.premiumgems').approved(function(product) {
    // Determine platform and handle accordingly
    if (device.platform === 'iOS') {
      handleiOSPurchase(product.transaction);
    } else if (device.platform === 'Android') {
      handleAndroidPurchase(product.transaction);
    }

    // Finish the transaction
    product.finish();
  });

  // Refresh the store
  store.refresh();
});

수동 구매 추적

구매 유효성 검사 없는 구매

구매 개체 없이 통화, 금액, 선택적 제품 세부 정보를 전달하여 구매을 추적합니다. 이 방법은 유효성 검사를 위한 거래 영수증을 제공하지 않습니다.

구매 방법

지정된 통화와 금액으로 간단한 구매 이벤트를 추적합니다.

// Track revenue without product details
cordova.plugins.SingularCordovaSdk.revenue('USD', 4.99);

메소드 서명 :

revenue(currency: string, amount: number): void

전체 메소드 목록은 구매 메소드 참조를 참조하세요.

RevenueWithArgs 메서드

지정된 통화, 금액 및 추가 사용자 지정 속성을 사용하여 구매 이벤트를 추적합니다.

// Track revenue with attributes
cordova.plugins.SingularCordovaSdk.revenueWithArgs('USD', 9.98, {
  productSKU: 'coin_package_abc123',
  productName: 'Coin Pack 10',
  productCategory: 'Bundles',
  productQuantity: 2,
  productPrice: 4.99,
  transaction_id: 'T12345'
});

메소드 서명 :

revenueWithArgs(currency: string, amount: number, args: Object): void

전체 메소드 목록은 구매 메소드 참조를 참조하세요.

CustomRevenue 메서드

지정된 이벤트 이름, 통화 및 금액으로 사용자 지정 구매 이벤트를 추적합니다.

// Track custom revenue event
cordova.plugins.SingularCordovaSdk.customRevenue('PremiumUpgrade', 'USD', 9.99);

메서드 서명 :

customRevenue(eventName: string, currency: string, amount: number): void

전체 메소드 목록은 customRevenue 메소드 참조를 참조하세요.

CustomRevenueWithArgs 메서드

지정된 이벤트 이름, 통화, 금액 및 추가 사용자 지정 속성을 사용하여 사용자 지정 구매 이벤트를 추적합니다.

// Track custom revenue event with attributes
cordova.plugins.SingularCordovaSdk.customRevenueWithArgs('PremiumBundlePurchase', 'USD', 99.99, {
  productSKU: 'premium_bundle_xyz',
  productName: 'Premium Bundle',
  productCategory: 'Bundles',
  productQuantity: 1,
  productPrice: 99.99,
  discount_applied: true
});

메서드 서명 :

customRevenueWithArgs(eventName: string, currency: string, amount: number, args: Object): void

전체 메소드 목록은 customRevenueWithArgs 메소드 참조를 참조하세요.

구독 구매

구독 추적

Singular는 Singular SDK를 사용하여 구독 이벤트를 구현하는 방법에 대한 포괄적인 가이드를 제공합니다. 이 가이드는 다양한 플랫폼에서 인앱 구독 이벤트 추적을 다룹니다.

• 구독 구매을 추적하려면 구독 이벤트 기술 구현 가이드를 읽어보세요.

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

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

Singular SDK 외부에서 전송되는 이벤트는 Singular의 서버 간 이벤트 문서 요구사항을 준수해야 하며, 정확한 어트리뷰션을 위해 일치하는 기기 식별자를 제공해야 합니다.

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

내부 서버에서 이벤트 보내기

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

요구 사항

• 디바이스 식별자를 캡처합니다: 인앱 등록 또는 로그인 이벤트에서 디바이스 식별자를 캡처하여 전달하고 이 데이터를 서버에 사용자 ID와 함께 저장하세요. 디바이스 식별자는 사용자에 따라 변경될 수 있으므로 사용자가 앱 세션을 생성할 때 식별자를 업데이트하세요. 이렇게 하면 서버 측 이벤트가 올바른 디바이스에 어트리뷰션되도록 보장할 수 있습니다.
• 플랫폼별 식별자: 서버 측 이벤트는 플랫폼별로 다르며 디바이스 플랫폼과 일치하는 디바이스 식별자(예: iOS 디바이스의 경우 IDFA 또는 IDFV, 안드로이드 디바이스의 경우 GAID)로만 전송해야 합니다.
• 실시간 업데이트: Singular 내부 BI 포스트백 메커니즘을 사용하여 이벤트를 내부 엔드포인트에 실시간으로 푸시하여 서버 측의 데이터 집합을 업데이트할 수 있습니다. 내부 BI 포스트백 FAQ를 참조하세요.
• 구현 세부 정보: 자세한 내용은 서버 간 연동 가이드의 구매 추적 섹션을 검토하세요.

구매 제공업체에서 이벤트 보내기

RevenueCat 또는 어댑터와 같은 타사 구매 제공업체를 연동하여 구매 및 구독 구매을 Singular로 전송하세요.

지원되는 제공업체

• RevenueCat: RevenueCat 문서에서 자세히 알아보기
• adapty: 어댑티브: 어댑티브 문서에서 자세히 알아보기
• Superwall: 어댑티브: 어댑티브 문서에서 자세히 알아보기
• Xsolla: 어댑티브: 어댑티브 문서에서 자세히 알아보기

세그먼트에서 이벤트 보내기

세그먼트에 "클라우드 모드" 대상을 추가하여 세그먼트에서 이벤트를 Singular SDK와 병행하여 Singular로 전송할 수 있도록 설정하세요.

자세한 설정 지침은 구현 가이드 Singular-Segment 연동을 참조하세요.