MEC(メディアエンターテイメントコア)メタデータは、MovieLabs仕様を使用して公開する場合に使用されます。シングルタイトルアップロードまたはmRSSを使用する場合、MECメタデータは適用されません。
MECファイルは、Amazon固有の要件を含む MovieLabs MEC仕様v2.6に準拠している必要があります。矛盾がある場合は、Prime Videoの要件が優先されます。MECサンプルファイルについては、次を参照してください:サンプルファイルリポジトリ.
最初に視聴
タイトルメタデータの要件
この動画では、Prime Videoのタイトルメタデータの要件を簡単に説明します。タイトルメタデータの基本について詳しくは、以下のガイドをご覧ください。
MEC XML納品基準
MEC XMLを送信するたびに、次のルールに従ってください。
- XMLは自動的に生成されなければなりません。XMLを手動で作成すると、納品エラーが発生します。
- MECファイルの提出は、Prime Videoのファイル命名規則に従う必要があります。
- XMLスキーマ定義(XSD)とドキュメントは、サンプルファイルパッケージに含まれています。
- ContentIDとWorkTypeの値は、最初の提出で固定されます。異なる値で再送信すると、納品エラーが発生します。
ContentID形式
ContentIDは@ContentID属性のこのURN形式に従う必要があります。Unique_ID、またはContentID (SKU)は、MovieLabs仕様内のAltID/ALIDです。
形式: md:cid:org:[partner_alias]:[unique_id]
例:
- 映画: md:cid:org:wb:suicidesquadfeature
- シリーズ: md:cid:org:amzn_studios_example:HighCastleSeries
- シーズン: md:cid:org:amzn_studios_example:HighCastle1
- エピソード: md:cid:org:amzn_studios_example:HighCastle1_1
altiIdentifier/IdentifierフィールドはID文字列部分のみを使用します。たとえば、完全なURNではなくHighCastle1_1を使用してください。
更新および部分提出規則
- 以前に納品されたメタデータを更新するには、元のメタデータとまったく同じContentIDを使用してください。
- 最新の提出物(言語ロケールおよび納品タイムスタンプ別)が信頼できるバージョンです。
- LocalizedInfoセクション内の属性の部分更新がサポートされています。
- RatingSetと人物の部分更新はサポートされていません。すべての評価とキャスト/クルーを常に含めてください。
- 同じ言語ロケールのメタデータを2回納品すると、最新のファイルが前のファイルを上書きします。
TVコンテンツ構造
MEC XMLには、TVコンテンツに関する特定の構造規則があります。
- 各エピソードは独自のMEC XMLファイルで納品する必要があります。
- 同じエピソードの複数の言語バリアントは1つのMECファイルにまとめることができます。
- ParentContentIDフィールドを使用して、エピソードが属するシーズンを指定してください。
- Prime Videoでは、シリーズ、シーズン、エピソードXMLの同時納品を優先しています。
- 同時納品が不可能な場合は、順番に納品してください。 最初にシリーズ、次にシーズン、次にエピソード。
アートリファレンス要件
すべてのコンテンツタイプにMECファイル内のアートワーク参照を含める必要があります。
アートワークタイプ |
@purpose値 |
@resolution |
ファイル名パターン |
カバーアート(4:3) |
Cover Art |
3840x2160 |
[タイトル]-[ロケール]-4x3.jpg |
カバーアート(16:9) |
Cover Art |
3840x2160 |
[タイトル]-[ロケール]-16x9.jpg |
ボックスアート(3:4) |
Box Art |
1920x2560 |
[タイトル]-[ロケール]-3x4.jpg |
ポスターアート(2:3) |
Poster Art |
2000x3000 |
[タイトル]-[ロケール]-2x3.jpg |
@resolution属性と@purpose属性の両方がすべてのArtReferenceエントリーに必要です。4つのアートワークタイプはすべて、すべてのコンテンツタイプテンプレートに表示されます。
重要
ジャンルフォーマット
ジャンルは@id属性にAmazon固有のジャンルIDコードを使用する必要があります。LocalizedInfoセクションごとに最大3つのジャンルを使用できます。ストアフロントには2つのジャンルが表示されます。3つ目は公開の範囲アルゴリズムに関するものです。
フォーマット:<md:Genre @id="[genre_code]">
ジャンルコードの例:
- av_genre_action
- av_genre_drama
- av_genre_science_fiction
最初のジャンルエントリーには、Amazonジャンルリストを指す@source属性を含める必要があります。
コンテンツタイプ別の必須フィールド
次の表は、MEC v2.6に基づく各コンテンツタイプのフィールドステータスを示しています。コンテンツタイプの数が多いため、表は以下にまとめられています。
テーブルグループA: 映画、エピソード、シーズン
フィールド |
説明 |
映画 |
エピソード |
シーズン |
@ContentID |
一意のメタデータID。MovieLabsのベストプラクティスに従う必要があります。 |
必須 |
必須 |
必須 |
LocalizedInfo |
ローカライズ可能な要素のブロック。少なくとも1つは必要です。 |
必須 |
必須 |
必須 |
@Language |
Prime Video の許可リストの言語コード。 |
必須 |
必須 |
必須 |
TitleDisplayUnlimited |
タイトルを表示します。最大250文字。Amazonによる使用。 |
必須 |
必須 |
必須 |
TitleDisplay60 |
短いタイトル。最大60文字。 |
推奨 |
推奨 |
必須 |
ArtReference |
解像度と目的の属性が記載されたアートワークファイル。 |
推奨 |
推奨 |
推奨 |
Summary190 |
短いあらすじ。最大190文字。 |
必須 |
必須 |
必須 |
Summary400 |
中程度の長さのあらすじ。最大400文字。 |
必須 |
必須 |
必須 |
Summary4000 |
詳細なあらすじ。最大4,000文字。 |
推奨 |
推奨 |
推奨 |
Genre |
少なくとも1つのPrime Videoのジャンルが必要です。1件のLocalizedInfoにつき最大3つまで。 |
必須 |
必須 |
必須 |
ReleaseYear |
どの地域でも最初にリリースされた年。 |
必須 |
必須 |
必須 |
ReleaseDate |
特定のリリース日。形式: YYYY-MM-DD。 |
必須 |
必須 |
推奨 |
ReleaseHistory |
地域および組織を含む過去のリリースデータ。 |
推奨 |
不使用 |
推奨 |
WorkType |
コンテンツ分類: 映画、エピソード、シーズンなど。 |
必須 |
必須 |
必須 |
WorkTypeDetail |
その他の分類。シリーズでの注文に使用されます。 |
不使用 |
不使用 |
不使用 |
AltIdentifier (Namespace + Identifier) |
外部ID: EIDR、ISAN、IMDb、またはORG。 |
必須 |
必須 |
必須 |
RatingSet |
公式コンテンツ評価。入手可能なすべての評価を提供してください。 |
必須 |
必須 |
必須 |
People |
名前付きのキャストとクルーのエントリー。 |
必須 |
必須 |
必須 |
OriginalLanguage |
オリジナルプロダクションの言語。 |
必須 |
不使用 |
必須 |
AssociatedOrg (@role=licensor) |
IDと役割を持つライセンス組織。 |
必須 |
不使用 |
必須 |
SequenceInfo/Number |
シリーズのエピソードまたはシーズン番号。 |
不使用 |
必須 |
必須 |
Parent/ParentContentID |
エピソードからシーズンに、またはシーズンからシリーズにリンクします。 |
不使用 |
必須 |
必須 |
CompanyDisplayCredit |
お客様に表示されるスタジオ名または会社名。最大250文字。 |
必須 |
必須 |
必須 |
テーブルグループB: シリーズ、予告編、ボーナス、コレクション
フィールドの説明については、テーブルグループAを参照してください。ここでも同じフィールド定義が適用されます。
フィールド |
シリーズ |
予告 |
ボーナス編 |
コレクション |
@ContentID |
必須 |
必須 |
必須 |
必須 |
LocalizedInfo |
必須 |
必須 |
必須 |
必須 |
@Language |
必須 |
必須 |
必須 |
必須 |
TitleDisplayUnlimited |
必須 |
必須 |
必須 |
必須 |
TitleDisplay60 |
推奨 |
推奨 |
推奨 |
必須 |
ArtReference |
推奨 |
推奨 |
推奨 |
推奨 |
Summary190 |
必須 |
必須 |
必須 |
必須 |
Summary400 |
不使用 |
不使用 |
必須 |
必須 |
Summary4000 |
推奨 |
不使用 |
不使用 |
推奨 |
Genre |
必須 |
不使用 |
不使用 |
必須 |
ReleaseYear |
必須 |
必須 |
必須 |
必須 |
ReleaseDate |
推奨 |
不使用 |
不使用 |
推奨 |
ReleaseHistory |
不使用 |
不使用 |
不使用 |
不使用 |
WorkType |
必須 |
必須 |
必須 |
必須 |
WorkTypeDetail |
推奨 |
不使用 |
不使用 |
必須 |
AltIdentifier |
必須 |
必須 |
必須 |
必須 |
RatingSet |
必須 |
必須 |
必須 |
必須 |
People |
不使用 |
不使用 |
不使用 |
不使用 |
OriginalLanguage |
不使用 |
不使用 |
不使用 |
不使用 |
AssociatedOrg (@role=licensor) |
不使用 |
不使用 |
不使用 |
不使用 |
SequenceInfo/Number |
不使用 |
必須 |
必須 |
不使用 |
Parent/ParentContentID |
不使用 |
不使用 |
必須 |
不使用 |
CompanyDisplayCredit |
必須 |
必須 |
必須 |
必須 |
クイックヒント
フィールド詳細の強化
以下の表は、強化された親要素のサブフィールドの詳細を示しています。これらを使用すると、より豊富なメタデータが提供され、公開の範囲が改善されます。
人物サブフィールド
サブフィールド |
説明 |
映画 |
エピソード |
シーズン |
Job |
その人の役割(たとえば、俳優、監督)。 |
必須 |
推奨 |
必須 |
JobFunction |
機能的役割: 監督、プロデューサー、俳優、脚本家、クリエイター。 |
必須 |
推奨 |
必須 |
BillingBlockOrder |
詳細ページのキャスト表示順序を制御します。 |
推奨 |
推奨 |
推奨 |
Character |
キャストメンバーが演じたキャラクター名。 |
推奨 |
推奨 |
推奨 |
Guest |
公開の範囲向けに、ゲスト出演者にフラグを立てます。 |
推奨 |
推奨 |
推奨 |
Name/DisplayName |
その人物の完全な表示名。 |
必須 |
必須 |
必須 |
Name/SortName |
アルファベット順にソート可能な名前。 |
推奨 |
推奨 |
推奨 |
Gender |
その人の性別。パーソナライズされたおすすめ機能をサポートします。 |
推奨 |
推奨 |
推奨 |
RatingSetサブフィールド
以下のRatingSetサブフィールドはすべてのコンテンツタイプに適用されます。
サブフィールド |
説明 |
映画 |
エピソード |
シーズン |
Rating |
コンテンツ評価ブロック。 |
必須 |
必須 |
必須 |
Region |
この評価が適用される地理的地域。 |
必須 |
必須 |
必須 |
Country |
評価が適用されるISOの国コード。 |
必須 |
必須 |
必須 |
System |
使用されている評価システム(MPAA、BBFCなど)。 |
必須 |
必須 |
必須 |
Value |
評価値(たとえば、PG-13、12A)。 |
必須 |
必須 |
必須 |
Reason |
評価の説明はタイトルの詳細ページに表示されます。 |
推奨 |
推奨 |
推奨 |
NotRated |
どの地域にも正式な評価が存在しない場合に使用します。 |
必須 |
必須 |
必須 |
IsAdult |
アダルトコンテンツにフラグを付けて分類とフィルタリングを行います。 |
推奨 |
推奨 |
推奨 |
ReleaseHistoryサブフィールド(映画とシーズン)
サブフィールド |
説明 |
映画 |
シーズン |
DistrTerritory |
納品地域の国コード。 |
推奨 |
推奨 |
ReleaseOrg |
このリリースに関係する組織。 |
推奨 |
推奨 |
@organizationID |
リリース組織の一意のID。 |
推奨 |
推奨 |
@idType |
使用されている組織IDのタイプ。 |
推奨 |
推奨 |
@role |
リリースにおける組織の役割。 |
推奨 |
推奨 |
DisplayName |
リリース組織の名前を表示します。 |
推奨 |
推奨 |
SortName |
リリース組織のソート可能な名前。 |
推奨 |
推奨 |
AssociatedOrgサブフィールド(映画とシーズン)
サブフィールド |
説明 |
映画 |
シーズン |
@organizationID |
ライセンス機関の一意のID。 |
必須 |
必須 |
@role |
「ライセンサー」でなければなりません。 |
必須 |
必須 |
DisplayName |
ライセンサーの名前を表示します。 |
推奨 |
推奨 |
SortName |
アルファベット順にソート可能な名前。 |
推奨 |
推奨 |
AlternateName |
ライセンサーの別名。 |
推奨 |
推奨 |
LocalizedInfo強化サブフィールド
サブフィールド |
説明 |
映画 |
エピソード |
シーズン |
Region |
ローカライズされたメタデータの地理的地域。 |
推奨 |
推奨 |
推奨 |
Country |
ローカライズされたメタデータの国コード。 |
推奨 |
推奨 |
推奨 |
OriginalTitle |
元の言語でのタイトル。国際コンテンツの検索が改善されます。 |
推奨 |
推奨 |
推奨 |
PeopleLocal |
ローカルマーケット検索用のローカライズされたキャスト/クルー名。 |
推奨 |
推奨 |
推奨 |
その他の強化フィールド
フィールド |
説明 |
映画 |
エピソード |
シーズン |
CountryOfOrigin |
タイトルが制作された国。 |
推奨 |
推奨 |
推奨 |
PrimarySpokenLanguage |
コンテンツ内の主な話し言葉。 |
推奨 |
推奨 |
推奨 |
VersionLanguage |
この特定のメタデータエントリーの言語バージョン。 |
推奨 |
推奨 |
推奨 |
RunLength |
タイトルのランタイム。詳細ページに表示されます。 |
推奨 |
推奨 |
不使用 |
Location |
メタデータの精度を高めるための地理的位置データ。 |
推奨 |
推奨 |
推奨 |
親関係の値
コンテンツタイプ |
@relationshipType |
ParentContentIDが指す先 |
Episode |
isepisodeof |
シーズンContentID |
Season |
isseasonof |
シリーズContentID |
Trailer |
ispromotionfor |
映画またはシーズンのContentID |
Bonus |
issupplementalto |
映画またはシーズンのContentID |
シーズンとエピソードの順序づけ
シリーズレベルでWorkTypeDetailを使用して、シーズンとエピソードをお客様へ表示する方法をカスタマイズできます。
値 |
動作 |
最適な用途 |
StartAtLatestSeasonFirstEpisode |
エピソード1から最新シーズンを最初に表示します。 |
アンソロジーシリーズ、ニュース、スポーツ、トークショー、ゲーム番組 |
StartAtLatestSeasonLatestEpisode |
最新シーズンと最新エピソードを最初に表示します。 |
最新コンテンツが最も関連性の高いニュース、スポーツ、トーク番組 |
Chronological |
標準的な時系列順序。 |
時計の順番が重要なトラディショナルシリーズ |
(No value set) |
コンテンツタイプに基づく自動の順序付け。 |
デフォルトの動作 |
- この値はシリーズレベルのMECでのみ設定します。すべてのシーズンに自動的に適用されます。
- このフィールドはテレビシリーズにのみ適用されます。映画やVAMには適用されません。
- この値はいつでも更新できます。変更はMECが処理された後に有効になります。
- 対象となるコンテンツタイプ(ニュース、スポーツ、トーク番組、ゲーム番組)には自動的に逆順が適用されます。
多言語サポート
サンプルファイルリポジトリのエピソードテンプレートは、単一のMECファイルで複数の言語を納品する方法を示しています。言語ロケールごとに個別のLocalizedInfoブロックを含めてください。
構造の例:
- 最初のLocalizedInfoブロック:@language =「en-US」(タイトル、アートワーク、あらすじ、ジャンル付き)
- 2番目のLocalizedInfoブロック:@language = 「es-419」(ローカライズされたタイトル、アートワーク、あらすじ、ジャンル付き)
各LocalizedInfoブロックには、独自のTitleDisplayUnlimited、ArtReferenceエントリ、Summary190、Summary400、およびGenleエントリーが含まれている必要があります。
廃棄されたMEC XMLフィールド
以下のフィールドはMEC XSDでは使用できますが、Prime Video では使用されません。XSD準拠のためにこれらを含めることもできますが、効果はありません。
- UpdateNum
- LocalizedInfo @Default
- TitleSort(XSD準拠のため空のタグでも可)
- Keyword
- AlternateTitle
- PictureColorType
- PictureFormat
- AspectRatio
- DistributionNumber
- HouseSequence
- CountryRegion(LocalizedInfoおよびRatingSet内)
特殊文字エンコーディング
シノプシスフィールド内の特殊文字は、正しくエンコードされていないと公開エラーの原因となります。これらのXMLエンティティ参照を使用してください。
記号 |
Enter As |
< |
< |
> |
> |
& |
& |
' |
' |
" |
" |
パイプ(|)、ピリオド(.)、ハッシュ(#)、フォワードスラッシュ(/)、感嘆符(!)は、エンコードしなくてもそのまま使用できます。
MEC XML内の付加価値素材(VAM)コンテンツ
予告編とボーナス素材は個別のコンテンツエンティティとして扱われます。トレーラーと特典の納品に関する詳細なガイダンスについては、付加価値素材(VAM)ガイドをご覧ください。ほとんどのスタンダードMEC値が適用されます。納品に関する主なポイント:
- トレーラーにはWorkType =「promotion」を使用してください。
- ボーナスコンテンツにはWorkType =「supplemental」を使用してください。
- 親関係のタイプは「ispromotionfor」または「issupplementalto」である必要があります。
- SequenceInfoブロックと親ブロックが必要です。
ローカリゼーションの要件
- メタデータは複数の言語で納品できます。
- 各ローカライズ版では、言語コードを指定する必要があります。
- タイトル名や概要などのローカライズされたフィールドでは、部分的な更新がサポートされています。
- 評価とキャスト/クルーの一部更新はサポートされていません。常に利用可能なすべてのデータを含めてください。
- 特定の言語で提出された最新の提出物(納品タイムスタンプ順)が正式版です。
始める前に知っておくこと
MEC XMLを自動的に生成します。手動で作成するとエラーが発生します。
@ContentIDとParentContentIDには完全なURN形式(md:cid:org:[partner_alias]:[id])を使用してください。
AltiIdentifier/IdentifierフィールドにはID文字列(URNではなく)のみを使用してください。
MMCに含める予定がない限り、すべてのコンテンツタイプに4つのArtReferenceエントリをすべて含めてください。MMCは、Amazonが推奨するアートワークの納品方法です。
シリーズレベルのMECでは、ユーザーやReleaseDateは必要ありません。それらを含めないでください。
シーズンレベルのMECでは、ReleaseDateやReleaseHistoryは必要ありません。ReleaseYearだけが必要です。
すべての投稿には、常にすべての評価とキャスト/クルーを含めてください。これらについては、部分的な更新はサポートされていません。
各エピソードには独自のMECファイルが必要です。エピソードを1つのXMLにまとめないでください。
シノプシスフィールドには特殊文字をエンコードして、公開ミスを防ぎます。
WorkTypeDetailをシリーズレベルでのみ設定します。オールシーズンにカスケードします。
クイックヒント
送信前にXSDと照合して迅速に検証することで、何度もやり取りする時間を節約できます。
質問がありますか? お問い合わせサポートチケットを作成する前にサポートアシスタントに問い合わせるか、Prime Videoの連絡先に連絡してください。