**지원 종료 공지:** 2026년 10월 30일에 Amazon Pinpoint에 대한 지원이 AWS 종료됩니다. 2026년 10월 30일 이후에는 Amazon Pinpoint 콘솔 또는 Amazon Pinpoint 리소스(엔드포인트, 세그먼트, 캠페인, 여정, 분석)에 더 이상 액세스할 수 없습니다. 자세한 내용은 [Amazon Pinpoint 지원 종료](https://docs.aws.amazon.com/console/pinpoint/migration-guide)를 참조하세요. **참고:** 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를 통해 앱 이벤트 데이터 스트리밍](event-streams.md) 단원을 참조하십시오.
## 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` 값의 전체 목록은 [프로젝트, 캠페인 및 여정에 대한 표준 지표](analytics-standard-metrics.md) 섹션을 참조하세요.
쿼리를 전송한 후 Amazon Pinpoint는 쿼리 결과를 JSON 응답으로 반환합니다. 응답에서 결과 구조는 쿼리한 지표에 따라 달라집니다.
일부 지표는 하나의 값만 제공합니다(예: 캠페인에 의해 배달된 메시지 수). 다른 지표는 여러 값을 제공하며, 일반적으로 해당 값을 관련 필드별로 그룹화합니다(예: 캠페인 실행마다 배달된 메시지 수, 캠페인 실행별로 그룹화됨). 지표가 여러 값을 제공하고 그룹화하는 경우 JSON 응답에는 데이터를 그룹화하는 데 사용된 필드를 나타내는 필드가 포함됩니다. 쿼리 결과의 구조에 대한 자세한 내용은 [JSON 쿼리 결과 사용](analytics-query-results.md) 단원을 참조하십시오.
# Amazon Pinpoint 분석 데이터 쿼리를 위한 IAM 정책
Amazon Pinpoint API를 사용하면 Amazon Pinpoint 프로젝트, 캠페인, 여정에 적용되는 *핵심 성능 지표(KPI)*라고도 하는 표준 지표의 하위 집합에 대한 분석 데이터를 쿼리할 수 있습니다. 이러한 지표를 통해 프로젝트, 캠페인 및 여정의 성과를 모니터링하고 평가할 수 있습니다.
이 데이터에 대한 액세스를 관리하려면 데이터에 액세스할 권한이 있는 IAM 역할 또는 사용자에 대한 권한을 정의하는 AWS Identity and Access Management (IAM) 정책을 생성할 수 있습니다. 이 데이터에 대한 액세스를 세부적으로 제어할 수 있도록 Amazon Pinpoint에서는 IAM 정책에서 지정할 수 있는 여러 가지 고유한 작업을 제공합니다. Amazon Pinpoint 콘솔(`mobiletargeting:GetReports`)에서 분석 데이터를 보는 별도의 작업이 있으며 Amazon Pinpoint API를 사용하여 프로그래밍 방식으로 분석 데이터에 액세스하는 다른 작업이 있습니다.
분석 데이터에 대한 액세스를 관리하는 IAM 정책을 생성하려면 AWS Management Console, AWS CLI또는 IAM API를 사용할 수 있습니다. 참고로, AWS Management Console 의 **시각적 편집기** 탭에는 현재 Amazon Pinpoint 분석 데이터를 보거나 쿼리하기 위한 작업이 포함되어 있지 않습니다. 그러나 콘솔의 **JSON** 탭을 사용하여 IAM 정책에 필요한 작업을 수동으로 추가할 수 있습니다.
예를 들어 다음 정책은 모든 AWS 리전의 모든 프로젝트, 캠페인 및 여정에 대한 모든 분석 데이터에 프로그래밍 방식으로 액세스할 수 있도록 허용합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryAllAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetApplicationDateRangeKpi",
"mobiletargeting:GetCampaignDateRangeKpi",
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:*:111122223333:apps/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/campaigns/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/execution-metrics",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/activities/*/execution-metrics"
]
}
]
}
```
------
여기서 *accountId*는 AWS 계정 ID입니다.
하지만 가장 좋은 방법은 *최소 권한*의 원칙을 따르는 정책을 만드는 것입니다. 즉, 특정 작업을 수행하는 데 필요한 권한만 포함하는 정책을 만들어야 합니다. 이러한 관행을 지원하고 보다 세분화된 제어를 구현하기 위해 특정 AWS 리전의 특정 프로젝트에 대해서만 분석 데이터에 대한 프로그래밍 방식의 액세스를 제한할 수 있습니다. 예를 들면 다음과 같습니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryProjectAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetApplicationDateRangeKpi",
"mobiletargeting:GetCampaignDateRangeKpi",
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/campaigns/*/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/execution-metrics",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/activities/*/execution-metrics"
]
}
]
}
```
------
위치:
+ *region*은 프로젝트를 호스팅하는 AWS 리전의 이름입니다.
+ *accountId*는 AWS 계정 ID입니다.
+ *projectId*는 액세스 권한을 제공하려는 프로젝트의 식별자입니다.
마찬가지로 다음 예제 정책은 특정 캠페인의 분석 데이터에만 프로그래밍 방식으로 액세스할 수 있도록 허용합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryCampaignAnalytics",
"Effect": "Allow",
"Action": "mobiletargeting:GetCampaignDateRangeKpi",
"Resource": "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/campaigns/campaignId/kpis/*"
}
]
}
```
------
위치:
+ *region*은 프로젝트를 호스팅하는 AWS 리전의 이름입니다.
+ *accountId*는 AWS 계정 ID입니다.
+ *projectId*는 캠페인과 연결된 프로젝트의 식별자입니다.
+ *campaignId*는 액세스 권한을 제공하려는 캠페인의 식별자입니다.
다음 예제 정책은 특정 여정과 해당 여정을 구성하는 활동에 대한 모든 분석 데이터(참여 및 실행 데이터)에 프로그래밍 방식으로 액세스할 수 있도록 허용합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryJourneyAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/execution-metrics",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/activities/*/execution-metrics"
]
}
]
}
```
------
위치:
+ *region*은 프로젝트를 호스팅하는 AWS 리전의 이름입니다.
+ *accountId*는 AWS 계정 ID입니다.
+ *projectId*는 여정과 연결된 프로젝트의 식별자입니다.
+ *journeyId*는 액세스 권한을 제공하려는 여정의 식별자입니다.
IAM 정책에서 사용할 수 있는 Amazon Pinpoint API 작업의 전체 목록은 [IAM 정책에 대한 Amazon Pinpoint 작업](permissions-actions.md) 섹션을 참조하세요. IAM 정책 생성 및 관리에 대한 자세한 내용은 [IAM 사용 설명서](https://docs.aws.amazon.com/IAM/latest/UserGuide/)를 참조하세요.
# Amazon Pinpoint 프로젝트, 캠페인 및 여정에 적용되는 표준 지표
Amazon Pinpoint 분석 API를 사용하여 Amazon Pinpoint 프로젝트, 캠페인 및 여정에 적용되는 표준 지표의 하위 집합에 대한 분석 데이터를 쿼리할 수 있습니다. *KPI(핵심 성과 지표)*라고도 하는 이 지표는 프로젝트, 캠페인 및 여정의 성과를 모니터링하고 평가하는 데 사용할 수 있는 측정 가능한 값입니다.
Amazon Pinpoint는 여러 표준 지표 유형의 분석 데이터에 대한 프로그래밍 방식 액세스를 제공합니다.
+ **애플리케이션 지표** - 프로젝트와 연결된 모든 캠페인 및 트랜잭션 메시지(*애플리케이션*이라고도 함)에 대한 추세를 파악할 수 있는 지표입니다. 예를 들어 애플리케이션 지표를 사용하면 프로젝트와 연결된 각 캠페인에 대해 수신자가 열어본 메시지 수를 분석할 수 있습니다.
+ **캠페인 지표** - 개별 캠페인의 성과를 파악할 수 있는 지표입니다. 예를 들어, 캠페인 지표를 사용하여 캠페인 메시지를 전송한 엔드포인트의 수 또는 엔드포인트에 전달된 메시지의 수를 확인할 수 있습니다.
+ **여정 참여 지표** - 이 지표는 개별 여정의 성과를 파악할 수 있습니다. 예를 들어 여정 참여 지표를 사용하여 각 여정 활동에서 참가자가 연 메시지 수를 분석할 수 있습니다.
+ **여정 실행 지표** - 이 지표는 개별 여정의 참여 추세를 파악할 수 있습니다. 예를 들어 여정 실행 지표를 사용하여 여정을 시작한 참가자 수를 확인할 수 있습니다.
+ **여정 활동 실행 지표** - 이 지표는 여정 내 개별 활동에 대한 참여 추세를 파악할 수 있습니다. 예를 들어 여정 활동 실행 지표를 사용하여 활동을 시작한 참가자 수와 활동의 각 경로를 완료한 참가자 수를 확인할 수 있습니다.
이 섹션의 항목에서는 각 지표 유형에 대해 쿼리할 수 있는 개별 지표를 나열하고 설명합니다.
**Topics**
+ [캠페인의 Amazon Pinpoint 애플리케이션 지표](application-metrics-campaigns.md)
+ [트랜잭션 이메일 메시지의 Amazon Pinpoint 애플리케이션 지표](application-metrics-txn-email.md)
+ [트랜잭션 SMS 메시지의 Amazon Pinpoint 애플리케이션 지표](application-metrics-txn-sms.md)
+ [Amazon Pinpoint 캠페인 지표](campaign-metrics.md)
+ [Amazon Pinpoint 여정 참여 지표](journey-metrics-engagement-email.md)
+ [Amazon Pinpoint 여정 실행 지표](journey-metrics-execution.md)
+ [Amazon Pinpoint 여정 활동 실행 지표](journey-metrics-activity-execution.md)
+ [Amazon Pinpoint 여정 및 캠페인 실행 지표](journey-run-metrics-activity-execution.md)
# 캠페인의 Amazon Pinpoint 애플리케이션 지표
다음 표에는 Amazon Pinpoint 프로젝트와 연결된 모든 캠페인의 성과를 평가하기 위해 쿼리할 수 있는 표준 애플리케이션 지표 목록과 설명이 나와 있습니다. 이러한 지표에 대한 데이터를 쿼리하려면 Amazon Pinpoint API의 [애플리케이션 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) 리소스를 사용하세요. **kpi-name** 열은 쿼리에서 `kpi-name` 파라미터에 사용할 값을 나타냅니다.
| 지표 | kpi-name | 설명 |
| --- | --- | --- |
| 전송률 | `successful-delivery-rate` | 프로젝트와 연결된 모든 캠페인에 대해 수신자에게 배달된 메시지의 비율입니다. 이 지표는 프로젝트의 모든 캠페인에서 전송한 메시지 중 수신자에게 배달된 메시지 수를 모든 캠페인에서 전송한 메시지 수로 나눈 값으로 계산됩니다. |
| 배달율(날짜별 그룹화) | `successful-delivery-rate-grouped-by-date` | 프로젝트와 연결된 모든 캠페인에 대해 지정된 날짜 범위의 각 날짜에 수신자에게 배달된 메시지의 비율입니다. 이 지표는 프로젝트의 모든 캠페인에서 전송한 메시지 중 수신자에게 배달된 메시지 수를 지정된 날짜 범위의 각 날짜에 모든 캠페인에서 전송한 메시지 수로 나눈 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 이메일 오픈율 | `email-open-rate` | 프로젝트와 연결된 모든 캠페인에 대해 수신자가 열어본 이메일 메시지의 비율입니다. 이 지표는 프로젝트의 모든 캠페인에서 전송한 이메일 메시지 중 수신자가 열어본 이메일 메시지 수를 모든 캠페인에서 전송한 이메일 메시지 중 수신자에게 배달된 이메일 메시지 수로 나눈 값으로 계산됩니다. |
| 이메일 오픈율(캠페인별 그룹화) | `email-open-rate-grouped-by-campaign` | 프로젝트와 연결된 각 캠페인에 대해 수신자가 열어본 이메일 메시지의 비율입니다. 이 지표는 한 캠페인에서 전송한 이메일 메시지 중 수신자가 열어본 이메일 메시지 수를 해당 캠페인에서 전송한 이메일 메시지 중 수신자에게 배달된 이메일 메시지 수로 나눈 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 캠페인을 고유하게 식별하는 문자열인 캠페인 ID(`CampaignId`)별로 그룹화됩니다. |
| 엔드포인트 전달 | `unique-deliveries` | 프로젝트와 연결된 모든 캠페인에 대해 메시지가 배달된 고유 엔드포인트 수입니다. |
| 엔드포인트 배달(캠페인별 그룹화) | `unique-deliveries-grouped-by-campaign` | 프로젝트와 연결된 각 캠페인에 대해 메시지가 배달된 고유 엔드포인트 수입니다. 이 지표에 대한 쿼리 결과는 캠페인을 고유하게 식별하는 문자열인 캠페인 ID(`CampaignId`)별로 그룹화됩니다. |
| 엔드포인트 배달(날짜별 그룹화) | `unique-deliveries-grouped-by-date` | 프로젝트와 연결된 모든 캠페인에 대해 지정된 날짜 범위의 각 날짜에 메시지가 배달된 고유 엔드포인트 수입니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 배달된 메시지(캠페인별 그룹화) | `successful-deliveries-grouped-by-campaign` | 프로젝트와 연결된 각 캠페인에 대해 수신자에게 배달된 메시지 수입니다. 이 지표는 한 캠페인에서 전송한 메시지 수에서, 캠페인에서 전송했지만 하드 바운스로 인해 수신자에게 배달할 수 없는 메시지 수를 뺀 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 캠페인을 고유하게 식별하는 문자열인 캠페인 ID(`CampaignId`)별로 그룹화됩니다. |
| 푸시 오픈율 | `push-open-rate` | 프로젝트와 연결된 모든 캠페인에 대해 수신자가 열어본 푸시 알림의 비율입니다. 이 지표는 프로젝트의 모든 캠페인에서 전송한 푸시 알림 중 수신자가 열어본 푸시 알림 수를 모든 캠페인에서 전송한 푸시 알림 중 수신자에게 배달된 푸시 알림 수로 나눈 값으로 계산됩니다. |
| 푸시 오픈율(캠페인별 그룹화) | `push-open-rate-grouped-by-campaign` | 프로젝트와 연결된 각 캠페인에 대해 수신자가 열어본 푸시 알림의 비율입니다. 이 지표는 한 캠페인에서 전송한 푸시 알림 중 수신자가 열어본 푸시 알림 수를 해당 캠페인에서 전송한 푸시 알림 중 수신자에게 배달된 푸시 알림 수로 나눈 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 캠페인을 고유하게 식별하는 문자열인 캠페인 ID(`CampaignId`)별로 그룹화됩니다. |
# 트랜잭션 이메일 메시지의 Amazon Pinpoint 애플리케이션 지표
다음 표에는 Amazon Pinpoint 프로젝트와 연결된 모든 트랜잭션 이메일 메시지의 추세를 모니터링하기 위해 쿼리할 수 있는 표준 애플리케이션 지표 목록과 설명이 나와 있습니다. 이러한 지표에 대한 데이터를 쿼리하려면 Amazon Pinpoint API의 [애플리케이션 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) 리소스를 사용하세요. **kpi-name** 열은 쿼리에서 `kpi-name` 파라미터에 사용할 값을 나타냅니다.
이러한 지표는 캠페인에서 전송한 이메일 메시지에 대한 데이터를 제공하지 않으며, 트랜잭션 이메일 메시지에 대한 데이터만 제공합니다. 하나 이상의 캠페인에서 전송한 메시지에 대한 데이터를 쿼리하려면 [캠페인 지표](campaign-metrics.md) 또는 [캠페인의 애플리케이션 지표](application-metrics-campaigns.md)를 사용합니다.
| 지표 | kpi-name | 설명 |
| --- | --- | --- |
| 클릭 수 | `txn-emails-clicked` | 수신자가 메시지에서 링크를 클릭한 횟수입니다. 수신자 한 명이 메시지에 있는 여러 링크를 클릭하거나 동일한 링크를 두 번 이상 클릭하는 경우에도 각 클릭이 계수됩니다. |
| 클릭(날짜별 그룹화) | `txn-emails-clicked-grouped-by-date` | 지정된 날짜 범위의 각 날짜에 수신자가 메시지에서 링크를 클릭한 횟수입니다. 수신자 한 명이 메시지에 있는 여러 링크를 클릭하거나 동일한 링크를 두 번 이상 클릭하는 경우에도 각 클릭이 계수됩니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 수신 거부율 | `txn-emails-complaint-rate` | 수신자가 요청되지 않은 이메일 또는 원치 않는 이메일로 보고한 메시지의 비율입니다. 이 지표는 수신자가 요청되지 않은 이메일 또는 원치 않는 이메일로 보고한 메시지 수를 전송한 메시지 수로 나눈 값으로 계산됩니다. |
| 불만 제기 비율(날짜별 그룹화) | `txn-emails-complaint-rate-grouped-by-date` | 지정된 날짜 범위의 각 날짜에 수신자가 요청되지 않은 이메일 또는 원치 않는 이메일로 보고한 메시지의 비율입니다. 이 지표는 수신자가 요청되지 않은 이메일 또는 원치 않는 이메일로 보고한 메시지 수를 지정된 날짜 범위의 각 날짜에 전송한 메시지 수로 나눈 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 수신 거부 | `txn-emails-with-complaints` | 수신자가 요청되지 않은 이메일 또는 원치 않는 이메일로 보고한 메시지의 수입니다. |
| 불만 제기(날짜별 그룹화) | `txn-emails-with-complaints-grouped-by-date` | 지정된 날짜 범위의 각 날짜에 수신자가 요청되지 않은 이메일 또는 원치 않는 이메일로 보고한 메시지의 수입니다.이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 전달 | `txn-emails-delivered` | 수신자에게 배달된 메시지의 수입니다. 이 지표는 전송한 메시지 수에서 소프트 바운스나 하드 바운스로 인해 또는 메시지가 거부되어서 배달할 수 없는 메시지 수를 뺀 값으로 계산됩니다. 메시지에 맬웨어가 포함되어 있다고 Amazon Pinpoint가 판단하면 메시지가 거부됩니다. Amazon Pinpoint는 거부된 메시지를 보내려고 시도하지 않습니다. |
| 배달(날짜별 그룹화) | `txn-emails-delivered-grouped-by-date` | 지정된 날짜 범위의 각 날짜에 수신자에게 배달된 메시지의 수입니다. 이 지표는 전송한 메시지 수에서 지정된 날짜 범위의 각 날짜에 소프트 바운스나 하드 바운스로 인해 또는 메시지가 거부되어서 배달할 수 없는 메시지 수를 뺀 값으로 계산됩니다. 메시지에 맬웨어가 포함되어 있다고 Amazon Pinpoint가 판단하면 메시지가 거부됩니다. Amazon Pinpoint는 거부된 메시지를 보내려고 시도하지 않습니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 전송률 | `txn-emails-delivery-rate` | 수신자에게 배달된 메시지의 비율입니다. 이 지표는 수신자에게 전송되고 배달된 메시지 수를 전송한 메시지 수로 나눈 값으로 계산됩니다. |
| 배달율(날짜별 그룹화) | `txn-emails-delivery-rate-grouped-by-date` | 지정된 날짜 범위의 각 날짜에 수신자에게 배달된 메시지의 비율입니다. 이 지표는 수신자에게 전송되고 배달된 메시지 수를 지정된 날짜 범위의 각 날짜에 전송한 메시지 수로 나눈 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 하드 바운스 | `txn-emails-hard-bounced` | 하드 바운스로 인해 수신자에게 배달될 수 없는 메시지의 수입니다. 하드 바운스는 영구적인 문제로 인해 메시지가 배달되지 못할 때 발생합니다(예: 수신자의 이메일 주소가 존재하지 않음). |
| 하드 바운스(날짜별 그룹화) | `txn-emails-hard-bounced-grouped-by-date` | 지정된 날짜 범위의 각 날짜에 하드 바운스로 인해 수신자에게 배달될 수 없는 메시지의 수입니다. 하드 바운스는 영구적인 문제로 인해 메시지가 배달되지 못할 때 발생합니다(예: 수신자의 이메일 주소가 존재하지 않음). 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 열기 | `txn-emails-opened` | 수신자가 열어본 메시지의 수입니다. |
| 열기(날짜별 그룹화) | `txn-emails-opened-grouped-by-date` | 지정된 날짜 범위의 각 날짜에 수신자가 열어본 메시지의 수입니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 전송 | `txn-emails-sent` | 전송한 메시지의 수입니다. |
| 전송(날짜별 그룹화) | `txn-emails-sent-grouped-by-date` | 지정된 날짜 범위의 각 날짜에 전송한 메시지의 수입니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 소프트 바운스 | `txn-emails-soft-bounced` | 소프트 바운스로 인해 수신자에게 배달될 수 없는 메시지의 수입니다. 소프트 바운스는 일시적인 문제로 인해 메시지가 배달되지 못할 때 발생합니다(예: 수신자의 받은 편지함이 가득 찼거나 수신 서버를 일시적으로 사용할 수 없는 경우). |
| 소프트 바운스(날짜별 그룹화) | `txn-emails-soft-bounced-grouped-by-date` | 지정된 날짜 범위의 각 날짜에 소프트 바운스로 인해 수신자에게 배달될 수 없는 메시지의 수입니다. 소프트 바운스는 일시적인 문제로 인해 메시지가 배달되지 못할 때 발생합니다(예: 수신자의 받은 편지함이 가득 찼거나 수신 서버를 일시적으로 사용할 수 없는 경우). 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 고유 사용자 클릭 이벤트 | `txn-emails-unique-clicks` | 메시지에 있는 링크를 클릭한 고유 수신자(엔드포인트)의 수입니다. **클릭** 지표와 달리 이 지표는 발생한 클릭 이벤트 수가 아니라 링크를 클릭한 고유 수신자 수를 보고합니다. 예를 들어 수신자 한 명이 동일한 메시지에 있는 여러 링크를 클릭하거나 동일한 링크를 두 번 이상 클릭하는 경우 이 지표는 해당 수신자에 대한 유일한 클릭 이벤트를 보고합니다. |
| 고유 사용자 클릭 이벤트(날짜별 그룹화) | `txn-emails-unique-clicks-grouped-by-date` | 지정된 날짜 범위의 각 날짜에 메시지에 있는 링크를 클릭한 고유 수신자(엔드포인트)의 수입니다. **클릭(날짜별 그룹화)** 지표와 달리 이 지표는 발생한 클릭 이벤트 수가 아니라 링크를 클릭한 고유 수신자 수를 보고합니다. 예를 들어 수신자 한 명이 동일한 메시지에 있는 여러 링크를 클릭하거나 동일한 링크를 두 번 이상 클릭하는 경우 이 지표는 해당 수신자에 대한 유일한 클릭 이벤트를 보고합니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 고유 사용자 열기 이벤트 | `txn-emails-unique-opens` | 메시지를 열어본 고유 수신자(엔드포인트)의 수입니다. **열기** 지표와 달리 이 지표는 발생한 열기 이벤트 수가 아니라 메시지를 열어본 고유 수신자 수를 보고합니다. 예를 들어 수신자 한 명이 동일한 메시지를 여러 번 여는 경우 이 지표는 해당 수신자에 대한 유일한 열기 이벤트를 보고합니다. |
| 고유 사용자 열기 이벤트(날짜별 그룹화) | `txn-emails-unique-opens-grouped-by-date` | 지정된 날짜 범위의 각 날짜에 메시지를 열어본 고유 수신자(엔드포인트)의 수입니다. **열기(날짜별 그룹화)** 지표와 달리 이 지표는 발생한 열기 이벤트 수가 아니라 메시지를 열어본 고유 수신자 수를 보고합니다. 예를 들어 수신자 한 명이 동일한 메시지를 여러 번 여는 경우 이 지표는 해당 수신자에 대한 유일한 열기 이벤트를 보고합니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
# 트랜잭션 SMS 메시지의 Amazon Pinpoint 애플리케이션 지표
다음 표에는 Amazon Pinpoint 프로젝트와 연결된 모든 트랜잭션 SMS 메시지의 추세를 모니터링하기 위해 쿼리할 수 있는 표준 애플리케이션 지표 목록과 설명이 나와 있습니다. 이러한 지표에 대한 데이터를 쿼리하려면 Amazon Pinpoint API의 [애플리케이션 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) 리소스를 사용하세요. **kpi-name** 열은 쿼리에서 `kpi-name` 파라미터에 사용할 값을 나타냅니다.
이러한 지표는 캠페인에서 전송한 SMS 메시지에 대한 데이터를 제공하지 않으며, 트랜잭션 SMS 메시지에 대한 데이터만 제공합니다. 하나 이상의 캠페인에서 전송한 메시지에 대한 데이터를 쿼리하려면 [캠페인 지표](campaign-metrics.md) 또는 [캠페인의 애플리케이션 지표](application-metrics-campaigns.md)를 사용합니다.
| 지표 | kpi-name | 설명 |
| --- | --- | --- |
| 메시지당 평균 가격(국가별 그룹화) | `txn-sms-average-price-grouped-by-country` | 메시지가 전송된 각 국가 또는 리전에 대해 각 메시지 전송에 소요되는 평균 비용입니다. 가격은 미국 센트의 1/1000로 표시됩니다. 예를 들어 이 속성의 값이 645인 경우, 메시지 전송에 대해 0.645¢가 청구된 것입니다(645 / 1000 = 0.645¢ = \$10.00645). 이 지표는 각 국가 또는 지역의 받는 사람에게 전송된 모든 메시지의 총 비용을 해당 국가 및 지역의 받는 사람에게 보낸 메시지 수로 나눈 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 ISO 3166-1 alpha-2 형식으로 국가별 또는 리전별로 그룹화됩니다. |
| 메시지 파트당 평균 가격(국가별 그룹화) | `txn-sms-average-price-by-parts-grouped-by-country` | 메시지 파트가 전송된 각 국가 또는 리전에 대해 각 메시지 전송에 소요되는 평균 비용입니다. 메시지 파트는 SMS 메시지의 일부입니다. 가격은 미국 센트의 1/1000로 표시됩니다. 예를 들어 이 속성의 값이 645인 경우, 메시지 전송에 대해 0.645¢가 청구된 것입니다(645 / 1000 = 0.645¢ = \$10.00645). 이 지표는 각 국가 또는 지역의 받는 사람에게 전송된 모든 메시지 파트의 총 비용을 해당 국가 및 지역의 받는 사람에게 보낸 메시지 파트 수로 나눈 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 ISO 3166-1 alpha-2 형식으로 국가별 또는 리전별로 그룹화됩니다. |
| 전달 | `txn-sms-delivered` | 수신자에게 배달된 메시지의 수입니다. |
| 배달(국가별 그룹화) | `txn-sms-delivered-grouped-by-country` | 메시지가 전송된 각 국가 또는 리전에 대해 수신자에게 배달된 메시지의 수입니다. 이 지표에 대한 쿼리 결과는 ISO 3166-1 alpha-2 형식으로 국가별 또는 리전별로 그룹화됩니다. |
| 배달(날짜별 그룹화) | `txn-sms-delivered-grouped-by-date` | 지정된 날짜 범위의 각 날짜에 수신자에게 배달된 메시지의 수입니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 배달 오류 | `txn-sms-error-distribution` | 발생한 각 유형의 오류에 대해 메시지 배달을 시도하는 동안 오류가 발생한 횟수입니다. 이 지표에 대한 쿼리 결과는 발생한 각 유형의 오류에 대해 오류 코드별로 그룹화됩니다. |
| 전송률 | `txn-sms-delivery-rate` | 수신자에게 배달된 메시지의 비율입니다. 이 지표는 수신자에게 전송되고 배달된 메시지 수를 전송한 메시지 수로 나눈 값으로 계산됩니다. |
| 배달율(날짜별 그룹화) | `txn-sms-delivery-rate-grouped-by-date` | 지정된 날짜 범위의 각 날짜에 수신자에게 배달된 메시지의 비율입니다. 이 지표는 수신자에게 전송되고 배달된 메시지 수를 지정된 날짜 범위의 각 날짜에 전송한 메시지 수로 나눈 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 배달된 메시지 파트 | `txn-sms-delivered-by-parts` | 배달된 메시지 파트의 수입니다. *메시지 파트*는 SMS 메시지의 일부입니다. SMS 메시지에 SMS 프로토콜이 허용하는 것보다 많은 문자가 포함된 경우, Amazon Pinpoint는 메시지를 수신자에게 전송하는 데 필요한 개수만큼 메시지 파트로 분할합니다. |
| 배달된 메시지 파트(국가별 그룹화) | `txn-sms-delivered-by-parts-grouped-by-country` | 메시지가 전송된 각 국가 또는 리전에 대해 배달된 메시지 파트의 수입니다. *메시지 파트*는 SMS 메시지의 일부입니다. 이 지표에 대한 쿼리 결과는 ISO 3166-1 alpha-2 형식으로 국가별 또는 리전별로 그룹화됩니다. |
| 전송된 메시지 파트 | `txn-sms-sent-by-parts` | 전송된 메시지 파트의 수입니다. *메시지 파트*는 SMS 메시지의 일부입니다. SMS 메시지에 SMS 프로토콜이 허용하는 것보다 많은 문자가 포함된 경우, Amazon Pinpoint는 메시지를 수신자에게 전송하는 데 필요한 개수만큼 메시지 파트로 분할합니다. |
| 전송된 메시지 파트(국가별 그룹화) | `txn-sms-sent-by-parts-grouped-by-country` | 메시지 파트가 전송된 각 국가 또는 리전에 대해 수신자에게 전송된 메시지의 수입니다. *메시지 파트*는 SMS 메시지의 일부입니다. 이 지표에 대한 쿼리 결과는 ISO 3166-1 alpha-2 형식으로 국가별 또는 리전별로 그룹화됩니다. |
| 전송한 메시지 | `txn-sms-sent` | 전송한 메시지의 수입니다. |
| 전송된 메시지(국가별 그룹화) | `txn-sms-sent-grouped-by-country` | 메시지가 전송된 각 국가 또는 리전에 대해 수신자에게 전송된 메시지의 수입니다. 이 지표에 대한 쿼리 결과는 ISO 3166-1 alpha-2 형식으로 국가별 또는 리전별로 그룹화됩니다. |
| 전송된 메시지(날짜별 그룹화) | `txn-sms-sent-grouped-by-date` | 지정된 날짜 범위의 각 날짜에 전송한 메시지의 수입니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 총 가격(국가별 그룹화) | `txn-sms-total-price-grouped-by-country` | 메시지가 전송된 각 국가 또는 리전에 대해 메시지 전송에 소요되는 총 비용입니다. 가격은 미국 센트의 1/1000로 표시됩니다. 예를 들어 이 속성의 값이 645인 경우, 메시지 전송에 대해 0.645¢가 청구된 것입니다(645 / 1000 = 0.645¢ = \$10.00645). 이 지표에 대한 쿼리 결과는 ISO 3166-1 alpha-2 형식으로 국가별 또는 리전별로 그룹화됩니다. |
# Amazon Pinpoint 캠페인 지표
다음 표에는 개별 캠페인의 성과를 평가하기 위해 쿼리할 수 있는 표준 캠페인 지표 목록과 설명이 나와 있습니다. 이러한 지표에 대한 데이터를 쿼리하려면 Amazon Pinpoint API의 [캠페인 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) 리소스를 사용하세요. 표에 나와 있는 **kpi-name** 열은 쿼리에서 `kpi-name` 파라미터에 사용할 값을 나타냅니다.
| 지표 | kpi-name | 설명 |
| --- | --- | --- |
| 반송률 | `hard-bounce-rate` | 모든 캠페인 실행에 대해 수신자에게 배달할 수 없는 이메일 메시지의 비율입니다. 이 지표는 하드 바운스만 측정합니다. 하드 바운스란 수신자의 이메일 주소에 영구적인 문제가 있어 메시지를 배달할 수 없는 메시지입니다. 이 지표는 모든 캠페인 실행에서 전송한 이메일 메시지 중 반송된 이메일 메시지 수를 모든 캠페인 실행에서 전송한 이메일 메시지 수로 나눈 값으로 계산됩니다. |
| 반송률(캠페인 실행별 그룹화) | `hard-bounce-rate-grouped-by-campaign-activity` | 각 캠페인 실행에 대해 수신자에게 배달할 수 없는 이메일 메시지의 비율입니다. 이 지표는 하드 바운스만 측정합니다. 하드 바운스란 수신자의 이메일 주소에 영구적인 문제가 있어 메시지를 배달할 수 없는 메시지입니다. 이 지표는 한 캠페인 실행에서 전송한 이메일 메시지 중 반송된 이메일 메시지 수를 해당 캠페인 실행에서 전송한 이메일 메시지 수로 나눈 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 캠페인 실행을 고유하게 식별하는 문자열인 캠페인 활동 ID(`CampaignActivityId`)별로 그룹화됩니다. |
| 전송률 | `successful-delivery-rate` | 모든 캠페인 실행에 대해 수신자에게 배달된 메시지의 비율입니다. 이 지표는 모든 캠페인 실행에서 전송한 메시지 중 수신자에게 배달된 메시지 수를 모든 캠페인 실행에서 전송한 메시지 수로 나눈 값으로 계산됩니다. |
| 배달율(캠페인 실행별 그룹화) | `successful-delivery-rate-grouped-by-campaign-activity` | 각 캠페인 실행에 대해 수신자에게 배달된 메시지의 비율입니다. 이 지표는 한 캠페인 실행에서 전송한 메시지 중 수신자에게 배달된 메시지 수를 해당 캠페인 실행에서 전송한 메시지 수로 나눈 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 캠페인 실행을 고유하게 식별하는 문자열인 캠페인 활동 ID(`CampaignActivityId`)별로 그룹화됩니다. |
| 배달율(날짜별 그룹화) | `successful-delivery-rate-grouped-by-date` | 모든 캠페인 실행에 대해 지정된 날짜 범위의 각 날짜에 수신자에게 배달된 메시지의 비율입니다. 이 지표는 모든 캠페인 실행에서 전송한 메시지 중 수신자에게 배달된 메시지 수를 지정된 날짜 범위의 각 날짜에 모든 캠페인에서 전송한 메시지 수로 나눈 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 이메일 오픈율 | `email-open-rate` | 모든 캠페인 실행에 대해 수신자가 열어본 이메일 메시지의 비율입니다.이 지표는 모든 캠페인 실행에서 전송한 이메일 메시지 중 수신자가 열어본 이메일 메시지 수를 모든 캠페인 실행에서 전송한 이메일 메시지 중 수신자에게 배달된 이메일 메시지 수로 나눈 값으로 계산됩니다. |
| 이메일 오픈율(캠페인 실행별 그룹화) | `email-open-rate-grouped-by-campaign-activity` | 각 캠페인 실행에 대해 수신자가 열어본 이메일 메시지의 비율입니다. 이 지표는 한 캠페인 실행에서 전송한 이메일 메시지 중 수신자가 열어본 이메일 메시지 수를 해당 캠페인 실행에서 전송한 이메일 메시지 중 수신자에게 배달된 이메일 메시지 수로 나눈 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 캠페인 실행을 고유하게 식별하는 문자열인 캠페인 활동 ID(`CampaignActivityId`)별로 그룹화됩니다. |
| 열어본 이메일(캠페인 실행별 그룹화) | `direct-email-opens-grouped-by-campaign-activity` | 각 캠페인 실행에 대해 수신자가 열어본 이메일 메시지의 수입니다. 이 지표에 대한 쿼리 결과는 캠페인 실행을 고유하게 식별하는 문자열인 캠페인 활동 ID(`CampaignActivityId`)별로 그룹화됩니다. |
| 엔드포인트 전달 | `unique-deliveries` | 모든 캠페인 실행에 대해 메시지가 배달된 고유 엔드포인트 수입니다. |
| 엔드포인트 배달(캠페인 실행별 그룹화) | `unique-deliveries-grouped-by-campaign-activity` | 각 캠페인 실행에 대해 메시지가 배달된 고유 엔드포인트 수입니다. 이 지표에 대한 쿼리 결과는 캠페인 실행을 고유하게 식별하는 문자열인 캠페인 활동 ID(`CampaignActivityId`)별로 그룹화됩니다. |
| 엔드포인트 배달(날짜별 그룹화) | `unique-deliveries-grouped-by-date` | 모든 캠페인 실행에 대해 지정된 날짜 범위의 각 날짜에 메시지가 배달된 고유 엔드포인트 수입니다. 이 지표에 대한 쿼리 결과는 확장된 ISO 8601 형식으로 날짜별로 그룹화됩니다. |
| 클릭한 링크(캠페인 실행별 그룹화) | `clicks-grouped-by-campaign-activity` | 각 캠페인 실행에 대해 수신자가 이메일 메시지에서 링크를 클릭한 횟수입니다. 수신자 한 명이 메시지에 있는 여러 링크를 클릭하거나 동일한 링크를 두 번 이상 클릭하는 경우에도 각 클릭이 계수됩니다. 이 지표에 대한 쿼리 결과는 캠페인 실행을 고유하게 식별하는 문자열인 캠페인 활동 ID(`CampaignActivityId`)별로 그룹화됩니다. |
| 배달된 메시지(캠페인 실행별 그룹화) | `successful-deliveries-grouped-by-campaign-activity` | 각 캠페인 실행에 대해 수신자에게 배달된 메시지의 수입니다. 이 지표는 한 캠페인 실행에서 전송한 메시지 수에서, 하드 바운스로 인해 수신자에게 배달할 수 없는 메시지 수를 뺀 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 캠페인 실행을 고유하게 식별하는 문자열인 캠페인 활동 ID(`CampaignActivityId`)별로 그룹화됩니다. |
| 전송한 메시지(캠페인 실행별 그룹화) | `attempted-deliveries-grouped-by-campaign-activity` | 각 캠페인 실행에 대해 전송한 메시지의 수입니다. 이 지표에 대한 쿼리 결과는 캠페인 실행을 고유하게 식별하는 문자열인 캠페인 활동 ID(`CampaignActivityId`)별로 그룹화됩니다. |
| 푸시 오픈율 | `push-open-rate` | 모든 캠페인 실행에 대해 수신자가 열어본 푸시 알림의 비율입니다. 이 지표는 모든 캠페인 실행에서 전송한 푸시 알림 중 수신자가 열어본 푸시 알림 수를 모든 캠페인 실행에서 전송한 푸시 알림 중 수신자에게 배달된 푸시 알림 수로 나눈 값으로 계산됩니다. |
| 푸시 오픈율(캠페인 실행별 그룹화) | `push-open-rate-grouped-by-campaign-activity` | 각 캠페인 실행에 대해 수신자가 열어본 푸시 알림의 비율입니다. 이 지표는 한 캠페인 실행에서 전송한 푸시 알림 중 수신자가 열어본 푸시 알림 수를 해당 캠페인 실행에서 전송한 푸시 알림 중 수신자에게 배달된 푸시 알림 수로 나눈 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 캠페인 실행을 고유하게 식별하는 문자열인 캠페인 활동 ID(`CampaignActivityId`)별로 그룹화됩니다. |
| 열어본 총 푸시(캠페인 실행별 그룹화) | `direct-push-opens-grouped-by-campaign-activity` | 각 캠페인 실행에 대해 수신자가 열어본 푸시 알림의 수입니다. 이 지표에 대한 쿼리 결과는 캠페인 실행을 고유하게 식별하는 문자열인 캠페인 활동 ID(`CampaignActivityId`)별로 그룹화됩니다. |
| 총 SMS 지출 | sms-spend | 모든 캠페인에 대해 SMS 전송에 지출한 총 금액(밀리센트 단위). |
# Amazon Pinpoint 여정 참여 지표
다음 표에서는 Amazon Pinpoint 여정에서 보낸 모든 이메일 메시지의 추세를 모니터링하기 위해 쿼리할 수 있는 표준 여정 참여 지표를 나열하고 설명합니다. 이러한 지표에 대한 데이터를 쿼리하려면 Amazon Pinpoint API의 [여정 참여 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-kpis-daterange-kpi-name.html) 리소스를 사용하세요. **kpi-name** 열은 쿼리에서 `kpi-name` 파라미터에 사용할 값을 나타냅니다.
| 지표 | kpi-name | 설명 |
| --- | --- | --- |
| 클릭 수 | `journey-emails-clicked` | 참가자가 메시지에서 링크를 클릭한 횟수입니다. 참가자 한 명이 메시지에 있는 여러 링크를 클릭하거나 동일한 링크를 두 번 이상 클릭하는 경우에도 각 클릭이 계수됩니다. |
| 클릭(활동별 그룹화) | `emails-clicked-grouped-by-journey-activity` | 여정의 각 활동에 대해 참가자가 메시지의 링크를 클릭한 횟수입니다. 참가자 한 명이 메시지에 있는 여러 링크를 클릭하거나 동일한 링크를 두 번 이상 클릭하는 경우에도 각 클릭이 계수됩니다. 이 지표에 대한 쿼리 결과는 활동을 고유하게 식별하는 문자열인 활동 ID(`JourneyActivityId`)별로 그룹화됩니다. |
| 수신 거부 | `journey-emails-complained` | 참가자가 요청되지 않은 이메일 또는 원치 않는 이메일로 보고한 메시지의 수입니다. |
| 불만 사항(활동별 그룹화) | `emails-complained-grouped-by-journey-activity` | 여정의 각 활동에 대해 참가자가 요청되지 않은 이메일 또는 원치 않는 이메일로 보고한 메시지의 수입니다.이 지표에 대한 쿼리 결과는 활동을 고유하게 식별하는 문자열인 활동 ID(`JourneyActivityId`)별로 그룹화됩니다. |
| 전달 | `journey-emails-delivered` | 참가자에게 배달된 메시지의 수입니다. 이 지표는 전송한 메시지 수에서 소프트 바운스나 하드 바운스로 인해 또는 메시지가 거부되어서 배달할 수 없는 메시지 수를 뺀 값으로 계산됩니다. |
| 배달(활동별 그룹화) | `emails-delivered-grouped-by-journey-activity` | 여정의 각 활동에 대해 참가자에게 배달된 메시지 수입니다. 이 지표는 전송된 메시지 수에서 여정의 각 활동에 대해 소프트 바운스나 하드 바운스로 인해 또는 메시지가 거부되어서 배달할 수 없는 메시지 수를 뺀 값으로 계산됩니다. 이 지표에 대한 쿼리 결과는 활동을 고유하게 식별하는 문자열인 활동 ID(`JourneyActivityId`)별로 그룹화됩니다. |
| 하드 바운스 | `journey-emails-hardbounced` | 하드 바운스로 인해 참가자에게 배달될 수 없는 메시지의 수입니다. 하드 바운스는 영구적인 문제로 인해 메시지가 배달되지 못할 때 발생합니다(예: 참가자의 이메일 주소가 존재하지 않음). |
| 하드 바운스(활동별 그룹화) | `emails-hardbounced-grouped-by-journey-activity` | 여정의 각 활동에 대해 하드 바운스로 인해 참가자에게 배달할 수 없는 메시지의 수입니다. 하드 바운스는 영구적인 문제로 인해 메시지가 배달되지 못할 때 발생합니다(예: 참가자의 이메일 주소가 존재하지 않음). 이 지표에 대한 쿼리 결과는 활동을 고유하게 식별하는 문자열인 활동 ID(`JourneyActivityId`)별로 그룹화됩니다. |
| 열기 | `journey-emails-opened` | 참가자가 열어본 메시지의 수입니다. |
| 열기(활동별 그룹화) | `emails-opened-grouped-by-journey-activity` | 여정의 각 활동에 대해 참가자가 열어본 메시지 수입니다. 이 지표에 대한 쿼리 결과는 활동을 고유하게 식별하는 문자열인 활동 ID(`JourneyActivityId`)별로 그룹화됩니다. |
| 거부 | `journey-emails-rejected` | 참가자가 거부하여 참가자에게 전송되지 않은 메시지 수입니다. 메시지에 맬웨어가 포함되어 있다고 Amazon Pinpoint가 판단하면 메시지가 거부됩니다. Amazon Pinpoint는 거부된 메시지를 보내려고 시도하지 않습니다. |
| 거부(활동별 그룹화) | `emails-rejected-grouped-by-journey-activity` | 여정의 각 활동에 대해 거부되었기 때문에 참가자에게 전송되지 않은 메시지 수입니다. 메시지에 맬웨어가 포함되어 있다고 Amazon Pinpoint가 판단하면 메시지가 거부됩니다. Amazon Pinpoint는 거부된 메시지를 보내려고 시도하지 않습니다. 이 지표에 대한 쿼리 결과는 활동을 고유하게 식별하는 문자열인 활동 ID(`JourneyActivityId`)별로 그룹화됩니다. |
| 전송 | `journey-emails-sent` | 전송한 메시지의 수입니다. |
| 전송(활동별 그룹화) | `emails-sent-grouped-by-journey-activity` | 여정의 각 활동에 대해 전송된 메시지 수입니다. 이 지표에 대한 쿼리 결과는 활동을 고유하게 식별하는 문자열인 활동 ID(`JourneyActivityId`)별로 그룹화됩니다. |
| 소프트 바운스 | `journey-emails-softbounced` | 소프트 바운스로 인해 참가자에게 배달할 수 없는 메시지의 수입니다. 소프트 바운스는 일시적인 문제로 인해 메시지가 배달되지 못할 때 발생합니다(예: 참가자의 받은 편지함이 가득 찼거나 수신 서버를 일시적으로 사용할 수 없는 경우). |
| 소프트 바운스(활동별 그룹화) | `emails-softbounced-grouped-by-journey-activity` | 여정의 각 활동에 대해 소프트 바운스로 인해 참가자에게 배달할 수 없는 메시지의 수입니다. 소프트 바운스는 일시적인 문제로 인해 메시지가 배달되지 못할 때 발생합니다(예: 참가자의 받은 편지함이 가득 찼거나 수신 서버를 일시적으로 사용할 수 없는 경우). 이 지표에 대한 쿼리 결과는 활동을 고유하게 식별하는 문자열인 활동 ID(`JourneyActivityId`)별로 그룹화됩니다. |
| 구독 해지 | `journey-emails-unsubscribed` | 참가자가 메시지에서 구독 취소 링크를 클릭한 횟수입니다. 참가자 한 명이 동일한 구독 취소 링크를 두 번 이상 클릭하는 경우에도 각 클릭이 계수됩니다. |
| 구독 취소(활동별 그룹화) | `emails-unsubscribed-grouped-by-journey-activity` | 여정의 각 활동에 대해 참가자가 메시지에서 구독 취소 링크를 클릭한 횟수입니다. 참가자 한 명이 동일한 구독 취소 링크를 두 번 이상 클릭하는 경우에도 각 클릭이 계수됩니다. 이 지표에 대한 쿼리 결과는 활동을 고유하게 식별하는 문자열인 활동 ID(`JourneyActivityId`)별로 그룹화됩니다. |
# Amazon Pinpoint 여정 실행 지표
다음 표에서는 Amazon Pinpoint 여정 참가자 상태를 평가하기 위해 쿼리할 수 있는 표준 실행 지표를 나열하고 설명합니다. 이러한 지표에 대한 데이터를 쿼리하려면 Amazon Pinpoint API의 [여정 실행 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-execution-metrics.html) 리소스를 사용하세요. 이 표의 **필드** 열은 각 지표에 대한 쿼리 결과에 나타나는 필드 이름을 식별합니다.
| 지표 | 필드 | 설명 |
| --- | --- | --- |
| 활성 참가자 | `ENDPOINT_ACTIVE` | 여정 활동을 적극적으로 진행하고 있는 참가자의 수입니다. 이 지표는 여정에 참가한 참가자 수에서 여정을 시작한 참가자 수와 여정에서 제거된 참가자 수를 뺀 값으로 계산됩니다. |
| 참가자 취소 | `CANCELLED` | 여정이 취소되어 여행을 완료하지 않은 참가자 수입니다. |
| 이탈한 참가자 | `ENDPOINT_LEFT` | 여정을 떠난 참가자의 수입니다. |
| 시작한 참가자 | `ENDPOINT_ENTERED` | 여정을 시작한 참가자의 수입니다. |
| 참가자 예외(재참가 제한) | `REENTRY_CAP_EXCEEDED` | 한 명의 참가자가 여정에 다시 참가할 수 있는 최대 횟수를 초과했기 때문에 여정을 완료하지 않은 참가자 수입니다. |
| 참가자 예외, 거부 | `ACTIVE_ENDPOINT_REJECTED` | 이미 이 여정의 활성 참가자이기 때문에 여정을 시작할 수 없는 참가자의 수입니다. 참가자가 여정을 시작한 이후, 참가자를 세그먼트(세그먼트 기준에 따라) 또는 여정(활동 조건에 따라)에 포함하는지 여부에 영향을 주는 방식으로 참가자의 엔드포인트 정의를 업데이트하면 참가자는 거부됩니다. |
# Amazon Pinpoint 여정 활동 실행 지표
다음 표에서는 Amazon Pinpoint 여정에 대한 각 개별 활동 유형의 참가자 상태를 평가하기 위해 쿼리할 수 있는 표준 실행 지표를 나열하고 설명합니다. 이러한 지표에 대한 데이터를 쿼리하려면 Amazon Pinpoint API의 [여정 활동 실행 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-activities-journey-activity-id-execution-metrics.html) 리소스를 사용하세요. 이 표의 **지표** 열에는 각 활동 유형에 대한 쿼리 결과에 나타나는 필드가 나열됩니다. 또한 각 필드에 대한 간략한 설명을 제공합니다.
| 활동 유형 | Metrics |
| --- | --- |
| 예/아니요 분할(`CONDITIONAL_SPLIT`) | 지표는 다음과 같습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) 각 경로의 활동에 대해 추가 지표를 사용할 수 있습니다. 이러한 지표에 대한 자세한 내용은 이 테이블에서 해당 활동 유형에 대한 행을 참조하십시오. |
| 홀드아웃(`HOLDOUT`) | 지표는 다음과 같습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| 이메일(`MESSAGE`) | 지표는 다음과 같습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| 다변량 분할(`MULTI_CONDITIONAL_SPLIT`) | 활동의 각 경로에 대해, 해당 경로에서 활동을 진행한 참가자 수입니다. 이 지표에 대한 쿼리 결과는 경로별로 그룹화됩니다. `Branch_#`에서 *\$1* 기호는 경로의 숫자 식별자입니다. 예를 들어 활동의 첫 번째 경로는 `Branch_1`입니다. 각 경로의 활동에 대해 추가 지표를 사용할 수 있습니다. 이러한 지표에 대한 자세한 내용은 이 테이블에서 해당 활동 유형에 대한 행을 참조하십시오. |
| 임의 분할(`RANDOM_SPLIT`) | 활동의 각 경로에 대해, 해당 경로에서 활동을 진행한 참가자 수입니다. 이 지표에 대한 쿼리 결과는 경로별로 그룹화됩니다. `Branch_#`에서 *\$1* 기호는 경로의 숫자 식별자입니다. 예를 들어 활동의 첫 번째 경로는 `Branch_1`입니다. 각 경로의 활동에 대해 추가 지표를 사용할 수 있습니다. 이러한 지표에 대한 자세한 내용은 이 테이블에서 해당 활동 유형에 대한 행을 참조하십시오. |
| 대기(`WAIT`) | 지표는 다음과 같습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| 고객 센터(`CONTACT_CENTER`) | 지표는 다음과 같습니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
# Amazon Pinpoint 여정 및 캠페인 실행 지표
Amazon Pinpoint 여정 또는 캠페인에 대한 각 개별 활동 유형의 참가자 상태를 평가하기 위해 표준 실행 지표를 쿼리할 수 있습니다. 이러한 지표에 대한 데이터를 쿼리하려면 Amazon Pinpoint API의 [여정 실행 활동 실행 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-runs-run-id-activities-journey-activity-id-execution-metrics.html) 또는 [캠페인 리소스](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html)를 사용하세요. 아래 표에는 각 활동 유형에 대한 쿼리 결과에 나타나는 필드가 나열됩니다.
****
| 지표 이름 | 여정, 캠페인 또는 둘 다에 적용 | 설명 |
| --- | --- | --- |
| ENDPOINT\$1PRODUCED | 둘 다 | 필터링 전에 세그먼트 또는 이벤트에서 처음 생성된 엔드포인트 수입니다. |
| ENDPOINTS\$1FROM\$1USER | 둘 다 | 고객이 사용자 ID 전용 세그먼트를 보유한 경우, 이러한 사용자의 모든 엔드포인트가 추가됩니다. 이 지표는 이러한 방식으로 추가된 엔드포인트 수를 측정합니다. |
| ENDPOINT\$1OPT\$1OUT | 둘 다 | 엔드포인트가 옵트아웃되었으며 캠페인 또는 여정에 참여하지 않았습니다. |
| ENDPOINT\$1INACTIVE | 둘 다 | 엔드포인트가 비활성화되었으며 캠페인 또는 여정에 참여하지 않았습니다. |
| FILTERED\$1OUT\$1BY\$1SEGMENT | 둘 다 | 엔드포인트가 세그먼트 필터와 일치하지 않았으며 캠페인 또는 여정에 참여하지 않았습니다. |
| ENDPOINT\$1MISSING\$1ADDRESS | 둘 다 | 엔드포인트에서 주소가 누락되었으며 캠페인 또는 여정에 참여하지 않았습니다. |
| ENDPOINT\$1MISSING\$1CHANNEL | 둘 다 | 엔드포인트에서 채널이 누락되었으며 캠페인 또는 여정에 참여하지 않았습니다. |
| ENDPOINT\$1MISSING\$1TIMEZONE | 둘 다 | 엔드포인트에 시간대 값이 누락되었으며 필터링되었습니다. 이는 시간대 값이 필요한 경우에만 발생합니다. |
| ENDPOINT\$1TIMEZONE\$1MISMATCH | 둘 다 | 엔드포인트가 그 당시 실행에 포함되지 않은 시간대에 있었습니다. |
| ENDPOINT\$1CHANNEL\$1MISMATCH | Campaigns | 캠페인에 이 엔드포인트의 채널 유형에 맞게 구성된 메시지가 없습니다. |
| DUPLICATE\$1ENDPOINT | 둘 다 | 중복된 엔드포인트가 발견되었으며 중복 제거되었습니다. |
| DUPLICATE\$1USER | 둘 다 | 중복된 사용자가 발견되었으며 사용자 ID 전용 세그먼트에서 중복 제거되었습니다. 사용자 ID가 동일한 경우 지표 1이 방출됩니다. |
| PAUSED | 여정 | 여정이 일시 중지되었으므로 실행에서 삭제되었습니다. |
| ENDED | 여정 | 여정이 종료되었으므로 실행에서 삭제되었습니다. |
| TREATMENT\$1HOLDOUT | Campaigns | 이는 집단이 현재 처리와 일치하지 않는 엔드포인트에 대해 A/B 캠페인에서 방출됩니다. 예를 들어, 50/50 A/B 분할에서는 엔드포인트의 50%가 각 처리에 대해 이 지표를 방출합니다. |
| ENDPOINT\$1ESTIMATED\$1TIMEZONE | 여정 | 시간대 추정을 통해 엔드포인트의 시간대를 추정할 수 있었습니다. |
# 캠페인에 대한 Amazon Pinpoint 분석 데이터 쿼리
Amazon Pinpoint 콘솔의 분석 페이지를 사용하는 것 외에도 Amazon Pinpoint Analytics API를 사용하여 분석 데이터를 쿼리하여 캠페인의 제공 및 참여 동향에 대한 통찰력을 제공하는 표준 지표의 하위 집합을 제공할 수 있습니다.
이러한 각 지표는 측정 가능한 값으로, *KPI(핵심 성과 지표)*라고도 하며, 하나 이상의 캠페인 성과를 모니터링하고 평가하는 데 도움이 됩니다. 예를 들어, 지표를 사용하여 캠페인 메시지를 전송한 엔드포인트의 수 또는 의도한 엔드포인트에 배달된 메시지의 수를 확인할 수 있습니다.
Amazon Pinpoint는 모든 캠페인에 대해 이 데이터를 자동으로 수집하고 집계합니다. 데이터는 90일 동안 저장됩니다. Mobile SDK를 사용하여 AWS 모바일 앱을 Amazon Pinpoint와 통합한 경우 Amazon Pinpoint는 수신자가 열어본 푸시 알림의 백분율과 같은 추가 지표를 포함하도록이 지원을 확장합니다. 모바일 앱 통합에 대한 자세한 내용은 [Amazon Pinpoint를 애플리케이션과 통합](integrate.md) 단원을 참조하십시오.
Amazon Pinpoint Analytics API를 사용하여 데이터를 쿼리하는 경우 쿼리의 범위, 데이터, 그룹화 및 필터를 정의하는 다양한 옵션을 선택할 수 있습니다. 이 작업은 적용할 날짜 기반 필터와 함께 쿼리할 프로젝트, 캠페인 및 지표를 지정하는 파라미터를 사용하여 수행할 수 있습니다.
이 항목에서는 이러한 옵션을 선택하고 하나 이상의 캠페인에 대한 데이터를 쿼리하는 방법에 대해 설명하고 예제를 제공합니다.
## 사전 조건
하나 이상의 캠페인에 대한 분석 데이터를 쿼리하기 전에 쿼리를 정의하는 데 사용할 다음 정보를 수집하는 것이 좋습니다.
+ **프로젝트 ID** - 캠페인과 연관된 프로젝트의 고유 식별자입니다. Amazon Pinpoint API에서 이 값은 `application-id` 속성에 저장됩니다. Amazon Pinpoint 콘솔에서는 이 값이 **모든 프로젝트** 페이지에 **프로젝트 ID**로 표시됩니다.
+ **캠페인 ID** - 하나의 캠페인에 대해서만 데이터를 쿼리하려는 경우 캠페인의 고유 식별자입니다. Amazon Pinpoint API에서 이 값은 `campaign-id` 속성에 저장됩니다. 이 값은 콘솔에 표시되지 않습니다.
+ **날짜 범위** - 날짜 범위 또는 데이터를 쿼리할 일자 범위의 최초 및 최종 날짜 및 시간입니다. 날짜 범위는 포괄적이며 31일 이하로 제한되어야 합니다. 또한 현재 날짜로부터 90일 이내에 시작해야 합니다. 날짜 범위를 지정하지 않으면 Amazon Pinpoint에서 이전 31일의 데이터를 자동으로 쿼리합니다.
+ **지표 유형** - 쿼리할 지표의 유형입니다. *애플리케이션 지표*와 *캠페인 지표*의 두 가지 유형이 있습니다. *애플리케이션 지표*는 프로젝트와 연관된 모든 캠페인(*애플리케이션*이라고도 함)에 대한 데이터를 제공합니다. *캠페인 지표*는 하나의 캠페인에 대한 데이터만 제공합니다.
+ **지표** - 쿼리할 지표의 이름입니다. 보다 구체적으로 말하면 지표의 값입니다. 지원되는 지표의 전체 목록과 각 지표에 대한 `kpi-name` 값은 [프로젝트, 캠페인 및 여정에 대한 표준 지표](analytics-standard-metrics.md) 단원을 참조하십시오.
이는 또한 관련 필드로 데이터를 그룹화할지 여부를 결정하는 데 도움이 됩니다. 이 경우 자동으로 데이터를 그룹화하도록 설계된 지표를 선택하여 분석 및 보고를 단순화할 수 있습니다. 예를 들어 Amazon Pinpoint에서는 캠페인 수신자에게 배달된 메시지의 비율을 보고하는 몇 가지 표준 지표를 제공합니다. 이러한 지표 중 하나는 자동으로 데이터를 날짜별(`successful-delivery-rate-grouped-by-date`)로 그룹화합니다. 다른 지표는 자동으로 데이터를 캠페인 실행별(`successful-delivery-rate-grouped-by-campaign-activity`)로 그룹화합니다. 세 번째 지표는 단일 값, 즉 모든 캠페인 실행에서 수신자에게 배달된 메시지 비율을 반환합니다(`successful-delivery-rate`).
원하는 방식으로 데이터를 그룹화하는 표준 지표를 찾을 수 없는 경우 원하는 데이터를 반환하는 일련의 쿼리를 개발할 수 있습니다. 그런 다음 쿼리 결과를 수동으로 분류하거나 디자인 중인 사용자 지정 그룹으로 결합할 수 있습니다.
마지막으로 쿼리할 데이터에 액세스할 수 있는 권한이 있는지 확인하는 것이 중요합니다. 자세한 내용은 [Amazon Pinpoint 분석 데이터 쿼리를 위한 IAM 정책](analytics-permissions.md) 단원을 참조하십시오.
# 하나의 캠페인에 대한 Amazon Pinpoint 데이터 쿼리
하나의 캠페인에 대한 데이터를 쿼리하려면 [캠페인 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) API를 사용하여 다음 필수 파라미터에 대한 값을 지정합니다.
+ **application-id** - 캠페인과 연관된 프로젝트의 고유 식별자인 프로젝트 ID입니다. Amazon Pinpoint에서 *프로젝트* 및 *애플리케이션*이라는 용어는 동일한 의미를 갖습니다.
+ **campaign-id** - 캠페인의 고유 식별자입니다.
+ **kpi-name** - 쿼리할 지표의 이름입니다. 이 값은 연관된 지표를 설명하며 두 개 이상의 용어로 구성되며, 이 용어는 소문자 영숫자 문자로 구성되며 하이픈으로 구분됩니다. 지원되는 지표의 전체 목록과 각 지표에 대한 `kpi-name` 값은 [프로젝트, 캠페인 및 여정에 대한 표준 지표](analytics-standard-metrics.md) 단원을 참조하십시오.
특정 날짜 범위에 대해 데이터를 쿼리하는 필터를 적용할 수도 있습니다. 날짜 범위를 지정하지 않으면 Amazon Pinpoint에서는 이전 31일 동안의 데이터를 반환합니다. 다른 날짜별로 데이터를 필터링하려면 지원되는 날짜 범위 파라미터를 사용하여 날짜 범위의 첫 번째 및 마지막 날짜 및 시간을 지정합니다. 값은 확장된 ISO 8601 형식이어야 하며 협정 세계시(UTC)를 사용해야 합니다. 예를 들어 `2019-07-19T20:00:00Z`는 2019년 7월 19일 오후 8시 UTC입니다. 날짜 범위는 포괄적이며 31일 이하로 제한되어야 합니다. 또한 첫 번째 날짜 및 시간은 현재 날짜로부터 90일 이내여야 합니다.
다음 예제에서는 Amazon Pinpoint REST API, AWS CLI및를 사용하여 캠페인에 대한 분석 데이터를 쿼리하는 방법을 보여줍니다 AWS SDK for Java. 지원되는 AWS SDK를 사용하여 캠페인에 대한 분석 데이터를 쿼리할 수 있습니다. 이 AWS CLI 예제는 Microsoft Windows용 형식입니다. Unix, Linux 및 macOS의 경우 캐럿(^) 행 연속 문자를 백슬래시(\$1)로 바꿉니다.
------
#### [ REST API ]
Amazon Pinpoint REST API를 사용하여 캠페인의 분석 데이터를 쿼리하려면 HTTP(S) GET 요청을 [캠페인 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) URI에 보냅니다. URI에서 필요한 경로 파라미터에 적합한 값을 지정합니다.
```
https://endpoint/v1/apps/application-id/campaigns/campaign-id/kpis/daterange/kpi-name
```
위치:
+ *엔드포인트*는 캠페인과 연결된 프로젝트를 호스팅하는 AWS 리전의 Amazon Pinpoint 엔드포인트입니다.
+ *application-id*는 캠페인과 관련된 프로젝트의 고유 식별자입니다.
+ *campaign-id*는 캠페인의 고유 식별자입니다.
+ *kpi-name*은 쿼리할 지표의 `kpi-name` 값입니다.
모든 파라미터는 URL로 인코딩해야 합니다.
특정 날짜 범위에 대한 데이터를 쿼리하는 필터를 적용하려면 `start-time` 및 `end-time` 쿼리 파라미터와 값을 URI에 추가합니다. 이러한 파라미터를 사용하여 데이터를 검색할 포함 날짜 범위의 확장 ISO 8601 형식으로 첫 번째 날짜와 마지막 날짜 및 시간을 지정할 수 있습니다. 앰퍼샌드(&)를 사용하여 파라미터를 구분합니다.
예를 들어 다음 요청은 2019년 7월 19일부터 2019년 7월 26일까지 캠페인의 모든 실행에 의해 메시지가 배달된 고유 엔드포인트 수를 검색합니다.
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/campaigns/80b8efd84042ff8d9c96ce2f8example/kpis/daterange/unique-deliveries?start-time=2019-07-19T00:00:00Z&end-time=2019-07-26T23:59:59Z
```
위치:
+ `pinpoint.us-east-1.amazonaws.com`은 프로젝트를 호스팅하는 AWS 리전의 Amazon Pinpoint 엔드포인트입니다.
+ `1234567890123456789012345example`은 캠페인과 연결된 프로젝트의 고유 식별자입니다.
+ `80b8efd84042ff8d9c96ce2f8example`은 캠페인의 고유 식별자입니다.
+ `unique-deliveries`는 *엔드포인트 배달 건수* 캠페인 지표의 `kpi-name` 값이며, 이는 캠페인의 모든 실행에 의해 메시지가 배달된 고유한 엔드포인트 수를 보고하는 지표입니다.
+ `2019-07-19T00:00:00Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 첫 번째 날짜 및 시간입니다.
+ `2019-07-26T23:59:59Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 마지막 날짜 및 시간입니다.
------
#### [ AWS CLI ]
를 사용하여 캠페인의 분석 데이터를 쿼리하려면 **get-campaign-date-range-kpi** 명령을 AWS CLI사용하고 필요한 파라미터에 적절한 값을 지정합니다.
```
C:\> aws pinpoint get-campaign-date-range-kpi ^
--application-id application-id ^
--campaign-id campaign-id ^
--kpi-name kpi-name
```
위치:
+ *application-id*는 캠페인과 관련된 프로젝트의 고유 식별자입니다.
+ *campaign-id*는 캠페인의 고유 식별자입니다.
+ *kpi-name*은 쿼리할 지표의 `kpi-name` 값입니다.
특정 날짜 범위에 대한 데이터를 쿼리하는 필터를 적용하려면 `start-time` 및 `end-time` 파라미터와 값을 쿼리에 추가합니다. 이러한 파라미터를 사용하여 데이터를 검색할 포함 날짜 범위의 확장 ISO 8601 형식으로 첫 번째 날짜와 마지막 날짜 및 시간을 지정할 수 있습니다. 예를 들어 다음 요청은 2019년 7월 19일부터 2019년 7월 26일까지 캠페인의 모든 실행에 의해 메시지가 배달된 고유 엔드포인트 수를 검색합니다.
```
C:\> aws pinpoint get-campaign-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--campaign-id 80b8efd84042ff8d9c96ce2f8example ^
--kpi-name unique-deliveries ^
--start-time 2019-07-19T00:00:00Z ^
--end-time 2019-07-26T23:59:59Z
```
위치:
+ `1234567890123456789012345example`은 캠페인과 연결된 프로젝트의 고유 식별자입니다.
+ `80b8efd84042ff8d9c96ce2f8example`은 캠페인의 고유 식별자입니다.
+ `unique-deliveries`는 *엔드포인트 배달 건수* 캠페인 지표의 `kpi-name` 값이며, 이는 캠페인의 모든 실행에 의해 메시지가 배달된 고유한 엔드포인트 수를 보고하는 지표입니다.
+ `2019-07-19T00:00:00Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 첫 번째 날짜 및 시간입니다.
+ `2019-07-26T23:59:59Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 마지막 날짜 및 시간입니다.
------
#### [ SDK for Java ]
를 사용하여 캠페인에 대한 분석 데이터를 쿼리하려면 캠페인 지표 API의 **GetCampaignDateRangeKpiRequest** 메서드를 AWS SDK for Java사용합니다. [https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) 필수 파라미터에 대해 적절한 값을 지정합니다.
```
GetCampaignDateRangeKpiRequest request = new GetCampaignDateRangeKpiRequest()
.withApplicationId("applicationId")
.withCampaignId("campaignId")
.withKpiName("kpiName")
```
위치:
+ *applicationId*는 캠페인과 관련된 프로젝트의 고유 식별자입니다.
+ *campaignId*는 캠페인의 고유 식별자입니다.
+ *kpiName*은 쿼리할 지표의 `kpi-name` 값입니다.
특정 날짜 범위에 대한 데이터를 쿼리하는 필터를 적용하려면 쿼리에 `startTime` 및 `endTime` 파라미터 및 값을 포함합니다. 이러한 파라미터를 사용하여 데이터를 검색할 포함 날짜 범위의 확장 ISO 8601 형식으로 첫 번째 날짜와 마지막 날짜 및 시간을 지정할 수 있습니다. 예를 들어 다음 요청은 2019년 7월 19일부터 2019년 7월 26일까지 캠페인의 모든 실행에 의해 메시지가 배달된 고유 엔드포인트 수를 검색합니다.
```
GetCampaignDateRangeKpiRequest request = new GetCampaignDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withCampaignId("80b8efd84042ff8d9c96ce2f8example")
.withKpiName("unique-deliveries")
.withStartTime(Date.from(Instant.parse("2019-07-19T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-07-26T23:59:59Z")));
```
위치:
+ `1234567890123456789012345example`은 캠페인과 연결된 프로젝트의 고유 식별자입니다.
+ `80b8efd84042ff8d9c96ce2f8example`은 캠페인의 고유 식별자입니다.
+ `unique-deliveries`는 *엔드포인트 배달 건수* 캠페인 지표의 `kpi-name` 값이며, 이는 캠페인의 모든 실행에 의해 메시지가 배달된 고유한 엔드포인트 수를 보고하는 지표입니다.
+ `2019-07-19T00:00:00Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 첫 번째 날짜 및 시간입니다.
+ `2019-07-26T23:59:59Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 마지막 날짜 및 시간입니다.
------
쿼리를 전송한 후 Amazon Pinpoint는 쿼리 결과를 JSON 응답으로 반환합니다. 결과 구조는 쿼리한 지표에 따라 다릅니다. 일부 지표는 하나의 값만 반환합니다. 예를 들어, 이전 예제에서 사용된 *엔드포인트 배달 건수*(`unique-deliveries`) 캠페인 지표는 하나의 값, 즉 캠페인의 모든 실행에 의해 메시지가 배달된 고유한 엔드포인트 수를 반환합니다. 이 경우 JSON 응답은 다음과 같습니다.
```
{
"CampaignDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"CampaignId":"80b8efd84042ff8d9c96ce2f8example",
"EndTime":"2019-07-26T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
}
]
},
"StartTime":"2019-07-19T00:00:00Z"
}
}
```
다른 지표는 여러 값을 반환하고 관련 필드별로 값을 그룹화합니다. 지표가 여러 값을 반환하는 경우 JSON 응답에는 데이터를 그룹화하는 데 사용된 필드를 나타내는 필드가 포함됩니다.
쿼리 결과의 구조에 대한 자세한 내용은 [JSON 쿼리 결과 사용](analytics-query-results.md) 단원을 참조하십시오.
# 여러 캠페인에 대한 Amazon Pinpoint 데이터 쿼리
여러 캠페인의 데이터를 쿼리하는 방법에는 두 가지가 있습니다. 가장 좋은 방법은 모두 동일한 프로젝트와 연결된 캠페인의 데이터를 쿼리할지 여부에 따라 다릅니다. 이 경우 해당 캠페인 전체 또는 일부에 대한 데이터를 쿼리할지 아니면 해당 캠페인의 하위 집합에 대한 데이터를 쿼리할지 여부에 따라서도 달라집니다.
서로 다른 프로젝트와 연결된 캠페인 또는 동일한 프로젝트와 연결된 캠페인의 하위 집합에 대해서만 데이터를 쿼리하려면 데이터를 쿼리할 각 캠페인에 대해 하나씩 일련의 개별 쿼리를 생성하고 실행하는 것이 가장 좋습니다. 이전 섹션에서는 하나의 캠페인에 대해서만 데이터를 쿼리하는 방법에 대해 설명합니다.
동일한 프로젝트와 연결된 모든 캠페인의 데이터를 쿼리하려면 [애플리케이션 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API를 사용하면 됩니다. 다음 필수 파라미터 값을 지정합니다.
+ **application-id** - 프로젝트의 고유 식별자인 프로젝트 ID입니다. Amazon Pinpoint에서 *프로젝트* 및 *애플리케이션*이라는 용어는 동일한 의미를 갖습니다.
+ **kpi-name** - 쿼리할 지표의 이름입니다. 이 값은 연관된 지표를 설명하며 두 개 이상의 용어로 구성되며, 이 용어는 소문자 영숫자 문자로 구성되며 하이픈으로 구분됩니다. 지원되는 지표의 전체 목록과 각 지표에 대한 `kpi-name` 값은 [프로젝트, 캠페인 및 여정에 대한 표준 지표](analytics-standard-metrics.md) 단원을 참조하십시오.
날짜 범위를 기준으로 데이터를 필터링할 수도 있습니다. 날짜 범위를 지정하지 않으면 Amazon Pinpoint에서는 이전 31일 동안의 데이터를 반환합니다. 다른 날짜별로 데이터를 필터링하려면 지원되는 날짜 범위 파라미터를 사용하여 날짜 범위의 첫 번째 및 마지막 날짜 및 시간을 지정합니다. 값은 확장된 ISO 8601 형식이어야 하며 협정 세계시(UTC)를 사용해야 합니다. 예를 들어 `2019-07-19T20:00:00Z`는 2019년 7월 19일 오후 8시 UTC입니다. 날짜 범위는 포괄적이며 31일 이하로 제한되어야 합니다. 또한 첫 번째 날짜 및 시간은 현재 날짜로부터 90일 이내여야 합니다.
다음 예제에서는 Amazon Pinpoint REST API, AWS CLI및를 사용하여 캠페인에 대한 분석 데이터를 쿼리하는 방법을 보여줍니다 AWS SDK for Java. 지원되는 AWS SDK를 사용하여 캠페인에 대한 분석 데이터를 쿼리할 수 있습니다. 이 AWS CLI 예제는 Microsoft Windows용 형식입니다. Unix, Linux 및 macOS의 경우 캐럿(^) 행 연속 문자를 백슬래시(\$1)로 바꿉니다.
------
#### [ REST API ]
Amazon Pinpoint REST API를 사용하여 여러 캠페인의 분석 데이터를 쿼리하려면 HTTP(S) GET 요청을 [애플리케이션 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) URI로 보냅니다. URI에서 필요한 경로 파라미터에 적합한 값을 지정합니다.
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
위치:
+ *엔드포인트*는 캠페인과 연결된 프로젝트를 호스팅하는 AWS 리전의 Amazon Pinpoint 엔드포인트입니다.
+ *application-id*는 캠페인과 관련된 프로젝트의 고유 식별자입니다.
+ *kpi-name*은 쿼리할 지표의 `kpi-name` 값입니다.
모든 파라미터는 URL로 인코딩해야 합니다.
특정 날짜 범위에 대한 데이터를 검색하는 필터를 적용하려면 `start-time` 및 `end-time` 쿼리 파라미터와 값을 URI에 추가합니다. 이러한 파라미터를 사용하여 데이터를 검색할 포함 날짜 범위의 확장 ISO 8601 형식으로 첫 번째 날짜와 마지막 날짜 및 시간을 지정할 수 있습니다. 앰퍼샌드(&)를 사용하여 파라미터를 구분합니다.
예를 들어 다음 요청은 2019년 7월 19일부터 2019년 7월 26일까지 각 프로젝트 캠페인에 의해 메시지가 배달된 고유한 엔드포인트 수를 검색합니다.
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/unique-deliveries-grouped-by-campaign?start-time=2019-07-19T00:00:00Z&end-time=2019-07-26T23:59:59Z
```
위치:
+ `pinpoint.us-east-1.amazonaws.com`은 프로젝트를 호스팅하는 AWS 리전의 Amazon Pinpoint 엔드포인트입니다.
+ `1234567890123456789012345example`은 캠페인과 연결된 프로젝트의 고유 식별자입니다.
+ `unique-deliveries-grouped-by-campaign`은 *엔드포인트 배달 건수(캠페인별 그룹화)* 애플리케이션 지표의 `kpi-name` 값이며, 이는 각 캠페인에 의해 메시지가 배달된 고유 엔드포인트 수를 반환하는 지표입니다.
+ `2019-07-19T00:00:00Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 첫 번째 날짜 및 시간입니다.
+ `2019-07-26T23:59:59Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 마지막 날짜 및 시간입니다.
------
#### [ AWS CLI ]
를 사용하여 여러 캠페인의 분석 데이터를 쿼리하려면 **get-application-date-range-kpi** 명령을 AWS CLI사용하고 필요한 파라미터에 적절한 값을 지정합니다.
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
위치:
+ *application-id*는 캠페인과 관련된 프로젝트의 고유 식별자입니다.
+ *kpi-name*은 쿼리할 지표의 `kpi-name` 값입니다.
특정 날짜 범위에 대한 데이터를 검색하는 필터를 적용하려면 쿼리에 `start-time` 및 `end-time` 파라미터 및 값을 포함합니다. 이러한 파라미터를 사용하여 데이터를 검색할 포함 날짜 범위의 확장 ISO 8601 형식으로 첫 번째 날짜와 마지막 날짜 및 시간을 지정할 수 있습니다. 예를 들어 다음 요청은 2019년 7월 19일부터 2019년 7월 26일까지 각 프로젝트 캠페인에 의해 메시지가 배달된 고유한 엔드포인트 수를 검색합니다.
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name unique-deliveries-grouped-by-campaign ^
--start-time 2019-07-19T00:00:00Z ^
--end-time 2019-07-26T23:59:59Z
```
위치:
+ `1234567890123456789012345example`은 캠페인과 연결된 프로젝트의 고유 식별자입니다.
+ `unique-deliveries-grouped-by-campaign`은 *엔드포인트 배달 건수(캠페인별 그룹화)* 애플리케이션 지표의 `kpi-name` 값이며, 이는 각 캠페인에 의해 메시지가 배달된 고유 엔드포인트 수를 반환하는 지표입니다.
+ `2019-07-19T00:00:00Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 첫 번째 날짜 및 시간입니다.
+ `2019-07-26T23:59:59Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 마지막 날짜 및 시간입니다.
------
#### [ SDK for Java ]
를 사용하여 여러 캠페인의 분석 데이터를 쿼리하려면 [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API의 **GetApplicationDateRangeKpiRequest** 메서드를 AWS SDK for Java사용합니다. 필수 파라미터에 대해 적절한 값을 지정합니다.
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
위치:
+ *applicationId*는 캠페인과 관련된 프로젝트의 고유 식별자입니다.
+ *kpiName*은 쿼리할 지표의 `kpi-name` 값입니다.
특정 날짜 범위에 대한 데이터를 검색하는 필터를 적용하려면 쿼리에 `startTime` 및 `endTime` 파라미터 및 값을 포함합니다. 이러한 파라미터를 사용하여 데이터를 검색할 포함 날짜 범위의 확장 ISO 8601 형식으로 첫 번째 날짜와 마지막 날짜 및 시간을 지정할 수 있습니다. 예를 들어 다음 요청은 2019년 7월 19일부터 2019년 7월 26일까지 각 프로젝트 캠페인에 의해 메시지가 배달된 고유한 엔드포인트 수를 검색합니다.
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("unique-deliveries-grouped-by-campaign")
.withStartTime(Date.from(Instant.parse("2019-07-19T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-07-26T23:59:59Z")));
```
위치:
+ `1234567890123456789012345example`은 캠페인과 연결된 프로젝트의 고유 식별자입니다.
+ `unique-deliveries-grouped-by-campaign`은 *엔드포인트 배달 건수(캠페인별 그룹화)* 애플리케이션 지표의 `kpi-name` 값이며, 이는 각 캠페인에 의해 메시지가 배달된 고유 엔드포인트 수를 반환하는 지표입니다.
+ `2019-07-19T00:00:00Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 첫 번째 날짜 및 시간입니다.
+ `2019-07-26T23:59:59Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 마지막 날짜 및 시간입니다.
------
쿼리를 전송한 후 Amazon Pinpoint는 쿼리 결과를 JSON 응답으로 반환합니다. 결과 구조는 쿼리한 지표에 따라 다릅니다. 일부 지표는 하나의 값만 반환합니다. 다른 지표는 여러 값을 반환하며 이러한 값은 관련 필드별로 그룹화됩니다. 지표가 여러 값을 반환하는 경우 JSON 응답에는 데이터를 그룹화하는 데 사용된 필드를 나타내는 필드가 포함됩니다.
예를 들어 이전 예제에서 사용된 *엔드포인트 배달 건수(캠페인별 그룹화)*(`unique-deliveries-grouped-by-campaign`) 애플리케이션 지표는 프로젝트와 관련된 각 캠페인에 대해 메시지가 배달된 고유한 엔드포인트 수와 같은 여러 값을 반환합니다. 이 경우 JSON 응답은 다음과 같습니다.
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-07-26T23:59:59Z",
"KpiName":"unique-deliveries-grouped-by-campaign",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"80b8efd84042ff8d9c96ce2f8example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"810c7aab86d42fb2b56c8c966example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"456.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"42d8c7eb0990a57ba1d5476a3example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"789.0"
}
]
}
]
},
"StartTime":"2019-07-19T00:00:00Z"
}
}
```
이 경우 `GroupedBys` 필드는 값이 캠페인 ID(`CampaignId`)별로 그룹화됨을 나타냅니다.
쿼리 결과의 구조에 대한 자세한 내용은 [JSON 쿼리 결과 사용](analytics-query-results.md) 단원을 참조하십시오.
# 트랜잭션 메시지에 대한 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` 값은 [프로젝트, 캠페인 및 여정에 대한 표준 지표](analytics-standard-metrics.md) 단원을 참조하십시오.
이는 또한 관련 필드로 데이터를 그룹화할지 여부를 결정하는 데 도움이 됩니다. 이 경우 자동으로 데이터를 그룹화하도록 설계된 지표를 선택하여 분석 및 보고를 단순화할 수 있습니다. 예를 들어 Amazon Pinpoint는 받는 사람에게 배달된 트랜잭션 SMS 메시지의 수를 보고하는 몇 가지 표준 지표를 제공합니다. 이러한 지표 중 하나는 자동으로 데이터를 날짜별(`txn-sms-delivered-grouped-by-date`)로 그룹화합니다. 다른 지표는 자동으로 데이터를 국가 또는 리전별(`txn-sms-delivered-grouped-by-country`)로 그룹화합니다. 세 번째 지표는 단일 값, 즉 수신자에게 배달된 메시지 수를 반환합니다(`txn-sms-delivered`). 원하는 방식으로 데이터를 그룹화하는 표준 지표를 찾을 수 없는 경우 원하는 데이터를 반환하는 일련의 쿼리를 개발할 수 있습니다. 그런 다음 쿼리 결과를 수동으로 분류하거나 디자인 중인 사용자 지정 그룹으로 결합할 수 있습니다.
마지막으로 쿼리할 데이터에 액세스할 수 있는 권한이 있는지 확인하는 것이 중요합니다. 자세한 내용은 [Amazon Pinpoint 분석 데이터 쿼리를 위한 IAM 정책](analytics-permissions.md) 단원을 참조하십시오.
# 트랜잭션 이메일 메시지에 대한 Amazon Pinpoint 데이터 쿼리
프로젝트에 대해 전송된 트랜잭션 이메일 메시지의 데이터를 쿼리하려면 [애플리케이션 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API를 사용하여 다음 필수 파라미터에 대한 값을 지정합니다.
+ **application-id** - 프로젝트의 고유 식별자인 프로젝트 ID입니다. Amazon Pinpoint에서 *프로젝트* 및 *애플리케이션*이라는 용어는 동일한 의미를 갖습니다.
+ **kpi-name** - 쿼리할 지표의 이름입니다. 이 값은 연관된 지표를 설명하며 두 개 이상의 용어로 구성되며, 이 용어는 소문자 영숫자 문자로 구성되며 하이픈으로 구분됩니다. 지원되는 지표의 전체 목록과 각 지표에 대한 `kpi-name` 값은 [프로젝트, 캠페인 및 여정에 대한 표준 지표](analytics-standard-metrics.md) 단원을 참조하십시오.
특정 날짜 범위에 대해 데이터를 쿼리하는 필터를 적용할 수도 있습니다. 날짜 범위를 지정하지 않으면 Amazon Pinpoint에서는 이전 31일 동안의 데이터를 반환합니다. 다른 날짜별로 데이터를 필터링하려면 지원되는 날짜 범위 파라미터를 사용하여 날짜 범위의 첫 번째 및 마지막 날짜 및 시간을 지정합니다. 값은 확장된 ISO 8601 형식이어야 하며 협정 세계시(UTC)를 사용해야 합니다. 예를 들어 `2019-09-06T20:00:00Z`는 2019년 9월 6일 오후 8시 UTC입니다. 날짜 범위는 포괄적이며 31일 이하로 제한되어야 합니다. 또한 첫 번째 날짜 및 시간은 현재 날짜로부터 90일 이내여야 합니다.
다음 예제에서는 Amazon Pinpoint REST API, AWS CLI및를 사용하여 트랜잭션 이메일 메시지에 대한 분석 데이터를 쿼리하는 방법을 보여줍니다 AWS SDK for Java. 지원되는 AWS SDK를 사용하여 트랜잭션 메시지에 대한 분석 데이터를 쿼리할 수 있습니다. 이 AWS CLI 예제는 Microsoft Windows용 형식입니다. Unix, Linux 및 macOS의 경우 캐럿(^) 행 연속 문자를 백슬래시(\$1)로 바꿉니다.
------
#### [ REST API ]
Amazon Pinpoint REST API를 사용하여 트랜잭션 이메일 메시지에 대한 분석 데이터를 쿼리하려면 HTTP(S) GET 요청을 [애플리케이션 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) URI로 보냅니다. URI에서 필요한 경로 파라미터에 적합한 값을 지정합니다.
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
위치:
+ *엔드포인트*는 프로젝트를 호스팅하는 AWS 리전의 Amazon Pinpoint 엔드포인트입니다.
+ *application-id*는 프로젝트의 고유 식별자입니다.
+ *kpi-name*은 쿼리할 지표의 `kpi-name` 값입니다.
모든 파라미터는 URL로 인코딩해야 합니다.
특정 날짜 범위에 대한 데이터를 쿼리하는 필터를 적용하려면 `start-time` 및 `end-time` 쿼리 파라미터와 값을 URI에 추가합니다. 이러한 파라미터를 사용하여 데이터를 검색할 포함 날짜 범위의 확장 ISO 8601 형식으로 첫 번째 날짜와 마지막 날짜 및 시간을 지정할 수 있습니다. 앰퍼샌드(&)를 사용하여 파라미터를 구분합니다.
예를 들어 다음 요청은 2019년 9월 6일부터 2019년 9월 13일까지 프로젝트에 대해 전송된 트랜잭션 이메일 메시지의 수를 검색합니다.
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/txn-emails-sent?start-time=2019-09-06T00:00:00Z&end-time=2019-09-13T23:59:59Z
```
위치:
+ `pinpoint.us-east-1.amazonaws.com`은 프로젝트를 호스팅하는 AWS 리전의 Amazon Pinpoint 엔드포인트입니다.
+ `1234567890123456789012345example`은 프로젝트의 고유 식별자입니다.
+ `txn-emails-sent`는 *전송 수* 애플리케이션 지표의 `kpi-name` 값으로, 이는 프로젝트에 대해 배달된 트랜잭션 이메일 메시지 수를 보고하는 지표입니다.
+ `2019-09-06T00:00:00Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 첫 번째 날짜 및 시간입니다.
+ `2019-09-13T23:59:59Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 마지막 날짜 및 시간입니다.
------
#### [ AWS CLI ]
를 사용하여 트랜잭션 이메일 메시지에 대한 분석 데이터를 쿼리하려면 **get-application-date-range-kpi** 명령을 AWS CLI사용하고 필요한 파라미터에 적절한 값을 지정합니다.
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
위치:
+ *application-id*는 프로젝트의 고유 식별자입니다.
+ *kpi-name*은 쿼리할 지표의 `kpi-name` 값입니다.
특정 날짜 범위에 대한 데이터를 쿼리하는 필터를 적용하려면 `start-time` 및 `end-time` 파라미터와 값을 쿼리에 추가합니다. 이러한 파라미터를 사용하여 데이터를 검색할 포함 날짜 범위의 확장 ISO 8601 형식으로 첫 번째 날짜와 마지막 날짜 및 시간을 지정할 수 있습니다. 예를 들어 다음 요청은 2019년 9월 6일부터 2019년 9월 13일까지 프로젝트에 대해 전송된 트랜잭션 이메일 메시지의 수를 검색합니다.
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name txn-emails-sent ^
--start-time 2019-09-06T00:00:00Z ^
--end-time 2019-09-13T23:59:59Z
```
위치:
+ `1234567890123456789012345example`은 프로젝트의 고유 식별자입니다.
+ `txn-emails-sent`는 *전송 수* 애플리케이션 지표의 `kpi-name` 값으로, 이는 프로젝트에 대해 배달된 트랜잭션 이메일 메시지 수를 보고하는 지표입니다.
+ `2019-09-06T00:00:00Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 첫 번째 날짜 및 시간입니다.
+ `2019-09-13T23:59:59Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 마지막 날짜 및 시간입니다.
------
#### [ SDK for Java ]
를 사용하여 트랜잭션 이메일 메시지에 대한 분석 데이터를 쿼리하려면 [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API의 **GetApplicationDateRangeKpiRequest** 메서드를 AWS SDK for Java사용합니다. 필수 파라미터에 대해 적절한 값을 지정합니다.
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
위치:
+ *applicationId*는 프로젝트의 고유 식별자입니다.
+ *kpiName*은 쿼리할 지표의 `kpi-name` 값입니다.
특정 날짜 범위에 대한 데이터를 쿼리하는 필터를 적용하려면 쿼리에 `startTime` 및 `endTime` 파라미터 및 값을 포함합니다. 이러한 파라미터를 사용하여 데이터를 검색할 포함 날짜 범위의 확장 ISO 8601 형식으로 첫 번째 날짜와 마지막 날짜 및 시간을 지정할 수 있습니다. 예를 들어 다음 요청은 2019년 9월 6일부터 2019년 9월 13일까지 프로젝트에 대해 전송된 트랜잭션 이메일 메시지의 수를 검색합니다.
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("txn-emails-sent")
.withStartTime(Date.from(Instant.parse("2019-09-06T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-09-13T23:59:59Z")));
```
위치:
+ `1234567890123456789012345example`은 프로젝트의 고유 식별자입니다.
+ `txn-emails-sent`는 *전송 수* 애플리케이션 지표의 `kpi-name` 값으로, 이는 프로젝트에 대해 배달된 트랜잭션 이메일 메시지 수를 보고하는 지표입니다.
+ `2019-09-06T00:00:00Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 첫 번째 날짜 및 시간입니다.
+ `2019-09-13T23:59:59Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 마지막 날짜 및 시간입니다.
------
쿼리를 전송한 후 Amazon Pinpoint는 쿼리 결과를 JSON 응답으로 반환합니다. 결과 구조는 쿼리한 지표에 따라 다릅니다. 일부 지표는 하나의 값만 반환합니다. 예를 들어, 이전 예제에서 사용된 *전송 수*(`txn-emails-sent`) 애플리케이션 지표는 하나의 값, 즉 프로젝트에서 전송된 트랜잭션 이메일 메시지 수를 반환합니다. 이 경우 JSON 응답은 다음과 같습니다.
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-09-13T23:59:59Z",
"KpiName":"txn-emails-sent",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"TxnEmailsSent",
"Type":"Double",
"Value":"62.0"
}
]
}
]
},
"StartTime":"2019-09-06T00:00:00Z"
}
}
```
다른 지표는 여러 값을 반환하고 관련 필드별로 값을 그룹화합니다. 지표가 여러 값을 반환하는 경우 JSON 응답에는 데이터를 그룹화하는 데 사용된 필드를 나타내는 필드가 포함됩니다.
쿼리 결과의 구조에 대한 자세한 내용은 [JSON 쿼리 결과 사용](analytics-query-results.md) 단원을 참조하십시오.
# 트랜잭션 SMS 메시지에 대한 Amazon Pinpoint 데이터 쿼리
프로젝트에 대해 전송된 트랜잭션 SMS 메시지의 데이터를 쿼리하려면 [애플리케이션 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API를 사용하여 다음 필수 파라미터에 대한 값을 지정합니다.
+ **application-id** - 프로젝트의 고유 식별자인 프로젝트 ID입니다. Amazon Pinpoint에서 *프로젝트* 및 *애플리케이션*이라는 용어는 동일한 의미를 갖습니다.
+ **kpi-name** - 쿼리할 지표의 이름입니다. 이 값은 연관된 지표를 설명하며 두 개 이상의 용어로 구성되며, 이 용어는 소문자 영숫자 문자로 구성되며 하이픈으로 구분됩니다. 지원되는 지표의 전체 목록과 각 지표에 대한 `kpi-name` 값은 [프로젝트, 캠페인 및 여정에 대한 표준 지표](analytics-standard-metrics.md) 단원을 참조하십시오.
특정 날짜 범위에 대해 데이터를 쿼리하는 필터를 적용할 수도 있습니다. 날짜 범위를 지정하지 않으면 Amazon Pinpoint에서는 이전 31일 동안의 데이터를 반환합니다. 다른 날짜를 기준으로 데이터를 필터링하려면 지원되는 날짜 범위 파라미터를 사용하여 날짜 범위의 첫 번째 및 마지막 날짜와 시간을 지정합니다. 값은 확장된 ISO 8601 형식이어야 하며 협정 세계시(UTC)를 사용해야 합니다. 예를 들어 `2019-09-06T20:00:00Z`는 2019년 9월 6일 오후 8시 UTC입니다. 날짜 범위는 포괄적이며 31일 이하로 제한되어야 합니다. 또한 첫 번째 날짜 및 시간은 현재 날짜로부터 90일 이내여야 합니다.
다음 예제에서는 Amazon Pinpoint REST API, AWS CLI및를 사용하여 트랜잭션 SMS 메시지에 대한 분석 데이터를 쿼리하는 방법을 보여줍니다 AWS SDK for Java. 지원되는 AWS SDK를 사용하여 트랜잭션 메시지에 대한 분석 데이터를 쿼리할 수 있습니다. 이 AWS CLI 예제는 Microsoft Windows용 형식입니다. Unix, Linux 및 macOS의 경우 캐럿(^) 행 연속 문자를 백슬래시(\$1)로 바꿉니다.
------
#### [ REST API ]
Amazon Pinpoint REST API를 사용하여 트랜잭션 SMS 메시지에 대한 분석 데이터를 쿼리하려면 HTTP(S) GET 요청을 [애플리케이션 지표](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) URI로 보냅니다. URI에서 필요한 경로 파라미터에 적합한 값을 지정합니다.
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
위치:
+ *엔드포인트*는 프로젝트를 호스팅하는 AWS 리전의 Amazon Pinpoint 엔드포인트입니다.
+ *application-id*는 프로젝트의 고유 식별자입니다.
+ *kpi-name*은 쿼리할 지표의 `kpi-name` 값입니다.
모든 파라미터는 URL로 인코딩해야 합니다.
특정 날짜 범위에 대한 데이터를 검색하는 필터를 적용하려면 `start-time` 및 `end-time` 쿼리 파라미터와 값을 URI에 추가합니다. 이러한 파라미터를 사용하여 데이터를 검색할 포함 날짜 범위의 확장 ISO 8601 형식으로 첫 번째 날짜와 마지막 날짜 및 시간을 지정할 수 있습니다. 앰퍼샌드(&)를 사용하여 파라미터를 구분합니다.
예를 들어 다음 요청은 2019년 9월 6일부터 2019년 9월 8일까지 매일 전송된 트랜잭션 SMS 메시지 수를 검색합니다.
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/txn-sms-sent-grouped-by-date?start-time=2019-09-06T00:00:00Z&end-time=2019-09-08T23:59:59Z
```
위치:
+ `pinpoint.us-east-1.amazonaws.com`은 프로젝트를 호스팅하는 AWS 리전의 Amazon Pinpoint 엔드포인트입니다.
+ `1234567890123456789012345example`은 프로젝트의 고유 식별자입니다.
+ `txn-sms-sent-grouped-by-date`는 *날짜별로 그룹화된 전송 수* 애플리케이션 지표의 `kpi-name` 값으로, 이 지표는 날짜 범위에서 매일 전송된 트랜잭션 SMS 메시지 수를 반환하는 지표입니다.
+ `2019-09-06T00:00:00Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 첫 번째 날짜 및 시간입니다.
+ `2019-09-08T23:59:59Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 마지막 날짜 및 시간입니다.
------
#### [ AWS CLI ]
를 사용하여 트랜잭션 SMS 메시지에 대한 분석 데이터를 쿼리하려면 **get-application-date-range-kpi** 명령을 AWS CLI사용하고 필요한 파라미터에 적절한 값을 지정합니다.
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
위치:
+ *application-id*는 프로젝트의 고유 식별자입니다.
+ *kpi-name*은 쿼리할 지표의 `kpi-name` 값입니다.
특정 날짜 범위에 대한 데이터를 검색하는 필터를 적용하려면 쿼리에 `start-time` 및 `end-time` 파라미터 및 값을 포함합니다. 이러한 파라미터를 사용하여 데이터를 검색할 포함 날짜 범위의 확장 ISO 8601 형식으로 첫 번째 날짜와 마지막 날짜 및 시간을 지정할 수 있습니다. 예를 들어 다음 요청은 2019년 9월 6일부터 2019년 9월 8일까지 매일 전송된 트랜잭션 SMS 메시지 수를 검색합니다.
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name txn-sms-sent-grouped-by-date ^
--start-time 2019-09-06T00:00:00Z ^
--end-time 2019-09-08T23:59:59Z
```
위치:
+ `1234567890123456789012345example`은 프로젝트의 고유 식별자입니다.
+ `txn-sms-sent-grouped-by-date`는 *날짜별로 그룹화된 전송 수* 애플리케이션 지표의 `kpi-name` 값으로, 이 지표는 날짜 범위에서 매일 전송된 트랜잭션 SMS 메시지 수를 반환하는 지표입니다.
+ `2019-09-06T00:00:00Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 첫 번째 날짜 및 시간입니다.
+ `2019-09-08T23:59:59Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 마지막 날짜 및 시간입니다.
------
#### [ SDK for Java ]
를 사용하여 트랜잭션 SMS 메시지에 대한 분석 데이터를 쿼리하려면 [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) API의 **GetApplicationDateRangeKpiRequest** 메서드를 AWS SDK for Java사용하고 필요한 파라미터에 적절한 값을 지정합니다.
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
위치:
+ *applicationId*는 프로젝트의 고유 식별자입니다.
+ *kpiName*은 쿼리할 지표의 `kpi-name` 값입니다.
특정 날짜 범위에 대한 데이터를 검색하는 필터를 적용하려면 쿼리에 `startTime` 및 `endTime` 파라미터 및 값을 포함합니다. 이러한 파라미터를 사용하여 데이터를 검색할 포함 날짜 범위의 확장 ISO 8601 형식으로 첫 번째 날짜와 마지막 날짜 및 시간을 지정할 수 있습니다. 예를 들어 다음 요청은 2019년 9월 6일부터 2019년 9월 8일까지 매일 전송된 트랜잭션 SMS 메시지 수를 검색합니다.
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("txn-sms-sent-grouped-by-date")
.withStartTime(Date.from(Instant.parse("2019-09-06T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-09-08T23:59:59Z")));
```
위치:
+ `1234567890123456789012345example`은 프로젝트의 고유 식별자입니다.
+ `txn-sms-sent-grouped-by-date`는 *날짜별로 그룹화된 전송 수* 애플리케이션 지표의 `kpi-name` 값으로, 이 지표는 날짜 범위에서 매일 전송된 트랜잭션 SMS 메시지 수를 반환하는 지표입니다.
+ `2019-09-06T00:00:00Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 첫 번째 날짜 및 시간입니다.
+ `2019-09-08T23:59:59Z`는 포함된 날짜 범위의 일부로 데이터를 검색할 마지막 날짜 및 시간입니다.
------
쿼리를 전송한 후 Amazon Pinpoint는 쿼리 결과를 JSON 응답으로 반환합니다. 결과 구조는 쿼리한 지표에 따라 다릅니다. 일부 지표는 하나의 값만 반환합니다. 다른 지표는 여러 값을 반환하고 관련 필드별로 값을 그룹화합니다. 지표가 여러 값을 반환하는 경우 JSON 응답에는 데이터를 그룹화하는 데 사용된 필드를 나타내는 필드가 포함됩니다.
예를 들어, 이전 예제에서 사용된 *전송 수(날짜별로 그룹화)*(`txn-sms-sent-grouped-by-date`) 애플리케이션 지표는 여러 값, 즉 지정된 날짜 범위에서 매일 전송된 트랜잭션 SMS 메시지 수를 반환합니다. 이 경우 JSON 응답은 다음과 같습니다.
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-09-08T23:59:59Z",
"KpiName":"txn-sms-sent-grouped-by-date",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-06"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"29.0"
}
]
},
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-07"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"35.0"
}
]
},
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-08"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"10.0"
}
]
}
]
},
"StartTime":"2019-09-06T00:00:00Z"
}
}
```
이 경우 `GroupedBys` 필드는 값이 달력 일(`Date`)별로 그룹화됨을 나타냅니다. 이는 다음을 의미합니다.
+ 2019년 9월 6일에 29개의 메시지가 전송되었습니다.
+ 2019년 9월 7일에 35개의 메시지가 전송되었습니다.
+ 2019년 9월 8일에 10개의 메시지가 전송되었습니다.
쿼리 결과의 구조에 대한 자세한 내용은 [JSON 쿼리 결과 사용](analytics-query-results.md) 단원을 참조하십시오.
# Amazon Pinpoint 분석 JSON 쿼리 결과 사용
Amazon Pinpoint Analytics API를 사용하여 분석 데이터를 쿼리하면 Amazon Pinpoint는 결과를 JSON 응답으로 반환합니다. 애플리케이션 지표, 캠페인 지표 및 여정 참여 지표의 경우 응답의 데이터는 Amazon Pinpoint 분석 데이터 보고를 위한 표준 JSON 스키마를 준수합니다.
즉, 선택한 프로그래밍 언어나 도구를 사용하여 하나 이상의 지표에 대한 데이터를 쿼리하고 각 쿼리의 결과를 캡처한 다음 결과를 테이블, 객체 또는 기타 위치에 쓰는 사용자 지정 솔루션을 구현할 수 있습니다. 그런 다음 다른 서비스 또는 애플리케이션을 사용하여 해당 위치에서 쿼리 결과를 사용할 수 있습니다.
예를 들어, 다음을 수행할 수 있습니다.
+ 정기적으로 지표 집합을 쿼리하고 선호하는 데이터 시각화 프레임워크를 사용하여 결과를 표시하는 사용자 지정 대시보드를 빌드합니다.
+ 적절한 지표를 쿼리하고 차트 또는 사용자가 디자인한 다른 유형의 보고서에 결과를 표시하여 참여율을 추적하는 보고서를 만듭니다.
+ 분석 데이터를 구문 분석하여 특정 스토리지 형식으로 작성한 다음 결과를 장기 스토리지 솔루션으로 포트합니다.
Amazon Pinpoint Analytics API는 나중에 Amazon Pinpoint 프로젝트 또는 Amazon Pinpoint 계정에서 읽거나 사용할 수 있는 영구 객체를 만들거나 저장하도록 설계되지 않았습니다. 대신 API는 분석 데이터를 검색하고 추가 분석, 저장 또는 보고를 위해 해당 데이터를 다른 서비스 및 애플리케이션으로 전송할 수 있도록 설계되었습니다. 애플리케이션 지표, 캠페인 지표 및 여정 참여 지표에 대해 프로그래밍 방식으로 쿼리할 수 있는 모든 분석 데이터에 대해 동일한 JSON 응답 구조 및 스키마를 사용하여 이 작업을 부분적으로 수행합니다.
이 주제에서는 애플리케이션 지표, 캠페인 지표 또는 여정 참여 지표 쿼리에 대한 JSON 응답의 구조, 객체 및 필드에 대해 설명합니다. 여정 실행 지표 또는 여정 활동 실행 지표 쿼리에 대한 JSON 응답의 필드에 대한 자세한 내용은 [Amazon Pinpoint 프로젝트, 캠페인 및 여정에 적용되는 표준 지표](analytics-standard-metrics.md) 단원을 참조하십시오.
## JSON 구조
쿼리 결과를 구문 분석하고 사용하는 데 도움이 되도록 Amazon Pinpoint 분석 API는 애플리케이션 지표, 캠페인 지표 및 여정 참여 지표에 대해 프로그래밍 방식으로 쿼리할 수 있는 모든 Amazon Pinpoint 분석 데이터에 대해 동일한 JSON 응답 구조를 사용합니다. 각 JSON 응답은 프로젝트 ID(`ApplicationId`)와 같이 쿼리를 정의한 값을 지정합니다. 응답에는 단 하나의 `KpiResult` 객체도 포함됩니다. `KpiResult` 객체에는 쿼리에 대한 전체 결과 집합이 포함됩니다.
각 `KpiResult` 객체에는 `Rows` 객체가 포함됩니다. 이는 쿼리 결과 및 해당 결과의 값에 대한 관련 메타데이터가 포함된 객체 배열입니다. `Rows` 객체의 구조와 내용에는 다음과 같은 일반적인 특성이 있습니다.
+ 쿼리 결과의 각 행은 객체에서 이름이 지정된 `Values`, 별도의 JSON `Rows` 객체입니다. 예를 들어 쿼리가 세 개의 값을 반환하는 경우 `Rows` 객체에는 세 개의 `Values` 객체가 포함됩니다. 각 `Values` 객체에는 쿼리에 대한 개별 결과가 포함되어 있습니다.
+ 쿼리 결과의 각 열은 적용되는 `Values` 객체의 속성입니다. 열 이름은 `Values` 객체의 `Key` 필드에 저장됩니다.
+ 그룹화된 쿼리 결과의 경우 각 `Values` 객체에는 연관된 `GroupedBys` 객체가 있습니다. `GroupedBys` 객체는 결과를 그룹화하는 데 사용된 필드를 나타냅니다. 또한 연관된 `Values` 객체의 그룹화 값을 제공합니다.
+ 지표에 대한 쿼리 결과가 null이면 `Rows` 객체는 비어 있습니다.
이러한 일반적인 특성 외에도 `Rows` 객체의 구조와 내용은 지표에 따라 다릅니다. Amazon Pinpoint는 *단일 값 지표*와 *다중 값 지표*라는 두 가지 종류의 지표를 지원하기 때문입니다.
*단일 값 지표*는 하나의 누적 값만 제공합니다. 이러한 예로는 캠페인의 모든 실행에 의해 수신자에게 배달된 메시지의 비율을 들 수 있습니다. *다중 값 지표*는 둘 이상의 값을 제공하고 해당 값을 관련 필드별로 그룹화합니다. 예를 들어 캠페인 실행마다 수신자에게 배달된 메시지의 비율이 캠페인 실행별로 그룹화되어 있습니다.
지표의 이름을 참조하여 지표가 단일 값 지표인지 또는 다중 값 지표인지 신속하게 확인할 수 있습니다. 이름에 `grouped-by`가 포함되어 있지 않으면 단일 값 지표입니다. 포함한다면 다중 값 지표입니다. 프로그래밍 방식으로 쿼리할 수 있는 지표의 전체 목록은 [Amazon Pinpoint 프로젝트, 캠페인 및 여정에 적용되는 표준 지표](analytics-standard-metrics.md) 단원을 참조하십시오.
### 단일 값 지표
단일 값 지표의 경우 `Rows` 객체는 다음과 같은 `Values` 객체를 포함합니다.
+ 쿼리된 지표의 이름을 지정합니다.
+ 쿼리된 지표에 대한 값을 제공합니다.
+ 반환된 값의 데이터 유형을 식별합니다.
예를 들어 다음 JSON 응답에는 단일 값 지표에 대한 쿼리 결과가 포함되어 있습니다. 이 지표는 2019년 8월 1일부터 2019년 8월 31일까지 프로젝트와 연결된 모든 캠페인에 의해 메시지가 배달된 고유한 엔드포인트 수를 보고합니다.
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"1368.0"
}
]
}
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
이 예에서 응답은 모든 프로젝트의 캠페인이 2019년 8월 1일부터 2019년 8월 31일까지 1,368개의 고유한 엔드포인트에 메시지를 배달했음을 나타냅니다.
+ `Key`는 `Value` 필드(`UniqueDeliveries`)에 값이 지정된 지표의 친숙한 이름입니다.
+ `Type`은 `Value` 필드(`Double`) 에 지정된 값의 데이터 유형입니다.
+ `Value`는 적용된 필터를 포함하여 쿼리된 지표의 실제 값입니다(`1368.0`).
단일 값 지표에 대한 쿼리 결과가 null(0보다 크거나 같지 않음)인 경우 `Rows` 객체는 비어 있습니다. Amazon Pinpoint는 어떤 지표에 대해 반환할 데이터가 없을 경우, 해당 지표에 대해 null 값을 반환합니다. 예제:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"2345678901234567890123456example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
### 다중 값 지표
다중 값 지표에 대한 `Rows` 객체의 구조 및 내용은 대부분 단일 값 지표와 동일합니다. 다중 값 지표에 대한 `Rows` 객체에는 `Values` 객체도 포함되어 있습니다. `Values` 객체는 쿼리된 지표의 친숙한 이름을 지정하고 해당 지표에 대한 값을 제공하고 해당 값의 데이터 유형을 식별합니다.
그러나 다중 값 지표에 대한 `Rows` 객체에는 하나 이상의 `GroupedBy` 객체도 포함됩니다. 쿼리 결과에는 각 `Values` 객체에 대해 하나의 `GroupedBy` 객체가 있습니다. `GroupedBy` 객체는 결과의 데이터를 그룹화하는 데 사용된 필드와 해당 필드의 데이터 유형을 나타냅니다. 또한 연관된 `Values` 객체의 해당 필드에 대한 그룹화 값을 나타냅니다.
예를 들어 다음 JSON 응답에는 2019년 8월 1일부터 2019년 8월 31일까지 프로젝트와 연결된 각 캠페인에 대해 메시지가 배달된 고유한 엔드포인트 수를 보고하는 다중 값 지표에 대한 쿼리 결과가 포함되어 있습니다.
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries-grouped-by-campaign",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"80b8efd84042ff8d9c96ce2f8example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"810c7aab86d42fb2b56c8c966example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"456.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"42d8c7eb0990a57ba1d5476a3example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"789.0"
}
]
}
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
이 예에서 응답은 프로젝트 캠페인 중 세 개가 2019년 8월 1일부터 2019년 8월 31일까지 고유한 엔드포인트로 메시지를 배달했음을 나타냅니다. 각 캠페인의 제공 건수 분석은 다음과 같습니다.
+ `80b8efd84042ff8d9c96ce2f8example` 캠페인은 123개의 고유한 엔드포인트에 메시지를 배달했습니다.
+ `810c7aab86d42fb2b56c8c966example` 캠페인은 456개의 고유한 엔드포인트로 메시지를 배달했습니다.
+ `42d8c7eb0990a57ba1d5476a3example` 캠페인은 789개의 고유한 엔드포인트로 메시지를 배달했습니다.
객체 및 필드의 일반적인 구조는 다음과 같습니다.
+ `GroupedBys.Key` - `GroupedBys.Value` 필드(`CampaignId`)에 지정된 그룹화 값을 저장하는 속성 또는 필드의 이름입니다.
+ `GroupedBys.Type` - `GroupedBys.Value` 필드(`String`)에 지정된 값의 데이터 유형입니다.
+ `GroupedBys.Value` - `GroupedBys.Key` 필드(캠페인 ID)에 지정된 대로 데이터를 그룹화하는 데 사용된 필드의 실제 값입니다.
+ `Values.Key` - `Values.Value` 필드(`UniqueDeliveries`)에 값이 지정된 지표의 친숙한 이름입니다.
+ `Values.Type` - `Values.Value` 필드(`Double`)에 지정된 값의 데이터 유형입니다.
+ `Values.Value` - 적용된 필터를 포함하여 쿼리된 지표의 실제 값입니다.
다중 값 지표에 대한 쿼리 결과가 특정 프로젝트, 캠페인 또는 기타 리소스에 대해 null(0보다 크거나 같지 않음)인 경우 Amazon Pinpoint는 리소스에 대한 객체나 필드를 반환하지 않습니다. 다중 값 지표에 대한 쿼리 결과가 모든 리소스에 대해 null인 경우 Amazon Pinpoint는 빈 `Rows` 객체를 반환합니다.
## JSON 객체 및 필드
프로젝트 ID(`ApplicationId`)와 같이 쿼리를 정의한 값을 지정하는 것 외에도 애플리케이션 지표, 캠페인 지표 또는 여정 참여 지표 쿼리에 대한 각 JSON 응답에는 `KpiResult` 객체가 포함됩니다. 이 객체에는 쿼리에 대한 전체 결과 집합이 포함되어 있습니다. 이 결과 집합을 구문 분석하여 분석 데이터를 다른 서비스 또는 애플리케이션으로 보낼 수 있습니다. 각 `KpiResult` 객체에는 지표에 따라 다음과 같은 표준 객체 및 필드 중 일부 또는 전체가 포함됩니다.
| 객체 또는 필드 | 설명 |
| --- | --- |
| Rows | 쿼리에 대한 결과 집합을 포함하는 객체의 배열입니다. |
| Rows.GroupedBys | 다중 값 지표의 경우 쿼리 결과에서 데이터를 그룹화하는 데 사용된 필드 및 값을 정의하는 필드 배열입니다. |
| Rows.GroupedBys.Key | 다중 값 지표의 경우 필드에 지정된 값을 저장하는 속성 또는 GroupedBys.Value 필드의 이름입니다. |
| Rows.GroupedBys.Type | 다중 값 지표의 경우 GroupedBys.Value 필드에 지정된 값의 데이터 유형입니다. |
| Rows.GroupedBys.Value | 다중 값 지표의 경우 쿼리 결과에서 데이터를 그룹화하는 데 사용된 필드의 실제 값입니다. 이 값은 연결된 Values 객체와 연관됩니다. |
| Rows.Values | 쿼리 결과를 포함하는 필드의 배열입니다. |
| Rows.Values.Key | 쿼리된 지표의 이름입니다. 지표의 값은 Values.Value 필드에서 지정됩니다. |
| Rows.Values.Type | Values.Value 필드에 지정된 값의 데이터 유형입니다. |
| Rows.Values.Value | 적용된 필터를 포함하여 쿼리된 지표의 실제 값입니다. |
여정 실행 지표 또는 여정 활동 실행 지표 쿼리에 대한 JSON 응답의 필드에 대한 자세한 내용은 [Amazon Pinpoint 프로젝트, 캠페인 및 여정에 적용되는 표준 지표](analytics-standard-metrics.md) 단원을 참조하십시오.