本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # VIDEO\$1ON\$1DEMAND 資料集和結構描述 當您為 VIDEO\$1ON\$1DEMAND 網域建立網域資料集群組時，每個資料集類型都有預設結構描述，其中包含一組 VIDEO\$1ON\$1DEMAND 特定的必要和建議欄位。您可以使用預設結構描述，或根據預設結構描述建立新的結構描述。您匯入的資料必須符合格式和類型的結構描述。使用下列各節中列出的預設網域結構描述作為指南，以判斷要匯入哪些資料來建立 VIDEO\$1ON\$1DEMAND 型建議程式。 您可以自由新增其他欄位。只要欄位未列為必要或預留，且資料類型列於 中[結構描述資料類型](how-it-works-dataset-schema.md#personalize-datatypes)，欄位名稱和資料類型將由您決定。 如需有關一般 Amazon Personalize 結構描述要求的資訊，例如格式化要求和可用的欄位資料類型，請參閱 [為 Amazon Personalize 結構描述建立結構描述 JSON 檔案](how-it-works-dataset-schema.md)。這些要求適用於所有結構描述，無論網域為何。 下列主題提供有關 VIDEO\$1ON\$1DEMAND 網域每個資料集的必要和建議欄位的資訊。每個資料集區段都包含 JSON 格式的預設 VIDEO\$1ON\$1DEMAND 結構描述。 **Topics** + [VIDEO\$1ON\$1DEMAND 網域資料集和結構描述要求](#VIDEO-ON-DEMAND-dataset-requirements) + [項目互動資料集需求 (VIDEO\$1ON\$1DEMAND 網域）](VIDEO-ON-DEMAND-interactions-dataset.md) + [使用者資料集需求 (VIDEO\$1ON\$1DEMAND 網域）](VIDEO-ON-DEMAND-users-dataset.md) + [項目資料集需求 (VIDEO\$1ON\$1DEMAND 網域）](VIDEO-ON-DEMAND-items-dataset.md) ## VIDEO\$1ON\$1DEMAND 網域資料集和結構描述要求 每個資料集類型都有下列必要欄位和預留關鍵字。預留關鍵字是選用的非中繼資料欄位。這些欄位被視為預留，因為您在使用它們時，必須將欄位定義為其必要資料類型。預留類別字串欄位必須`categorical`設定為 `true`，而預留字串欄位不能是類別。關鍵字不能在您的資料中。 | 資料集類型 | 必要欄位 | 保留的關鍵字 | | --- | --- | --- | | 項目互動 [（預設結構描述](VIDEO-ON-DEMAND-interactions-dataset.md#VIDEO-ON-DEMAND-interactions-schema)) | USER\$1ID (`string`) ITEM\$1ID (`string`) TIMESTAMP (`long`) EVENT\$1TYPE (`string` 和 取決於[使用案例](domain-use-cases.md)`Watch`和`Click`事件類型） | EVENT\$1VALUE (`float`、`null`) 印象 (`string`、`null`) RECOMMENDATION\$1ID (`string`、`null`) EVENT\$1ATTRIBUTION\$1SOURCE (`string`、`null`) | | 使用者 [（預設結構描述](VIDEO-ON-DEMAND-users-dataset.md#VIDEO-ON-DEMAND-users-dataset-schema)) | USER\$1ID (`string`) 1 個中繼資料欄位 （分類`string`或數值） | SUBSCRIPTION\$1MODEL （類別 `string`、`null`) | | 項目 [（預設結構描述](VIDEO-ON-DEMAND-items-dataset.md#VIDEO-ON-DEMAND-items-dataset-schema)) | ITEM\$1ID (`string`) CREATION\$1TIMESTAMP (`long`) GENRES （類別 `string`) | 價格 (`float`、`null`) 持續時間 (`float`、`null`) GENRE\$1L2 （類別 `string`、`null`) GENRE\$1L3 （類別 `string`、`null`) AVERAGE\$1RATING (`float`、`null`) PRODUCT\$1DESCRIPTION （文字 `string`、`null`) CONTENT\$1OWNER （類別 `string`、`null`) CONTENT\$1CLASSIFICATION （類別 `string`、`null`) | # 項目互動資料集需求 (VIDEO\$1ON\$1DEMAND 網域） *項目互動資料集*會存放 VIDEO\$1ON\$1DEMAND 目錄中使用者和項目之間互動的歷史和即時資料。如需可存放在互動資料集之資料類型的詳細資訊，請參閱 [項目互動資料](interactions-datasets.md)。 您必須擁有所有使用案例的項目互動資料集，而且您的結構描述必須具有下列欄位： + USER\$1ID (`string`) + ITEM\$1ID `string` + TIMESTAMP (`long`) + EVENT\$1TYPE (`string` 和 取決於[使用案例](domain-use-cases.md)`Watch`和`Click`事件類型） 您的結構描述也可以包含下列預留關鍵字： + EVENT\$1VALUE (`float`、`null`) + 印象 (`string`、`null`) + RECOMMENDATION\$1ID (`string`、`null`) 您可以根據您的使用案例和資料，自由新增其他欄位。只要欄位未列為必要或預留，且資料類型列於 中[結構描述資料類型](how-it-works-dataset-schema.md#personalize-datatypes)，欄位名稱和資料類型將由您決定。如需 VIDEO\$1ON\$1DEMAND 網域之項目互動資料集的預設結構描述範例，請參閱 [預設互動結構描述 (VIDEO\$1ON\$1DEMAND 網域）](#VIDEO-ON-DEMAND-interactions-schema)。 如果您有事件的值資料，例如監看影片的百分比，可選擇性地新增預留關鍵字 EVENT\$1VALUE。如果您想要包含明確和隱含的印模資料，可選擇性地新增預留關鍵字 IMPRESSION。如需記錄印模資料的詳細資訊，請參閱 [印象資料](interactions-datasets.md#interactions-impressions-data)。 您可以新增至項目互動資料集的選用中繼資料欄位總數上限，結合項目互動資料中*不同*事件類型的總數為 10。此計數中包含的中繼資料欄位為 EVENT\$1TYPE、EVENT\$1VALUE 欄位，以及您新增至結構描述的任何自訂中繼資料欄位。排除預留欄位的中繼資料欄位數目上限為 5。分類值最多可有 1000 個字元。如果您與超過 1000 個類別值的互動，您的資料集匯入任務將會失敗。 如需 VIDEO\$1ON\$1DEMAND 網域的項目互動資料集最低需求和最高資料限制的詳細資訊，請參閱 [Service Quotas](limits.md#limits-table)。如需有關一般 Amazon Personalize 結構描述要求的資訊，例如格式化要求和可用的欄位資料類型，請參閱 [為 Amazon Personalize 結構描述建立結構描述 JSON 檔案](how-it-works-dataset-schema.md)。這些要求適用於所有結構描述，無論網域為何。 ## 預設互動結構描述 (VIDEO\$1ON\$1DEMAND 網域） 以下是項目互動資料集的預設 VIDEO\$1ON\$1DEMAND 網域結構描述。 ``` { "type": "record", "name": "Interactions", "namespace": "com.amazonaws.personalize.schema", "fields": [ { "name": "USER_ID", "type": "string" }, { "name": "ITEM_ID", "type": "string" }, { "name": "EVENT_TYPE", "type": "string" }, { "name": "TIMESTAMP", "type": "long" } ], "version": "1.0" } ``` # 使用者資料集需求 (VIDEO\$1ON\$1DEMAND 網域） *使用者資料集*會儲存有關使用者的中繼資料。這可能包括每位使用者年齡、興趣、性別和忠誠度成員資格等資訊。如需可匯入 Amazon Personalize 的使用者資料類型資訊，請參閱 [使用者中繼資料](users-datasets.md)。如需一般 Amazon Personalize 結構描述需求的資訊，請參閱 [為 Amazon Personalize 結構描述建立結構描述 JSON 檔案](how-it-works-dataset-schema.md)。這些要求適用於所有結構描述，無論網域為何。 對於所有 VIDEO\$1ON\$1DEMAND 使用案例，使用者資料集都是選用的。如果您有使用者資料，建議您建立一個，以取得最相關的建議。如果您建立使用者資料集，您的結構描述必須包含下列欄位。 + USER\$1ID + 1 個中繼資料欄位 （分類`string`或數值） 您可以根據您的使用案例和資料，自由新增其他欄位。只要欄位未列為必要或預留，且資料類型列於 中[結構描述資料類型](how-it-works-dataset-schema.md#personalize-datatypes)，欄位名稱和資料類型將由您決定。如需 VIDEO\$1ON\$1DEMAND 網域之使用者資料集的預設結構描述範例，請參閱 [預設使用者結構描述 (VIDEO\$1ON\$1DEMAND 網域）](#VIDEO-ON-DEMAND-users-dataset-schema)。 預設結構描述中包含 `SUBSCRIPTION_MODEL` 欄位。此欄位是選用的預留關鍵字，且必須具有將分類設為 `string`的 類型`true`。為了取得最佳建議，如果您有資料中每個使用者的訂閱模型資訊，建議您在結構描述中保留此欄位。您匯入的資料必須符合您的結構描述。 ## 使用分類資料 若要使用分類資料，請在結構描述`true`中新增 類型的欄位，`string`並將欄位的分類屬性設定為 。然後在大量 CSV 檔案和個別記錄匯入中包含分類資料。對於具有多個類別的使用者，請使用垂直列 '\$1' 分隔每個值。例如，對於 SUBSCRIPTION\$1MODEL 欄位，使用者的資料可能是 student\$1monthly\$1discount。 分類值最多可有 1000 個字元。如果您有分類值超過 1000 個字元的使用者，您的資料集匯入任務將會失敗。 ## 預設使用者結構描述 (VIDEO\$1ON\$1DEMAND 網域） 以下是使用者資料集的預設 VIDEO\$1ON\$1DEMAND 網域結構描述。 ``` { "type": "record", "name": "Users", "namespace": "com.amazonaws.personalize.schema", "fields": [ { "name": "USER_ID", "type": "string" }, { "name": "SUBSCRIPTION_MODEL", "type": "string", "categorical": true } ], "version": "1.0" } ``` # 項目資料集需求 (VIDEO\$1ON\$1DEMAND 網域） *項目資料集*會將項目的中繼資料存放在目錄中。這可能包括每個項目的價格、類型和可用性等資訊。如需可匯入 Amazon Personalize 的項目資料類型資訊，請參閱 [項目中繼資料](items-datasets.md)。如需有關一般 Amazon Personalize 結構描述要求的資訊，例如格式化要求和可用的欄位資料類型，請參閱 [為 Amazon Personalize 結構描述建立結構描述 JSON 檔案](how-it-works-dataset-schema.md)。這些要求適用於所有結構描述，無論網域為何。 某些使用案例需要項目資料集 （請參閱 [VIDEO\$1ON\$1DEMAND 使用案例](VIDEO_ON_DEMAND-use-cases.md))。選用時，仍建議您建立一個，以取得最相關的建議。如果您建立項目資料集，您的結構描述必須包含下列欄位： + ITEM\$1ID + GENRES （類別 `string`) + CREATION\$1TIMESTAMP （以 Unix epoch 時間格式顯示） 您的結構描述也可以包含下列預留關鍵字。每個關鍵字會列出其所需的資料類型，以及是否支援 null 資料。新增 null 類型是選用的。 + 價格 （浮點數） + DURATION （浮點數） + GENRE\$1L2 （類別 `string`、`null`) + GENRE\$1L3 （類別 `string`、`null`) + AVERAGE\$1RATING (`float`、`null`) + PRODUCT\$1DESCRIPTION （文字 `string`、`null`) + CONTENT\$1OWNER （類別 `string`、)`null`：擁有影片的公司。例如，值可能是 HBO、Paramount 和 NBC。 + CONTENT\$1CLASSIFICATION （類別 `string`、)`null`：內容的評分。例如，值可能是 G、PG、PG-13、R、NC-17 和未評分。 若要取得最佳建議，我們建議您在結構描述中保留這些欄位的數量與資料相同。您匯入的資料必須符合您的結構描述。中繼資料資料欄的數量上限為 100。您可以根據您的使用案例和資料，自由新增其他欄位。只要欄位未列為必要或預留，且資料類型列於 中[結構描述資料類型](how-it-works-dataset-schema.md#personalize-datatypes)，欄位名稱和資料類型將由您決定。 針對具有多個多層類別的項目，使用預留關鍵字 GENRE\$1L2 和 GENRE\$1L3。如需詳細資訊，請參閱[使用分類資料](#VIDEO-ON-DEMAND-items-categorical-data)。如需文字和分類中繼資料的資訊，請參閱 [準備項目中繼資料以進行訓練](items-datasets.md)。如需 ECOMMERCE 網域項目資料集的預設結構描述範例，請參閱 [預設項目結構描述 (VIDEO\$1ON\$1DEMAND 網域）](#VIDEO-ON-DEMAND-items-dataset-schema)。 ## 使用分類資料 若要使用分類資料，請在結構描述`true`中新增 類型的欄位，`string`並將欄位的分類屬性設定為 。然後在大量 CSV 檔案和個別項目匯入中包含分類資料。分類值最多可有 1000 個字元。如果您有類別值超過 1000 個字元的項目，您的資料集匯入任務將會失敗。 對於具有多個類別的項目，請以垂直長條 '\$1' 分隔每個值。例如，對於 GENRES 欄位，項目的資料可能是 `Action|Crime|Biopic`。如果您有多個層級的分類資料，而且有些項目在階層中的每個層級都有多個類別，請為每個層級新增欄位，並在每個欄位名稱後面附加層級指標：GENRES、GENRE\$1L2、GENRE\$1L3。這可讓您根據子類別篩選建議，即使項目屬於多個多層級類別也一樣。例如，影片可能具有每個類別層級的下列資料： + GENRES：Action\$1Adventure + GENRE\$1L2：Crimer\$1Western + GENRE\$1L3：生物特性 在此範例中，影片位於動作 > 犯罪 > 生物特徵階層*和*冒險 > 西部 > 生物特徵階層中。我們建議最多只使用 L3，但如有必要，您可以使用更多關卡。如需建立和使用篩選條件的資訊，請參閱 [篩選建議和使用者客群](filter.md)。 ## 預設項目結構描述 (VIDEO\$1ON\$1DEMAND 網域） 以下是 VIDEO\$1ON\$1DEMAND 網域的項目資料集的預設結構描述。 ``` { "type": "record", "name": "Items", "namespace": "com.amazonaws.personalize.schema", "fields": [ { "name": "ITEM_ID", "type": "string" }, { "name": "GENRES", "type": [ "string" ], "categorical": true }, { "name": "CREATION_TIMESTAMP", "type": "long" } ], "version": "1.0" } ```