從 Amazon Pinpoint 的應用程式事件資料串流 - Amazon Pinpoint
應用程式事件範例應用程式事件屬性

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

從 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 時間顯示 (毫秒)。