기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 캠페인을 사용하여 Amazon Personalize 솔루션 버전 배포
사용자 지정 리소스가 포함된 실시간 추천의 경우, [솔루션 버전 수동 생성](creating-a-solution-version.md)을 완료하고 나면 캠페인과 함께 솔루션 버전을 배포할 준비가 된 것입니다.
캠페인에서는 프로비저닝 트랜잭션 용량이 포함된 솔루션 버전(학습된 모델)을 배포하여 실시간 추천을 생성합니다.** 캠페인을 생성한 후 [GetRecommendations](API_RS_GetRecommendations.md)또는 [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md)API 작업을 사용하여 추천을 얻을 수 있습니다. 배치 항목 추천 또는 사용자 세그먼트를 받는 경우, 캠페인을 생성할 필요가 없습니다. 자세한 내용은 [배치 항목 추천 받기](getting-batch-recommendations.md) 또는 [배치 사용자 세그먼트 가져오기](getting-user-segments.md)을 참조하세요.
캠페인을 생성할 때 다음을 구성할 수 있습니다.
+ 솔루션의 최신 솔루션 버전을 사용하도록 캠페인을 자동으로 업데이트하도록 구성할 수 있습니다. 자세한 내용은 [자동 캠페인 업데이트](#create-campaign-automatic-latest-sv-update)을 참조하세요.
+ 추천에서 항목 메타데이터를 활성화할 수 있습니다. 자세한 내용은 [추천에서 항목 메타데이터](#create-campaign-return-metadata) 섹션을 참조하세요.
+ 캠페인에 대해 초당 프로비저닝된 최소 트랜잭션을 지정할 수 있습니다. 이는 Amazon Personalize에서 프로비저닝한 캠페인의 기준 트랜잭션 처리량입니다. 캠페인이 활성 상태일 때의 최소 청구 요금을 설정합니다. 자세한 내용은 [초당 최소 프로비저닝 트랜잭션 수 및 자동 스케일링](#min-tps-auto-scaling) 섹션을 참조하세요.
Amazon Personalize 콘솔, AWS Command Line Interface(AWS CLI) 또는 AWS SDK를 사용하여 캠페인을 생성할 수 있습니다. 기존 캠페인의 설정을 변경하려면(예: 추천에서 메타데이터 활성화) 캠페인을 업데이트해야 합니다. 자세한 내용은 [Amazon Personalize 캠페인의 구성 업데이트](update-campaigns.md) 섹션을 참조하세요.
캠페인이 활성화되어 있는 동안 캠페인 비용이 발생합니다. 불필요한 비용을 방지하려면 완료 시 캠페인을 삭제해야 합니다. 캠페인 비용에 대한 자세한 내용은 [Amazon Personalize 요금](https://aws.amazon.com/personalize/pricing/)을 참조하세요.
**Topics**
+ [자동 캠페인 업데이트](#create-campaign-automatic-latest-sv-update)
+ [초당 최소 프로비저닝 트랜잭션 수 및 자동 스케일링](#min-tps-auto-scaling)
+ [추천에서 항목 메타데이터](#create-campaign-return-metadata)
+ [캠페인 생성(콘솔)](#create-campaign-console)
+ [캠페인 생성(AWS CLI)](#create-campaign-cli)
+ [캠페인(AWSSDK) 만들기](#create-campaign-sdk)
## 자동 캠페인 업데이트
캠페인을 생성할 때 자동 캠페인 업데이트를 활성화할 수 있습니다. 자동 업데이트를 사용하면 캠페인이 자동으로 업데이트되어 솔루션의 최신 자동 또는 수동으로 학습된 솔루션 버전을 배포합니다. 이렇게 하면 캠페인을 최신 상태로 유지하기가 더 쉬워집니다.
예를 들어 솔루션에서 [자동 학습](solution-config-auto-training.md)을 사용하여 7일마다 새 솔루션 버전을 생성하는 경우 캠페인은 매주 학습에 최신 솔루션 버전을 사용하도록 자동으로 업데이트됩니다. 자동 캠페인 업데이트를 사용하지 않는 경우 캠페인을 수동으로 업데이트하여 훈련된 최신 모델을 배포해야 합니다.
+ Amazon Personalize 콘솔을 사용하여 캠페인을 생성할 때 자동 캠페인 업데이트를 활성화하려면 **캠페인 세부 정보**에서 **솔루션의 최신 솔루션 버전을 사용하도록 자동 업데이트**를 선택합니다. 캠페인 세부 정보 페이지에서 최신 업데이트의 타임스탬프를 찾을 수 있습니다.
자세한 내용은 [캠페인 생성(콘솔)](#create-campaign-console) 섹션을 참조하세요.
+ [CreateCampaign](API_CreateCampaign.md) API 작업을 사용할 때 자동 캠페인 업데이트를 활성화하려면 `SolutionVersionArn` 파라미터에 솔루션의 Amazon 리소스 이름(ARN)을 `SolutionArn/$LATEST` 형식으로 지정합니다. `campaignConfig`에서 `enableMetadataWithRecommendations`을 `true`로 설정합니다.
최신 캠페인 업데이트의 타임스탬프를 가져오려면 [DescribeCampaign](API_DescribeCampaign.md) API 작업을 사용하고 응답의 `latestCampaignUpdate` 세부 정보를 확인할 수 있습니다.
자동 업데이트를 활성화하는 방법을 보여주는 코드 샘플은 [캠페인 생성(AWS CLI)](#create-campaign-cli) 또는 [캠페인(AWSSDK) 만들기](#create-campaign-sdk) 섹션을 참조하세요.
## 초당 최소 프로비저닝 트랜잭션 수 및 자동 스케일링
**중요**
`minProvisionedTPS`가 높으면 비용이 증가합니다. `minProvisionedTPS`(기본값)의 경우 1부터 시작하는 것이 좋습니다. Amazon CloudWatch 지표를 사용하여 사용량을 추적하고 필요에 따라 `minProvisionedTPS`를 늘리세요.
Amazon Personalize 캠페인을 생성할 때 캠페인에 대한 초당 최소 프로비저닝 트랜잭션 수(`minProvisionedTPS`)를 지정할 수 있습니다. 이는 Amazon Personalize에서 프로비저닝한 캠페인의 기준 트랜잭션 처리량입니다. 캠페인이 활성 상태일 때의 최소 청구 요금을 설정합니다. 트랜잭션은 단일 `GetRecommendations` 또는 `GetPersonalizedRanking` 요청으로 이루어집니다. 기본 `minProvisionedTPS` 값은 1입니다.
TPS가 `minProvisionedTPS` 이상으로 증가할 경우 Amazon Personalize는 프로비저닝 용량을 자동으로 확장 및 축소하지만, `minProvisionedTPS` 이하로는 확장 및 축소하지 않습니다. 용량이 증가 중에 잠시 동안의 지연으로 거래 손실이 발생할 수 있습니다. 트래픽이 감소하면 용량은 `minProvisionedTPS`로 돌아옵니다.
프로비저닝된 최소 TPS에 대한 요금이 부과되며, 요청이 `minProvisionedTPS`를 초과하는 경우 실제 TPS에 대한 요금이 부과됩니다. 실제 TPS는 추천을 요청한 총 건수입니다. 낮은 `minProvisionedTPS`로 시작하여 CloudWatch 지표를 사용하여 사용량을 추적한 다음 필요에 따라 `minProvisionedTPS`를 늘리는 것이 좋습니다.
캠페인 비용에 대한 자세한 내용은 [Amazon Personalize 요금](https://aws.amazon.com/personalize/pricing/)을 참조하세요.
## 추천에서 항목 메타데이터
**중요**
User-Personalization-v2 또는 Personalized-Ranking-v2 레시피를 사용하는 경우 메타데이터에 대한 추가 비용이 발생하지 않습니다. 다른 모든 레시피와 모든 도메인 사용 사례의 경우 추가 비용이 발생합니다. 자세한 내용은 [Amazon Personalize 요금](https://aws.amazon.com/personalize/pricing/)을 참조하세요.
추천을 받으면 Amazon Personalize가 추천 결과에 항목 메타데이터를 포함하도록 할 수 있습니다. 요청에서 포함할 항목 데이터세트의 열을 선택할 수 있습니다. Amazon Personalize는 추천 응답의 각 항목에 대해 이 데이터를 반환합니다.
메타데이터를 통해 사용자 인터페이스에서 추천을 강화할 수 있습니다(예: 캐러셀에 영화 장르 추가). 또는 이를 사용하여 추천 품질을 시각적으로 평가할 수도 있습니다. 앱에서 생성형 AI를 사용하는 경우 메타데이터를 AI 프롬프트에 연결하여 관련성이 더 높은 콘텐츠를 생성할 수 있습니다. Amazon Personalize를 생성형 AI와 함께 사용하는 방법에 대한 자세한 내용은 [Amazon Personalize 및 생성형 AI](personalize-with-gen-ai.md) 섹션을 참조하세요.
### 메타데이터 활성화
추천에 메타데이터를 추가하려면 메타데이터 열이 포함된 항목 데이터 세트가 있어야 합니다. 교육 시 메타데이터를 사용할 필요는 없습니다. 데이터 세트 생성에 대한 내용은 [스키마 및 데이터세트 생성](data-prep-creating-datasets.md) 섹션을 참조하세요. 데이터 업데이트에 대한 자세한 내용은 [학습 후 데이 세트의 데이터 업데이트](updating-datasets.md) 섹션을 참조하세요.
User-Personalization-v2 또는 Personalized-Ranking-v2 레시피를 사용하는 경우 새 캠페인에는 추천 결과와 함께 항목 메타데이터를 자동으로 포함할 수 있는 옵션이 있습니다. 캠페인에 대한 메타데이터를 수동으로 활성화하지 않았습니다. 다른 모든 레시피 및 도메인 사용 사례의 경우 메타데이터 옵션을 활성화해야 합니다.
+ Amazon Personalize 콘솔에서 메타데이터를 활성화하려면 캠페인을 생성할 때 **캠페인 세부 정보**의 **추천 결과에서 항목 메타데이터 반환**을 선택합니다. 자세한 내용은 [캠페인 생성(콘솔)](#create-campaign-console) 섹션을 참조하세요.
+ AWS SDK 또는 AWS CLI를 사용하여 메타데이터를 활성화하려면 [CreateCampaign](API_CreateCampaign.md) API 작업을 사용하고 `campaignConfig`에서 `enableMetadataWithRecommendations`를 `true`로 설정합니다. 자세한 내용은 [캠페인 생성(AWS CLI)](#create-campaign-cli) 또는 [캠페인(AWSSDK) 만들기](#create-campaign-sdk)을 참조하세요.
## 캠페인 생성(콘솔)
**중요**
캠페인이 활성화되어 있는 동안 캠페인 비용이 발생합니다. 불필요한 비용을 방지하려면 완료 시 캠페인을 삭제해야 합니다. 캠페인 비용에 대한 자세한 내용은 [Amazon Personalize 요금](https://aws.amazon.com/personalize/pricing/)을 참조하세요.
솔루션 버전 상태가 활성이면 Personalize 캠페인을 통해 솔루션을 배포할 준비가 된 것입니다.
**캠페인을 생성하려면(콘솔)**
1. [https://console.aws.amazon.com/acm-pca/home](https://console.aws.amazon.com/personalize/home)에서 Personalize 콘솔을 열고 계정에 로그인합니다.
1. 배포하려는 솔루션 버전이 포함된 데이터세트 그룹을 선택합니다.
1. 탐색 창의 **사용자 지정 리소스**에서 **캠페인**을 선택합니다.
1. **캠페인** 페이지에서 **캠페인 생성**을 선택합니다.
1. **새 캠페인 생성 페이지에서 캠페인 세부 정보에 대해 다음 정보를 제공합니다******.
+ **캠페인 이름** – 캠페인 이름을 입력합니다. 여기에 입력하는 텍스트는 캠페인 대시보드 및 세부 정보 페이지에 표시됩니다.
+ **솔루션** – 방금 만든 솔루션을 선택합니다.
+ **솔루션의 최신 솔루션 버전을 사용하도록 자동 업데이트** - 캠페인이 최신 활성 솔루션 버전을 자동으로 사용하도록 하려면 이 옵션을 선택합니다. 이 옵션을 선택하지 않으면 새 솔루션 버전을 배포할 때마다 캠페인을 수동으로 업데이트해야 합니다. 자세한 내용은 [자동 캠페인 업데이트](#create-campaign-automatic-latest-sv-update) 섹션을 참조하세요.
+ **솔루션 버전 ID** - 자동 캠페인 업데이트를 사용하여 최신 솔루션 버전을 사용하지 않는 경우 배포하려는 솔루션 버전의 ID를 선택합니다.
+ **초당 최소 프로비저닝된 트랜잭션(API에서 minProvisionedTPS라고 함)** – Amazon Personalize에서 지원하는 초당 최소 프로비저닝 트랜잭션을 설정합니다. 값이 높으면 요금이 인상됩니다. 1(기본값)부터 시작하는 것이 좋습니다. Amazon CloudWatch 지표를 사용하여 사용량을 추적하고 필요에 따라 `minProvisionedTPS`를 늘리세요. 자세한 내용은 [초당 최소 프로비저닝 트랜잭션 수 및 자동 스케일링](#min-tps-auto-scaling) 섹션을 참조하세요.
+ **추천 결과에서 항목 메타데이터 반환** - 추천 결과에 메타데이터를 포함하려면 이 옵션을 선택합니다. 활성화한 경우 추천을 가져올 때 항목 데이터세트의 열을 지정할 수 있습니다. 자세한 내용은 [추천에서 항목 메타데이터](#create-campaign-return-metadata) 섹션을 참조하세요.
1. User-Personalization 레시피를 사용한 경우, **캠페인 구성**에서 **탐색 가중치** 및 **탐색 항목 연령 컷오프** 값을 선택적으로 입력할 수 있습니다. 자세한 내용은 [사용자-개인 맞춤](native-recipe-new-item-USER_PERSONALIZATION.md) 섹션을 참조하세요.
1. **태그**의 경우, 원하는 태그를 추가할 수 있습니다. Personalize 리소스 태그 지정에 대한 자세한 내용은 [Personalize 리소스에 태그 지정](tagging-resources.md)단원을 참조하세요.
1. **캠페인 생성**을 선택합니다.
1. 캠페인 세부 정보 페이지에서 캠페인 상태가 **활성**일 때 캠페인을 사용하여 추천을 받고 노출 수를 기록할 수 있습니다. 자세한 내용은 [Amazon Personalize에서 추천 받기](getting-recommendations.md)단원을 참조하세요.
캠페인 상태가 활성이면 캠페인 준비가 완료된 것입니다. 솔루션 버전을 재교육하거나 캠페인 설정을 변경하려면 캠페인을 업데이트해야만 합니다. 자세한 내용은 [Amazon Personalize 캠페인의 구성 업데이트](update-campaigns.md) 섹션을 참조하세요.
## 캠페인 생성(AWS CLI)
**중요**
캠페인이 활성화되어 있는 동안 캠페인 비용이 발생합니다. 불필요한 비용을 방지하려면 완료 시 캠페인을 삭제해야 합니다. 캠페인 비용에 대한 자세한 내용은 [Amazon Personalize 요금](https://aws.amazon.com/personalize/pricing/)을 참조하세요.
솔루션 버전 상태가 활성이면 Amazon Personalize 캠페인을 통해 솔루션을 배포할 준비가 된 것입니다. AWS CLI를 통해 캠페인을 생성하려면 `create-campaign` 명령을 사용합니다.
다음 코드 샘플은 캠페인을 생성하는 방법을 보여줍니다. User-Personalization 레시피를 사용하는 솔루션의 최신 솔루션 버전을 배포합니다. 생성하는 캠페인은 향후 솔루션 버전을 사용하도록 자동으로 업데이트됩니다. 코드에서 다음 구성을 사용합니다.
+ `solution-version-arn`이 `solution ARN/$LATEST` 형식이고 `syncWithLatestSolutionVersion`이 `True`인 솔루션의 최신 솔루션 버전을 사용하도록 캠페인을 자동으로 업데이트하도록 구성합니다. 코드를 사용하려면 `solution ARN`을 솔루션의 Amazon 리소스 이름(ARN)으로 바꿉니다.
자동 `syncWithLatestSolutionVersion`을 비활성화하려면 솔루션 버전 ARN(`/$LATEST` 제외)만 지정하고 `syncWithLatestSolutionVersion`을 `False`로 설정합니다..
+ `enableMetadataWithRecommendations` 옵션을 `True`로 설정합니다. 이렇게 하면 추천 결과에 항목 데이터세트의 항목 메타데이터를 포함하는 추천 요청 옵션을 활성화할 수 있습니다. 이 옵션을 비활성화하려면 `False`로 설정합니다. 자세한 내용은 [추천에서 항목 메타데이터](#create-campaign-return-metadata) 섹션을 참조하세요.
+ `min-provisioned-tps`를 1(기본값)로 설정합니다. `minProvisionedTPS`(기본값)의 경우 1부터 시작하는 것이 좋습니다. Amazon CloudWatch 지표를 사용하여 사용량을 추적하고 필요에 따라 `minProvisionedTPS`를 늘리세요. 자세한 내용은 [초당 최소 프로비저닝 트랜잭션 수 및 자동 스케일링](#min-tps-auto-scaling) 섹션을 참조하세요.
모든 파라미터의 전체 목록은 [CreateCampaign](API_CreateCampaign.md) 섹션을 참조하세요.
```
aws personalize create-campaign \
--name campaign-name \
--solution-version-arn solution-arn/\$LATEST \
--min-provisioned-tps 1 \
--campaign-config "{"\"syncWithLatestSolutionVersion"\": "true", "\"enableMetadataWithRecommendations"\": "true"}"
```
캠페인 상태가 활성이면 캠페인 준비가 완료된 것입니다. 현재 상태를 확인하려면 [DescribeCampaign](API_DescribeCampaign.md)을 직접적으로 호출하고 `status`필드가 `ACTIVE`인지 확인합니다.
솔루션 버전을 재훈련했는데 캠페인이 최신 솔루션 버전을 사용하도록 자동으로 업데이트되지 않거나 캠페인 설정을 변경하려면 캠페인을 업데이트해야 합니다. 자세한 내용은 [Amazon Personalize 캠페인의 구성 업데이트](update-campaigns.md) 섹션을 참조하세요.
Amazon Personalize에서는 생성한 캠페인을 나열하는 [ListCampaigns](API_ListCampaigns.md)과 같은 캠페인 관리용 작업을 제공합니다. 캠페인은 [DeleteCampaign](API_DeleteCampaign.md)을 호출하여 삭제할 수 있습니다. 캠페인을 삭제하더라도 캠페인의 일부인 솔루션 버전은 삭제되지 않습니다.
캠페인을 생성한 후에 캠페인을 사용하여 추천을 생성할 수 있습니다. 자세한 내용은 [Amazon Personalize에서 추천 받기](getting-recommendations.md) 섹션을 참조하세요.
## 캠페인(AWSSDK) 만들기
**중요**
캠페인이 활성화되어 있는 동안 캠페인 비용이 발생합니다. 불필요한 비용을 방지하려면 완료 시 캠페인을 삭제해야 합니다. 캠페인 비용에 대한 자세한 내용은 [Amazon Personalize 요금](https://aws.amazon.com/personalize/pricing/)을 참조하세요.
솔루션 버전 상태가 활성이면 Amazon Personalize 캠페인을 통해 솔루션을 배포할 준비가 된 것입니다. AWS SDK를 사용하여 캠페인을 생성하려면 [CreateCampaign](API_CreateCampaign.md) API 작업을 사용합니다.
다음 코드 샘플은 캠페인을 생성하는 방법을 보여줍니다. 코드는 User-Personalization 레시피를 사용하는 솔루션의 최신 솔루션 버전을 배포합니다. 생성하는 캠페인은 향후 솔루션 버전을 사용하도록 자동으로 업데이트됩니다. 코드에서 다음 구성을 사용합니다.
+ `solutionVersionArn`이 `solution ARN/$LATEST` 형식이고 `syncWithLatestSolutionVersion`이 `True`인 솔루션의 최신 솔루션 버전을 사용하도록 캠페인을 자동으로 업데이트하도록 구성합니다. 코드를 사용하려면 `solution ARN`을 솔루션 버전의 Amazon 리소스 이름(ARN)으로 바꿉니다.
자동 `syncWithLatestSolutionVersion`을 비활성화하려면 솔루션 버전 ARN(`/$LATEST` 제외)만 지정하고 `syncWithLatestSolutionVersion`을 `False`로 설정합니다..
+ `enableMetadataWithRecommendations` 옵션을 `True`로 설정합니다. 이렇게 하면 추천 결과에 항목 데이터세트의 항목 메타데이터를 포함하는 추천 요청 옵션을 활성화할 수 있습니다. 이 옵션을 비활성화하려면 `False`로 설정합니다. 자세한 내용은 [추천에서 항목 메타데이터](#create-campaign-return-metadata) 섹션을 참조하세요.
+ `minProvisionedTPS`를 1(기본값)로 설정합니다. `minProvisionedTPS`의 경우 1(기본값)부터 시작하는 것이 좋습니다. Amazon CloudWatch 지표를 사용하여 사용량을 추적하고 필요에 따라 `minProvisionedTPS`를 늘리세요. 자세한 내용은 [초당 최소 프로비저닝 트랜잭션 수 및 자동 스케일링](#min-tps-auto-scaling) 섹션을 참조하세요.
모든 파라미터의 전체 목록은 [CreateCampaign](API_CreateCampaign.md) 섹션을 참조하세요.
------
#### [ SDK for Python (Boto3) ]
```
import boto3
personalize = boto3.client('personalize')
response = personalize.create_campaign(
name = 'campaign name',
solutionVersionArn = 'solution ARN/$LATEST',
minProvisionedTPS = 1,
campaignConfig = {"syncWithLatestSolutionVersion": True, "enableMetadataWithRecommendations": True}
)
arn = response['campaignArn']
description = personalize.describe_campaign(campaignArn = arn)['campaign']
print('Name: ' + description['name'])
print('ARN: ' + description['campaignArn'])
print('Status: ' + description['status'])
```
------
#### [ SDK for JavaScript v3 ]
```
// Get service clients module and commands using ES6 syntax.
import { CreateCampaignCommand, PersonalizeClient } from
"@aws-sdk/client-personalize";
// create personalizeClient
const personalizeClient = new PersonalizeClient({ region: "REGION" });
// set the campaign parameters
export const createCampaignParam = {
solutionVersionArn: "SOLUTION_ARN/$LATEST" /* required */,
name: "NAME" /* required */,
minProvisionedTPS: 1 /* optional */,
campaignConfig: { /* optional */
syncWithLatestSolutionVersion: true,
enableMetadataWithRecommendations: true,
},
};
export const run = async () => {
try {
const response = await personalizeClient.send(
new CreateCampaignCommand(createCampaignParam)
);
console.log("Success", response);
return response; // For unit tests.
} catch (err) {
console.log("Error", err);
}
};
run();
```
------
캠페인 상태가 활성이면 캠페인 준비가 완료된 것입니다. 현재 상태를 확인하려면 [DescribeCampaign](API_DescribeCampaign.md)을 직접적으로 호출하고 `status` 필드가 `ACTIVE`인지 확인합니다.
솔루션 버전을 수동으로 재교육하거나 캠페인 설정을 변경하려면 캠페인을 업데이트해야만 합니다. 자세한 내용은 [Amazon Personalize 캠페인의 구성 업데이트](update-campaigns.md) 섹션을 참조하세요.
Amazon Personalize에서는 생성한 캠페인을 나열하는 [ListCampaigns](API_ListCampaigns.md)과 같은 캠페인 관리용 작업을 제공합니다. 캠페인은 [DeleteCampaign](API_DeleteCampaign.md)을 호출하여 삭제할 수 있습니다. 캠페인을 삭제하더라도 캠페인의 일부인 솔루션 버전은 삭제되지 않습니다.
캠페인을 생성한 후에 캠페인을 사용하여 추천을 생성합니다. 자세한 내용은 [Amazon Personalize에서 추천 받기](getting-recommendations.md)단원을 참조하세요.