인앱 이벤트 추적

인앱 이벤트를 추적하여 캠페인 성과를 분석하고 사용자 로그인, 등록, 튜토리얼 완료 또는 진행 마일스톤과 같은 핵심 성과 지표(KPI)를 측정할 수 있습니다.

표준 이벤트 및 속성

이벤트 유형 이해

Singular는 두 가지 유형의 이벤트를 지원하여 범용 및 앱별 추적 요구 사항을 모두 충족합니다.

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

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

커스텀 이벤트 제한 사항

사용자 지정 이벤트에는 타사 파트너 및 분석 솔루션과의 호환성을 보장하기 위해 특정 문자 및 인코딩 제약 조건이 있습니다.

이벤트 보내기

이벤트 메서드

event() 메서드를 사용하여 추가 속성 없이 간단한 이벤트를 추적합니다.

import 'package:singular_flutter_sdk/singular.dart';

// Track a simple custom event
Singular.event('SignUp');

// Track a standard event
Singular.event('sngLogin');

메소드 서명:

static void event(String eventName)

전체 메서드 목록은 이벤트 메서드 참조를 참조하세요.

EventWithArgs 메서드

추가 사용자 지정 속성으로 이벤트를 추적하여 보다 풍부한 컨텍스트를 제공하고 보고서에서 세부적인 세분화를 가능하게 합니다.

import 'package:singular_flutter_sdk/singular.dart';

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

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

메서드 서명:

static void eventWithArgs(String eventName, Map args)

전체 메서드 목록은 이벤트WithArgs 메서드 참조를 참조하세요.

모범 사례

인앱 구매 추적

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

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

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

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

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

인앱 구매 연동

IAP 구매 개체 캡처

Flutter in_app_purchase 패키지를 사용하여 전체 거래 세부 정보가 포함된 구매 객체를 검색할 수 있습니다.

• Flutter: 인앱 구매 패키지를 사용하여 iOS 스토어키트 및 안드로이드 구글 플레이 결제 구매 세부 정보에 모두 액세스하세요.

인앱 구매 방법

구매 검증 및 사기 방지를 위해 구매 세부 정보가 포함된 인앱 구매 이벤트를 추적합니다.

메소드 서명:

static void inAppPurchase(String eventName, SingularIAP purchase)

static void inAppPurchaseWithAttributes(String eventName, SingularIAP purchase, Map attributes)

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

전체 IAP 구현 예시

IAP 이벤트를 캡처하여 플랫폼별 구매 개체와 함께 Singular로 전송하는 전체 구매 리스너를 구현합니다.

import 'dart:io' show Platform;
import 'package:in_app_purchase/in_app_purchase.dart';
import 'package:in_app_purchase_android/in_app_purchase_android.dart';
import 'package:in_app_purchase_storekit/in_app_purchase_storekit.dart';
import 'package:singular_flutter_sdk/singular.dart';
import 'package:singular_flutter_sdk/singular_iap.dart';

Future<void> handlePurchase(PurchaseDetails purchaseDetails) async {
  if (purchaseDetails.status != PurchaseStatus.purchased &&
      purchaseDetails.status != PurchaseStatus.restored) {
    return;
  }

  final response = await InAppPurchase.instance
      .queryProductDetails({purchaseDetails.productID});
  if (response.productDetails.isEmpty) {
    return;
  }
  final product = response.productDetails.first;

  // Extract price and currency with platform-specific handling
  double price = 0.0;
  String currency = 'USD';

  if (Platform.isAndroid && product is GooglePlayProductDetails) {
    final offer = product.productDetails.oneTimePurchaseOfferDetails;
    price = (offer?.priceAmountMicros ?? 0) / 1000000;
    currency = offer?.priceCurrencyCode ?? 'USD';
  } else if (Platform.isIOS && product is AppStoreProductDetails) {
    price = product.skProduct.price;
    currency = product.skProduct.priceLocale.currencyCode ?? 'USD';
  }

  SingularIAP? singularPurchase;

  if (Platform.isAndroid && purchaseDetails is GooglePlayPurchaseDetails) {
    singularPurchase = SingularAndroidIAP(
      price,
      currency,
      purchaseDetails.billingClientPurchase.signature,
      purchaseDetails.billingClientPurchase.originalJson,
    );
  } else if (Platform.isIOS && purchaseDetails is AppStorePurchaseDetails) {
    singularPurchase = SingularIOSIAP(
      price,
      currency,
      purchaseDetails.productID,
      purchaseDetails.skPaymentTransaction.transactionIdentifier ?? '',
      purchaseDetails.verificationData.serverVerificationData,
    );
  } else {
    return;
  }

  const String eventName = 'iap_purchase';
  
  // Track with attributes (use only ONE tracking method)
  Singular.inAppPurchaseWithAttributes(eventName, singularPurchase, {
    'user_level': 42,
    'is_first_purchase': true,
    'gems_balance': 1500
  });

  await InAppPurchase.instance.completePurchase(purchaseDetails);
}

수동 구매 추적

구매 검증 없는 구매

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

CustomRevenue 메서드

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

import 'package:singular_flutter_sdk/singular.dart';

// Track custom revenue event
Singular.customRevenue('PremiumUpgrade', 'USD', 9.99);

메소드 서명:

static void customRevenue(String eventName, String currency, double amount)

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

CustomRevenueWithAttributes 메서드

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

import 'package:singular_flutter_sdk/singular.dart';

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

메서드 서명:

static void customRevenueWithAttributes(
  String eventName,
  String currency,
  double amount,
  Map attributes
)

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

CustomRevenueWithAllAttributes 메서드

제품 SKU, 이름, 카테고리, 수량, 사용자 지정 속성 등 가능한 모든 속성을 사용하여 사용자 지정 구매 이벤트를 추적합니다.

import 'package:singular_flutter_sdk/singular.dart';

// Track custom revenue with all attributes
Singular.customRevenueWithAllAttributes(
  'CoinPackagePurchase',
  'USD',
  4.99,
  'coin_package_abc123',
  'Coin Pack 10',
  'Virtual Currency',
  2,
  {
    'payment_method': 'google_play',
    'transaction_id': 'T12345'
  }
);

메서드 서명:

static void customRevenueWithAllAttributes(
  String eventName,
  String currency,
  double amount,
  String productSKU,
  String productName,
  String productCategory,
  int productQuantity,
  Map attributes
)

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

구독 구매

구독 추적

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: 어댑티브: 어댑티브 문서에서자세히 알아보기

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

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

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