本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # CreateCampaign **重要** 您在活動期間會產生行銷活動成本。為了避免不必要的成本，請務必在完成時刪除行銷活動。如需行銷活動成本的資訊，請參閱 [Amazon Personalize 定價](https://aws.amazon.com/personalize/pricing/)。 建立部署解決方案版本的行銷活動。當用戶端呼叫 [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) 和 [GetPersonalizedRanking](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetPersonalizedRanking.html) APIs時，會在請求中指定行銷活動。 **最小佈建 TPS 和自動擴展** **重要** 較高的 `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/)。 **狀態** 行銷活動可以處於下列其中一種狀態： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 若要取得行銷活動狀態，請呼叫 [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html)。 **注意** 請等到行銷活動`status`的 變成 ，`ACTIVE`再向行銷活動要求建議。 **相關 API** + [ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html) + [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) + [UpdateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateCampaign.html) + [DeleteCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteCampaign.html) ## 請求語法 ``` { "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number }, "syncWithLatestSolutionVersion": boolean }, "minProvisionedTPS": number, "name": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [campaignConfig](#API_CreateCampaign_RequestSyntax) ** 行銷活動的組態詳細資訊。 類型：[CampaignConfig](API_CampaignConfig.md) 物件 必要：否 ** [minProvisionedTPS](#API_CreateCampaign_RequestSyntax) ** 指定 Amazon Personalize 將支援的每秒請求的最低佈建交易 （建議）。較高的 `minProvisionedTPS`會增加您的帳單。我們建議從 1 開始 `minProvisionedTPS`（預設值）。使用 Amazon CloudWatch 指標追蹤您的用量，並視需要增加 `minProvisionedTPS`。 類型：整數 有效範圍：最小值為 1。 必要：否 ** [name](#API_CreateCampaign_RequestSyntax) ** 新行銷活動的名稱。行銷活動名稱在您的帳戶中必須是唯一的。 類型：字串 長度限制：長度下限為 1。長度上限為 63。 模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必要：是 ** [solutionVersionArn](#API_CreateCampaign_RequestSyntax) ** 要與行銷活動一起部署之訓練模型的 Amazon Resource Name (ARN)。若要指定解決方案的最新解決方案版本，請以 `SolutionArn/$LATEST` 格式指定*解決方案*的 ARN。如果您在 [CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html) `True`中`syncWithLatestSolutionVersion`將 設定為 ，則必須使用此格式。 若要部署不是解決方案最新版本的模型，請指定解決方案版本的 ARN。 如需自動行銷活動更新的詳細資訊，請參閱[啟用自動行銷活動更新](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update)。 類型：字串 長度限制：長度上限為 256。 模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必要：是 ** [tags](#API_CreateCampaign_RequestSyntax) ** 要套用至行銷活動的[標籤](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)清單。 類型：[Tag](API_Tag.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 200。 必要：否 ## 回應語法 ``` { "campaignArn": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [campaignArn](#API_CreateCampaign_ResponseSyntax) ** 行銷活動的 Amazon Resource Name (ARN)。 類型：字串 長度限制：長度上限為 256。 模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 提供欄位或參數的有效值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每秒請求數的限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 指定的資源已存在。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 找不到指定的資源。 HTTP 狀態碼：400 ** TooManyTagsException ** 您已超過可套用至此資源的標籤數量上限。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateCampaign) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateCampaign) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateCampaign) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateCampaign) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateCampaign) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateCampaign) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateCampaign) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateCampaign) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateCampaign) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateCampaign)