기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
3단계: 추가 요청 전송
Postman 구성 및 테스트가 완료되면 Amazon Pinpoint API로 추가 요청 전송을 시작할 수 있습니다. 이 단원에는 요청 전송을 시작하기 전에 알아야 할 정보가 들어 있습니다. 또한 Amazon Pinpoint 컬렉션을 사용하는 방법을 설명하는 두 개의 샘플 요청도 포함되어 있습니다.
중요
이 단원의 절차를 완료하면 요청을 Amazon Pinpoint API에 제출합니다. 이러한 요청은 Amazon Pinpoint 계정에서 새 리소스 생성, 기존 리소스 수정, 메시지 전송, Amazon Pinpoint 프로젝트의 구성 변경, 기타 Amazon Pinpoint 기능 사용 등의 작업을 수행할 수 있습니다. 이러한 요청을 실행할 때는 주의하세요.
Amazon Pinpoint Postman 컬렉션을 사용하기 전에 이러한 컬렉션에서 대부분의 작업을 구성해야 합니다. GET
및 DELETE
작업의 경우 일반적으로 요청 전 스크립트 탭에서 설정된 변수만 수정하면 됩니다.
참고
IAM 정책 생성에 나와 있는 IAM 정책을 사용하면 이 컬렉션에 포함된 DELETE
요청을 수행할 수 없습니다.
예를 들어 GetCampaign
작업을 수행하려면 projectId
와 campaignId
를 지정해야 합니다. 요청 전 스크립트 탭에 이러한 변수가 모두 있으며 예제 값으로 채워져 있습니다. 예제 값을 삭제하고 Amazon Pinpoint 프로젝트 및 캠페인에 적절한 값으로 바꿉니다.
이러한 변수 중에서 가장 일반적으로 사용되는 변수가 projectId
변수입니다. 이 변수의 값은 요청이 적용되는 프로젝트의 고유 식별자여야 합니다. 프로젝트에 대한 이러한 식별자 목록을 보려면 이 자습서의 이전 단계에서 보낸 GetApps
요청에 대한 응답을 참조하세요. 이 응답에서 Id
필드는 프로젝트의 고유 식별자를 제공합니다. GetApps
작동 및 응답 내 각 필드의 의미에 대해 자세히 알아보려면 Amazon Pinpoint API 참조의 앱을 참조하세요.
참고
Amazon Pinpoint에서 ‘프로젝트’는 ‘앱’ 또는 ‘애플리케이션’과 동일합니다.
또한 POST
및 PUT
작업의 경우 API에 전송하려는 값을 포함하도록 요청도 수정해야 합니다. 예를 들어 CreateApp
요청(POST
요청)을 제출할 때, 생성하는 프로젝트의 이름을 지정해야 합니다. 본문 탭에서 요청을 수정할 수 있습니다. 이 예제에서는 "Name"
옆의 값을 프로젝트 이름으로 바꿉니다. 태그를 프로젝트에 추가하려는 경우 tags
객체에서 태그를 지정할 수 있습니다. 또는 태그를 추가하지 않으려는 경우 전체 tags
객체를 삭제할 수 있습니다.
참고
UntagResource
작업을 수행하려면 URL 파라미터도 지정해야 합니다. 파라미터 탭에서 이러한 파라미터를 지정할 수 있습니다. VALUE 열의 값을 지정된 리소스에 대해 삭제하려는 태그로 바꿉니다.
Amazon Pinpoint에서 세그먼트와 캠페인을 생성하기 전에 먼저 프로젝트를 생성해야 합니다. Amazon Pinpoint에서 프로젝트는 공통 목적으로 통합된 세그먼트, 캠페인, 구성 및 데이터로 구성되어 있습니다. 예를 들어 프로젝트를 사용하여 특정 앱이나 특정 브랜드 또는 마케팅 이니셔티브와 관련된 모든 콘텐츠를 포함시킬 수 있습니다. Amazon Pinpoint에 고객 정보를 추가하면 해당 정보가 프로젝트와 연결됩니다.
API 요청을 전송하여 프로젝트를 생성하려면 CreateApp
-
환경 메뉴에서 프로젝트를 AWS 리전 만들려는 프로젝트를 선택합니다.
이 예제에서는 환경 메뉴에 다음 네 가지 옵션이 표시되도록 Postman이 구성되었습니다.
-
미국 동부(버지니아 북부)
-
미국 서부(오리건)
-
유럽(프랑크푸르트)
-
유럽(아일랜드)
-
-
Apps 폴더에서 CreateApp작업>을 선택합니다.
Amazon Pinpoint Postman 컬렉션의 Apps 폴더가 확장되어 다음과 같은 요청이 표시됩니다.
-
GetApp
-
GetApps
-
CreateApp
-
DeleteApp
-
-
본문 탭의
"Name"
옆에서 자리 표시자 값("string"
)을 캠페인 이름(예:"MySampleProject"
)으로 바꿉니다. -
캠페인 이름 뒤의 쉼표를 삭제한 다음 3행부터 5행까지 전체
tags
객체를 삭제합니다 완료되면 요청은 다음 이미지에 표시된 코드 조각과 비슷하게 됩니다.{ "Name": "MySampleProject" }
Postman은 요청을 원시 JSON 페이로드로 전송하도록 구성됩니다.
-
전송를 선택합니다. 캠페인이 성공적으로 생성되면 응답 창에
201 Created
상태가 표시됩니다.{ "Name": "MySampleProject" "Id": "12345678901234567890123456789012", "Arn": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/12345678901234567890123456789012", "tags": {} }
Amazon Pinpoint SendMessages
API를 사용하여 트랜잭션 메시지를 전송하는 것은 매우 일반적입니다. SendMessages
API를 사용하여 메시지를 전송하는 장점(캠페인 생성과 비교 시) 중 하나는 메시지를 어떤 주소로든(예: 이메일 주소, 전화 번호 또는 디바이스 토큰) 전송할 수 있다는 것입니다. 메시지를 보내는 주소가 Amazon Pinpoint 계정에 이미 존재할 필요는 없습니다 이 방법을 캠페인을 생성하여 메시지를 전송하는 방법과 비교해 보겠습니다 Amazon Pinpoint에서 캠페인을 보내려면 먼저 Amazon Pinpoint 계정에 엔드포인트를 추가하고, 세그먼트를 생성하고, 캠페인을 생성하고, 캠페인을 실행해야 합니다.
이 단원의 예제에서는 특정 이메일 주소로 트랜잭션 이메일 메시지를 직접 전송하는 방법을 보여 줍니다. SMS, 모바일 푸시 또는 음성과 같은 다른 채널을 통해 메시지를 전송하도록 이 요청을 수정할 수 있습니다.
요청을 제출하여 이메일 메시지를 보내려면 SendMessages
-
프로젝트에 이메일 채널이 활성화되어 있고 메시지를 보내고 받는 데 사용할 이메일 주소 또는 도메인이 구성되어 있는지 확인하세요. 자세한 내용은 Amazon Pinpoint 사용 설명서의 이메일 채널 활성화 및 비활성화 및 이메일 ID 확인을 참조하세요.
참고
이 단원의 절차를 완료하려면 이메일 주소를 확인해야 합니다.
-
환경 메뉴에서 메시지를 AWS 리전 보내려는 대상을 선택합니다.
이 예제에서는 환경 메뉴에 다음 네 가지 옵션이 표시되도록 Postman이 구성되었습니다.
-
미국 동부(버지니아 북부)
-
미국 서부(오리건)
-
유럽(프랑크푸르트)
-
유럽(아일랜드)
-
-
메시지 폴더에서 SendMessages작업을 선택합니다.
-
요청 전 스크립트 탭에서
projectId
변수의 값을 이 단원의 2단계에서 선택한 리전에 이미 있는 프로젝트의 ID로 바꿉니다. -
본문 탭에서 요청 편집기에 표시된 예제 요청을 삭제합니다. 다음 코드를 붙여넣습니다.
{ "MessageConfiguration":{ "EmailMessage":{ "FromAddress":"
sender@example.com
", "SimpleEmail":{ "Subject":{ "Data":"Sample Amazon Pinpoint message" }, "HtmlPart":{ "Data":"<h1>Test message</h1><p>This is a sample message sent from <a href=\"https://aws.amazon.com/pinpoint\">Amazon Pinpoint</a> using the SendMessages API.</p>" }, "TextPart":{ "Data":"This is a sample message sent from Amazon Pinpoint using the SendMessages API." } } } }, "Addresses":{ "recipient@example.com
": { "ChannelType": "EMAIL" } } } -
이전의 코드에서
sender@example.com
을 자신의 확인된 이메일 주소로 바꿉니다.recipient@example.com
을 메시지를 전송하려는 확인된 이메일 주소로 바꿉니다.참고
계정이 여전히 Amazon Pinpoint 이메일 샌드박스에 있는 경우 Amazon Pinpoint 계정에서 확인된 이메일 주소 또는 도메인으로만 이메일을 전송할 수 있습니다. 샌드박스에서 계정을 제거하는 방법에 대한 자세한 내용은 Amazon Pinpoint 사용 설명서의 이메일에 대한 프로덕션 액세스 요청을 참조하세요.
-
전송를 선택합니다. 메시지가 성공적으로 전송되면 응답 창에
200 OK
상태가 표시됩니다.{ "ApplicationId": "12345678901234567890123456789012", "RequestId": "<sampleValue>", "Result": { "recipient@example.com": { "DeliveryStatus": "SUCCESSFUL", "StatusCode": 200, "StatusMessage": "<sampleValue>", "MessageId": "<sampleValue>" } } }