트랜잭션 메시지에 대한 Amazon Pinpoint 분석 데이터 쿼리

Amazon Pinpoint 콘솔의 분석 페이지를 사용하는 것 외에도 Amazon Pinpoint Analytics API를 사용하여 분석 데이터에 표준 지표의 하위 집합을 쿼리하여 프로젝트에 대해 전송된 트랜잭션 메시지의 제공 및 참여 추세를 파악할 수 있습니다.

이러한 각 지표는 측정 가능한 값으로, KPI(핵심 성과 지표)라고도 하며 트랜잭션 메시지의 성과를 모니터링하고 평가하는 데 사용할 수 있습니다. 예를 들어 지표를 사용하여 보낸 트랜잭션 이메일이나 SMS 메시지 수 또는 수신자에게 배달된 메시지 수를 확인할 수 있습니다. Amazon Pinpoint는 는 프로젝트에 보내는 모든 트랜잭션 이메일 및 SMS 메시지에 대해 이 데이터를 자동으로 수집하고 집계합니다. 데이터는 90일 동안 저장됩니다.

Amazon Pinpoint Analytics API를 사용하여 데이터를 쿼리하는 경우 쿼리의 범위, 데이터, 그룹화 및 필터를 정의하는 다양한 옵션을 선택할 수 있습니다. 이 작업은 적용할 날짜 기반 필터와 함께 쿼리할 프로젝트 및 지표를 지정하는 파라미터를 사용하여 수행할 수 있습니다.

이 항목에서는 이러한 옵션을 선택하고 프로젝트에 대한 트랜잭션 메시징 데이터를 쿼리하는 방법에 대해 설명하고 예제를 제공합니다.

사전 조건

트랜잭션 메시지에 대한 분석 데이터를 쿼리하기 전에 쿼리를 정의하는 데 사용할 다음 정보를 수집하는 것이 좋습니다.

• 프로젝트 ID - 메시지를 보낸 프로젝트의 고유 식별자입니다. Amazon Pinpoint API에서 이 값은 application-id 속성에 저장됩니다. Amazon Pinpoint 콘솔에서는 이 값이 모든 프로젝트 페이지에 프로젝트 ID로 표시됩니다.

• 날짜 범위 - 날짜 범위 또는 데이터를 쿼리할 일자 범위의 최초 및 최종 날짜 및 시간입니다. 날짜 범위는 포괄적이며 31일 이하로 제한되어야 합니다. 또한 현재 날짜로부터 90일 이내에 시작해야 합니다. 날짜 범위를 지정하지 않으면 Amazon Pinpoint에서 이전 31일의 데이터를 자동으로 쿼리합니다.

• 지표 - 쿼리할 지표의 이름입니다. 보다 구체적으로 말하면 지표의 값입니다. 지원되는 지표의 전체 목록과 각 지표에 대한 kpi-name 값은 프로젝트, 캠페인 및 여정에 대한 표준 지표 단원을 참조하십시오.

이는 또한 관련 필드로 데이터를 그룹화할지 여부를 결정하는 데 도움이 됩니다. 이 경우 자동으로 데이터를 그룹화하도록 설계된 지표를 선택하여 분석 및 보고를 단순화할 수 있습니다. 예를 들어 Amazon Pinpoint는 받는 사람에게 배달된 트랜잭션 SMS 메시지의 수를 보고하는 몇 가지 표준 지표를 제공합니다. 이러한 지표 중 하나는 자동으로 데이터를 날짜별(txn-sms-delivered-grouped-by-date)로 그룹화합니다. 다른 지표는 자동으로 데이터를 국가 또는 리전별(txn-sms-delivered-grouped-by-country)로 그룹화합니다. 세 번째 지표는 단일 값, 즉 수신자에게 배달된 메시지 수를 반환합니다(txn-sms-delivered). 원하는 방식으로 데이터를 그룹화하는 표준 지표를 찾을 수 없는 경우 원하는 데이터를 반환하는 일련의 쿼리를 개발할 수 있습니다. 그런 다음 쿼리 결과를 수동으로 분류하거나 디자인 중인 사용자 지정 그룹으로 결합할 수 있습니다.

마지막으로 쿼리할 데이터에 액세스할 수 있는 권한이 있는지 확인하는 것이 중요합니다. 자세한 내용은 Amazon Pinpoint 분석 데이터 쿼리를 위한 IAM 정책 단원을 참조하십시오.