יצירת פיד

פיד המדיה הוא אובייקט JSON שמכיל אוסף של ישויות שמייצגות את תוכן המדיה בקטלוג, כמו סדרות טלוויזיה, סרטים, שירים, אלבומים ועוד. השלב הראשון בתהליך ההצטרפות הוא להתחיל לפתח את הפידים. כשהקבצים מוכנים, צריך לארח את הפיד באחת משיטות האירוח הנתמכות כדי ש-Google תוכל לאחזר אותו באופן קבוע.

הדרישות לגבי פורמט קובץ הפיד

אלה הדרישות לגבי קובצי הפיד:

• קובץ הפיד חייב לכלול את הסיומת .json.
• אל תצפינו את קובץ הפיד.

• מקודדים את קובץ הפיד ב-UTF-8 (בודקים את ההגדרות של עורך הקבצים).

  

• אם קובץ הפיד גדול מ-1GB (לא דחוס), צריך לפצל אותו לכמה קבצים.

• מומלץ ליצור קובץ לכל סוג ישות (לדוגמה, tvseries.json,‏ tvseasons.json,‏ tvepisodes.json,‏ movies.json וכו').

  • אם אחד מהקבצים האלה גדול מ-1GB, צריך לפצל את הישויות שלו לכמה קבצים (לדוגמה, tvepisodes_01.json,‏ tvepisodes_02.json וכו').
  • כל עוד גודל הקובץ קטן מ-1GB, אין הגבלה על מספר הישויות שאפשר לכלול בקובץ אחד.

• חשוב לוודא שהקובץ מקודד בלי BOM, בהתאם למפרט של JSON. כדי לבדוק במערכת הפעלה של Linux, הערך של hexdump file.json | head -n 1 לא יכול להתחיל ב-BBEF בכתובת 0x00.

סוגים של פידים

פיד של סביבת הייצור

• זהו קובץ פיד בפורמט JSON (או קבוצה של קבצים כאלה) שמייצג את כל הקטלוג שאתם רוצים להשיק ב-Google. בקטע הבא מוסבר איך ליצור פיד.
• זה הפיד היחיד שצריך אם אתם מבצעים שילוב עם Google בפעם הראשונה.
• אחרי שהפיד נשלח אל Google, הוא עובר ניתוח מקיף ועיבוד חוזר כמה פעמים כדי להשיג רף איכות גבוה יותר ביחס לכמות המידע שנלכד ולנכונות שלו, לפני שהוא מוטמע ומופעל סופית.

פיד בסביבת Staging

• יש תרחישים מסוימים שבהם צריך להרחיב את פיד המוצרים. כמה דוגמאות לתרחישים כאלה:
  • הרחבת הפיד כך שיכלול סוגי ישויות חדשים שלא הושקו בעבר.
  • הרחבת הפיד כך שיכלול מספר עצום של ישויות או מטא-נתונים חדשים להשקה באזורים גיאוגרפיים חדשים.
  • הרחבת הפיד לסוגי פלטפורמות חדשים. לדוגמה, אם פיד המוצרים הושק רק בחיפוש Google ועכשיו אתם רוצים להרחיב את ההשקה ל-Google TV.
• במקרים כאלה, צריך פיד של סביבת Staging. הפיד הזה הוא עותק של פיד הייצור, אבל יש בו מטא-נתונים נוספים, למשל קישורי עומק לפלטפורמה חדשה, מטא-נתונים ללוקאל חדש וכו'.
• בדומה לפיד מוצרים, הפיד הזה יעבור ניתוח מקיף ואיטרציה כמה פעמים כדי להשיג רף איכות גבוה יותר ביחס לכמות המידע שנלכד ולנכונות שלו. אחרי שהפיד יעמוד בדרישות האיכות, הוא יחליף את פיד הייצור הנוכחי ויהפוך לפיד הייצור החדש.
• הפיד הזה מאפשר לנו להפריד בין ההשקה הראשונית לבין ההשקות הנוספות, ולבצע את כל הבדיקות הנדרשות בלי להשפיע על פיד הייצור. כך אפשר להבטיח שלא יהיו שיבושים בחוויית המשתמש.

אם יש לכם שאלות לגבי מה שכתוב למעלה, אתם יכולים לפנות לנציג Google.

יצירת קובץ פיד

כדאי לפעול לפי השיטות המומלצות הבאות כשיוצרים את הפיד:

1. יצירת פיד לדוגמה באמצעות קבוצה קטנה של ישויות

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

2. אימות הפיד לדוגמה

   אנחנו מספקים כלים שמוודאים שהפיד שלכם תואם למפרטים. מומלץ להשתמש בכלים האלה כדי לפתור את כל השגיאות והאזהרות שנמצאו בפיד לדוגמה.

3. יצירת פיד מוצרים

   אחרי שמוודאים שהמבנה של קבוצת הישויות הקטנה תקין, מפתחים פיד לכל הקטלוג.

יצירת פיד לדוגמה

1. בוחרים ישות מייצגת אחת מהקטלוג. בוחרים ישות עם מבנה מורכב במידה סבירה, אבל עדיין אופייני לישות בקטלוג.
2. משתמשים בכלי לאימות סכימת JSON כדי לבדוק אם יש שגיאות תחביר ומאפייני חובה חסרים. (פרטים נוספים בסעיף הבא).

   דוגמה לפיד עם ישות 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 מאמת את כל הקבצים בפיד באופן מקומי לפני ההעלאה. כדאי להשתמש בכלי הזה במהלך פיתוח הפיד כדי למנוע שגיאות נפוצות במבנה ובסוג. כאן אפשר למצוא פרטים נוספים על הכלי.

• נכסי קטלוג ב-Search Console

  אחרי שנציג Google יפעיל את נכס הקטלוג ב-Search Console והפיד לדוגמה או הפיד בסביבת ה-Staging ייקלט, תוכלו להשתמש בנכסי קטלוג ב-Search Console כדי לבדוק שגיאות אימות, אזהרות וניתוח נתונים של קליטת נתונים ברמת הישות.

יצירת פיד מוצרים

1. אחרי שפותרים את כל השגיאות והאזהרות המבניות בפיד לדוגמה, מרחיבים את הפיד כך שיכלול את כל הישויות בקטלוג.
2. מריצים את הכלי לאימות סכימת JSON על קובצי הפיד המורחב ובודקים את הנכסים מסוג קטלוג ב-Search Console אחרי ההעלאה כדי לוודא שאין שגיאות אימות. כדי לוודא שהפיד כולל את כל הישויות בקטלוג, משווים בין מספר הישויות בפיד למספר הפריטים בקטלוג.