Amazon Mobile Analytics - AWSMobile SDK for Unity
集成 Amazon Mobile Analytics

所以此AWS適用於 Unity 的 Mobile SDK 現已包含在AWS SDK for .NET。本指南引用適用於 Unity 的 Mobile SDK 的存檔版本。如需詳細資訊，請參閱「」什麼是AWS適用於 Unity 的 Mobile SDK？

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon Mobile Analytics

使用 Amazon Mobile Analytics，您可以跟蹤買家行為、彙總指標、生成數據可視化以及識別有意義的模式。有關 Mobile Analytics 的信息，請參閲AWS Mobile Analytics。

集成 Amazon Mobile Analytics

以下部分介紹瞭如何將 Mobile Analytics 與您的應用集成。

在 Mobile Analytics 控制台中創建應用

前往Amazon Mobile Analytics並建立應用程式。請注意appId值，因為您稍後需要。

注意

若要進一步了解在控台中工作，請參Amazon Mobile Analytics 使用者指南。

在 Mobile Analytics 控制台中創建應用時，您需要指定一個 Cognito 身份池 ID。要創建新的 Cognito 身份池並生成 ID，請參閲Cognito Identity Analytics 指南。

將 Mobile Analytics 集成到您的應用

要從 Unity 訪問 Mobile Analytics，您將需要以下使用語句：

using Amazon.MobileAnalytics.MobileAnalyticsManager;
using Amazon.CognitoIdentity;

最佳做法是使用 Amazon Cognito 來提供臨時 AWS 登入資料給您的應用程式。這些登入資料可讓應用程式存取您的 AWS 資源。若要建立登入資料供應商，請依照Amazon Cognito Identity。

實例化MobileAnalyticsManager 實例，包含下列資訊：

  • cognitoIdentityPoolId-應用程式的 Cognito Identity Pool 的 ID

  • cognitoRegion-您的 Cognito 身份池的區域，例如」RegionEndpoint.USAST1」

  • 區域-Mobile Analytics 服務的區域，例如」RegionEndpoint.USAST1」

  • appId-添加應用程序時 Mobile Analytics 控制台生成的值

使用MobileAnalyticsClientContextConfig 初始化 MobileAnalyticsManager 實例，如下列程式碼片段所示：

// Initialize the MobileAnalyticsManager
void Start()
{
    // ...
    analyticsManager = MobileAnalyticsManager.GetOrCreateInstance(
        new CognitoAWSCredentials(<cognitoIdentityPoolId>, <cognitoRegion>),
        <region>,
        <appId>);
    // ...
}
注意

應用程序 ID 是在應用程序創建嚮導期間為您生成的。這兩個值都必須與 Mobile Analytics 控制台中的值匹配。

所以此appId用於在 Mobile Analytics 控制台中對您的數據進行分組。要在 Mobile Analytics 控制台中創建應用後查找應用 ID，請瀏覽至 Mobile Analytics 控制台，單擊屏幕右上角的齒輪圖標。這將顯示應用程序管理頁面，其中列出了所有已註冊的應用程序及其應用 ID。

記錄獲利事件

適 SDK for Unity 提供了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 允許您定義自定義事件。自定義事件完全由您定義；它們可幫助您跟蹤特定於應用或遊戲的用户操作。如需自訂事件的詳細資訊，請參自訂事件。在此示例中，假設您的應用程序是一個遊戲，並且您希望在用户完成關卡時記錄事件。建立」LevelComplete」事件，方法是創建一個新的AmazonMobileAnalyticsEvent實例：

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);

記錄會話

當應用程序失去焦點時，您可以暫停會話。InOnApplicationFocus檢查應用程序是否正在暫停。如果是這樣，調用PauseSession否則調用ResumeSession如下列程式碼片段所示：

void OnApplicationFocus(bool focus)
{
    if(focus)
    {
        analyticsManager.ResumeSession();
    }
    else
    {
        analyticsManager.PauseSession();
    }
}

默認情況下，如果用户將焦點從應用程序切換到不到 5 秒，並切換回應用程序，則會話將恢復。如果用户將焦點從應用程序切換為 5 秒或更長時間，將創建一個新會話。此設置可以在 awsconfig.xml 文件中進行配置。如需詳細資 Mobile Analytics 參適用於 Unity 的 AWS Mobile SDK 入門。