MEC-Metadaten (Media Entertainment Core-Metadaten) werden verwendet, wenn du dich für die Veröffentlichung über die MovieLabs-Spezifikation entscheidest. Wenn du Einzeltitel-Upload oder mRSS verwendest, gelten die MEC-Metadaten nicht für dich.
MEC-Dateien müssen der MovieLabs MEC-Spezifikation v2.6 mit Amazon-spezifischen Anforderungen entsprechen. Wenn Konflikte bestehen, haben die Prime Video-Anforderungen Vorrang. Sieh dir unsere MEC-Beispieldateien in unserem Beispieldatei-Repository an.
Sieh dir dieses Video an, um einen kurzen Überblick über die Anforderungen an Titel-Metadaten bei Prime Video zu erhalten. Weitere Informationen zu den Grundlagen von Titel-Metadaten findest du im folgenden Leitfaden:
MEC XML-Bereitstellungsstandards
Befolge diese Regeln für jede MEC-XML-Einreichung.
- Dein XML muss automatisch generiert werden. Die manuelle XML-Erstellung führt zu Bereitstellungsfehlern.
- Das Einreichen von MEC-Dateien muss den Prime Video-Regeln für die Benennung von Dateien entsprechen.
- Die XML-Schemadefinition (XSD) und die Dokumentation befinden sich im Beispieldateipaket.
- ContentID- und WorkType-Werte werden bei der ersten Einreichung festgelegt. Ein erneutes Senden mit anderen Werten führt zu einem Bereitstellungsfehler.
ContentID-Format
Deine ContentID muss diesem URN-Format im @ContentID-Attribut folgen. Die unique_ID oder Inhalts-ID (SKU) ist die AltID/ALID innerhalb der MovieLabs-Spezifikation.
Format: md:cid:org:[partner_alias]:[unique_id]
Beispiele:
- Film: md:cid:org:wb:suicidesquadfeature
- Serien: md:cid:org:amzn_studios_example:HighCastleSeries
- Staffel: md:cid:org:amzn_studios_example:HighCastle1
- Folge: md:cid:org:amzn_studios_example:HighCastle1_1
Das Feld AltIdentifier/Identifier verwendet nur den Teil der ID-Zeichenfolge. Verwende beispielsweise HighCastle1_1, nicht den vollständigen URN.
Regeln für Aktualisierungen und teilweise Einreichungen
- Um zuvor bereitgestellte Metadaten zu aktualisieren, verwende exakt dieselbe ContentID wie das Original.
- Deine letzte Einreichung (nach language-LOCALE und Bereitstellungszeitstempel) ist deine maßgebliche Version.
- Teilaktualisierungen WERDEN für Attribute in LocalizedInfo-Abschnitten unterstützt.
- Teilaktualisierungen werden für RatingSet und People NICHT unterstützt. Gib immer alle Alterseinstufungen und Darstellende/Crew-Mitglieder an.
- Wenn du Metadaten für dasselbe language-LOCALE zweimal bereitstellst, überschreibt die neueste Datei die vorherige.
Struktur von TV-Inhalten
MEC XML hat spezifische Strukturregeln für TV-Inhalte.
- Jede Folge muss in einer eigenen MEC-XML-Datei bereitgestellt werden.
- Mehrere Sprachvarianten derselben Folge können in einer einzelnen MEC kombiniert werden.
- Verwende das Feld ParentContentID, um anzugeben, zu welcher Staffel eine Folge gehört.
- Prime Video bevorzugt die gleichzeitige Bereitstellung von Serien-, Staffel- und Folgen-XMLs.
- Wenn eine gleichzeitige Bereitstellung nicht möglich ist, stelle nacheinander bereit: Zuerst Serie, dann Staffel, dann Folge.
Anforderungen an Grafikreferenzen
Alle Kategorien des Inhalts müssen Grafikreferenzen in der MEC-Datei enthalten.
Grafiktyp |
@purpose-Wert |
@resolution |
Dateinamenmuster |
Cover-Grafik (4:3) |
Cover-Grafiken |
3840 x 2160 |
[title]-[locale]-4x3.jpg |
Cover-Grafik (16:9) |
Cover-Grafiken |
3840 x 2160 |
[title]-[locale]-16x9.jpg |
Box-Grafik (3:4) |
Verpackungsgrafik |
1920x2560 |
[title]-[locale]-3x4.jpg |
Postergrafik (2:3) |
Posterbildmaterial |
2000 x 3000 |
[title]-[locale]-2x3.jpg |
Sowohl @resolution- als auch @purpose-Attribute sind für jeden ArtReference-Eintrag erforderlich. Alle vier Grafiktypen sind in jeder Vorlage von Kategorien des Inhalts enthalten.
Wichtig
Genre-Format
Genres müssen Amazon-spezifische Genre-ID-Codes im @id-Attribut verwenden. Pro LocalizedInfo-Abschnitt sind bis zu drei Genres zulässig. Zwei Genres werden in der Storefront angezeigt; das dritte dient den Sichtbarkeitsalgorithmen.
Format: <md:Genre @id="[genre_code]">
Beispiele für Genre-Codes:
- av_genre_action
- av_genre_drama
- av_genre_science_fiction
Der erste Genreeintrag muss das @source-Attribut enthalten, das auf die Amazon-Genreliste verweist.
Erforderliche Felder nach Kategorie des Inhalts
Die folgenden Tabellen zeigen Feldstatus für jede Kategorie des Inhalts auf der Grundlage von MEC v2.6. Aufgrund der Anzahl der Kategorien des Inhalts sind die Tabellen unten gruppiert.
Tabellengruppe A: Film, Folge und Staffel
Feld |
Beschreibung |
Film |
Folge |
Staffel |
@ContentID |
Eindeutige Metadaten-ID. Muss den bewährten Verfahren von MovieLabs folgen. |
Erforderlich |
Erforderlich |
Erforderlich |
LocalizedInfo |
Block lokalisierbarer Elemente. Mindestens ein Eintrag ist erforderlich. |
Erforderlich |
Erforderlich |
Erforderlich |
@Language |
Sprachcode aus der Positivliste der Prime Video-Sprachen. |
Erforderlich |
Erforderlich |
Erforderlich |
TitleDisplayUnlimited |
Anzeigetitel. Max. 250 Zeichen. Wird von Amazon verwendet. |
Erforderlich |
Erforderlich |
Erforderlich |
TitleDisplay60 |
Kurzer Titel. Max. 60 Zeichen |
Erweitert |
Erweitert |
Erforderlich |
ArtReference |
Grafikdateien mit Auflösungs- und Verwendungsattributen. |
Erweitert |
Erweitert |
Erweitert |
Summary190 |
Kurze Zusammenfassung. Max. 190 Zeichen. |
Erforderlich |
Erforderlich |
Erforderlich |
Summary400 |
Mittlere Zusammenfassung. Max. 400 Zeichen. |
Erforderlich |
Erforderlich |
Erforderlich |
Summary4000 |
Erweiterte Zusammenfassung. Max. 4.000 Zeichen. |
Erweitert |
Erweitert |
Erweitert |
Genre |
Mindestens ein Prime Video-Genre. Bis zu 3 pro LocalizedInfo. |
Erforderlich |
Erforderlich |
Erforderlich |
ReleaseYear |
Jahr der ersten Veröffentlichung in einem beliebigen Gebiet. |
Erforderlich |
Erforderlich |
Erforderlich |
ReleaseDate |
Spezifisches Veröffentlichungsdatum. Format: JJJJ-MM-TT. |
Erforderlich |
Erforderlich |
Erweitert |
ReleaseHistory |
Historische Veröffentlichungsdaten mit Gebiet und Organisation. |
Erweitert |
Verworfen |
Erweitert |
WorkType |
Klassifizierung des Inhalts: Film, Folge, Staffel usw. |
Erforderlich |
Erforderlich |
Erforderlich |
WorkTypeDetail |
Zusätzliche Klassifizierung. Wird für die Bestellung in Serien verwendet. |
Verworfen |
Verworfen |
Verworfen |
AltIdentifier (Namespace + Identifier) |
Externe ID: EIDR, ISAN, IMDB oder ORG. |
Erforderlich |
Erforderlich |
Erforderlich |
RatingSet |
Offizielle Alterseinstufung. Gib alle verfügbaren Alterseinstufungen an. |
Erforderlich |
Erforderlich |
Erforderlich |
People |
Namen der Darstellenden und Crew-Mitglieder. |
Erforderlich |
Erforderlich |
Erforderlich |
OriginalLanguage |
Sprache der Originalproduktion. |
Erforderlich |
Verworfen |
Erforderlich |
AssociatedOrg (@role=licensor) |
Lizenzierungsorganisation mit ID und Rolle. |
Erforderlich |
Verworfen |
Erforderlich |
SequenceInfo/Number |
Folge- oder Staffelnummer in der Serie. |
Verworfen |
Erforderlich |
Erforderlich |
Parent/ParentContentID |
Verknüpft Folge mit Staffel oder Staffel mit Serie. |
Verworfen |
Erforderlich |
Erforderlich |
CompanyDisplayCredit |
Den Kundinnen und Kunden wird der Studio- oder Firmenname angezeigt. Max. 250 Zeichen. |
Erforderlich |
Erforderlich |
Erforderlich |
Tabellengruppe B: Serien, Trailer, Bonusmaterial und Sammlung
Feldbeschreibungen findest du in Tabellengruppe A. Hier gelten die gleichen Felddefinitionen.
Feld |
Serien |
Trailer |
Bonusmaterial |
Sammlung |
@ContentID |
Erforderlich |
Erforderlich |
Erforderlich |
Erforderlich |
LocalizedInfo |
Erforderlich |
Erforderlich |
Erforderlich |
Erforderlich |
@Language |
Erforderlich |
Erforderlich |
Erforderlich |
Erforderlich |
TitleDisplayUnlimited |
Erforderlich |
Erforderlich |
Erforderlich |
Erforderlich |
TitleDisplay60 |
Erweitert |
Erweitert |
Erweitert |
Erforderlich |
ArtReference |
Erweitert |
Erweitert |
Erweitert |
Erweitert |
Summary190 |
Erforderlich |
Erforderlich |
Erforderlich |
Erforderlich |
Summary400 |
Verworfen |
Verworfen |
Erforderlich |
Erforderlich |
Summary4000 |
Erweitert |
Verworfen |
Verworfen |
Erweitert |
Genre |
Erforderlich |
Verworfen |
Verworfen |
Erforderlich |
ReleaseYear |
Erforderlich |
Erforderlich |
Erforderlich |
Erforderlich |
ReleaseDate |
Erweitert |
Verworfen |
Verworfen |
Erweitert |
ReleaseHistory |
Verworfen |
Verworfen |
Verworfen |
Verworfen |
WorkType |
Erforderlich |
Erforderlich |
Erforderlich |
Erforderlich |
WorkTypeDetail |
Erweitert |
Verworfen |
Verworfen |
Erforderlich |
AltIdentifier |
Erforderlich |
Erforderlich |
Erforderlich |
Erforderlich |
RatingSet |
Erforderlich |
Erforderlich |
Erforderlich |
Erforderlich |
People |
Verworfen |
Verworfen |
Verworfen |
Verworfen |
OriginalLanguage |
Verworfen |
Verworfen |
Verworfen |
Verworfen |
AssociatedOrg (@role=licensor) |
Verworfen |
Verworfen |
Verworfen |
Verworfen |
SequenceInfo/Number |
Verworfen |
Erforderlich |
Erforderlich |
Verworfen |
Parent/ParentContentID |
Verworfen |
Verworfen |
Erforderlich |
Verworfen |
CompanyDisplayCredit |
Erforderlich |
Erforderlich |
Erforderlich |
Erforderlich |
Schneller Tipp
Verbesserte Felddetails
Die folgenden Tabellen zeigen Unterfelddetails für erweiterte übergeordnete Elemente. Verwende diese, um umfassendere Metadaten bereitzustellen und die Sichtbarkeit zu verbessern.
Personen-Unterfelder
Unterfeld |
Beschreibung |
Film |
Folge |
Staffel |
Job |
Die Jobbezeichnung der Person (zum Beispiel Schauspielende, Regie). |
Erforderlich |
Erweitert |
Erforderlich |
JobFunction |
Funktionelle Rolle: Regisseur(in), Produzent(in), Schauspielende, Autor(in) oder Creator. |
Erforderlich |
Erweitert |
Erforderlich |
BillingBlockOrder |
Steuert die Darstellungsreihenfolge der Darstellenden auf der Detailseite. |
Erweitert |
Erweitert |
Erweitert |
Charakter |
Charaktername, gespielt von dem oder der Darstellenden. |
Erweitert |
Erweitert |
Erweitert |
Gast |
Kennzeichnet Gastauftritte zur Sichtbarkeit. |
Erweitert |
Erweitert |
Erweitert |
Name/DisplayName |
Vollständiger Anzeigename der Person. |
Erforderlich |
Erforderlich |
Erforderlich |
Name/SortName |
Sortierbarer Name für alphabetische Sortierung. |
Erweitert |
Erweitert |
Erweitert |
Gender |
Geschlecht der Person. Unterstützt personalisierte Empfehlungen. |
Erweitert |
Erweitert |
Erweitert |
RatingSet-Unterfelder
Die folgenden RatingSet-Unterfelder gelten für alle Kategorien des Inhalts.
Unterfeld |
Beschreibung |
Film |
Folge |
Staffel |
Alterseinstufung |
Der Alterseinstufungsblock des Inhalts. |
Erforderlich |
Erforderlich |
Erforderlich |
Region |
Geografische Region, in der die Alterseinstufung gilt. |
Erforderlich |
Erforderlich |
Erforderlich |
Country |
ISO-Ländercode, für den die Alterseinstufung gilt. |
Erforderlich |
Erforderlich |
Erforderlich |
System |
Verwendetes Alterseinstufungssystem (zum Beispiel MPAA, BBFC). |
Erforderlich |
Erforderlich |
Erforderlich |
Value |
Der Alterseinstufungswert (zum Beispiel PG-13, 12A). |
Erforderlich |
Erforderlich |
Erforderlich |
Reason |
Die Beschreibung der Alterseinstufung wird auf der Titeldetailseite angezeigt. |
Erweitert |
Erweitert |
Erweitert |
NotRated |
Wird verwendet, wenn in keinem Gebiet eine offizielle Alterseinstufung existiert. |
Erforderlich |
Erforderlich |
Erforderlich |
IsAdult |
Kennzeichnet Inhalte für Erwachsene zur Klassifizierung und Filterung. |
Erweitert |
Erweitert |
Erweitert |
ReleaseHistory-Unterfelder (Film und Staffel)
Unterfeld |
Beschreibung |
Film |
Staffel |
DistrTerritory |
Ländercode für das Verbreitungsgebiet. |
Erweitert |
Erweitert |
ReleaseOrg |
Organisation, die an dieser Veröffentlichung beteiligt ist. |
Erweitert |
Erweitert |
@organizationID |
Eindeutige ID der veröffentlichenden Organisation. |
Erweitert |
Erweitert |
@idType |
Art der verwendeten Organisations-ID. |
Erweitert |
Erweitert |
@role |
Rolle der Organisation in der Veröffentlichung. |
Erweitert |
Erweitert |
DisplayName |
Zeigt den Namen der veröffentlichenden Organisation an. |
Erweitert |
Erweitert |
SortName |
Sortierbarer Name der veröffentlichenden Organisation. |
Erweitert |
Erweitert |
AssociatedOrg-Unterfelder (Film und Staffel)
Unterfeld |
Beschreibung |
Film |
Staffel |
@organizationID |
Eindeutige ID der Lizenzierungsorganisation. |
Erforderlich |
Erforderlich |
@role |
Muss „licensor“ sein. |
Erforderlich |
Erforderlich |
DisplayName |
Anzeigename des Lizenzgebers. |
Erweitert |
Erweitert |
SortName |
Sortierbarer Name für alphabetische Sortierung. |
Erweitert |
Erweitert |
AlternateName |
Alternativer Name für den Lizenzgeber. |
Erweitert |
Erweitert |
Erweiterte Unterfelder von LocalizedInfo
Unterfeld |
Beschreibung |
Film |
Folge |
Staffel |
Region |
Geografische Region für lokalisierte Metadaten. |
Erweitert |
Erweitert |
Erweitert |
Country |
Ländercode für lokalisierte Metadaten. |
Erweitert |
Erweitert |
Erweitert |
OriginalTitle |
Titel in der Originalsprache. Verbessert die Suche nach internationalen Inhalten. |
Erweitert |
Erweitert |
Erweitert |
PeopleLocal |
Lokalisierte Namen der Darstellenden/Crew-Mitglieder für die lokale Suche. |
Erweitert |
Erweitert |
Erweitert |
Zusätzliche erweiterte Felder
Feld |
Beschreibung |
Film |
Folge |
Staffel |
CountryOfOrigin |
Land, in dem der Titel produziert wurde. |
Erweitert |
Erweitert |
Erweitert |
PrimarySpokenLanguage |
Wichtigste gesprochene Sprache im Inhalt. |
Erweitert |
Erweitert |
Erweitert |
VersionLanguage |
Sprachversion dieses spezifischen Metadateneintrags. |
Erweitert |
Erweitert |
Erweitert |
RunLength |
Laufzeit des Titels. Wird auf der Detailseite angezeigt. |
Erweitert |
Erweitert |
Verworfen |
Ort |
Geografische Standortdaten für die Genauigkeit der Metadaten. |
Erweitert |
Erweitert |
Erweitert |
Werte der übergeordneten Beziehung
Kategorie des Inhalts |
@relationshipType |
ParentContentID verweist auf |
Folge |
isepisodeof |
Staffel-ContentID |
Staffel |
isseasonof |
Serien-ContentID |
Trailer |
ispromotionfor |
Film- oder Staffel-ContentID |
Bonusmaterial |
issupplementalto |
Film- oder Staffel-ContentID |
Staffel- und Folgenreihenfolge
Mithilfe von WorkTypeDetail auf Serienebene kannst du anpassen, wie Staffeln und Folgen für Kundinnen und Kunden angezeigt werden.
Value |
Verhalten |
Geeignet für |
StartAtLatestSeasonFirstEpisode |
Zeigt die neueste Staffel zuerst an, ab Folge 1. |
Anthologieserien, Nachrichten, Sport, Talkshows, Spielshows |
StartAtLatestSeasonLatestEpisode |
Zeigt zuerst die neueste Staffel und die neueste Folge an. |
Nachrichten, Sport, Talkshows, bei denen der neueste Inhalt am relevantesten ist |
Chronological |
Chronologische Standardreihenfolge. |
Traditionelle Serie, bei der es auf die Reihenfolge des Ansehens ankommt |
(Kein Wert festgelegt) |
Automatische Bestellung basierend auf dem Inhaltstyp. |
Standardverhalten |
- Stelle diesen Wert nur auf den MEC auf Serienebene ein. Es gilt automatisch für alle Staffeln.
- Dieses Feld gilt nur für Fernsehserien. Gilt nicht für Filme oder VAM.
- Du kannst diesen Wert jederzeit aktualisieren. Änderungen werden wirksam, nachdem der MEC verarbeitet wurde.
- Die umgekehrte Reihenfolge wird automatisch auf berechtigte Inhaltstypen angewendet (Nachrichten, Sport, Talkshows, Spielshows).
Mehrsprachiger Support
Die Folgenvorlage im Beispieldatei-Repository zeigt, wie mehrere Sprachen in einer einzigen MEC-Datei bereitgestellt werden. Füge für jedes language-LOCALE einen separaten LocalizedInfo-Block hinzu.
Beispielstruktur:
- Erster LocalizedInfo-Block: @language="en-US” (mit Titel, Grafikmaterial, Zusammenfassungen, Genres)
- Zweiter LocalizedInfo-Block: @language="en-419" (mit lokalisiertem Titel, Grafikmaterial, Zusammenfassungen, Genres)
Jeder LocalizedInfo-Block muss seine eigenen TitleDisplayUnlimited, ArtReference-Einträge, Summary190, Summary400 und Genre-Einträge enthalten.
Verworfene MEC-XML-Felder
Die folgenden Felder werden vom MEC XSD akzeptiert, von Prime Video jedoch nicht verwendet. Du kannst sie aus Gründen der XSD-Konformität hinzufügen, aber sie haben keine Wirkung.
- UpdateNum
- LocalizedInfo @Default
- TitleSort (leere Tags sind aus Gründen der XSD-Konformität zulässig)
- Keyword
- AlternateTitle
- PictureColorType
- PictureFormat
- AspectRatio
- DistributionNumber
- HouseSequence
- CountryRegion (in LocalizedInfo und RatingSet)
Codierung von Sonderzeichen
Sonderzeichen in Übersichtsfeldern führen zu Veröffentlichungsfehlern, wenn sie nicht richtig codiert sind. Verwende diese XML-Entitätsreferenzen.
Symbol |
Eingeben als |
< |
< |
> |
> |
& |
& |
' |
' |
" |
" |
Pipe (|), Punkt (.), Hashtag (#), Schrägstrich (/) und Ausrufezeichen (!) können unverändert ohne Kodierung verwendet werden.
Inhalt des Zusatzmaterials (VAM) im MEC-XML
Trailer und Bonusmaterial werden als eigenständige Inhaltseinheiten behandelt. Eine ausführliche Anleitung zur Bereitstellung von Trailern und Boni findest du im Leitfaden für Zusatzmaterial (VAM). Es gelten die meisten Standard-MEC-Werte. Wichtige Bereitstellungspunkte:
- Verwende workType = „promotion“ für Trailer.
- Verwende WorkType = „supplemental“ für Bonusinhalte.
- Der übergeordnete Beziehungstyp muss „ispromotionfor“ oder „issupplementalto“ sein.
- SequenceInfo und übergeordnete Blöcke sind erforderlich.
Lokalisierungsanforderungen
- Metadaten können in mehreren Sprachen bereitgestellt werden.
- Jede lokalisierte Version muss ihren Sprachcode angeben.
- Teilaktualisierungen werden für lokalisierte Felder wie Titelname und Zusammenfassung unterstützt.
- Teilaktualisierungen für Bewertungen und Darstellende/Crew-Mitglieder werden NICHT unterstützt. Schließe immer alle verfügbaren Daten ein.
- Deine letzte Einreichung (mit Bereitstellungszeitstempel) für eine bestimmte Sprache ist deine maßgebliche Version.
Gut zu wissen, bevor du loslegst
Generiere dein MEC-XML automatisch. Die manuelle Erstellung verursacht Fehler.
Verwende das vollständige URN-Format (md:cid:org: [partner_alias]: [id]) für @ContentID und parentContentId.
Verwende nur die ID-Zeichenfolge (nicht die URN) im AltIdentifier/Identifier-Feld.
Füge alle vier ArtReference-Einträge für jeden Inhaltstyp hinzu, es sei denn, du planst, diese in die MMC aufzunehmen. Die MMC ist Amazons bevorzugte Bereitstellungsmethode für Grafiken.
MEC auf Serienebene erfordert weder People noch ReleaseDate. Schließe sie nicht ein.
MEC auf Staffelebene erfordert weder ReleaseDate noch ReleaseHistory. Nur ReleaseYear wird benötigt.
Gib bei jeder Einreichung immer alle Alterseinstufungen und Darstellenden/Crew-Mitglieder an. Für diese werden keine Teilupdates unterstützt.
Jede Folge benötigt eine eigene MEC-Datei. Kombiniere keine Folgen zu einem XML.
Codiere Sonderzeichen in Übersichtsfeldern, um Veröffentlichungsfehler zu vermeiden.
Stelle WorkTypeDetail nur auf Serienebene ein. Es kaskadiert zu allen Staffeln.
Schneller Tipp
Eine schnelle Validierung anhand der XSD vor dem Absenden kann tagelanges Hin und Her ersparen.
Hast du Fragen? Frage den Support-Assistenten, bevor du ein Kontakt-Supportticket erstellst oder wende dich an deinen Prime Video-Kontakt.