Amazon Pinpoint의 앱 이벤트 데이터 스트림 - Amazon Pinpoint
앱 이벤트 예앱 이벤트 속성

Amazon Pinpoint의 앱 이벤트 데이터 스트림

애플리케이션(앱)을 Amazon Pinpoint와 통합하고 이벤트 스트리밍을 설정하면 Amazon Pinpoint는 설정 중에 지정한 대상에서 앱의 사용자 활동, 사용자 지정 이벤트 및 메시지 전송 데이터를 검색하여 볼 수 있도록 합니다. 이벤트 데이터를 볼 수 있도록 이벤트 스트리밍을 설정하는 방법에 대한 자세한 내용은 Amazon Kinesis 또는 Amazon Data Firehose를 통해 앱 이벤트 데이터를 스트리밍하도록 Amazon Pinpoint 설정 섹션을 참조하세요.

앱 이벤트 예

앱 이벤트에 대한 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 시간).