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

בקטע הזה מפורטים מאפייני התוכן של תגי העיצוב עבור סוג הישות 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 חייב להכיל כתובת URL קנונית תקינה ש-Google יכולה לסרוק.
כדי לראות את קישור העומק להפעלה, צריך לעיין במאפיין urlTemplate של אובייקט היעד.
name טקסט חובה – שם הסרט.
  • משתמשים במערך כדי לפרט את השמות בשפות שונות. אפשר לעיין בדוגמה Multiple regions and languages.
  • שימו לב: אפשר להשתמש רק בשם אחד לכל לוקאל (שילוב של שפה ואזור).
titleEIDR טקסט מומלץ מאוד למה? ‫– מזהה EIDR (Entertainment Identifier Registry) שמייצג ברמה הכללית או המופשטת ביותר יצירה קולנועית או טלוויזיונית.

לדוגמה, מזהה EIDR של הכותרת לסרט הקולנוע 'מכסחי השדים' הוא ‎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 חובה אם רלוונטיאובייקט של תג Action שמספק את הפרטים של הפעולה.
  • אם התוכן זמין ב'סרטון לפי דרישה' (VoD), חובה לציין את המאפיין הזה. אובייקט התיוג של הפעולה צריך לספק את הקישור העמוק של התוכן.
  • אם התוכן זמין בערוץ LiveTV, המאפיין הזה הוא אופציונלי. במקומו, הישות המשויכת BroadcastService מספקת את הקישור העמוק של הערוץ.
  • תוכן Movie יכול להיות זמין גם ב-VoD וגם בשידור חי בטלוויזיה.
כדי לציין קישורי עומק שונים במספר אזורים, משתמשים במערך. אפשר לעיין בדוגמה Multiple regions and languages.
sameAs כתובת URL מומלץ מאוד למה? כתובת URL לדף אינטרנט שמשמש כהפניה ויכול לזהות את הסרט. לדוגמה, דף ויקיפדיה של הסרט. הערך הזה צריך להיות שונה מהערך של המאפיין url.
inLanguage טקסט מומלץ מאוד לציין את שפת המקור של הסרט בפורמט BCP 47.
genre טקסט רשימה מסודרת של כל הז'אנרים הרלוונטיים. לדוגמה : ['פעולה', 'אופנה', 'סביבה', 'כדורגל']
keywords טקסט מילות מפתח או תגים שמשמשים לתיאור התוכן הזה. אפשר גם להשתמש במערך של מילות מפתח. לדוגמה, [‎"feature, biography"‎] יכול להיות מערך של מילות מפתח לתיאור התוכן.
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 Person מומלץ מאוד למה? הבמאי או הבמאים של הסרט.
actor Person מומלץ מאוד למה? השחקנים בסרט.
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 = Dialogue (דיאלוג),‏ FV = Fantasy Violence (אלימות דמיונית),‏ L = Language (שפה),‏ S = Sexual Content (תוכן מיני),‏ V = Violence (אלימות).
popularityScore PopularityScoreSpecification מומלץ מאוד למה? ציון ש-Google משתמשת בו, בנוסף לאותות אחרים, כדי לקבוע אילו מדיה להפעיל למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג שלכם. לכן, סולם הציון צריך להיות עקבי בכל הפידים שלכם, בין כל הישויות בקטלוג. כברירת מחדל, ציון הפופולריות של ישות מוגדר כ-0.
popularityScore.@type טקסט הערך תמיד יהיה PopularityScoreSpecification.
popularityScore.value Number ערך מספרי לא שלילי שמציין את הפופולריות של הישות. ציון גבוה יותר מציין פופולריות גבוהה יותר.
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"
}

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