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

使用行銷活動部署 Amazon Personalize 解決方案版本

如需使用自訂資源的即時建議，在完成 之後手動建立解決方案版本，您就可以使用行銷活動部署解決方案版本。

行銷活動會部署具有佈建交易容量的解決方案版本 （訓練模型），以產生即時建議。建立行銷活動後，您可以使用 GetRecommendations或 GetPersonalizedRankingAPI操作取得建議。如果您取得批次項目建議或使用者區段，則不需要建立行銷活動。如需詳細資訊，請參閱 取得批次項目建議 或 取得批次使用者區段。

建立行銷活動時，您可以設定下列項目：

您可以使用 Amazon Personalize 主控台 AWS Command Line Interface （AWS CLI） 或 建立行銷活動 AWS SDKs。如果您想要變更現有行銷活動的設定，例如在建議中啟用中繼資料，則必須更新行銷活動。如需詳細資訊，請參閱更新 Amazon Personalize 行銷活動的組態。

當行銷活動處於作用中狀態時，您會產生行銷活動成本。為了避免不必要的成本，請務必在完成時刪除行銷活動。如需行銷活動成本的相關資訊，請參閱 Amazon Personalize 定價 。

自動行銷活動更新

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

例如，如果您的解決方案每七天使用自動訓練來建立新的解決方案版本，您的行銷活動會自動更新為每週訓練使用最新的解決方案版本。如果您不使用自動行銷活動更新，則必須手動更新行銷活動，才能部署最新的訓練模型。

每秒的佈建交易下限和自動擴展

當您建立 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 定價 。

建議中的項目中繼資料

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

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

啟用中繼資料

若要將中繼資料新增至建議，您必須具有具有中繼資料資料欄的項目資料集。您不需要在訓練中使用中繼資料。如需建立資料集的相關資訊，請參閱 建立結構描述和資料集。如需更新資料的資訊，請參閱 訓練後更新資料集中的資料。

如果您使用 User-Personalization-v2 或 Personalized-Ranking-v2 個配方，新的行銷活動會自動選擇將項目中繼資料包含建議結果。您沒有手動啟用行銷活動的中繼資料。對於所有其他配方和網域使用案例，您必須啟用中繼資料選項：

建立行銷活動 （主控台）

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

建立行銷活動 （AWS CLI）

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

下列程式碼範例示範如何建立行銷活動。它部署使用使用者個人化配方的最新解決方案版本。其建立的行銷活動會自動更新，以使用未來的解決方案版本。程式碼使用以下組態：

如需所有參數的完整清單，請參閱 CreateCampaign。

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，並檢查 status 欄位是否為 ACTIVE。

如果您重新訓練解決方案版本，且行銷活動未自動更新為使用最新的解決方案版本，或者如果您想要變更行銷活動設定，則必須更新您的行銷活動。如需詳細資訊，請參閱更新 Amazon Personalize 行銷活動的組態。

Amazon Personalize 為您提供管理行銷活動的操作ListCampaigns，例如列出您已建立的行銷活動。您可以呼叫 DeleteCampaign 來刪除活動。如果刪除行銷活動，則不會刪除屬於行銷活動的解決方案版本。

建立行銷活動之後，您可以使用它提出建議。如需詳細資訊，請參閱從 Amazon Personalize 取得建議。

建立行銷活動 （AWS SDKs）

解決方案版本處於作用中狀態後，您就可以使用 Amazon Personalize 行銷活動來部署它。若要使用 建立行銷活動 AWS SDKs，您可以使用 CreateCampaignAPI操作。

下列程式碼範例示範如何建立行銷活動。此程式碼會部署使用使用者個人化配方之解決方案的最新解決方案版本。其建立的行銷活動會自動更新，以使用未來的解決方案版本。程式碼使用以下組態：

如需所有參數的完整清單，請參閱 CreateCampaign。

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，並檢查 status 欄位是否為 ACTIVE。

如果您手動重新訓練解決方案版本，或者如果您想要變更行銷活動設定，則必須更新您的行銷活動。如需詳細資訊，請參閱更新 Amazon Personalize 行銷活動的組態。

Amazon Personalize 為您提供管理行銷活動的操作ListCampaigns，例如列出您已建立的行銷活動。您可以呼叫 DeleteCampaign 來刪除活動。如果刪除行銷活動，則不會刪除屬於行銷活動的解決方案版本。

建立行銷活動後，請使用它來提供建議。如需詳細資訊，請參閱從 Amazon Personalize 取得建議。