来自亚马逊 Pinpoint 的旅程事件数据 - Amazon Pinpoint
旅程事件示例旅程事件属性

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

来自亚马逊 Pinpoint 的旅程事件数据

当您发布旅程时，Amazon Pinpoint 可以流式传输您在旅程中发送的电子邮件SMS、推送和自定义消息的事件数据。设置事件直播后，Amazon Pinpoint 会从您在设置期间指定的目标中检索数据供您查看。有关 Amazon Pinpoint 流式传输的电子邮件和SMS消息数据的详细信息，请参阅通过电子邮件发送来自亚马逊 Pinpoint 的事件数据流和。SMS来自亚马逊 Pinpoint 的事件数据流有关如何设置事件直播的信息，请参阅 设置 Amazon Pinpoint 以通过亚马逊 Kinesis 或亚马逊 Data Firehose 流式传输应用程序事件数据 。

旅程事件示例

旅程事件的JSON对象包含以下示例中显示的数据。

{
   "event_type":"_journey.send",
   "event_timestamp":1572989078843,
   "arrival_timestamp":1572989078843,
   "event_version":"3.1",
   "application":{
      "app_id":"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
      "sdk":{

      }
   },
   "client":{
      "client_id":"d8dcf7c5-e81a-48ae-8313-f540cexample"
   },
   "device":{
      "platform":{

      }
   },
   "session":{

   },
   "attributes":{
      "journey_run_id":"edc9a0b577164d1daf72ebd15example",
      "journey_send_status":"SUCCESS",
      "journey_id":"546401670c5547b08811ac6a9example",
      "journey_activity_id":"0yKexample",
      "journey_activity_type": "EMAIL",
      "journey_send_status_message": "200", 
      "journey_send_status_code": "200"
   },
   "client_context":{
      "custom":{
         "endpoint":"{\"ChannelType\":\"EMAIL\",\"EndpointStatus\":\"ACTIVE\",\"OptOut\":\"NONE\",\"Demographic\":{\"Timezone\":\"America/Los_Angeles\"}}"
      }
   },
   "awsAccountId":"123456789012"
}

旅程事件属性

此部分定义 Amazon Pinpoint 为旅程生成的事件流数据中包含的属性。

属性 描述
event_type

事件类型。对于旅程事件，此属性的值始终为 _journey.send，这表示 Amazon Pinpoint 已执行旅程。
event_timestamp

报告事件的时间，显示为以毫秒为单位的 Unix 时间。
arrival_timestamp

Amazon Pinpoint 收到事件的时间，显示为以毫秒为单位的 Unix 时间。
event_version

事件JSON架构的版本。

提示

在事件处理应用程序中检查此版本，以便知道何时更新应用程序以响应架构更新。
application

与事件关联的 Amazon Pinpoint 项目的相关信息。有关更多信息，请参阅应用程序表。
client

与事件关联的端点的相关信息。有关更多信息，请参阅客户端 表。
device

报告事件的设备的相关信息。对于历程，此对象为空。
session

有关生成事件的会话的信息。对于历程，此对象为空。
attributes

与生成事件的旅程和旅程活动关联的属性。有关更多信息，请参阅属性表。
client_context 包含一个 custom 对象，其中包含一个 endpoint 属性。endpoint 属性包含与事件关联的端点的端点记录内容。
awsAccountId

用于执行旅程的 AWS 账户的 ID。

应用程序

包括与事件关联的 Amazon Pinpoint 项目的相关信息。

属性 描述
app_id

报告事件的 Amazon Pinpoint 项目的唯一 ID。
sdk

SDK用于报告事件的。

客户端

包括与事件关联的端点的相关信息。

属性 描述
client_id 端点的 ID。

Attributes

包括有关生成事件的旅程的信息。

属性 描述
journey_run_id

生成事件的旅程的唯一 ID。Amazon Pinpoint 会自动为旅程的每一个新运行生成并分配此 ID。
journey_send_status

指示与事件关联的消息的传输状态。可能的值包括：

  • SUCCESS— 消息已成功发送到端点。

  • FAILURE— 由于出现错误，消息未发送到端点。

  • CUSTOM_ DELIVERY _ FAILURE — 自定义传送失败。

  • FAILURE_ PERMANENT — 发送到端点时出现永久故障。

    提示

    您可以筛选PERMANENT状态为 FAILURE_ 且journey_send_status_code设置为 403 的事件，以确定是否存在访问策略和角色违规。对于带语音的出站营销活动，这些例外情况通常是将 Amazon Pinpoint 旅程与 Amazon Connect 活动绑定的 connect 活动执行角色无意中删除以执行机上旅程的情况。

  • THROTTLED— 发送已受限制。

  • UNSUPPORTED_ CHANNEL — 不支持频道。

  • DAILY_ CAP — 消息未发送到终端节点，因为发送消息将超过旅程或项目在 24 小时内可以向单个终端节点发送的最大消息数量。

  • QUIET_ TIME — 由于旅程或项目的安静时间限制，消息未发送。

  • QUIET_ TIME _ MISSING _ TIMEZONE — 消息未发送，因为时区估计无法估计端点的时区，且已启用安静时间。
journey_id

生成事件的旅程的唯一 ID。
journey_activity_id

生成事件的旅程活动的唯一 ID。
journey_activity_type

事件的旅程活动类型。这可以是EMAILSMS、PUSH、CENTER、CONTACT_ 或CUSTOM。

注意

VOICE不是支持的旅程活动类型。

journey_send_status_message

 发送事件状态的描述。
journey_send_status_code 请求的HTTP状态码。