Amazon Pinpoint에서 이벤트 데이터 스트림 이메일 전송 - Amazon Pinpoint
이메일 이벤트 예제이메일 이벤트 속성

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

Amazon Pinpoint에서 이벤트 데이터 스트림 이메일 전송

Amazon Pinpoint를 사용하여 이메일을 보내는 경우 Amazon Pinpoint는 해당 이메일에 대한 이벤트 데이터를 스트리밍할 수 있습니다. 이벤트 스트리밍을 설정한 후 Amazon Pinpoint는 설정 중에 지정한 대상에서 이벤트 데이터를 검색하여 볼 수 있도록 합니다. 이벤트 스트리밍을 설정하는 방법에 대한 자세한 내용은 섹션을 참조하세요 Amazon Kinesis 또는 Amazon Data Firehose를 통해 앱 이벤트 데이터를 스트리밍하도록 Amazon Pinpoint 설정 Amazon Kinesis . Amazon Pinpoint는 이메일 메시지에 대해 다음 유형의 이벤트에 대한 데이터를 스트리밍합니다.

  • 전송

  • 전달

  • 반송 메일

  • 수신 거부

  • 열기

  • 클릭

  • 거부

  • 구독 해지

  • 렌더링 오류

이러한 이벤트 유형은 에 자세히 설명되어 있습니다이메일 이벤트 속성.

이메일 메시지를 보내는 데 사용하는 API 및 설정에 따라 추가 이벤트 유형 또는 다른 데이터가 표시될 수 있습니다. 예를 들어 Amazon Simple Email Service(Amazon SES)에서 제공하는 것과 같이 이벤트 데이터를 Amazon Kinesis 에 게시하는 구성 세트를 사용하여 메시지를 보내는 경우, 데이터에 템플릿 렌더링 실패에 대한 이벤트도 포함될 수 있습니다. 해당 데이터에 대한 자세한 내용은 Amazon Simple Email Service 개발자 안내서의 Amazon SES 이벤트 게시를 사용한 모니터링을 참조하세요. 이벤트를 보려면 먼저 이벤트 스트리밍을 설정해야 합니다. 섹션을 참조하세요 Amazon Kinesis 또는 Amazon Data Firehose를 통해 앱 이벤트 데이터를 스트리밍하도록 Amazon Pinpoint 설정 Amazon Kinesis . 이벤트 스트리밍을 설정할 때 이벤트 데이터를 저장할 대상을 지정한 다음 대상을 사용하여 볼 이벤트 데이터를 검색할 수 있습니다.

이메일 이벤트 예제

이메일 전송

이메일 전송 이벤트의 JSON 객체에는 다음 예제에 표시된 데이터가 포함됩니다.

{
  "event_type": "_email.send",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618622025,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "9a311b17-6f8e-4093-be61-4d0bbexample"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "received"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "send": {}
      }
    }
  }
}
이메일 배달됨

이메일 전송 이벤트의 JSON 객체에는 다음 예제에 표시된 데이터가 포함됩니다.

{
  "event_type": "_email.delivered",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618622690,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "e9a3000d-daa2-40dc-ac47-1cd34example"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "delivered"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "delivery": {
          "smtp_response": "250 ok:  Message 82080542 accepted",
          "reporting_mta": "a8-53.smtp-out.amazonses.com",
          "recipients": ["recipient@example.com"],
          "processing_time_millis": 1310
        }
      }
    }
  }
}
이메일 클릭

이메일 클릭 이벤트의 JSON 객체에는 다음 예제에 표시된 데이터가 포함됩니다.

{
  "event_type": "_email.click",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618713751,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "49c1413e-a69c-46dc-b1c4-6470eexample"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "https://aws.amazon.com/pinpoint/"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }, {
            "name": "Message-ID",
            "value": "null"
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "click": {
          "ip_address": "72.21.198.67",
          "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.1.2 Safari/605.1.15",
          "link": "https://aws.amazon.com/pinpoint/"
        }
      }
    }
  }
}
이메일 열기

이메일 열기 이벤트의 JSON 객체에는 다음 예제에 표시된 데이터가 포함됩니다.

{
  "event_type": "_email.open",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618712316,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "8dc1f651-b3ec-46fc-9b67-2a050example"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "opened"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }, {
            "name": "Message-ID",
            "value": "null"
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "open": {
          "ip_address": "72.21.198.67",
          "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/605.1.15 (KHTML, like Gecko)"
        }
      }
    }
  }
}

이메일 이벤트 속성

이 섹션에서는 이메일 메시지를 보낼 때 Amazon Pinpoint가 생성하는 이벤트 스트림 데이터의 이전 예제에 포함된 속성을 정의합니다.

속성 설명
event_type

이벤트의 유형입니다. 가능한 값은 다음과 같습니다.

  • _email.send – Amazon Pinpoint가 메시지를 수락하고 수신자에게 배달하려고 시도했습니다.

  • _email.delivered – 메시지가 수신자에게 배달되었습니다.

  • _email.rejected – Amazon Pinpoint가 메시지에 맬웨어가 포함되어 있다고 판단하여 전송을 시도하지 않습니다.

  • _email.hardbounce – 영구적인 문제로 인해 Amazon Pinpoint가 메시지를 배달하지 못했습니다. Amazon Pinpoint는 메시지 배달을 다시 시도하지 않습니다.

  • _email.softbounce – 일시적인 문제로 인해 Amazon Pinpoint가 메시지를 배달하지 못했습니다. Amazon Pinpoint는 일정 시간 동안 메시지 배달을 다시 시도합니다. 그래도 메시지를 배달할 수 없는 경우에는 더 이상 재시도하지 않습니다. 그러면 이메일의 최종 상태는 입니다SOFTBOUNCE.

  • _email.complaint – 수신자는 메시지를 받은 다음 이메일 공급자에게 메시지를 스팸으로 보고했습니다(예: 이메일 클라이언트의 "스팸 보고" 기능 사용).

  • _email.open – 수신자가 메시지를 수신하고 열었습니다.

  • _email.click – 수신자가 메시지를 수신하고 메시지에 포함된 링크를 클릭했습니다.

  • _email.unsubscribe – 수신자가 메시지를 수신하고 메시지에 포함된 구독 해지 링크를 클릭했습니다.

  • _email.rendering_failure – 렌더링 실패로 인해 이메일이 전송되지 않았습니다. 이는 템플릿 데이터가 누락되었을 때 또는 템플릿 파라미터와 데이터 사이에 불일치가 있을 때 발생할 수 있습니다.
event_timestamp

메시지가 전송된 시간입니다(밀리초 단위 Unix 시간). 이 값은 일반적으로 메시지에 대해 생성되는 모든 이벤트에 동일합니다.
arrival_timestamp

Amazon Pinpoint에서 이벤트가 수신된 시간입니다(밀리초 단위 Unix 시간).
event_version

이벤트 JSON 스키마의 버전입니다.

작은 정보

스키마 업데이트에 대응하여 언제 애플리케이션을 업데이트해야 하는지 알 수 있도록 이벤트 처리 애플리케이션에서 이 버전을 확인합니다.
application

이벤트와 관련된 Amazon Pinpoint 프로젝트에 대한 정보입니다. 자세한 내용은 애플리케이션 표를 참조하십시오.
client

이벤트를 보고한 디바이스에 설치된 앱 클라이언트에 대한 정보입니다. 자세한 내용은 클라이언트 표를 참조하십시오.
device

이벤트를 보고한 디바이스에 대한 정보입니다. 자세한 내용은 디바이스 표를 참조하십시오.

이메일 이벤트의 경우 이 객체가 비어 있습니다.
session 이메일 이벤트의 경우 이 객체가 비어 있습니다.
attributes

이벤트와 연결된 속성입니다. 자세한 내용은 속성 표를 참조하십시오.

앱 중 하나에서 보고한 이벤트의 경우 이 객체에는 앱에서 정의한 사용자 지정 속성이 포함될 수 있습니다. 캠페인이나 여정에서 메시지를 전송할 때 생성되는 이벤트의 경우, 이 객체에는 캠페인이나 여정과 연결된 속성이 포함됩니다. 트랜잭션 메시지를 전송할 때 생성되는 이벤트의 경우 이 객체에는 메시지 자체와 관련된 정보가 포함됩니다.
client_context 이메일 이벤트의 경우 이 객체에는 custom 객체(legacy_identifier 속성 포함)가 포함됩니다. legacy_identifier 속성 값은 메시지가 전송된 프로젝트의 ID입니다.
facets

메시지에 대한 추가 정보입니다(예: 이메일 헤더). 자세한 내용은 패싯 표를 참조하십시오.
awsAccountId

메시지를 보내는 데 사용된 AWS 계정의 ID입니다.

애플리케이션

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

속성 설명
app_id

이벤트를 보고한 Amazon Pinpoint 프로젝트의 고유 ID입니다.
sdk

이벤트를 보고하는 데 SDK 사용된 . Amazon Pinpoint를 직접 호출하거나 Amazon Amazon Pinpoint 콘솔을 사용하여 트랜잭션 이메일 메시지를 보내는 경우 이 객체는 비어 있습니다. API

속성

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

Campaign

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

속성 설명
feedback

_email.click 이벤트의 경우 이 속성의 값은 수신자가 메시지를 클릭하여 이벤트를 생성한 링크URL의 값입니다. 다른 이벤트의 경우 이 값은 이벤트 유형을 나타냅니다(예:received, opened 또는 clicked).
treatment_id

A/B 테스트 캠페인을 사용하여 메시지를 전송한 경우 이 값은 메시지의 처리 번호를 나타냅니다. 표준 캠페인 및 트랜잭션 이메일 메시지의 경우 이 값은 0입니다.
campaign_activity_id 이벤트가 발생할 때 Amazon Pinpoint에서 생성하는 고유 ID입니다.
campaign_id

메시지를 전송한 캠페인의 고유 ID입니다.

여정

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

속성 설명
journey_run_id 메시지를 보낸 여정 실행의 고유 ID입니다. Amazon Pinpoint는 여정을 새로 실행할 때마다 이 ID를 생성하고 자동으로 할당합니다.
feedback

_email.click 이벤트의 경우 이 속성의 값은 수신자가 메시지를 클릭하여 이벤트를 생성한 링크URL의 값입니다. 다른 이벤트의 경우 이 값은 이벤트 유형을 나타냅니다(예:received, delivered 또는 opened).
journey_id 메시지를 보낸 여정의 고유 ID입니다.
journey_activity_id 메시지를 보낸 여정 활동의 고유 ID입니다.

클라이언트

캠페인 또는 여정의 대상이 된 고객의 고유 식별자입니다.

속성 설명
client_id 클라이언트의 ID입니다. 값은 캠페인 및 여정의 엔드포인트 ID이고 트랜잭션 전송의 경우 입니다UUID.

패싯

메시지 및 이벤트 유형에 대한 정보를 포함합니다.

속성 설명
email_channel

mail_event 객체를 포함하며, 여기에는 두 개의 객체 즉, mail 및 이벤트 유형에 해당하는 객체가 포함됩니다.

Mail

이메일 메시지의 콘텐츠에 대한 정보와 메시지에 대한 메타데이터를 포함합니다.

속성 설명
message_id

메시지의 고유 ID입니다. Amazon Pinpoint는 메시지를 수락할 때 이 ID를 자동으로 생성합니다.
message_send_timestamp

RFC 822에 지정된 형식으로 메시지가 전송된 날짜 및 시간입니다.
from_address

메시지를 전송한 이메일 주소입니다.
destination

메시지를 전송한 이메일 주소가 포함된 배열입니다.
headers_truncated

이메일 헤더가 잘렸는지 여부를 나타내는 Boolean 값입니다.
headers

메시지 헤더에 해당하는 여러 이름-값 쌍을 포함하는 객체입니다. 이 객체는 일반적으로 다음 헤더에 대한 정보를 포함합니다.

  • From - 발신자의 이메일 주소입니다.

  • To - 수신자의 이메일 주소입니다.

  • Subject - 이메일의 제목 줄입니다.

    작은 정보

    캠페인 _email.send 이벤트에는 제목 헤더가 포함되지 않습니다.

  • MIME-Version - 메시지가 MIME 형식임을 나타냅니다. 이 헤더가 있으면 값은 항상 1.0입니다.

  • Content-Type - 메시지 콘텐츠의 MIME 미디어 유형입니다.
common_headers

이메일 메시지의 몇 가지 일반적인 헤더에 대한 정보가 들어 있습니다. 이 정보는 메시지가 전송된 날짜, 메시지 받는 사람, 보낸 사람 및 제목 줄이 포함될 수 있습니다.