앱 이벤트

애플리케이션(앱)을 Amazon Pinpoint와 통합한 후 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 시간).