לכל הישויות בקטלוג שלכם נדרשים המאפיינים הבאים:
@id
: מזהה גלובלי של התוכן.url
: כתובת URL קנונית של התוכן.name
: שם התוכן.
דוגמה של @id
, url
ו-name
:
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
מזהה
מזהה (@id
) צריך לעמוד בדרישות הבאות:
- ייחודי בכל העולם בקטלוג שלך
- למשל, לא להשתמש באותו
@id
ל-TVSeries
ול-TVSeason
.
- למשל, לא להשתמש באותו
- סטטי
- אי אפשר לשנות את
@id
מאוחר יותר.
- אי אפשר לשנות את
- בפורמט של מזהה משאבים מאוחד (URI)
- אם המזהה המקומי של התוכן (ID) לא מופיע בפורמט URI, צריך לצרף את הדומיין למזהה מראש כדי לעמוד בדרישה הזו. לדוגמה, אם מזהה התוכן הוא 1234abc והדומיין הוא https://example.com, הערך של
@id
יכול להיות https://example.com/1234abc. @id
לא חייבת להיות כתובת URL פעילה. הוא צריך להיות רק בפורמט URI.- הדומיין שבו נעשה שימוש ב-
@id
(לדוגמה, https://example.com) חייב להיות בבעלות הארגון.
- אם המזהה המקומי של התוכן (ID) לא מופיע בפורמט URI, צריך לצרף את הדומיין למזהה מראש כדי לעמוד בדרישה הזו. לדוגמה, אם מזהה התוכן הוא 1234abc והדומיין הוא https://example.com, הערך של
ה-url
של הישות עומד בכל הדרישות כמזהה (כלומר ייחודי גלובלי, סטטי ובצורת URI), מומלץ להשתמש ב-url
של הישות בתור @id
.
כתובת אתר קנונית
כתובת URL קנונית (url
) עוזרת ל-Google להתאים באופן מדויק את התוכן בקטלוג שלכם לתוכן שבמסדי הנתונים של Google.
"כתובת URL קנונית היא כתובת ה-URL של הדף ש-Google סבורה שהיא הייצוגית ביותר מתוך קבוצה של דפים כפולים באתר שלכם. לדוגמה, אם יש לכם כתובות URL לאותו הדף (לדוגמה: example.com?dress=1234 וגם example.com/dress/1234), Google תבחר אחת מהן כקנונית." (מקור: איחוד כתובות URL כפולות)
אלה הדרישות לגבי כתובת ה-URL הקנונית:
- הערך של
url
חייב להיות ייחודי בכל העולם. url
חייבת להכיל כתובת URL קנונית פעילה ש-Google יכולה לסרוק.- (פעולות האזנה בלבד)
url
צריך להפנות אל דף תיאור תוכן שאינו חסום על ידי חומת תשלום.
איסוף המזהה, כתובת ה-URL והשם
בצע את הפעולות הבאות:
- אוספים את שמות התוכן בקטלוג.
- מזהים את כתובות ה-URL הקנוניות של התוכן. (אנחנו ממליצים להשתמש ב
url
של התוכן בתור ה-@id
שלו).