3단계: 추가 요청 전송 - Amazon Pinpoint

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

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

  1. 환경 메뉴에서 프로젝트를 AWS 리전 만들려는 프로젝트를 선택합니다.

    사용 가능한 리전을 보여주는 환경 메뉴가 열려 있습니다.

    이 예제에서는 환경 메뉴에 다음 네 가지 옵션이 표시되도록 Postman이 구성되었습니다.

    • 미국 동부(버지니아 북부)

    • 미국 서부(오리건)

    • 유럽(프랑크푸르트)

    • 유럽(아일랜드)

  2. Apps 폴더에서 CreateApp작업>을 선택합니다.

    Amazon Pinpoint Postman 컬렉션의 Apps 폴더입니다.

    Amazon Pinpoint Postman 컬렉션의 Apps 폴더가 확장되어 다음과 같은 요청이 표시됩니다.

    • GetApp

    • GetApps

    • CreateApp

    • DeleteApp

  3. 본문 탭의 "Name" 옆에서 자리 표시자 값("string")을 캠페인 이름(예: "MySampleProject")으로 바꿉니다.

  4. 캠페인 이름 뒤의 쉼표를 삭제한 다음 3행부터 5행까지 전체 tags 객체를 삭제합니다 완료되면 요청은 다음 이미지에 표시된 코드 조각과 비슷하게 됩니다.

    {
    "Name": "MySampleProject"
}

    Postman은 요청을 원시 JSON 페이로드로 전송하도록 구성됩니다.

  5. 전송를 선택합니다. 캠페인이 성공적으로 생성되면 응답 창에 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

  1. 프로젝트에 이메일 채널이 활성화되어 있고 메시지를 보내고 받는 데 사용할 이메일 주소 또는 도메인이 구성되어 있는지 확인하세요. 자세한 내용은 Amazon Pinpoint 사용 설명서의 이메일 채널 활성화 및 비활성화 및 이메일 ID 확인을 참조하세요.

    참고

    이 단원의 절차를 완료하려면 이메일 주소를 확인해야 합니다.

  2. 환경 메뉴에서 메시지를 AWS 리전 보내려는 대상을 선택합니다.

    이 예제에서는 환경 메뉴에 다음 네 가지 옵션이 표시되도록 Postman이 구성되었습니다.

    • 미국 동부(버지니아 북부)

    • 미국 서부(오리건)

    • 유럽(프랑크푸르트)

    • 유럽(아일랜드)

  3. 메시지 폴더에서 SendMessages작업을 선택합니다.

    Amazon Pinpoint Postman 컬렉션의 Messages 폴더입니다. 폴더 내용이 확장되고 SendMessages 및 SendUsersMessages 요청이 표시됩니다.

  4. 요청 전 스크립트 탭에서 projectId 변수의 값을 이 단원의 2단계에서 선택한 리전에 이미 있는 프로젝트의 ID로 바꿉니다.

  5. 본문 탭에서 요청 편집기에 표시된 예제 요청을 삭제합니다. 다음 코드를 붙여넣습니다.

    {
    "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"
        }
    }
}

  6. 이전의 코드에서 sender@example.com을 자신의 확인된 이메일 주소로 바꿉니다. recipient@example.com을 메시지를 전송하려는 확인된 이메일 주소로 바꿉니다.

    참고

    계정이 여전히 Amazon Pinpoint 이메일 샌드박스에 있는 경우 Amazon Pinpoint 계정에서 확인된 이메일 주소 또는 도메인으로만 이메일을 전송할 수 있습니다. 샌드박스에서 계정을 제거하는 방법에 대한 자세한 내용은 Amazon Pinpoint 사용 설명서의 이메일에 대한 프로덕션 액세스 요청을 참조하세요.

  7. 전송를 선택합니다. 메시지가 성공적으로 전송되면 응답 창에 200 OK 상태가 표시됩니다.

    {
    "ApplicationId": "12345678901234567890123456789012",
    "RequestId": "<sampleValue>",
    "Result": {
        "recipient@example.com": {
            "DeliveryStatus": "SUCCESSFUL",
            "StatusCode": 200,
            "StatusMessage": "<sampleValue>",
            "MessageId": "<sampleValue>"
        }
    }
}