来自亚马逊 Pinpoint 的应用程序事件数据流 - Amazon Pinpoint
应用程序事件示例应用程序事件属性

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

来自亚马逊 Pinpoint 的应用程序事件数据流

在您将应用程序（应用程序）与 Amazon Pinpoint 集成并设置事件流之后，Amazon Pinpoint 会从您在设置期间指定的目标中检索应用程序的用户活动、自定义事件和消息传递数据供您查看。有关如何设置事件直播以便查看事件数据的信息，请参阅 设置 Amazon Pinpoint 以通过亚马逊 Kinesis 或亚马逊 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_id

标识会话的唯一 ID。
start_timestamp

会话开始的日期和时间，显示为以毫秒为单位的 Unix 时间。
stop_timestamp

会话结束的日期和时间，显示为以毫秒为单位的 Unix 时间。