מאפייני סימון תוכן של סרטים

המקטע הזה מספק את הפרטים של מאפייני תגי העיצוב של תוכן עבור סוג הישות Movie.

טבלת מפרט

נכס הסוג הצפוי תיאור
@context טקסט חובה – תמיד מוגדר לערך ["http://schema.org", {"@language": "xx"}]
  • איפה" xx" שמייצג את השפה של המחרוזות בפיד. לכל הקשר של ישות בסיסית צריך להגדיר את שפת ה-@ שלו לקוד השפה המתאים בפורמט פורמט BCP 47. לדוגמה, אם השפה מוגדרת לספרדית, ההנחה היא שהשמות הם בספרדית, גם אם שפת הכתוביות היא אנגלית.
@type טקסט חובה – תמיד מוגדר לערך Movie עבור סרטים.
@id כתובת URL חובה – מזהה התוכן בפורמט URI; לדוגמה, https://example.com/1234abc.
@id חייב לעמוד בדרישות הבאות:
  • ייחודי בכל העולם בקטלוג שלך
  • סטטי; המזהה צריך להיות יציב ולא להשתנות לאורך זמן (גם אם מאפיין כתובת ה-URL של התוכנית משתנה). הוא ייחשב כמחרוזת אטומה ולא חייב להיות קישור פעיל.
  • בפורמט של מזהה משאבים מאוחד (URI)
  • הדומיין שמשמש לערך @id חייב להיות בבעלות הארגון.
מכיוון שה-url של ישות עומד בכל הדרישות כמזהה, אנחנו ממליצים להשתמש ב-url של ישות בתור @id. פרטים נוספים זמינים בקטע מזהה.
url כתובת URL חובהכתובת ה-URL הקנונית של התוכן, ש-Google משתמשת בה כדי להתאים את התוכן בפיד לתוכן במסדי הנתונים של Google.
url חייבת לעמוד בדרישות הבאות:
  • url חייב להיות ייחודי בכל העולם
  • url חייבת להכיל כתובת URL קנונית פעילה ש-Google יכולה לסרוק.
לקישור העומק של הפעלה, כדאי לעיין במאפיין urlTemplate של אובייקט היעד.
name טקסט חובה – שם הסרט.
  • להשתמש במערך כדי להציג את השמות בשפות שונות. אפשר לעיין בדוגמה במספר אזורים ושפות.
  • לתשומת ליבכם: אפשר להזין רק שם אחד לכל לוקאל (צמד שפה-מדינה).
titleEIDR טקסט מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג ברמה הכללית/המופשטת ביותר יצירת סרטים או תוכן בטלוויזיה.

לדוגמה, titleEIDR של סרט הסרט 'מכסחי רפאים' הוא '10.5240/7EC7-228A-510A-053E-CBB8-J'.
editEIDR טקסט מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג מהדורה ספציפית של יצירה או סרט טלוויזיה.

לדוגמה, הסרט שמכונה "מכסחי השדים" שכותרת EIDR היא "10.5240/7EC7-228A-510A-053E-CBB8-J", וביצעו כמה עריכות, למשל: "10.5240/1F2A-E1C5-680A-14C6-E76B-I" ו-"10.5240/8A35-3BEE-6497-5D12-9E4F-3".

titleEIDR הוא מאפיין חובה כשמציינים EditEIDR.
potentialAction WatchAction חובה אם רלוונטיאובייקט תגי עיצוב של פעולה שמספק את פרטי הפעולה.
  • אם התוכן זמין ב-Video על פי דרישה (VoD), הנכס הזה נדרש. אובייקט תגי העיצוב של הפעולה צריך לספק את קישור העומק של התוכן.
  • אם התוכן זמין בערוץ LiveTV, הנכס הזה הוא אופציונלי. הישות BroadcastService המשויכת מספקת במקום זאת את קישור העומק של הערוץ.
  • המכשיר Movie יכול להיות זמין ב-VoD וגם ב-LiveTV.
שימוש במערך כדי לציין קישורי עומק שונים במספר אזורים. אפשר לעיין בדוגמה במספר אזורים ושפות.
sameAs כתובת URL מומלץ מאוד למה? כתובת URL של דף אינטרנט שיכול לזהות את הסרט. לדוגמה, דף ויקיפדיה של הסרט. הערך הזה חייב להיות שונה מהמאפיין url.
inLanguage טקסט השפה המקורית של הסרט בפורמט BCP 47.
genre טקסט רשימה ממוינת של כל הז'אנרים הרלוונטיים. לדוגמה : ["פעולה", "אופנה", "סביבה", "כדורגל"]
keywords טקסט מילות המפתח או התגים שמשמשים לתיאור התוכן הזה. מותר גם להשתמש במערך מילות מפתח. לדוגמה, המילה ["תכונה, ביוגרפיה"] יכולה להיות מערך של מילות מפתח שמתארות את התוכן.
releasedEvent PublicationEvent, FeaturedEvent או ExclusiveEvent מומלץ מאוד למה? - PublicationEvent משמש לציון ההוצאה המקורית (גלובלית או מקומית) של תוכן שמוציא לאור יוצר, למשל תאריך ההפצה המקורי של סרט.

בנוסף, צריך להשתמש ב-FeaturedEvent כדי לציין שהשירות משווק את התוכן הזה בתור תוכן מקורי, מוצג, מיוחד וכן הלאה.

ExclusiveEvent מציין שלשירות שלך יש זכויות הפצה בלעדיות והוא כולל איפה ומתי.

יש פרטים ודוגמאות בקטע לדוגמה.
releasedEvent.@type טקסט חובה – הקפידו תמיד להגדיר את המאפיין הזה לאחת מהאפשרויות הבאות:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location מדינה חובה – האזורים שמשויכים לאירוע הזה.

אם מדובר ב-PublicationEvent, זהו האזור שבו התוכן פורסם.

בFeaturedEvent ובExclusiveEvent, זהו האזור שבו התוכן מוצג או בלעדי.

יש להשתמש בקודי ISO 3166 למדינות. כדי לציין בכל מקום בעולם, צריך להגדיר את הערך EARTH.
releasedEvent.startDate Date או DateTime מומלץחובה עבור ExclusiveEvent – תאריך ההתחלה של הפרסום של הישות.

בPublicationEvent, תאריך הפרסום הראשוני של הישות הזו הוא תאריך הפרסום הראשוני של הישות הזו, למשל התאריך שבו סרט יצא לראשונה בבתי קולנוע.

עבור ExclusiveEvent ו-FeaturedEvent, תאריך ההתחלה של התאריך שבו הישות הייתה בלעדית או מוצגת.
releasedEvent.endDate Date או DateTime מומלץחובה עבור ExclusiveEvent – רלוונטי רק לסוגים ExclusiveEvent ו-FeaturedEvent.

בExclusiveEvent, הערך הזה מייצג את התאריך שבו פג התוקף של הזכויות על התוכן.

ב-FeaturedEvent, זה מייצג את התאריך האחרון שבו הספק מציג את הישות.

אם התוכן מוצג או בלעדי תמיד, צריך להגדיר את endDate ל-20 שנים מהתאריך הנוכחי.
releasedEvent.publishedBy ארגון או אדם אופציונלי – הארגון או האדם שפרסמו את הישות הזו.
description טקסט מומלץ מאוד למה? תקציר של הסרט. תקצירי עלילה עדיפים על סיכומים עובדתיים. עד 300 תווים.
duration משך הקורס זמן הריצה של הסרט בפורמט ISO 8601. יש להשתמש בפורמט: "PT00H00M".
director אדם מומלץ מאוד למה? במאי הסרט.
actor אדם מומלץ מאוד למה? השחקנים בסרט.
producer ארגון או אדם מומלץ מאוד למה? מפיקי הסרט.
image ImageObject חובה ב-Google TV – התמונות שקשורות לסרט. למידע נוסף על המאפיינים הנדרשים והאופציונליים שצריך לכלול עם image, ראו מאפייני תמונות.
trailer.description טקסט תיאור הטריילר. ראו את הדוגמה של הטריילר.
trailer.inLanguage טקסט השפה של הטריילר בפורמט BCP 47.
trailer.url כתובת URL כתובת URL של טריילר שמתארח באופן ציבורי והועלה על ידי אולפני ההפקה או מקורות מורשים רלוונטיים.
trailer.regionsAllowed מקום האזורים שבהם מותר לפרסם מדיה. אם לא מציינים זאת, ההנחה היא שמותר להשתמש בו בכל מקום. יש לציין את המדינות בפורמט ISO 3166.
identifier PropertyValue מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה באופן חד-משמעי את הישות הזו. אפשר לציין מספר מזהים. פרטים נוספים זמינים בקטע מאפייני מזהים.
review ביקורות דירוגי ביקורות לסרט
review.reviewRating דירוג חובה אם סופקה בדיקה. משמש לציון הדירוג שניתן בביקורת.
contentRating טקסט או דירוג חובה עבור תוכן למבוגרים בלבד, מומלץ מאוד אם לא למה? - סיווג כולל של תוכן. אם סיווג התוכן ניתן בפורמט של מחרוזת טקסט, יתקבלו שתי וריאציות:
  • סוכנות הדירוג הוסיפה את הדירוג עם רווח לבן באמצע. לדוגמה, "PG-13" דירוג מהסוכנות "MPAA" בארה"ב צריך להיות מתואר כ-"MPAA PG-13". לעיון ברשימת הסוכנויות
  • ערך של 'RATING NOT KNOWN' (לא תלוי-רישיות) כדי לציין שאתם לא יודעים מה הדירוג של הסרט.
contentRating.author ארגון חובה אם contentRating משתמש בערך Rating – השם של סוכנות הדירוג.
contentRating.ratingValue טקסט חובה אם contentRating משתמש ב-Rating – ערך הדירוג.
contentRating.advisoryCode טקסט קוד ההתרעה של התוכן. הערכים הקבילים כוללים: D, FV, L, S ו-V. D = דו-שיח, FV = אלימות בפנטזיה , L = שפה, S = תוכן מיני, V = אלימות.
popularityScore PopularityScoreSpecification מומלץ מאוד למה? ניקוד שבו Google משתמשת, ובאותות אחרים, כדי לקבוע איזו מדיה להציג למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג שלכם. לכן, סולם הציון צריך להיות עקבי בכל הפידים שלכם, בין כל הישויות בקטלוג. כברירת מחדל, ציון הפופולריות של ישות מסוימת מוגדר כ-0.
popularityScore.@type טקסט תמיד מוגדר ל-PopularityScoreSpecification.
popularityScore.value מספר ערך מספרי לא שלילי שמציין את הפופולריות של הישות. ניקוד גבוה יותר פירושו פופולריות גבוהה יותר.
popularityScore.eligibleRegion מדינה אזורים שבהם רלוונטי דירוג הפופולריות. אם ציון הפופולריות רלוונטי בכל העולם, צריך להגדיר את הערך EARTH. כברירת מחדל, הנכס הזה מוגדר ל-EARTH.
Note: פופולריות ספציפית ללוקאל מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH)
category טקסט חובה אם רלוונטי – צריך לאכלס את הנכס הזה אם הישות היא וריאנט של Movie. מגדירים את category לאחת מהאפשרויות הבאות:
  • Home Release: גרסה שנמכרה או נשכרה לצפייה ביתית.
  • Theatrical Release: גרסה שהופצה בבתי קולנוע.
  • International Release: גרסה נערכה לפרסום בינלאומי.
  • Remastered: גרסה שהתמונות, הסאונד או שניהם שופרו לפי תקן עדכני יותר.
  • Unrated: גרסה שלא נבדקה על ידי ה-MPAA או סוכנות דומה.
  • Director Cut: גרסה שמייצגת את העריכה שאושרה על ידי הבמאי.
  • Extended Cut: גרסה שנמשכת יותר זמן מהסרט הקולנועי.
workExample סרט מציין את הווריאציות של הסרט. צריך לכלול את הנכס הזה בישות הראשית Movie, ולא בישויות Movie של גרסאות הווריאנט.
workExample.@id כתובת URL לווריאציות של Movie, הנכס הזה מספק את המאפיין @id של הישות Movie שזו וריאציה שלה.
workExample.@type טקסט חובה – תמיד מוגדר לערך Movie. אפשר לייצג אותו כמערך עבור Movie עם כמה וריאנטים.
workExample.@id כתובת URL חובה@id של הווריאנט Movie.
workExample.name טקסט חובה – השם של הווריאנט Movie.
workExample.category טקסט חובה – הסוג של וריאציית הסרט בגרסה מסוימת. אפשר להגדיר את הקטגוריה לאחת מהאפשרויות הבאות:
  • Home Release: גרסה שנמכרה או נשכרה לצפייה ביתית.
  • Theatrical Release: גרסה שהופצה בבתי קולנוע.
  • International Release: גרסה נערכה לפרסום בינלאומי.
  • Remastered: גרסה שהתמונות, הסאונד או שניהם שופרו לפי תקן עדכני יותר.
  • Unrated: גרסה שלא נבדקה על ידי ה-MPAA או סוכנות דומה.
  • Director Cut: גרסה שמייצגת את העריכה שאושרה על ידי הבמאי.
  • Extended Cut: גרסה שנמשכת יותר זמן מהסרט הקולנועי.

דוגמה

הסרט הראשי

סרט עם וריאציית חיתוך מורחבת.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "contentRating": "RATING NOT KNOWN",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
  "workExample": {
      "@type": "Movie",
      "@id": "http://www.example.com/my_favorite_movie_extended_cut",
      "name": "My Favorite Movie Extended Cut"
      "category": "Extended Cut"
  }
}

וריאציה של חיתוך מורחב

גרסת החיתוך המורחבת של הסרט הראשי.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie_extended_cut",
  "url": "http://www.example.com/my_favorite_movie_extended_cut",
  "name": "My Favorite Movie Extended Cut",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package",
        "identifier": "example.com:example_package"
       },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
  "contentRating": {
        "@type": "Rating",
        "author": "MPAA",
        "ratingValue": "R",
        "advisoryCode": "FV"
   },
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "This is the extended cut of my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
 "exampleOfWork": {
  "@id": "http://www.example.com/my_favorite_movie",
 }
 "category": "Extended Cut"
}

בדפים הבאים תוכלו למצוא נושאים שקשורים לנכסים האלה: