ایجاد کردن فید

فید «رسانه» یک شیء JSON است که شامل مجموعه‌ای از نهادها است که محتوای رسانه‌ای را در کاتالوگ شما نشان می‌دهند، مانند سریال‌های تلویزیونی، فیلم‌ها، آهنگ‌ها، آلبوم‌ها، و غیره. اولین گام در فرایند آماده‌سازی، شروع به توسعه فیدهایتان است. وقتی فایل‌ها آماده شد، باید فید را بااستفاده از یکی از روش‌های میزبانی پشتیبانی‌شده میزبانی کنید تا Google بتواند به‌طور منظم آن را واکشی کند.

الزامات قالب فایل فید

موارد زیر الزامات فایل(های) فید است:

  • فایل فید باید پسوند نام فایل .json داشته باشد.
  • فایل فیدتان را رمزگذاری نکنید.
  • فایل فیدتان را در UTF-8 کدبندی کنید (تنظیمات ویرایشگر فایل را بررسی کنید).

    alt_text

  • اگر فایل فیدتان بزرگ‌تر از ۱ گیگابایت (فشرده‌نشده) است، فایل را به چند فایل تقسیم کنید.

  • توصیه می‌کنیم برای هر نوع نهاد یک فایل ایجاد کنید (برای مثال، tvseries.json، tvseasons.json، tvepisodes.json، movies.json، و غیره).

    • اگر هرکدام از این فایل‌ها از ۱ گیگابایت بیشتر است، نهادهای آن را به چند فایل تقسیم کنید (برای مثال، tvepisodes_01.json، tvepisodes_02.json، و غیره).
    • تا زمانی که اندازه فایل کمتر از ۱ گیگابایت باشد، هیچ محدودیتی برای تعداد نهادهایی که می‌توانید در یک فایل قرار دهید وجود ندارد.
  • مطمئن شوید که فایل بدون BOM کدگذاری شده باشد، طبق مشخصات JSON. برای بررسی در سیستم‌عامل لینوکس، hexdump file.json | head -n 1 نباید با BBEF در نشانی 0x00 شروع شود.

انواع فیدها

فید تولید

  • این نشان‌دهنده مجموعه فایل(های) فید json است که باهم کل کاتالوگ شما را که می‌خواهید در Google راه‌اندازی کنید نشان می‌دهد. در بخش زیر می‌توانید با نحوه ایجاد فید آشنا شوید.
  • اگر برای اولین‌بار با Google ادغام می‌کنید، این تنها فیدی است که نیاز دارید.
  • وقتی این فید به Google ارسال شد، به‌طور گسترده تجزیه‌وتحلیل می‌شود و چند بار تکرار می‌شود تا به سطح کیفیت بالاتری ازنظر میزان اطلاعات ثبت‌شده و درستی آن برسد و سپس درنهایت جذب و راه‌اندازی می‌شود.

فید آماده‌سازی

  • برخی‌از موارد استفاده به گسترش فید محصول نیاز دارند. چند نمونه از این سناریوها عبارت‌اند از:
    • گسترش فید برای گنجاندن انواع موجودیت‌های جدید که قبلاً راه‌اندازی نشده‌اند.
    • گسترش فید برای گنجاندن تعداد زیادی از نهادها/فراداده‌های جدید برای راه‌اندازی در مناطق جدید.
    • گسترش فید به انواع پلاتفرم‌های جدید. برای مثال، وقتی فید تولید فقط در «جستجوی Google» راه‌اندازی شده است و اکنون می‌خواهید راه‌اندازی را به Google TV گسترش دهید.
  • در این موارد، فید آماده‌سازی لازم است. این فید کپی فید تولید است با این تفاوت که فراداده‌های بیشتری دارد، مثلاً پیوندهای عمیق برای پلاتفرم جدید، فراداده برای منطقه جدید و غیره.
  • مشابه فید تولید، این فید نیز به‌طور گسترده تجزیه‌وتحلیل می‌شود و چند بار تکرار می‌شود تا ازنظر میزان اطلاعات ثبت‌شده و درستی آن، به سطح کیفیت بالاتری برسد. وقتی به حد کیفیت رسیدید، این فید جایگزین فید تولید فعلی می‌شود تا به فید تولید جدید تبدیل شود.
  • این فید به ما امکان می‌دهد راه‌اندازی اولیه را از راه‌اندازی‌های اضافی جدا کنیم و همه آزمایش‌های لازم را بدون تأثیر بر فید تولید انجام دهیم. این کار باعث می‌شود تجربه کاربر نهایی مختل نشود.

با نماینده 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» همه فایل‌های موجود در فید را پیش‌از بارگذاری به‌صورت محلی اعتبارسنجی می‌کند. از این ابزار درطول توسعه فید استفاده کنید تا از خطاهای رایج ساختاری و نوعی اجتناب کنید. جزئیات بیشتر درباره این ابزار را می‌توانید در اینجا ببینید.

  • دارایی‌های کاتالوگ در «کنسول جستجو»

    پس‌از اینکه نماینده Google دارایی کاتالوگ «کنسول جستجو» شما را فعال کرد و نمونه یا فید مرحله‌بندی شما دریافت شد، از دارایی‌های کاتالوگ در «کنسول جستجو» برای بررسی خطاهای اعتبارسنجی سطح نهاد، هشدارها، و تشخیص‌های دریافت استفاده کنید.

ایجاد فید تولید

  1. وقتی همه خطاها و هشدارهای ساختاری در فید نمونه برطرف شد، فید را گسترش دهید تا همه موجودیت‌های کاتالوگتان را دربرگیرد.
  2. ابزار اعتبارسنجی طرح‌واره JSON را روی فایل‌های فید گسترش‌یافته‌تان اجرا کنید و ویژگی‌های کاتالوگ را در «کنسول جستجو» پس‌از بارگذاری بازبینی کنید تا مطمئن شوید خطای اعتبارسنجی وجود ندارد. با مقایسه تعداد موجودیت‌های فیدتان با تعداد موارد کاتالوگتان، مطمئن شوید که فیدتان شامل همه موجودیت‌های کاتالوگتان باشد.