透過行銷活動部署 Amazon Personalize 解決方案版本 - Amazon Personalize
啟用自動更新行銷活最低佈建的 TPS建議的項目中繼資料建立行銷活動 (主控台)建立廣告活動 (AWS CLI)建立行銷活動 (AWS SDK)

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

透過行銷活動部署 Amazon Personalize 解決方案版本

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

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

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

  • 您可以將促銷活動設定為自動更新，以使用解決方案的最新解決方案版本。如需更多資訊，請參閱啟用自動更新行銷活。

  • 您可以在建議中啟用項目中繼資料。如需詳細資訊，請參閱 建議的項目中繼資料。

  • 您可以指定促銷活動每秒佈建的最低交易。這是 Amazon Personalize 佈建之促銷活動的基準交易輸送量。它會設定活動處於活動狀態時的最低帳單費用。如需詳細資訊，請參閱 每秒最低佈建交易和 auto-scaling。

您可以使用 Amazon Personalize 主控台 AWS Command Line Interface (AWS CLI) 或 AWS 開發套件建立行銷活動。如果您想要變更現有廣告活動的設定 (例如在建議中啟用中繼資料)，您必須更新廣告活動。如需詳細資訊，請參閱 更新 Amazon Personalize 化營銷活動的配置。

在廣告活動有效期間，您會產生廣告活動費用。為避免不必要的費用，請確保在完成後刪除廣告系列。如需宣傳活動費用的相關資訊，請參閱 Amazon Personalize 定價

主題

啟用自動更新行銷活

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

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

  • 若要在使用 Amazon Personalize 主控台建立行銷活動時啟用自動更新行銷活動，請在促銷活動詳細資料中選擇自動更新以使用解決方案的最新解決方案版本。您可以在活動詳細信息頁面上找到最新更新的時間戳。

    如需詳細資訊，請參閱 建立行銷活動 (主控台)。

  • 若要在使用 CreateCampaign API 作業時啟用自動促銷活動更新，請針對SolutionVersionArn參數，以SolutionArn/$LATEST格式指定解決方案的 Amazon 資源名稱 (ARN)。在中campaignConfig，設定enableMetadataInInferenceResponse為true。

    若要取得最新行銷活動更新的時間戳記，您可以使用 DescribeCampaign API 作業並檢查回應中的latestCampaignUpdate詳細資訊。

    如需示範如何啟用自動更新的程式碼範例，請參閱建立廣告活動 (AWS CLI)或建立行銷活動 (AWS SDK)。

每秒最低佈建交易和 auto-scaling

重要

高minProvisionedTPS會增加您的成本。我們建議從 1 開始 minProvisionedTPS (預設值)。使用 Amazon CloudWatch 指標追蹤您的使用情況，並minProvisionedTPS視需要增加使用量。

建立 Amazon 個人化行銷活動時，您可以指定行銷活動每秒佈建的最低交易數 (minProvisionedTPS)。這是 Amazon Personalize 佈建之促銷活動的基準交易輸送量。它會設定活動處於活動狀態時的最低帳單費用。事務是單個GetRecommendations或GetPersonalizedRanking請求。預設值minProvisionedTPS為 1。

如果您的 TPS 增加到超出的範圍minProvisionedTPS，Amazon Personalize 會自動擴展佈建的容量，但永遠不會降低佈建的容量。minProvisionedTPS容量增加時會有很短的時間延遲，這可能會導致交易損失。當您的流量減少時，容量會回到minProvisionedTPS.

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

如需宣傳活動成本的詳細資訊，請參閱 Amazon Personalize 定價。

建議的項目中繼資料

重要

如果您使用使用者個人化 V2 或個人化排名第 v2 方案，就不會產生中繼資料的額外費用。對於所有其他配方和所有網域使用案例，您需要支付額外費用。如需詳細資訊，請參閱 Amazon Personalize 定價。

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

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

啟用元數據

若要將中繼資料新增至建議，您必須擁有包含中繼資料欄的項目資料集。您不必在訓練中使用中繼資料。如需建立資料集的詳細資訊，請參閱建立資料集和結構描述。如需管理和更新資料的資訊，請參閱管理資料集中的訓練資料。

如果您使用使用者個人化 V2 或個人化排名-v2 方案，行銷活動會自動選擇將項目中繼資料包含在建議結果中。您沒有手動啟用廣告活動的中繼資料。對於所有其他方法和網域使用案例，您必須啟用中繼資料選項：

建立行銷活動 (主控台)

重要

在廣告活動有效期間，您會產生廣告活動費用。為避免不必要的費用，請確保在完成後刪除廣告系列。如需宣傳活動費用的相關資訊，請參閱 Amazon Personalize 定價

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

若要建立廣告活動 (主控台)

  1. 在 https://console.aws.amazon.com/personalize/home 打開 Amazon Personalize 化控制台並登錄到您的帳戶。

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

  3. 在導覽窗格的 [自訂資源] 下，選擇 [廣告活動]。

  4. 在行銷活動頁面上，選擇 [建立廣告活動]

  5. 在 [建立新行銷活動] 頁面上，針對促銷活動詳細資訊，提供下列資訊：

    • 行銷活動名稱 — 輸入行銷活動的名稱。您在此輸入的文字會顯示在促銷活動控制面板和詳細資訊頁面上。

    • 解決方案 — 選擇您剛建立的解決方案。

    • 自動更新以使用解決方案的最新解決方案版本 — 選擇此選項可讓促銷活動自動使用最新的作用中解決方案版本。如果您未選擇此選項，則必須在每次要部署新的解決方案版本時手動更新促銷活動。如需詳細資訊，請參閱 啟用自動更新行銷活。

    • 解決方案版本 ID — 如果您未使用自動促銷活動更新來使用最新的解決方案版本，請選擇您要部署的解決方案版本 ID。

    • 每秒最低佈建交易 (在 API 中稱為最小佈建交易) — 設定 Amazon Personalize 支援的每秒最低佈建交易數。高價值會增加您的費用。我們建議您從 1 開始 (預設值)。使用 Amazon CloudWatch 指標追蹤您的使用情況，並minProvisionedTPS視需要增加使用量。如需詳細資訊，請參閱 每秒最低佈建交易和 auto-scaling。

    • 在建議結果中傳回項目中繼資料 — 如果您希望選項包含建議結果的中繼資料，請選擇此選項。如果啟用，您可以在取得建議時指定 Items 資料集中的資料欄。如需詳細資訊，請參閱 建議的項目中繼資料。

  6. 如果您使用「使用者個人化」配方，則在「促銷活動」設定中，您可以選擇性地輸入「探索重量」和「探索」項目年齡截止的值。如需詳細資訊，請參閱 用戶個性化。

  7. 對於「標籤」，選擇性地新增任何標籤 如需標記 Amazon Personalize 資源的詳細資訊，請參閱標記 Amazon Personalize 化資。

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

  9. 在廣告活動詳細資料頁面上，當廣告活動狀態為「作用中」時，您可以使用廣告活動取得建議和記錄曝光次數。如需詳細資訊，請參閱 步驟 4：取得建議。

    促銷活動在狀態為「作用中」時就已準備就緒。如果您重新訓練解決方案版本，或想要變更廣告活動設定，則必須更新廣告活動。如需詳細資訊，請參閱 更新 Amazon Personalize 化營銷活動的配置。

建立廣告活動 (AWS CLI)

重要

在廣告活動有效期間，您會產生廣告活動費用。為避免不必要的費用，請確保在完成後刪除廣告系列。如需宣傳活動費用的相關資訊，請參閱 Amazon Personalize 定價

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

下列程式碼範例說明如何建立行銷活動。它會部署使用使用者個人化方案的解決方案的最新解決方案版本。它建立的行銷活動會自動更新以使用 future 的解決方案版本 該代碼使用以下配置：

  • 它會將促銷活動設定為自動更新，以便針對您的解決方案使用最新的解決方案版本：solution ARN/$LATEST格式solution-version-arn為且syncWithLatestSolutionVersion為。True若要使用程式碼，請solution ARN以解決方案的 Amazon 資源名稱 (ARN) 取代。

    若要停用自動syncWithLatestSolutionVersion，請僅指定解決方案版本 ARN (不含/$LATEST)，然後設定syncWithLatestSolutionVersion為False。

  • 它會將選enableMetadataWithRecommendations項設定為True。如此可讓建議要求選項包含 Items 資料集中的項目中繼資料與建議結果。若要停用此選項，請將其設定為False。如需詳細資訊，請參閱 建議的項目中繼資料。

  • 它設定min-provisioned-tps為 1 (預設值)。我們建議從 1 開始 minProvisionedTPS (預設值)。使用 Amazon CloudWatch 指標追蹤您的使用情況，並minProvisionedTPS視需要增加使用量。如需詳細資訊，請參閱 每秒最低佈建交易和 auto-scaling。

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

aws personalize create-campaign \
--name campaign-name \
--solution-version-arn solution-arn/\$LATEST \
--min-provisioned-tps 1 \
--campaign-config "{"\"syncWithLatestSolutionVersion"\": "true", "\"enableMetadataWithRecommendations"\": "true"}"

促銷活動在狀態為「作用中」時就已準備就緒。若要取得目前狀態，請呼叫 DescribeCampaign，並檢查 status 欄位是否為 ACTIVE。

如果您重新訓練解決方案版本，而廣告活動並未自動更新為使用最新的解決方案版本，或者您想要變更廣告活動設定，則必須更新廣告活動。如需詳細資訊，請參閱 更新 Amazon Personalize 化營銷活動的配置。

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

建立廣告活動後，您可以使用它來提出建議。如需詳細資訊，請參閱 步驟 4：取得建議。

建立行銷活動 (AWS SDK)

重要

在廣告活動有效期間，您會產生廣告活動費用。為避免不必要的費用，請確保在完成後刪除廣告系列。如需宣傳活動費用的相關資訊，請參閱 Amazon Personalize 定價

在您的解決方案版本處於作用中狀態之後，您就可以使用 Amazon 個人化行銷活動進行部署。若要使用 AWS SDK 建立行銷活動，請使用 CreateCampaign API 作業。

下列程式碼範例說明如何建立行銷活動。程式碼會部署使用使用者個人化配方的解決方案的最新解決方案版本。它建立的行銷活動會自動更新以使用 future 的解決方案版本 該代碼使用以下配置：

  • 它會將促銷活動設定為自動更新，以便針對您的解決方案使用最新的解決方案版本：solution ARN/$LATEST格式solutionVersionArn為且syncWithLatestSolutionVersion為。True若要使用程式碼，請solution ARN以解決方案版本的 Amazon 資源名稱 (ARN) 取代。

    若要停用自動syncWithLatestSolutionVersion，請僅指定解決方案版本 ARN (不含/$LATEST)，然後設定syncWithLatestSolutionVersion為False。

  • 它會將選enableMetadataWithRecommendations項設定為True。如此可讓建議要求選項包含 Items 資料集中的項目中繼資料與建議結果。若要停用此選項，請將其設定為False。如需詳細資訊，請參閱 建議的項目中繼資料。

  • 它設定minProvisionedTPS為 1 (預設值)。我們建議您從 1 開始 minProvisionedTPS (預設值)。使用 Amazon CloudWatch 指標追蹤您的使用情況，並minProvisionedTPS視需要增加使用量。如需詳細資訊，請參閱 每秒最低佈建交易和 auto-scaling。

如需所有參數的完整清單，請參閱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();

促銷活動在狀態為「作用中」時就已準備就緒。要獲取當前狀態，請調DescribeCampaign用並檢查該status字段是否為ACTIVE。

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

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

建立行銷活動後，請使用它來提供建議。如需更多詳細資訊，請參閱 步驟 4：取得建議。