פיד המדיה הוא אובייקט JSON שמכיל אוסף של ישויות שמייצגות את תוכן המדיה בקטלוג, כמו סדרות טלוויזיה, סרטים, שירים, אלבומים ועוד. השלב הראשון בתהליך ההצטרפות הוא פיתוח הפיד. אחרי שהקבצים מוכנים, צריך לארח את הפיד באחת משיטות האירוח הנתמכות כדי ש-Google תוכל לאחזר אותו באופן קבוע.
הדרישות לגבי פורמט קובץ הפיד
אלה הדרישות לקובצי הפיד:
- סיומת שם הקובץ של קובץ הפיד חייבת להיות
.json. - לא להצפין את קובץ הפיד.
מקודדים את קובץ הפיד ב-UTF-8 (בודקים את ההגדרה של עורך הקבצים).
אם קובץ הפיד גדול מ-1GB (לא דחוס), צריך לפצל אותו לכמה קבצים.
מומלץ ליצור קובץ לכל סוג ישות (לדוגמה,
tvseries.json,tvseasons.json,tvepisodes.json,movies.jsonוכו').- אם אחד מהקבצים האלה גדול מ-1GB, צריך לפצל את הישויות שלו לכמה קבצים (לדוגמה,
tvepisodes_01.json,tvepisodes_02.jsonוכו'). - כל עוד גודל הקובץ קטן מ-1GB, אין הגבלה על מספר הישויות שאפשר לכלול בקובץ יחיד.
- אם אחד מהקבצים האלה גדול מ-1GB, צריך לפצל את הישויות שלו לכמה קבצים (לדוגמה,
חשוב לוודא שהקובץ מקודד ללא BOM, בהתאם למפרט JSON. כדי לבדוק במערכת הפעלה של Linux,
hexdump file.json | head -n 1לא יכול להתחיל ב-BBEFבכתובת 0x00.
סוגים של פידים
פיד ייצור
- זהו קובץ JSON שמייצג את קבוצת קובצי הפיד של ה-JSON, שמייצגים יחד את כל הקטלוג שרוצים להשיק ב-Google. בקטע שבהמשך מוסבר איך יוצרים פיד.
- זהו הפיד היחיד שנחוץ אם אתם מבצעים שילוב עם Google בפעם הראשונה.
- אחרי שליחת הפיד ל-Google, הוא ינותח לעומק ויעבור כמה סבבים של שיפורים כדי לעמוד בסטנדרטים גבוהים יותר של איכות מבחינת כמות המידע שנאסף והנכונות שלו, לפני שהוא יאוחסן ויושקה.
פיד Staging
- יש תרחישים לדוגמה שבהם צריך להרחיב את הפיד בסביבת הייצור. כמה דוגמאות לתרחישים כאלה:
- הרחבת הפיד כך שיכלול סוגי ישויות חדשים שלא הושקו בעבר.
- הרחבת הפיד כך שיכלול מספר עצום של ישויות או מטא-נתונים חדשים, לצורך השקה באזורים חדשים.
- הרחבת הפיד לסוגי פלטפורמות חדשים. לדוגמה, כשפיד הייצור הושק רק בחיפוש Google ועכשיו אתם רוצים להרחיב את ההשקה ל-Google TV.
- במקרים כאלה, נדרש פיד ייעודי לניסיון. הפיד הזה הוא עותק של פיד הייצור, אלא שהוא מכיל מטא-נתונים נוספים, למשל קישורי עומק לפלטפורמה חדשה, מטא-נתונים לאזור גיאוגרפי חדש וכו'.
- בדומה לפיד הייצור, הפיד הזה ינותח לעומק ויעבור כמה סבבים של שיפורים כדי להשיג רף איכות גבוה יותר מבחינת כמות המידע שנאסף והנכונות שלו. אחרי שהפיד עומד בסטנדרטים של האיכות, הוא מחליף את פיד הייצור הנוכחי ונהיה הפיד החדש של הייצור.
- הפיד הזה מאפשר לנו להפריד בין ההשקה הראשונית לבין השקות נוספות, לבצע את כל הבדיקות הנדרשות בלי להשפיע על פיד הייצור. כך אין שיבושים בחוויית המשתמש.
אתם יכולים לפנות לנציג Google שלכם כדי לקבל תשובות לשאלות שיש לכם לגבי הנושאים האלה.
יצירת קובץ פיד
מומלץ לפעול לפי השיטות המומלצות הבאות כשיוצרים את הפיד:
יצירת פיד לדוגמה באמצעות קבוצה קטנה של ישויות
לפני שיוצרים פיד שמכיל את כל התוכן בקטלוג, מומלץ ליצור פיד לדוגמה עם קבוצה קטנה בלבד של ישויות. במהלך העבודה על הפיד, סביר להניח שתתקלו בבעיות. הגבלת הגודל של קבוצת הישויות תאפשר לכם לנפות באגים בשגיאות ובאזהרות האלה בקלות רבה יותר.
-
אנחנו מספקים כלים שיעזרו לכם לוודא שהפיד עומד במפרטים. מומלץ להשתמש בכלים האלה כדי לפתור את כל השגיאות והאזהרות שנמצאות בפיד לדוגמה.
-
אחרי שתבדקו שיש לכם מבנה טוב לקבוצה הקטנה של הישויות, תוכלו לפתח פיד לכל הקטלוג.
יצירת פיד לדוגמה
- בוחרים ישות נציגה אחת מהקטלוג. בוחרים ישות עם מבנה מורכב למדי, אבל עדיין אופייני לישות בקטלוג.
- משתמשים בכלי לאימות פידים של נתונים כדי לבדוק אם יש שגיאות תחביר ומאפיינים נדרשים חסרים. (פרטים נוספים מופיעים בקטע הבא).
דוגמה לפיד עם ישות
Movieאחת{ "@context": "http://schema.org", "@type": "DataFeed", "dateModified": "2018-07-20T00:44:51Z", "dataFeedElement": [ { "@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", "requiresSubscription": { "@type": "MediaSubscription", "name": "Example Package", "commonTier": true, "@id": "[partner determined string]" }, "availabilityStarts": "2018-07-21T10:35:29Z", "availabilityEnds": "2019-10-21T10:35:29Z", "eligibleRegion": [ { "@type": "Country", "name": "US" }, { "@type": "Country", "name": "CA" } ] } }, "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie", "releasedEvent": { "@type": "PublicationEvent", "startDate": "2008-01-20", "location": { "@type": "Country", "name": "US" } }, "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" } ] } ] }
אימות הפיד לדוגמה
הכלים הבאים זמינים כדי לעזור לכם לאמת פיד לדוגמה עם המפרטים של Google לנתונים מובְנים בפיד מדיה.
הכלי לאימות פידים של נתונים
הכלי לאימות פיד הנתונים יכול לאמת ישות אחת בכל פעם. אפשר להשתמש בכלי הזה כדי לאמת ישות לדוגמה מהקטלוג ולבדוק אם יש בה שגיאות מבניות ושגיאות נפוצות בתוכן. פרטים נוספים על הכלי זמינים כאן.
כלי לאימות של סכימות JSON
הכלי לאימות סכימת JSON יכול לאמת את כל הקבצים בפיד. מומלץ להשתמש בכלי הזה במהלך הפיתוח של הפיד כדי להימנע משגיאות מבניות נפוצות. פרטים נוספים על הכלי זמינים כאן.
יצירת פיד ייצור
- אחרי שתטפלו בכל השגיאות והאזהרות בפיד לדוגמה, תוכלו להרחיב את הפיד כך שיכלול את כל הישויות בקטלוג.
- מומלץ להשתמש בכלי לאימות פיד הנתונים לעיתים קרובות כדי לאמת מספר קטן של ישויות בפיד בכל פעם (הדבקה של מספר גדול של ישויות בכלי עלולה להקפיא את דפדפן האינטרנט). כדי לוודא שהפיד כולל את כל הישויות בקטלוג, צריך להשוות בין מספר הישויות בפיד למספר הפריטים בקטלוג.