AWS Mobile SDK for Xamarin은 이제 AWS SDK for .NET에 포함됩니다. 이 안내서에서는 Xamarin용 모바일 SDK의 아카이브된 버전을 참조합니다.

Amazon Mobile Analytics

Amazon Mobile Analytics는 대규모로 앱 사용량 데이터를 수집, 시각화, 분석 및 추출하는 서비스입니다. Mobile Analytics는 표준 디바이스 데이터와 커스텀 이벤트를 모두 손쉽게 캡처하고 사용자 대신 자동으로 보고서를 계산합니다. 아래 나열된 집계 보고서 이외에 추가 분석으로 위해 자동으로 데이터를 Redshift 및 S3으로 내보내도록 설정할 수도 있습니다.

Amazon Mobile Analytics를 사용하면 고객 행동을 추적하고, 지표를 집계하고, 데이터 시각화를 생성하고, 유의미한 패턴을 식별할 수 있습니다.

핵심 개념

보고서 유형

Mobile Analytics에서는 Mobile Analytics 콘솔을 통해 다음과 같은 보고서를 즉시 사용할 수 있습니다.

다음 보고서가 콘솔에서 6개 보고 탭을 통해 제공됩니다.

Mobile Analytics 보고서 및 Mobile Analytics 콘솔 사용에 대한 자세한 내용은 Mobile Analytics 개발자 안내서의 Mobile Analytics 콘솔 보고서 개요를 참조하세요.

프로젝트 설정

필수 조건

애플리케이션에서 Mobile Analytics를 사용하려면 프로젝트에 SDK를 추가해야 합니다. 이렇게 하려면 .NET 및 Xamarin용 AWS Mobile SDK 설정의 지침을 따르세요.

Mobile Analytics 설정 구성

Mobile Analytics는 몇 가지 설정을 정의하며, 각 설정은 awsconfig.xml 파일에서 구성할 수 있습니다.

var config = new MobileAnalyticsManagerConfig();
config.AllowUseDataNetwork = true;
config.DBWarningThreshold = 0.9f;
config.MaxDBSize = 5242880;
config.MaxRequestSize = 102400;
config.SessionTimeout = 5;

위에 표시된 설정은 각 구성 항목의 기본값입니다.

애플리케이션에 Mobile Analytics 통합

다음 섹션에서는 앱에 Mobile Analytics를 통합하는 방법을 설명합니다.

Mobile Analytics 콘솔에서 앱 생성

Amazon Mobile Analytics 콘솔로 이동하여 앱을 생성합니다. 나중에 필요하므로 appId 값을 기록합니다. Mobile Analytics 콘솔에서 앱을 생성할 때 자격 증명 풀 ID를 지정해야 합니다. 자격 증명 풀을 생성하기 위한 지침은 .NET 및 Xamarin용 AWS Mobile SDK 설정을 참조하세요.

Mobile Analytics 콘솔 사용에 대한 자세한 내용은 Mobile Analytics 개발자 안내서의 Mobile Analytics 콘솔 보고서 개요를 참조하세요.

MobileAnalyticsManager 클라이언트 생성

MobileAnalyticsManager를 초기화하려면 MobileAnalyticsManager에서 GetOrCreateInstance를 호출하여 AWS 자격 증명, 리전, Mobile Analytics 애플리케이션 ID 및 config 객체(선택 사항)를 가져옵니다.

// Initialize the MobileAnalyticsManager
analyticsManager = MobileAnalyticsManager.GetOrCreateInstance(
  cognitoCredentials,
  RegionEndpoint.USEast1,
  APP_ID,
  config
);

APP_ID는 앱 생성 마법사가 자동으로 생성합니다. 이들 두 값이 Mobile Analytics 콘솔 내 값과 일치해야 합니다. APP_ID는 Mobile Analytics 콘솔에서 데이터를 그룹화하는 데 사용됩니다. Mobile Analytics 콘솔에서 앱을 생성한 후 앱 ID를 찾으려면 Mobile Analytics 콘솔로 이동하여 화면의 오른쪽 위에 있는 기어 모양 아이콘을 클릭합니다. 그러면 [App Management] 페이지가 열려 모든 등록된 앱 및 해당 앱 ID가 나열됩니다.

수익화 이벤트 기록

.NET 및 Xamarin용 AWS Mobile SDK는 MonetizationEvent 클래스를 제공합니다. 이 클래스를 사용하면 수익화 이벤트를 생성하여 모바일 애플리케이션 내에서 발생한 구매를 추적할 수 있습니다. 다음 코드 조각은 수익화 이벤트를 생성하는 방법을 보여줍니다.

// Create the monetization event object
MonetizationEvent monetizationEvent = new MonetizationEvent();

// Set the details of the monetization event
monetizationEvent.Quantity = 3.0;
monetizationEvent.ItemPrice = 1.99;
monetizationEvent.ProductId = "ProductId123";
monetizationEvent.ItemPriceFormatted = "$1.99";
monetizationEvent.Store = "Your-App-Store";
monetizationEvent.TransactionId = "TransactionId123";
monetizationEvent.Currency = "USD";

// Record the monetiziation event
analyticsManager.RecordEvent(monetizationEvent);

커스텀 이벤트 기록

Mobile Analytics를 사용하면 커스텀 이벤트를 정의할 수 있습니다. 커스텀 이벤트는 전적으로 개발자가 정의합니다. 이러한 이벤트는 앱 또는 게임에 고유한 사용자 작업을 추적하는 데 도움이 됩니다. 커스텀 이벤트에 대한 자세한 내용은 커스텀 이벤트를 참조하세요.

이 예제에서는 앱이 게임이고 사용자가 레벨을 완료할 때마다 이벤트를 기록하는 것으로 가정합니다. 새 AmazonMobileAnalyticsEvent 인스턴스를 생성하여 "LevelComplete" 이벤트를 생성합니다.

CustomEvent customEvent = new CustomEvent("LevelComplete");

// Add attributes
customEvent.AddAttribute("LevelName","Level1");
customEvent.AddAttribute("CharacterClass","Warrior");
customEvent.AddAttribute("Successful","True");

// Add metrics
customEvent.AddMetric("Score",12345);
customEvent.AddMetric("TimeInLevel",64);

// Record the event
analyticsManager.RecordEvent(customEvent);

세션 기록

Xamarin iOS

애플리케이션이 포커스를 잃을 경우 세션을 일시 중지할 수 있습니다. iOS 앱인 경우 다음 코드 조각에 표시된 대로 AppDelegate.cs 파일에서 DidEnterBackground 및 WillEnterForeground를 재정의하여 MobileAnalyticsManager.PauseSesion 및 MobileAnalyticsManager.ResumeSession을 호출합니다.

public override void DidEnterBackground(UIApplication application)
{
  // ...
  _manager.PauseSesson();
  // ...
}

public override void WillEnterForeground(UIApplication application)
{
  // ...
  _manager.ResumeSession();
  // ...
}

Xamarin Android

Android 앱인 경우 다음 코드 조각에 표시된 대로 OnPause() 메서드에서 MobileAnalyticsManager.PauseSesion을 호출하고 OnResume() 메서드에서 MobileAnalyticsManager.ResumeSession을 호출합니다.

protected override void OnResume()
{
  _manager.ResumeSession();
  base.OnResume();
}

protected override void OnPause()
{
  _manager.PauseSession();
  base.OnPause();
}

기본적으로 사용자가 5초 미만으로 앱에서 포커스를 돌렸다가 다시 앱에 포커스를 맞출 경우 세션이 재개됩니다. 사용자가 5초 이상 앱에서 포커스를 돌릴 경우 새로운 세션이 생성됩니다. 이 설정은 aws_mobile_analytics.json 구성 파일에서 "SESSION_DELTA" 속성을 신규 세션을 생성하기 전에 대기할 시간(초)으로 설정하여 구성할 수 있습니다.