יצירת פיד

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

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

יצירת פיד ייצור

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