**지원 종료 알림:** 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의 캠페인 이벤트 데이터 스트림
<a name="event-streams-data-campaign"></a>

Amazon Pinpoint를 사용하여 채널을 통해 캠페인을 전송하는 경우, Amazon Pinpoint에서 해당 캠페인에 대한 이벤트 데이터를 스트리밍할 수 있습니다. 이벤트 스트리밍을 설정하면 Amazon Pinpoint는 설정 중에 지정한 대상에서 캠페인에서 보내는 이메일 또는 SMS 메시지에 대한 앱의 이벤트 데이터를 검색하여 볼 수 있도록 합니다. 이메일 및 SMS 메시지에 대해 Amazon Pinpoint에서 스트리밍하는 데이터에 대한 자세한 내용은 [Amazon Pinpoint에서 이메일 이벤트 데이터 스트리밍](event-streams-data-email.md) 및 [Amazon Pinpoint의 SMS 이벤트 데이터 스트림](event-streams-data-sms.md) 섹션을 참조하세요. 이벤트 스트리밍 설정 방법에 대한 자세한 내용은 [Amazon Kinesis 또는 Amazon Data Firehose를 통해 앱 이벤트 데이터를 스트리밍하도록 Amazon Pinpoint 설정](event-streams-setup.md) 섹션을 참조하세요.

## 캠페인 이벤트 예제
<a name="event-streams-data-campaign-example"></a>

캠페인 이벤트에 대한 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"
}
```

## 캠페인 이벤트 속성
<a name="event-streams-data-campaign-attributes"></a>

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


| 속성 | 설명 | 
| --- | --- | 
| event\_type | 이벤트의 유형입니다. 가능한 값은 다음과 같습니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/developerguide/event-streams-data-campaign.html) | 
| event\_timestamp | 이벤트가 보고된 시간입니다(밀리초 단위 Unix 시간). | 
| arrival\_timestamp | Amazon Pinpoint에서 이벤트가 수신된 시간입니다(밀리초 단위 Unix 시간). | 
| event\_version | 이벤트 JSON 스키마의 버전입니다. 스키마 업데이트에 대응하여 언제 애플리케이션을 업데이트해야 하는지 알 수 있도록 이벤트 처리 애플리케이션에서 이 버전을 확인합니다.  | 
| application | 이벤트와 관련된 Amazon Pinpoint 프로젝트에 대한 정보입니다. 자세한 내용은 [애플리케이션](#event-streams-data-campaign-attributes-application) 표를 참조하십시오. | 
| client | 이벤트가 연결된 엔드포인트에 대한 정보입니다. 자세한 내용은 [클라이언트](#event-streams-data-campaign-attributes-client) 표를 참조하십시오. | 
| device | 이벤트를 보고한 디바이스에 대한 정보입니다. 캠페인 및 트랜잭션 메시지의 경우 이 객체가 비어 있습니다. | 
| session | 이벤트를 생성한 세션에 대한 정보입니다. 캠페인의 경우 이 객체가 비어 있습니다. | 
| attributes | 이벤트와 연결된 속성입니다. 앱 중 하나에서 보고한 이벤트의 경우 이 객체에는 앱에서 정의한 사용자 지정 속성이 포함될 수 있습니다. 캠페인을 전송할 때 생성되는 이벤트의 경우 이 객체에는 캠페인과 연결된 속성이 포함됩니다. 트랜잭션 메시지를 전송할 때 생성되는 이벤트의 경우 이 객체에는 메시지 자체와 관련된 정보가 포함됩니다.<br />자세한 내용은 [속성](#event-streams-data-campaign-attributes-attrs) 표를 참조하십시오. | 
| client\_context | endpoint 속성을 포함하는 custom 객체를 포함합니다. endpoint 속성에는 캠페인이 전송된 엔드포인트에 대한 엔드포인트 레코드의 콘텐츠가 포함됩니다. | 
| awsAccountId | 메시지를 보내는 데 사용된 AWS 계정의 ID입니다. | 

### 애플리케이션
<a name="event-streams-data-campaign-attributes-application"></a>

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


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

### 속성
<a name="event-streams-data-campaign-attributes-attrs"></a>

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


| 속성 | 설명 | 
| --- | --- | 
| treatment\_id | A/B 테스트 캠페인을 사용하여 메시지를 전송한 경우 이 값은 메시지의 처리 번호를 나타냅니다. 표준 캠페인의 경우 이 값은 `0`입니다. | 
| campaign\_activity\_id | 이벤트가 발생할 때 Amazon Pinpoint에서 생성하는 고유 ID입니다. | 
| delivery\_type | 캠페인의 전송 방법입니다. 이 속성을 `client_context`의 `endpoint` 속성에 지정된 `ChannelType` 필드와 혼동하지 않도록 합니다. `ChannelType` 필드는 일반적으로 메시지가 전송되는 엔드포인트를 기반으로 합니다.<br />엔드포인트 유형을 하나만 지원하는 채널의 경우 `delivery_type` 및 `ChannelType` 필드의 값이 동일합니다. 예를 들어, 이메일 채널의 경우 `delivery_type` 및 `ChannelType` 필드는 EMAIL 값이 동일합니다.<br />하지만 사용자 지정 채널과 같이 다양한 엔드포인트 유형을 지원하는 채널의 경우, 이 조건이 항상 적용되는 것은 아닙니다. EMAIL, SMS, CUSTOM 등과 같은 다양한 엔드포인트에 사용자 지정 채널을 사용할 수 있습니다. 이 경우 `delivery_type`은 사용자 지정 배달 이벤트인 CUSTOM을 식별하고, `ChannelType`은 캠페인이 전송된 엔드포인트 유형(예: EMAIL, SMS, CUSTOM 등)을 지정합니다. 사용자 지정 채널 생성에 대한 자세한 정보는 [웹후크 또는 Lambda 함수를 사용하여 Amazon Pinpoint에서 사용자 지정 채널 생성](channels-custom.md) 섹션을 참조하세요.<br />가능한 값은 다음과 같습니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/developerguide/event-streams-data-campaign.html) | 
| campaign\_id | 메시지를 전송한 캠페인의 고유 ID입니다. | 
| campaign\_send\_status | 대상 엔드포인트에 대한 캠페인 상태를 나타냅니다. 가능한 값은 다음과 같습니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/developerguide/event-streams-data-campaign.html)  | 

### 클라이언트
<a name="event-streams-data-campaign-attributes-client"></a>

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


| 속성 | 설명 | 
| --- | --- | 
| client\_id | 캠페인이 전송된 엔드포인트의 ID입니다. |