Amazon Pinpoint의 캠페인 이벤트 데이터 스트림

Amazon Pinpoint를 사용하여 채널을 통해 캠페인을 전송하는 경우 Amazon Pinpoint는 해당 캠페인에 대한 이벤트 데이터를 스트리밍할 수 있습니다. 이벤트 스트리밍을 설정한 후 Amazon Pinpoint는 설정 중에 지정한 대상에서 캠페인에서 보낸 이메일 또는 SMS 메시지에 대한 앱의 이벤트 데이터를 검색합니다. Amazon Pinpoint가 이메일 및 SMS 메시지를 위해 스트리밍하는 데이터에 대한 자세한 내용은 Amazon Pinpoint에서 이벤트 데이터 스트림 이메일 전송 및 섹션을 참조하세요SMS Amazon Pinpoint의 이벤트 데이터 스트림. 이벤트 스트리밍을 설정하는 방법에 대한 자세한 내용은 섹션을 참조하세요 Amazon Kinesis 또는 Amazon Data Firehose를 통해 앱 이벤트 데이터를 스트리밍하도록 Amazon Pinpoint 설정 Amazon Kinesis .

캠페인 이벤트 예제

캠페인 이벤트의 JSON 객체에는 다음 예제에 표시된 데이터가 포함됩니다.

{
  "event_type": "_campaign.send",
  "event_timestamp": 1562109497426,
  "arrival_timestamp": 1562109497494,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "d8dcf7c5-e81a-48ae-8313-f540cexample"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "treatment_id": "0",
    "campaign_activity_id": "5473285727f04865bc673e527example",
    "delivery_type": "GCM",
    "campaign_id": "4f8d6097c2e8400fa3081d875example",
    "campaign_send_status": "SUCCESS"
  },
  "client_context": {
    "custom": {
      "endpoint": "{\"ChannelType\":\"GCM\",\"EndpointStatus\":\"ACTIVE\",
          ↳\"OptOut\":\"NONE\",\"RequestId\":\"ec229696-9d1e-11e9-8bf1-85d0aexample\",
          ↳\"EffectiveDate\":\"2019-07-02T23:12:54.836Z\",\"User\":{}}"
    }
  },
  "awsAccountId": "123456789012"
}

캠페인 이벤트 속성

이 단원에서는 캠페인 이벤트 스트림에 포함된 속성을 정의합니다.

속성	설명
event_type	이벤트의 유형입니다. 가능한 값은 다음과 같습니다. _campaign.send – Amazon Pinpoint가 캠페인을 실행했습니다. _campaign.opened_notification – 푸시 알림 캠페인의 경우 이 이벤트 유형은 수신자가 알림을 탭하여 열었음을 나타냅니다. _campaign.received_foreground – 푸시 알림 캠페인의 경우 이 이벤트 유형은 수신자가 포그라운드 알림으로 메시지를 수신했음을 나타냅니다. _campaign.received_background – 푸시 알림 캠페인의 경우 이 이벤트 유형은 수신자가 백그라운드 알림으로 메시지를 수신했음을 나타냅니다. 참고 _campaign.opened_notification, _campaign.received_foreground, _campaign.received_background는 AWS Amplify를 사용하는 경우에만 반환됩니다. 앱을 와 통합하는 방법에 대한 자세한 내용을 알아보세요 AWS Amplify. Amplify를 사용하여 AWS 프런트엔드 애플리케이션을 Amazon Pinpoint에 연결을 참조하세요.
event_timestamp	이벤트가 보고된 시간입니다(밀리초 단위 Unix 시간).
arrival_timestamp	Amazon Pinpoint에서 이벤트가 수신된 시간입니다(밀리초 단위 Unix 시간).
event_version	이벤트 JSON 스키마의 버전입니다. 작은 정보 스키마 업데이트에 대응하여 언제 애플리케이션을 업데이트해야 하는지 알 수 있도록 이벤트 처리 애플리케이션에서 이 버전을 확인합니다.
application	이벤트와 관련된 Amazon Pinpoint 프로젝트에 대한 정보입니다. 자세한 내용은 애플리케이션 표를 참조하십시오.
client	이벤트가 연결된 엔드포인트에 대한 정보입니다. 자세한 내용은 클라이언트 표를 참조하십시오.
device	이벤트를 보고한 디바이스에 대한 정보입니다. 캠페인 및 트랜잭션 메시지의 경우 이 객체가 비어 있습니다.
session	이벤트를 생성한 세션에 대한 정보입니다. 캠페인의 경우 이 객체가 비어 있습니다.
attributes	이벤트와 연결된 속성입니다. 앱 중 하나에서 보고한 이벤트의 경우 이 객체에는 앱에서 정의한 사용자 지정 속성이 포함될 수 있습니다. 캠페인을 전송할 때 생성되는 이벤트의 경우 이 객체에는 캠페인과 연결된 속성이 포함됩니다. 트랜잭션 메시지를 전송할 때 생성되는 이벤트의 경우 이 객체에는 메시지 자체와 관련된 정보가 포함됩니다. 자세한 내용은 속성 표를 참조하십시오.
client_context	endpoint 속성을 포함하는 custom 객체를 포함합니다. endpoint 속성에는 캠페인이 전송된 엔드포인트에 대한 엔드포인트 레코드의 콘텐츠가 포함됩니다.
awsAccountId	메시지를 보내는 데 사용된 AWS 계정의 ID입니다.

애플리케이션

이벤트가 연결된 Amazon Pinpoint 프로젝트에 대한 정보를 포함합니다.

속성	설명
app_id	이벤트를 보고한 Amazon Pinpoint 프로젝트의 고유 ID입니다.
sdk	이벤트를 보고하는 데 SDK 사용된 .

속성

이벤트를 생성한 캠페인에 대한 정보를 포함합니다.

속성	설명
treatment_id	A/B 테스트 캠페인을 사용하여 메시지를 전송한 경우 이 값은 메시지의 처리 번호를 나타냅니다. 표준 캠페인의 경우 이 값은 0입니다.
campaign_activity_id	이벤트가 발생할 때 Amazon Pinpoint에서 생성하는 고유 ID입니다.
delivery_type	캠페인의 전송 방법입니다. 이 속성을 client_context의 endpoint 속성에 지정된 ChannelType 필드와 혼동하지 않도록 합니다. ChannelType 필드는 일반적으로 메시지가 전송되는 엔드포인트를 기반으로 합니다. 엔드포인트 유형을 하나만 지원하는 채널의 경우 delivery_type 및 ChannelType 필드의 값이 동일합니다. 예를 들어 이메일 채널의 경우 delivery_type 및 ChannelType 필드의 값은 와 동일합니다EMAIL. 하지만 사용자 지정 채널과 같이 다양한 엔드포인트 유형을 지원하는 채널의 경우, 이 조건이 항상 적용되는 것은 아닙니다. , EMAIL, 등과 같은 다양한 엔드포인트에 사용자 지정 채널을 사용할 수 있습니다SMSCUSTOM. 이 경우 는 사용자 지정 전송 이벤트인 CUSTOM를 delivery_type 식별하고, 는 캠페인이 전송된 엔드포인트의 유형을 , EMAILSMSCUSTOM, 등과 같이 ChannelType 지정합니다. 사용자 지정 채널 생성에 대한 자세한 정보는 웹후크 또는 Lambda 함수를 사용하여 Amazon Pinpoint에서 사용자 지정 채널 생성 섹션을 참조하세요. 가능한 값은 다음과 같습니다. EMAIL SMS ADM APNS APNS_SANDBOX APNS_VOIP APNS_VOIP_SANDBOX VOICE GCM BAIDU PUSH CUSTOM
campaign_id	메시지를 전송한 캠페인의 고유 ID입니다.
campaign_send_status	대상 엔드포인트에 대한 캠페인 상태를 나타냅니다. 가능한 값은 다음과 같습니다. SUCCESS - 캠페인이 엔드포인트로 성공적으로 전송되었습니다. FAILURE - 캠페인이 엔드포인트로 전송되지 않았습니다. DAILY_CAP – 최대 일일 메시지 수가 이미 엔드포인트로 전송되었으므로 캠페인이 엔드포인트로 전송되지 않았습니다. EXPIRED - 캠페인을 보내는 것이 캠페인의 최대 기간 또는 전송 속도 설정을 초과하기 때문에 캠페인이 엔드포인트로 전송되지 않았습니다. QUIET_TIME – 조용한 시간 제한으로 인해 캠페인이 엔드포인트로 전송되지 않았습니다. HOLDOUT - 엔드포인트가 홀드아웃 그룹의 멤버였기 때문에 캠페인이 엔드포인트로 전송되지 않았습니다. DUPLICATE_ADDRESS – 세그먼트에 중복된 엔드포인트 주소가 있습니다. 캠페인이 엔드포인트 주소로 한 번 전송되었습니다. QUIET_TIME – 조용한 시간 제한으로 인해 캠페인이 엔드포인트로 전송되지 않았습니다. CAMPAIGN_CAP – 이 캠페인에서 엔드포인트로 최대 메시지 수가 이미 전송되었으므로 캠페인이 엔드포인트로 전송되지 않았습니다. FAILURE_PERMANENT – 엔드포인트로 전송할 때 영구 장애가 발생했습니다. TRANSIENT_FAILURE – 엔드포인트로 전송할 때 일시적인 오류가 발생했습니다. THROTTLED – 전송이 제한되었습니다. UNKNOWN – 알 수 없는 실패. HOOK_FAILURE – 캠페인 후크 실패. CUSTOM_DELIVERY_FAILURE - 사용자 지정 전송에 실패했습니다. RECOMMENDATION_FAILURE – 추천에 실패했습니다. UNSUPPORTED_CHANNEL – 채널은 지원되지 않습니다.

클라이언트

캠페인의 대상이 된 엔드포인트에 대한 정보를 포함합니다.

속성	설명
client_id	캠페인이 전송된 엔드포인트의 ID입니다.