

**지원 종료 알림:** 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에서 추천 모델 사용 AWS Lambda
<a name="ml-models-rm-lambda"></a>

Amazon Pinpoint에서는 추천 모델에서 맞춤형 추천을 검색하여 캠페인 및 여정에서 보내는 메시지에 추가할 수 있습니다. *추천 모델*은 데이터에서 패턴을 찾고 찾은 패턴을 기반으로 예측 및 추천을 생성하는 기계 학습(ML) 모델의 한 유형입니다. 특정 사용자가 특정 제품 또는 항목 집합에서 선호할 것을 예측하고, 해당 정보를 사용자에게 추천 집합으로 제공합니다.

Amazon Pinpoint에서 추천 모델을 사용하면 각 수신자의 속성 및 동작에 따라 메시지 수신자에게 맞춤형 추천을 보낼 수 있습니다. 를 사용하면 이러한 권장 사항을 사용자 지정하고 개선할 수도 AWS Lambda있습니다. 예를 들어 추천을 단일 텍스트 값(예: 제품 이름 또는 ID)에서 보다 정교한 콘텐트(예: 제품 이름, 설명 및 이미지)로 동적으로 변환할 수 있습니다. 또한 Amazon Pinpoint에서 메시지를 보낼 때 실시간으로 이를 수행할 수 있습니다.

이 기능은 미국 동부(버지니아 북부), 미국 서부(오레곤), 아시아 태평양(뭄바이), 아시아 태평양(시드니), 유럽(아일랜드) AWS 리전에서 사용할 수 있습니다.

## AWS CLI 및 Lambda add-permission 명령을 사용하여 Amazon Pinpoint가 Lambda 함수를 호출하도록 권한 부여
<a name="ml-models-rm-lambda-trust-policy-assign"></a>

Lambda 함수 정책을 함수에 할당한 후 Amazon Pinpoint에서 특정 프로젝트, 캠페인 또는 여정에 대해 함수를 간접적으로 호출할 수 있도록 하는 권한을 추가할 수 있습니다. AWS Command Line Interface (AWS CLI) 및 Lambda [https://docs.aws.amazon.com/cli/latest/reference/lambda/add-permission.html](https://docs.aws.amazon.com/cli/latest/reference/lambda/add-permission.html) 명령을 사용하여이 작업을 수행할 수 있습니다. 다음 예제에서는 특정 프로젝트({{projectId}})에 대해 이 작업을 수행하는 방법을 보여 줍니다.

```
$ aws lambda add-permission \
--function-name {{function-name}} \
--statement-id {{sid}} \
--action lambda:InvokeFunction \
--principal pinpoint.us-east-1.amazonaws.com \
--source-arn arn:aws:mobiletargeting:us-east-1:{{accountId}}:recommenders/*
```

앞의 예제는 Unix, Linux, macOS용 형식으로 지정된 예제입니다. Microsoft Windows의 경우 백슬래시(\\) 줄 연속 문자를 캐럿(^)으로 바꿉니다.

이 명령이 제대로 실행되면 다음과 비슷한 출력이 표시됩니다.

```
{
  "Statement": "{\"Sid\":\"sid\",
    \"Effect\":\"Allow\",
    \"Principal\":{\"Service\":\"pinpoint.us-east-1.amazonaws.com\"},
    \"Action\":\"lambda:InvokeFunction\",
    \"Resource\":\"arn:aws:lambda:us-east-1:111122223333:function:function-name\",
    \"Condition\":
      {\"ArnLike\":
        {\"AWS:SourceArn\":
         \"arn:aws:mobiletargeting:us-east-1:111122223333:recommenders/*\"}}}"
}
```

`Statement` 값은 Lambda 함수 정책에 추가된 문의 JSON 문자열 버전입니다.

## 추천자 모델에 대한 Lambda 함수를 간접적으로 호출하도록 Amazon Pinpoint 구성
<a name="ml-models-rm-lambda-configure"></a>

추천 모델에 대한 Lambda 함수를 간접적으로 호출하도록 Amazon Pinpoint를 구성하려면 모델에 대해 다음과 같은 Lambda 관련 구성 설정을 지정합니다.
+ `RecommendationTransformerUri` - 이 속성은 Lambda 함수의 이름 또는 Amazon 리소스 이름(ARN)을 지정합니다.
+ `Attributes` - 이 객체는 함수가 각 엔드포인트 정의에 추가하는 사용자 지정 추천 속성을 정의하는 맵입니다. 이러한 각 속성은 메시지 템플릿에서 메시지 변수로 사용할 수 있습니다.

Amazon Pinpoint API의 [추천 모델](https://docs.aws.amazon.com/pinpoint/latest/apireference/recommenders.html) 리소스(모델에 대한 구성을 생성할 경우) 또는 Amazon Pinpoint API의 [추천 모델](https://docs.aws.amazon.com/pinpoint/latest/apireference/recommenders-recommender-id.html) 모델 리소스(모델의 구성을 업데이트할 경우)를 사용하여 이러한 설정을 지정할 수 있습니다. Amazon Pinpoint 콘솔을 사용하여 이러한 설정을 정의할 수도 있습니다.

Amazon Pinpoint에서 추천 모델을 사용하는 방법에 대한 자세한 내용은 *Amazon Pinpoint 사용 설명서*의 [기계 학습 모델](https://docs.aws.amazon.com/pinpoint/latest/userguide/ml-models.html) 섹션을 참조하세요.