캠페인에 대한 Amazon Pinpoint 분석 데이터 쿼리

Amazon Pinpoint 콘솔의 분석 페이지를 사용하는 것 외에도 Amazon Pinpoint Analytics API를 사용하여 분석 데이터를 쿼리하여 캠페인의 제공 및 참여 동향에 대한 통찰력을 제공하는 표준 지표의 하위 집합을 제공할 수 있습니다.

이러한 각 지표는 측정 가능한 값으로, KPI(핵심 성과 지표)라고도 하며, 하나 이상의 캠페인 성과를 모니터링하고 평가하는 데 도움이 됩니다. 예를 들어, 지표를 사용하여 캠페인 메시지를 전송한 엔드포인트의 수 또는 의도한 엔드포인트에 배달된 메시지의 수를 확인할 수 있습니다.

Amazon Pinpoint는 모든 캠페인에 대해 이 데이터를 자동으로 수집하고 집계합니다. 데이터는 90일 동안 저장됩니다. Mobile SDK를 사용하여 AWS 모바일 앱을 Amazon Pinpoint와 통합한 경우 Amazon Pinpoint는 수신자가 열어본 푸시 알림의 백분율과 같은 추가 지표를 포함하도록이 지원을 확장합니다. 모바일 앱 통합에 대한 자세한 내용은 Amazon Pinpoint를 애플리케이션과 통합 단원을 참조하십시오.

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 값은 프로젝트, 캠페인 및 여정에 대한 표준 지표 단원을 참조하십시오.

이는 또한 관련 필드로 데이터를 그룹화할지 여부를 결정하는 데 도움이 됩니다. 이 경우 자동으로 데이터를 그룹화하도록 설계된 지표를 선택하여 분석 및 보고를 단순화할 수 있습니다. 예를 들어 Amazon Pinpoint에서는 캠페인 수신자에게 배달된 메시지의 비율을 보고하는 몇 가지 표준 지표를 제공합니다. 이러한 지표 중 하나는 자동으로 데이터를 날짜별(successful-delivery-rate-grouped-by-date)로 그룹화합니다. 다른 지표는 자동으로 데이터를 캠페인 실행별(successful-delivery-rate-grouped-by-campaign-activity)로 그룹화합니다. 세 번째 지표는 단일 값, 즉 모든 캠페인 실행에서 수신자에게 배달된 메시지 비율을 반환합니다(successful-delivery-rate).

원하는 방식으로 데이터를 그룹화하는 표준 지표를 찾을 수 없는 경우 원하는 데이터를 반환하는 일련의 쿼리를 개발할 수 있습니다. 그런 다음 쿼리 결과를 수동으로 분류하거나 디자인 중인 사용자 지정 그룹으로 결합할 수 있습니다.

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