本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用行銷活動部署 Amazon Personalize 解決方案版本
<a name="campaigns"></a>

如需使用自訂資源的即時建議，在完成 之後[手動建立解決方案版本](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 SDKs建立行銷活動。如果您想要變更現有行銷活動的設定，例如在建議中啟用中繼資料，則必須更新您的行銷活動。如需詳細資訊，請參閱[更新 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)
+ [建立行銷活動AWS SDKs)](#create-campaign-sdk)

## 自動行銷活動更新
<a name="create-campaign-automatic-latest-sv-update"></a>

建立行銷活動時，您可以啟用自動行銷活動更新。透過自動更新，行銷活動會自動更新，以部署最新自動或手動訓練的解決方案版本。這可讓您更輕鬆地將行銷活動保持在最新狀態。

例如，如果您的解決方案每七天使用[自動訓練](solution-config-auto-training.md)來建立新的解決方案版本，您的行銷活動會自動更新為每週訓練使用最新的解決方案版本。如果您不使用自動行銷活動更新，則必須手動更新行銷活動以部署最新的訓練模型。
+ 若要在使用 Amazon Personalize 主控台建立行銷活動時啟用自動行銷活動更新，請在**行銷活動詳細資訊**中選擇**自動更新以使用解決方案的最新解決方案版本**。您可以在行銷活動詳細資訊頁面上找到最新更新的時間戳記。

  如需詳細資訊，請參閱[建立行銷活動 （主控台）](#create-campaign-console)。
+ 若要在使用 [CreateCampaign](API_CreateCampaign.md) API 操作時啟用自動行銷活動更新，請針對 `SolutionVersionArn` 參數指定您解決方案的 Amazon Resource Name (ARN) `SolutionArn/$LATEST` 格式。在 中`campaignConfig`，將 `enableMetadataWithRecommendations` 設定為 `true`。

  若要取得最新行銷活動更新的時間戳記，您可以使用 [DescribeCampaign](API_DescribeCampaign.md) API 操作，並在回應中檢查`latestCampaignUpdate`詳細資訊。

  如需示範如何啟用自動更新的程式碼範例，請參閱 [建立行銷活動 (AWS CLI)](#create-campaign-cli)或 [建立行銷活動AWS SDKs)](#create-campaign-sdk)。

## 每秒佈建交易數下限和自動調整規模
<a name="min-tps-auto-scaling"></a>

**重要**  
 較高的 `minProvisionedTPS`會增加您的成本。我們建議從 1 開始 `minProvisionedTPS`（預設值）。使用 Amazon CloudWatch 指標追蹤您的用量，並視需要增加 `minProvisionedTPS`。

 當您建立 Amazon Personalize 行銷活動時，您可以指定行銷活動的每秒最低佈建交易數 (`minProvisionedTPS`)。這是 Amazon Personalize 佈建之行銷活動的基準交易輸送量。它會設定行銷活動在作用中時的最低帳單費用。交易是單一 `GetRecommendations`或 `GetPersonalizedRanking`請求。預設值`minProvisionedTPS`為 1。

 如果您的 TPS 增加超過 `minProvisionedTPS`，Amazon Personalize 會自動擴展和縮減佈建的容量，但絕不會低於 `minProvisionedTPS`。當容量增加時，會發生短暫的延遲，這可能會導致交易遺失。當您的流量減少時，容量會返回 `minProvisionedTPS`。

您需要支付最低佈建 TPS 的費用，或者，如果您的請求超過 `minProvisionedTPS`，則為實際 TPS。實際 TPS 是您提出的建議請求總數。我們建議您從較低的 開始`minProvisionedTPS`，使用 Amazon CloudWatch 指標追蹤您的用量，然後`minProvisionedTPS`視需要增加 。

如需行銷活動成本的詳細資訊，請參閱 [Amazon Personalize 定價](https://aws.amazon.com/personalize/pricing/)。

## 建議中的項目中繼資料
<a name="create-campaign-return-metadata"></a>

**重要**  
如果您使用 User-Personalization-v2 或 Personalized-Ranking-v2 配方，中繼資料不會產生額外費用。對於所有其他配方和所有網域使用案例，您需要支付額外費用。如需詳細資訊，請參閱 [Amazon Personalize 定價](https://aws.amazon.com/personalize/pricing/)。

當您取得建議時，可以讓 Amazon Personalize 在建議結果中包含項目中繼資料。在您的請求中，您可以從項目資料集選擇要包含的資料欄。Amazon Personalize 會針對建議回應中的每個項目傳回此資料。

您可以使用中繼資料來豐富使用者介面中的建議，例如將電影的類型新增至輪跳功能。或者，您可以使用它來視覺化評估建議品質。如果您在應用程式中使用生成式 AI，您可以將中繼資料插入 AI 提示，以產生更相關的內容。如需搭配生成式 AI 使用 Amazon Personalize 的詳細資訊，請參閱 [Amazon Personalize 和生成式 AI](personalize-with-gen-ai.md)。

### 啟用中繼資料
<a name="enabling-metadata"></a>

若要將中繼資料新增至建議，您必須具有具有中繼資料資料欄的項目資料集。您不需要在訓練中使用中繼資料。如需建立資料集的資訊，請參閱 [建立結構描述和資料集](data-prep-creating-datasets.md)。如需更新資料的資訊，請參閱 [訓練後更新資料集中的資料](updating-datasets.md)。

 如果您使用 User-Personalization-v2 或 Personalized-Ranking-v2 配方，新的行銷活動會自動選擇在建議結果中包含項目中繼資料。您沒有手動啟用行銷活動的中繼資料。對於所有其他配方和網域使用案例，您必須啟用中繼資料選項：
+ 若要使用 Amazon Personalize 主控台啟用中繼資料，當您建立行銷活動時，請在**行銷活動詳細資訊****的建議結果中選擇傳回項目中繼資料**。如需詳細資訊，請參閱[建立行銷活動 （主控台）](#create-campaign-console)。
+ 若要使用 AWS SDKs或 啟用中繼資料 AWS CLI，請使用 [CreateCampaign](API_CreateCampaign.md) API 操作，並將 中的 `campaignConfig``enableMetadataWithRecommendations`設定為 `true`。如需詳細資訊，請參閱 [建立行銷活動 (AWS CLI)](#create-campaign-cli) 或 [建立行銷活動AWS SDKs)](#create-campaign-sdk) 。

## 建立行銷活動 （主控台）
<a name="create-campaign-console"></a>

**重要**  
 當行銷活動處於作用中狀態時，您會產生行銷活動成本。為了避免不必要的成本，請務必在完成時刪除行銷活動。如需行銷活動成本的資訊，請參閱 [Amazon Personalize 定價](https://aws.amazon.com/personalize/pricing/)。

解決方案版本狀態為作用中之後，您就可以使用 Amazon Personalize 行銷活動進行部署。

**建立行銷活動 （主控台）**

1. 在 [https://console.aws.amazon.com/personalize/home](https://console.aws.amazon.com/personalize/home)：// 開啟 Amazon Personalize 主控台並登入您的帳戶。

1. 選擇具有您要部署之解決方案版本的資料集群組。

1. 在導覽窗格的**自訂資源**下，選擇**行銷活動**。

1. 在**行銷活動**頁面上，選擇**建立行銷活動**。

1. 在**建立新的行銷活動**頁面上，針對**行銷活動詳細資訊**，提供下列資訊：
   + **行銷活動名稱** – 輸入行銷活動的名稱。您在此處輸入的文字會顯示在行銷活動儀表板和詳細資訊頁面上。
   + **解決方案** – 選擇您剛建立的解決方案。
   + **自動更新以使用解決方案的最新解決方案版本** – 選擇此選項，讓行銷活動自動使用最新的作用中解決方案版本。如果您未選擇此選項，則每次想要部署新的解決方案版本時，都必須手動更新行銷活動。如需詳細資訊，請參閱[自動行銷活動更新](#create-campaign-automatic-latest-sv-update)。
   + **解決方案版本 ID** – 如果您不使用自動行銷活動更新來使用最新的解決方案版本，請選擇您要部署的解決方案版本 ID。
   + **每秒佈建交易數下限 （在 APIs 中稱為 minProvisionedTPS)** – 設定 Amazon Personalize 支援的每秒佈建交易數下限。較高的值會增加您的費用。我們建議您從 1 （預設值） 開始。使用 Amazon CloudWatch 指標追蹤您的用量，並視需要增加 `minProvisionedTPS`。如需詳細資訊，請參閱[每秒佈建交易數下限和自動調整規模](#min-tps-auto-scaling)。
   + 在**建議結果中傳回項目中繼資料** – 如果您希望 選項在建議結果中包含中繼資料，請選擇此選項。如果啟用，您可以在取得建議時，從項目資料集指定資料欄。如需詳細資訊，請參閱[建議中的項目中繼資料](#create-campaign-return-metadata)。

1. 如果您使用使用者個人化配方，在**行銷活動組態**中，您可以選擇輸入**探勘權重**和**探勘項目存留期截止**值。如需詳細資訊，請參閱[使用者個人化](native-recipe-new-item-USER_PERSONALIZATION.md)。

1. 對於**標籤**，選擇性地新增任何標籤。如需標記 Amazon Personalize 資源的詳細資訊，請參閱 [標記 Amazon Personalize 資源](tagging-resources.md)。

1. 選擇 **Create campaign (建立活動)**。

1. 在行銷活動詳細資訊頁面上，當行銷活動狀態為**作用中**時，您可以使用行銷活動來取得建議和記錄曝光。如需詳細資訊，請參閱[從 Amazon Personalize 取得建議](getting-recommendations.md)。

   當行銷活動的狀態為 ACTIVE 時，表示該行銷活動已準備就緒。如果您重新訓練解決方案版本，或想要變更行銷活動設定，則必須更新您的行銷活動。如需詳細資訊，請參閱[更新 Amazon Personalize 行銷活動的組態](update-campaigns.md)。

## 建立行銷活動 (AWS CLI)
<a name="create-campaign-cli"></a>

**重要**  
 當行銷活動處於作用中狀態時，您會產生行銷活動成本。為了避免不必要的成本，請務必在完成時刪除行銷活動。如需行銷活動成本的相關資訊，請參閱 [Amazon Personalize 定價](https://aws.amazon.com/personalize/pricing/)。

解決方案版本處於作用中狀態後，您就可以使用 Amazon Personalize 行銷活動進行部署。若要使用 建立行銷活動 AWS CLI，請使用 `create-campaign`命令。

下列程式碼範例示範如何建立行銷活動。它會部署使用使用者個人化配方的最新解決方案版本。其建立的行銷活動會自動更新，以使用未來的解決方案版本。此程式碼使用以下組態：
+ 它將行銷活動設定為自動更新，以為您的解決方案使用最新的解決方案版本： `solution ARN/$LATEST` 格式`solution-version-arn`為 ， `syncWithLatestSolutionVersion`為 `True`。若要使用程式碼，請將 取代`solution ARN`為您解決方案的 Amazon Resource Name (ARN)。

  若要停用自動 `syncWithLatestSolutionVersion`，請僅指定解決方案版本 ARN （不含 `/$LATEST`)，並將 `syncWithLatestSolutionVersion`設定為 `False`。
+ 它會將 `enableMetadataWithRecommendations`選項設定為 `True`。這可讓建議請求選項包含來自具有建議結果之項目資料集的項目中繼資料。若要停用此選項，請將其設定為 `False`。如需詳細資訊，請參閱[建議中的項目中繼資料](#create-campaign-return-metadata)。
+ 它會`min-provisioned-tps`設定為 1 （預設值）。我們建議從 1 開始 `minProvisionedTPS`（預設值）。使用 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"}"
```

當行銷活動的狀態為 ACTIVE 時，表示該行銷活動已準備就緒。若要取得目前狀態，請呼叫 [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)。

## 建立行銷活動AWS SDKs)
<a name="create-campaign-sdk"></a>

**重要**  
 當行銷活動處於作用中狀態時，您會產生行銷活動成本。為了避免不必要的成本，請務必在完成時刪除行銷活動。如需行銷活動成本的相關資訊，請參閱 [Amazon Personalize 定價](https://aws.amazon.com/personalize/pricing/)。

解決方案版本處於作用中狀態後，您就可以使用 Amazon Personalize 行銷活動進行部署。若要使用 AWS SDKs建立行銷活動，您可以使用 [CreateCampaign](API_CreateCampaign.md) API 操作。

下列程式碼範例示範如何建立行銷活動。此程式碼會部署使用使用者個人化配方之解決方案的最新解決方案版本。其建立的行銷活動會自動更新，以使用未來的解決方案版本。此程式碼使用以下組態：
+ 它將行銷活動設定為自動更新，以為您的解決方案使用最新的解決方案版本： `solution ARN/$LATEST` 格式`solutionVersionArn`為 ， `syncWithLatestSolutionVersion`為 `True`。若要使用程式碼，請將 取代`solution ARN`為您解決方案版本的 Amazon Resource Name (ARN)。

  若要停用自動 `syncWithLatestSolutionVersion`，請僅指定解決方案版本 ARN （不含 `/$LATEST`)，並將 `syncWithLatestSolutionVersion`設定為 `False`。
+ 它會將 `enableMetadataWithRecommendations`選項設定為 `True`。這可讓建議請求選項包含來自具有建議結果之項目資料集的項目中繼資料。若要停用此選項，請將其設定為 `False`。如需詳細資訊，請參閱[建議中的項目中繼資料](#create-campaign-return-metadata)。
+ 它會`minProvisionedTPS`設定為 1 （預設值）。建議您從 的 1 開始 `minProvisionedTPS`（預設值）。使用 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();
```

------

當行銷活動的狀態為 ACTIVE 時，表示該行銷活動已準備就緒。若要取得目前狀態，請呼叫 [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)。