สร้างฟีด

ฟีดสื่อคือออบเจ็กต์ JSON ที่มีคอลเล็กชันเอนทิตีที่แสดงถึงเนื้อหาสื่อในแคตตาล็อก เช่น ซีรีส์ทีวี ภาพยนตร์ เพลง อัลบั้ม และอื่นๆ ขั้นตอนแรกในกระบวนการเริ่มต้นใช้งานคือการเริ่มพัฒนาฟีด เมื่อไฟล์พร้อมแล้ว คุณต้องโฮสต์ฟีดโดยใช้วิธีการโฮสต์ที่รองรับวิธีใดวิธีหนึ่งเพื่อให้ Google ดึงข้อมูลเป็นประจำ

หมายเหตุ: หากยังไม่ได้รวบรวมข้อมูลที่จำเป็นทั้งหมดสำหรับเนื้อหา โปรดดูส่วนรวบรวมข้อมูล

ข้อกำหนดรูปแบบไฟล์ฟีด

ข้อกำหนดสำหรับไฟล์ฟีดมีดังนี้

• ไฟล์ฟีดต้องมีนามสกุลไฟล์ .json
• อย่าเข้ารหัสไฟล์ฟีด

• เข้ารหัสไฟล์ฟีดเป็น UTF-8 (ตรวจสอบการตั้งค่าเครื่องมือแก้ไขไฟล์)

  

• แบ่งไฟล์ออกเป็นหลายไฟล์หากไฟล์ฟีดมีขนาดใหญ่กว่า 1 GB (ไม่ได้บีบอัด)

• เราขอแนะนำให้คุณสร้างไฟล์ต่อประเภทเอนทิตี (เช่น tvseries.json, tvseasons.json, tvepisodes.json, movies.json ฯลฯ)

  • หากไฟล์ใดไฟล์หนึ่งมีขนาดใหญ่เกิน 1 GB ให้แยกเอนทิตีออกเป็นหลายไฟล์ (เช่น tvepisodes_01.json, tvepisodes_02.json ฯลฯ)
  • คุณจะใส่เอนทิตีในไฟล์เดียวได้เท่าใดก็ได้ ตราบใดที่ไฟล์มีขนาดน้อยกว่า 1 GB

• ตรวจสอบว่าไฟล์ได้รับการเข้ารหัสโดยไม่มี BOM ตามข้อกำหนด JSON หากต้องการตรวจสอบในระบบปฏิบัติการ Linux hexdump file.json | head -n 1 ต้องไม่ขึ้นต้นด้วย BBEF ที่ที่อยู่ 0x00

ประเภทของฟีด

ฟีดเวอร์ชันที่ใช้งานจริง

• ไฟล์นี้แสดงชุดไฟล์ฟีด JSON ที่รวมกันเป็นแคตตาล็อกทั้งหมดที่คุณต้องการเปิดตัวใน Google ดูวิธีสร้างฟีดได้ในส่วนด้านล่าง
• นี่เป็นฟีดเดียวที่คุณต้องใช้หากจะผสานรวมกับ Google เป็นครั้งแรก
• เมื่อส่งฟีดนี้ไปยัง Google แล้ว ระบบจะวิเคราะห์และทําซ้ำฟีดนี้อย่างละเอียดหลายครั้งเพื่อให้ได้มาตรฐานคุณภาพที่สูงขึ้นในแง่ของปริมาณข้อมูลที่บันทึกและความถูกต้องของข้อมูลก่อนที่จะส่งผ่านและเปิดตัวในที่สุด

ฟีดที่ใช้ทดสอบ

• กรณีการใช้งานบางอย่างจำเป็นต้องขยายฟีดเวอร์ชันที่ใช้งานจริง ตัวอย่างสถานการณ์ดังกล่าวมีดังนี้
  • การขยายฟีดให้รวมประเภทเอนทิตีใหม่ที่ไม่ได้เปิดตัวก่อนหน้านี้
  • การขยายฟีดให้รวมเอนทิตี/ข้อมูลเมตาใหม่จํานวนมากเพื่อเปิดตัวในภาษาใหม่
  • การขยายฟีดไปยังแพลตฟอร์มประเภทใหม่ เช่น เมื่อฟีดเวอร์ชันที่ใช้งานจริงเปิดตัวใน Google Search เท่านั้น และตอนนี้คุณต้องการขยายการเปิดตัวไปยัง Google TV
• ในกรณีเช่นนี้ คุณต้องใช้ฟีดที่ใช้ทดสอบ ฟีดนี้เป็นสำเนาของฟีดเวอร์ชันที่ใช้งานจริง ยกเว้นว่าจะมีข้อมูลเมตาเพิ่มเติม เช่น Deep Link สำหรับแพลตฟอร์มใหม่ ข้อมูลเมตาสำหรับภาษาใหม่ และอื่นๆ
• เช่นเดียวกับฟีดเวอร์ชันที่ใช้งานจริง ระบบจะวิเคราะห์และทําซ้ำข้อมูลนี้อย่างละเอียดหลายครั้งเพื่อให้ได้มาตรฐานคุณภาพที่สูงขึ้นในแง่ของปริมาณข้อมูลที่บันทึกและความถูกต้องของข้อมูล เมื่อผ่านเกณฑ์คุณภาพแล้ว ฟีดนี้จะแทนที่ฟีดเวอร์ชันที่ใช้งานจริงปัจจุบันเพื่อใช้เป็นฟีดเวอร์ชันที่ใช้งานจริงใหม่
• ฟีดนี้ช่วยให้เราแยกการเปิดตัวครั้งแรกออกจากการเปิดตัวเพิ่มเติม ทำการทดสอบที่จำเป็นทั้งหมดได้โดยไม่ส่งผลต่อฟีดเวอร์ชันที่ใช้งานจริง ซึ่งจะช่วยให้ผู้ใช้ปลายทางได้รับประสบการณ์การใช้งานที่ราบรื่น

โปรดติดต่อตัวแทนของ 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"
           }
         ]
       }
     ]
   }

ตรวจสอบฟีดตัวอย่าง

เครื่องมือต่อไปนี้พร้อมให้ใช้งานเพื่อช่วยคุณตรวจสอบฟีดตัวอย่างด้วยข้อกําหนดของ Structured Data สําหรับฟีดสื่อของ Google

• เครื่องมือตรวจสอบฟีดข้อมูล

  เครื่องมือตรวจสอบฟีดข้อมูลจะตรวจสอบเอนทิตีได้ทีละรายการ ใช้เครื่องมือนี้เพื่อตรวจสอบเอนทิตีตัวอย่างจากแคตตาล็อกเพื่อหาข้อผิดพลาดเชิงโครงสร้างและข้อผิดพลาดที่พบได้ทั่วไปในเนื้อหา ดูรายละเอียดเพิ่มเติมเกี่ยวกับเครื่องมือนี้ได้ที่นี่

• เครื่องมือตรวจสอบสคีมา JSON

  เครื่องมือตรวจสอบสคีมา JSON สามารถตรวจสอบไฟล์ทั้งหมดในฟีดได้ ใช้เครื่องมือนี้ในระหว่างการพัฒนาฟีดเพื่อหลีกเลี่ยงข้อผิดพลาดด้านโครงสร้างที่พบบ่อย ดูรายละเอียดเพิ่มเติมเกี่ยวกับเครื่องมือนี้ได้ที่นี่

สร้างฟีดเวอร์ชันที่ใช้งานจริง

1. เมื่อแก้ไขข้อผิดพลาดและคําเตือนทั้งหมดในฟีดตัวอย่างแล้ว ให้ขยายฟีดเพื่อรวมเอนทิตีทั้งหมดในแคตตาล็อก
2. ใช้เครื่องมือตรวจสอบฟีดข้อมูลบ่อยๆ เพื่อตรวจสอบเอนทิตีจำนวนน้อยในฟีดในแต่ละครั้ง (การวางเอนทิตีจำนวนมากในเครื่องมืออาจทำให้เว็บเบราว์เซอร์ค้าง) ยืนยันว่าฟีดมีเอนทิตีทั้งหมดในแคตตาล็อกโดยเปรียบเทียบจำนวนเอนทิตีในฟีดกับจำนวนสินค้าในแคตตาล็อก