Amazon Pinpoint 분석 데이터 쿼리 - Amazon Pinpoint
Amazon Pinpoint의 지표 쿼리

지원 종료 알림: 2026년 10월 30일에 Amazon Pinpoint에 대한 지원이 AWS 종료됩니다. 2026년 10월 30일 이후에는 Amazon Pinpoint 콘솔 또는 Amazon Pinpoint 리소스(엔드포인트, 세그먼트, 캠페인, 여정 및 분석)에 더 이상 액세스할 수 없습니다. 자세한 내용은 Amazon Pinpoint 지원 종료를 참조하세요. 참고: SMS, 음성, 모바일 푸시, OTP 및 전화번호 검증과 관련된 APIs는이 변경의 영향을 받지 않으며 AWS 최종 사용자 메시징에서 지원됩니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon Pinpoint 분석 데이터 쿼리

Amazon Pinpoint 콘솔에서 분석 페이지를 사용하는 것 외에도, Amazon Pinpoint Analytics API를 사용하여 사용자 참여, 캠페인 활동 등과 관련된 추세를 파악할 수 있는 표준 지표의 하위 집합에 대한 분석 데이터를 쿼리할 수 있습니다. KPI(핵심 성과 지표)라고도 하는 이 지표는 프로젝트, 캠페인 및 여정의 성과를 모니터링하고 평가하는 데 사용할 수 있는 측정 가능한 값입니다.

API를 사용하여 분석 데이터를 쿼리하는 경우 Amazon Pinpoint 콘솔에 로그인하거나 Amazon Kinesis 스트림과 같은 소스의 원시 이벤트 데이터를 분석할 필요 없이 원하는 보고 도구를 사용하여 데이터를 분석할 수 있습니다. 예를 들어 주간 캠페인 결과를 표시하거나 캠페인의 배달율을 자세히 분석하는 사용자 지정 대시보드를 만들 수 있습니다.

Amazon Pinpoint REST API, AWS Command Line Interface (AWS CLI) 또는 SDK를 사용하여 데이터를 쿼리할 AWS 수 있습니다. 데이터를 쿼리하려면 Amazon Pinpoint API에 요청을 보내고 지원되는 파라미터를 사용하여 원하는 데이터와 적용할 필터를 지정합니다. 쿼리를 제출한 후 Amazon Pinpoint는 쿼리 결과를 JSON 응답으로 반환합니다. 그런 다음 분석, 저장 또는 보고 기능을 향상시키기 위해 결과를 다른 서비스나 애플리케이션에 전달할 수 있습니다.

Amazon Pinpoint는 지원되는 모든 지표와 모든 프로젝트, 캠페인 및 여정에 대한 데이터를 자동으로 수집하고 집계합니다. 또한 데이터가 지속적으로 업데이트되므로 데이터 지연 시간 기간이 약 2시간으로 제한됩니다. 그러나 특정 지표에 대한 추가 데이터 지연 시간이 있을 수 있습니다. 이는 일부 지표에 대한 데이터가 수신자의 이메일 공급자로부터 수신한 정보를 기반으로 하기 때문입니다. 일부 공급자는 즉시 이 정보를 보내지만 그렇지 않은 공급자도 있습니다.

Amazon Pinpoint는 90일 동안 데이터를 저장합니다. 90일 이상 데이터를 저장하거나 원시 분석 데이터에 실시간으로 액세스하려면 Amazon Pinpoint 프로젝트를 구성하여 이벤트 데이터를 Amazon Kinesis Data Streams 또는 Amazon Data Firehose로 스트리밍할 수 있습니다. 이벤트 스트림 구성에 대한 자세한 내용은 Amazon Pinpoint를 사용하여 Kinesis 및 Firehose를 통해 앱 이벤트 데이터 스트리밍 단원을 참조하십시오.

Amazon Pinpoint의 지표에 대한 구성 요소 및 파라미터 쿼리

지표에 대한 데이터를 쿼리하려면 Amazon Pinpoint API의 적절한 지표 리소스에 get 요청을 보냅니다. 요청에서 다음 쿼리 구성 요소에 대해 지원되는 파라미터를 사용하여 쿼리를 정의합니다.

  • 프로젝트 - application-id 파라미터 값으로 프로젝트 ID를 제공하여 프로젝트를 지정합니다. 이 파라미터는 모든 지표에 필요합니다.

  • 캠페인 - campaign-id 파라미터 값으로 캠페인 ID를 제공하여 캠페인을 지정합니다. 이 파라미터는 캠페인 지표에만 필요합니다.

  • 여정 - journey-id 파라미터 값으로 여정 ID를 제공하여 여정을 지정합니다. 이 파라미터는 여정 참여 지표, 여정 실행 지표 및 여정 활동 실행 지표에만 필요합니다.

  • 여정 활동 - journey-activity-id 파라미터 값으로 여정 활동 ID를 제공하여 여정 활동을 지정합니다. 이 파라미터는 여정 활동 실행 지표에만 필요합니다.

  • 날짜 범위 - 날짜 범위를 기준으로 데이터를 선택적으로 필터링하려면 지원되는 시작 및 종료 시간 파라미터를 사용하여 날짜 범위의 첫 번째 및 마지막 날짜 및 시간을 제공합니다. 값은 확장된 ISO 8601 형식이어야 하며 협정 세계시(UTC)를 사용해야 합니다. 예를 들어 2019-07-19T20:00:00Z는 2019년 7월 19일 오후 8시 UTC입니다.

    날짜 범위는 포괄적이며 31일 이하로 제한되어야 합니다. 또한 첫 번째 날짜 및 시간은 현재 날짜로부터 90일 이내여야 합니다. 날짜 범위를 지정하지 않으면 Amazon Pinpoint에서는 이전 31일 동안의 데이터를 반환합니다. 날짜 범위 파라미터는 여정 실행 지표 및 여정 활동 실행 지표를 제외한 모든 지표에서 지원됩니다.

  • 지표 - 지표를 지정하려면 지표 이름을 kpi-name 파라미터 값으로 제공합니다. 이 값은 연관된 지표를 설명하며 두 개 이상의 용어로 구성되며, 이 용어는 소문자 영숫자 문자로 구성되며 하이픈으로 구분됩니다. 대표적인 예는 email-open-rate 및 successful-delivery-rate입니다. 이 파라미터는 여정 실행 지표 및 여정 활동 실행 지표를 제외한 모든 지표에 필요합니다. 지원되는 지표와 각 지표에 사용할 kpi-name 값의 전체 목록은프로젝트, 캠페인 및 여정에 대한 표준 지표 단원을 참조하십시오.

쿼리를 전송한 후 Amazon Pinpoint는 쿼리 결과를 JSON 응답으로 반환합니다. 응답에서 결과 구조는 쿼리한 지표에 따라 달라집니다.

일부 지표는 하나의 값만 제공합니다(예: 캠페인에 의해 배달된 메시지 수). 다른 지표는 여러 값을 제공하며, 일반적으로 해당 값을 관련 필드별로 그룹화합니다(예: 캠페인 실행마다 배달된 메시지 수, 캠페인 실행별로 그룹화됨). 지표가 여러 값을 제공하고 그룹화하는 경우 JSON 응답에는 데이터를 그룹화하는 데 사용된 필드를 나타내는 필드가 포함됩니다. 쿼리 결과의 구조에 대한 자세한 내용은 JSON 쿼리 결과 사용 단원을 참조하십시오.