從 Amazon Pinpoint 的應用程式事件資料串流

將應用程式 （應用程式） 與 Amazon Pinpoint 整合並設定事件串流後，Amazon Pinpoint 會從您在設定期間指定的目的地擷取應用程式的使用者活動、自訂事件和訊息傳遞資料，供您檢視。如需如何設定事件串流以便檢視事件資料的詳細資訊，請參閱 設定 Amazon Pinpoint，透過 Amazon Kinesis 或 Amazon Data Firehose 串流應用程式事件資料 。

應用程式事件範例

應用程式事件的JSON物件包含下列範例所示的資料。

{
  "event_type": "_session.stop",
  "event_timestamp": 1487973802507,
  "arrival_timestamp": 1487973803515,
  "event_version": "3.0",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "cognito_identity_pool_id": "us-east-1:a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
    "package_name": "main.page",
    "sdk": {
      "name": "aws-sdk-mobile-analytics-js",
      "version": "0.9.1:2.4.8"
    },
    "title": "title",
    "version_name": "1.0",
    "version_code": "1"
  },
  "client": {
    "client_id": "m3n4o5p6-a1b2-c3d4-e5f6-g7h8i9j0k1l2",
    "cognito_id": "us-east-1:i9j0k1l2-m3n4-o5p6-a1b2-c3d4e5f6g7h8"
  },
  "device": {
    "locale": {
      "code": "en_US",
      "country": "US",
      "language": "en"
    },
    "make": "generic web browser",
    "model": "Unknown",
    "platform": {
      "name": "android",
      "version": "10.10"
    }
  },
  "session": {
    "session_id": "f549dea9-1090-945d-c3d1-e4967example",
    "start_timestamp": 1487973202531,
    "stop_timestamp": 1487973802507
  },
  "attributes": {},
  "metrics": {}
}

應用程式事件屬性

本節定義了應用程式事件串流先前範例中包含的屬性。

屬性	描述
event_type	事件的類型。可能值為： _session.start – 端點已開始新的工作階段。 _session.stop – 端點已結束工作階段。 _userauth.sign_in – 端點已登入您的應用程式。 _userauth.sign_up – 新端點已在應用程式中完成註冊程序。 _userauth.auth_fail – 端點曾嘗試登入您的應用程式，但無法完成程序。 _monetization.purchase – 端點在應用程式中購買了商品。 _session.pause – 端點已暫停一個工作階段。暫停的工作階段可以繼續，所以您可繼續收集指標，不用啟動全新的工作階段。 _session.resume – 端點已恢復一個工作階段。
event_timestamp	報告事件的時間，以 Unix 時間顯示 (毫秒)。
arrival_timestamp	Amazon Pinpoint 收到事件的時間，顯示為 Unix 時間 (以毫秒為單位)。
event_version	事件JSON結構描述的版本。 提示 在您的事件處理應用程式中檢查此版本，讓您知道何時更新應用程式以回應結構描述更新。
application	與事件相關聯的 Amazon Pinpoint 專案的資訊。如需詳細資訊，請參閱應用程式表。
client	回報事件的端點相關資訊。如需詳細資訊，請參閱用戶端表。
device	回報事件的裝置資訊。如需詳細資訊，請參閱裝置表。
session	產生事件的工作階段資訊。如需詳細資訊，請參閱工作階段表。
attributes	與事件相關聯的屬性。針對您應用程式報告的事件，此物件包含您定義的自訂屬性。
metrics	與事件有關的指標。(選用) 您可以設定應用程式將自訂指標傳送到 Amazon Pinpoint。

應用程式

包含與事件相關聯的 Amazon Pinpoint 專案資訊。

屬性	描述
app_id	回報事件的 Amazon Pinpoint 專案的唯一 ID。
cognito_identity_pool_id	與端點相關聯的 Amazon Cognito 身分池的 ID。
package_name	應用程式套件的名稱，例如 com.example.my_app。
sdk	用於報告事件SDK的 相關資訊。如需詳細資訊，請參閱 SDK 資料表。
title	應用程式的名稱。
version_name	應用程式的版本名稱，例如 V2.5。
version_code	應用程式的版本號碼，例如 3。

SDK

包括用於報告事件SDK的 相關資訊。

屬性	描述
name	SDK 用於報告事件的 名稱。
version	的版本SDK。

用戶端

包含產生事件的端點相關資訊。

屬性	描述
client_id	端點的 ID。
cognito_id	與端點相關聯的 Amazon Cognito ID 權杖。

裝置

包含產生事件之端點的裝置相關資訊。

屬性	描述
locale	端點裝置的語言和區域設定相關資訊。如需詳細資訊，請參閱地區設定表。
make	端點裝置的製造商。
model	端點裝置的型號識別碼。
platform	端點裝置上作業系統的相關資訊。如需詳細資訊，請參閱平台表。

Locale

包括端點裝置的語言和區域設定相關資訊。

屬性	描述
code	與裝置關聯的地區設定識別符。
country	與裝置地區設定相關聯的國家或區域。
language	與裝置地區設定相關聯的語言。

平台

包括端點裝置上作業系統的相關資訊。

屬性	描述
name	裝置上的作業系統名稱。
version	裝置上的作業系統版本。

Session (工作階段)

包含產生事件的工作階段資訊。

屬性	描述
session_id	識別工作階段的唯一 ID。
start_timestamp	工作階段開始的日期和時間，以 Unix 時間顯示 (毫秒)。
stop_timestamp	工作階段結束的日期和時間，以 Unix 時間顯示 (毫秒)。