Tạo nguồn cấp dữ liệu

Nguồn cấp dữ liệu nội dung nghe nhìn là một đối tượng JSON chứa một tập hợp các thực thể đại diện cho nội dung nghe nhìn trong danh mục của bạn, chẳng hạn như Phim truyền hình dài tập, Phim, Bài hát, Đĩa nhạc, v.v. Bước đầu tiên trong quá trình làm quen là bắt đầu phát triển nguồn cấp dữ liệu. Sau khi các tệp đã sẵn sàng, bạn cần lưu trữ nguồn cấp dữ liệu bằng một trong các phương thức lưu trữ được hỗ trợ để Google thường xuyên tìm nạp.

Yêu cầu về định dạng tệp nguồn cấp dữ liệu

Sau đây là các yêu cầu đối với(các) tệp nguồn cấp dữ liệu:

  • Tệp nguồn cấp dữ liệu phải có đuôi tệp là .json.
  • Không mã hoá tệp nguồn cấp dữ liệu.
  • Mã hoá tệp nguồn cấp dữ liệu bằng UTF-8 (kiểm tra chế độ cài đặt trình chỉnh sửa tệp).

    alt_text

  • Chia tệp thành nhiều tệp nếu tệp nguồn cấp dữ liệu của bạn lớn hơn 1 GB (chưa nén).

  • Bạn nên tạo một tệp cho mỗi loại thực thể (ví dụ: tvseries.json, tvseasons.json, tvepisodes.json, movies.json, v.v.).

    • Nếu bất kỳ tệp nào trong số này vượt quá 1 GB, hãy chia các thực thể của tệp đó thành nhiều tệp (ví dụ: tvepisodes_01.json, tvepisodes_02.json, v.v.).
    • Miễn là kích thước tệp nhỏ hơn 1 GB, bạn có thể đưa bao nhiêu thực thể vào một tệp cũng được.
  • Đảm bảo rằng tệp được mã hoá không có BOM, theo thông số kỹ thuật JSON. Để kiểm tra trên hệ điều hành Linux, hexdump file.json | head -n 1 không được bắt đầu bằng BBEF tại địa chỉ 0x00.

Các loại nguồn cấp dữ liệu

Nguồn cấp dữ liệu phát hành công khai

  • Đây là tập hợp(các) tệp nguồn cấp dữ liệu json đại diện cho toàn bộ danh mục mà bạn muốn ra mắt trên Google. Bạn có thể tìm hiểu cách tạo nguồn cấp dữ liệu trong phần bên dưới.
  • Đây là nguồn cấp dữ liệu duy nhất bạn cần nếu đây là lần đầu tiên tích hợp với Google.
  • Sau khi bạn gửi nguồn cấp dữ liệu này cho Google, nguồn cấp dữ liệu này sẽ được phân tích và lặp lại nhiều lần để đạt được tiêu chuẩn chất lượng cao hơn liên quan đến lượng thông tin được thu thập và độ chính xác của nguồn cấp dữ liệu trước khi được nhập và phát hành.

Nguồn cấp dữ liệu thử nghiệm

  • Có một số trường hợp sử dụng nhất định yêu cầu mở rộng nguồn cấp dữ liệu chính thức. Sau đây là một số ví dụ về các trường hợp như vậy:
    • Mở rộng nguồn cấp dữ liệu để bao gồm các loại thực thể mới, chưa được ra mắt trước đây.
    • Mở rộng nguồn cấp dữ liệu để bao gồm một số lượng lớn thực thể/siêu dữ liệu mới nhằm ra mắt ở các ngôn ngữ mới.
    • Mở rộng nguồn cấp dữ liệu sang các loại nền tảng mới. Ví dụ: khi nguồn cấp dữ liệu chính thức chỉ được phát hành trên Google Tìm kiếm và giờ đây, bạn muốn mở rộng phạm vi phát hành sang Google TV.
  • Trong những trường hợp như vậy, bạn cần có nguồn cấp dữ liệu thử nghiệm. Nguồn cấp dữ liệu này là bản sao của nguồn cấp dữ liệu chính thức, ngoại trừ việc nguồn cấp dữ liệu này có siêu dữ liệu bổ sung, ví dụ: đường liên kết sâu cho một nền tảng mới, siêu dữ liệu cho một ngôn ngữ mới, v.v.
  • Tương tự như nguồn cấp dữ liệu chính thức, nguồn cấp dữ liệu này sẽ được phân tích và lặp lại nhiều lần để đạt được một tiêu chuẩn chất lượng cao hơn liên quan đến lượng thông tin được thu thập và độ chính xác của thông tin đó. Sau khi đạt được tiêu chuẩn chất lượng, nguồn cấp dữ liệu này sẽ thay thế nguồn cấp dữ liệu phát hành công khai hiện tại để trở thành nguồn cấp dữ liệu phát hành công khai mới.
  • Nguồn cấp dữ liệu này cho phép chúng tôi tách biệt lần chạy đầu tiên với các lần chạy bổ sung, thực hiện tất cả các hoạt động kiểm thử bắt buộc mà không ảnh hưởng đến nguồn cấp dữ liệu chính thức. Điều này giúp đảm bảo trải nghiệm người dùng cuối không bị gián đoạn.

Hãy làm việc với người đại diện của Google để làm rõ mọi thắc mắc của bạn về những vấn đề nêu trên.

Tạo tệp nguồn cấp dữ liệu

Hãy làm theo các phương pháp hay nhất sau đây khi tạo nguồn cấp dữ liệu:

  1. Tạo nguồn cấp dữ liệu mẫu bằng một nhóm nhỏ các thực thể

    Trước khi tạo nguồn cấp dữ liệu chứa tất cả nội dung trong danh mục, bạn nên tạo một nguồn cấp dữ liệu mẫu chỉ chứa một nhóm nhỏ thực thể. Trong khi xử lý nguồn cấp dữ liệu, bạn có thể gặp phải một số vấn đề. Bằng cách giới hạn kích thước của tập hợp thực thể, bạn sẽ có thể gỡ lỗi các lỗi và cảnh báo này dễ dàng hơn.

  2. Xác thực nguồn cấp dữ liệu mẫu

    Chúng tôi cung cấp các công cụ giúp đảm bảo nguồn cấp dữ liệu của bạn tuân thủ các thông số kỹ thuật. Bạn nên sử dụng các công cụ này để giải quyết tất cả lỗi và cảnh báo trong nguồn cấp dữ liệu mẫu.

  3. Tạo nguồn cấp dữ liệu chính thức

    Sau khi bạn xác minh rằng mình có cấu trúc phù hợp cho một nhóm nhỏ các thực thể, hãy phát triển nguồn cấp dữ liệu cho toàn bộ danh mục.

Tạo nguồn cấp dữ liệu mẫu

  1. Chọn một thực thể đại diện trong danh mục của bạn. Chọn một thực thể có cấu trúc phức tạp vừa phải nhưng vẫn là cấu trúc điển hình của một thực thể trong danh mục.
  2. Sử dụng Công cụ xác thực nguồn cấp dữ liệu để kiểm tra lỗi cú pháp và thiếu các thuộc tính bắt buộc. (Xem phần tiếp theo để biết thông tin chi tiết.)
    {
      "@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"
            }
          ]
        }
      ]
    }

Xác thực nguồn cấp dữ liệu mẫu

Các công cụ sau đây có thể giúp bạn xác thực nguồn cấp dữ liệu mẫu bằng thông số kỹ thuật của dữ liệu có cấu trúc của Google cho nguồn cấp dữ liệu nội dung nghe nhìn.

  • Công cụ xác thực nguồn cấp dữ liệu

    Công cụ Xác thực nguồn cấp dữ liệu có thể xác thực một thực thể tại một thời điểm. Sử dụng công cụ này để xác thực thực thể mẫu trong danh mục của bạn để tìm lỗi cấu trúc và lỗi nội dung thường gặp. Bạn có thể xem thêm thông tin chi tiết về công cụ này tại đây.

  • Công cụ xác thực giản đồ JSON

    Công cụ Xác thực giản đồ JSON có thể xác thực tất cả tệp trong nguồn cấp dữ liệu. Hãy sử dụng công cụ này trong quá trình phát triển nguồn cấp dữ liệu để tránh các lỗi cấu trúc phổ biến. Bạn có thể xem thêm thông tin chi tiết về công cụ này tại đây.

Tạo nguồn cấp dữ liệu chính thức

  1. Sau khi giải quyết xong tất cả lỗi và cảnh báo trong nguồn cấp dữ liệu mẫu, hãy mở rộng nguồn cấp dữ liệu để bao gồm tất cả các thực thể trong danh mục của bạn.
  2. Thường xuyên sử dụng Công cụ xác thực nguồn cấp dữ liệu để xác thực một số ít thực thể trong nguồn cấp dữ liệu của bạn tại mỗi thời điểm (Việc dán một số lượng lớn thực thể vào công cụ này có thể khiến trình duyệt web bị treo). Xác nhận rằng nguồn cấp dữ liệu của bạn bao gồm tất cả các thực thể trong danh mục bằng cách so sánh số lượng thực thể trong nguồn cấp dữ liệu với số lượng mặt hàng trong danh mục.