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

Nguồn cấp dữ liệu nội dung đa phương tiệ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 đa phương tiệ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 với quảng cáo 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 tìm nạp thường xuyên.

Yêu cầu về định dạng của 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.
  • Đừng mã hoá tệp nguồn cấp dữ liệu.
  • Mã hoá tệp nguồn cấp dữ liệu theo UTF-8 (kiểm tra chế độ cài đặt của 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 lớn hơn 1 GB (chưa nén).

  • Bạn nên tạo một tệp theo từng 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á 1GB, hãy chia các thực thể trong 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 dưới 1 GB, bạn sẽ không bị giới hạn về số lượng thực thể có thể đưa vào một tệp.
  • Đảm bảo rằng tệp được mã hoá mà không có BOM, theo quy cách JSON. Để kiểm tra 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 sản xuất

  • Tệp này đại diện cho tập hợp(các) tệp nguồn cấp dữ liệu json cùng đại diện cho toàn bộ danh mục của 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 bạn tích hợp với Google lần đầu tiên.
  • Sau khi được gửi đến Google, nguồn cấp dữ liệu này sẽ được phân tích kỹ lưỡng và lặp lại lần để đạt được tiêu chuẩn chất lượng cao hơn về lượng thông tin được thu thập cũng như trước khi được nhập và khởi chạy.

Nguồn cấp dữ liệu theo giai đoạn

  • Có một số trường hợp sử dụng yêu cầu phải mở rộng nguồn cấp dữ liệu sản xuất. Một vài ví dụ trong số các trường hợp đó là:
    • Mở rộng nguồn cấp dữ liệu để thêm các loại thực thể mới, chưa từng ra mắt trước đó.
    • Mở rộng nguồn cấp dữ liệu để bổ sung một số lượng lớn thực thể/siêu dữ liệu mới để ra mắt trong phiên bản mới ngôn ngữ.
    • 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 sản xuất chỉ đã ra mắt trên Google Tìm kiếm và giờ đây, bạn muốn mở rộng phạm vi ra mắt cho Google TV.
  • Trong những trường hợp như vậy, 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 sản xuất, ngoại trừ nó có siêu dữ liệu bổ sung, ví dụ: liên kết sâu cho một nền tảng mới, siêu dữ liệu cho ngôn ngữ mới và cứ tiếp tục như vậy.
  • Tương tự như nguồn cấp dữ liệu sản xuất, quá trình này sẽ được phân tích kỹ lưỡng và lặp lại vài lần để đạt được thanh chất lượng cao hơn về lượng thông tin được nắm bắt cũng như độ chính xác của thông tin đó. Sau khi đạt được thanh chất lượng, nguồn cấp dữ liệu này sẽ thay thế nguồn cấp dữ liệu sản xuất hiện tại để trở thành nguồn cấp dữ liệu sản xuất mới.
  • Nguồn cấp dữ liệu này cho phép chúng tôi tách biệt lần phát hành ban đầu với những lần phát hành bổ sung, thực hiện tất cả cần phải kiểm tra mà không ảnh hưởng đến nguồn cấp dữ liệu sản xuất. Nhờ đó, không bị gián đoạn trải nghiệm người dùng.

Hãy trao đổi 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 nội dung nêu trên.

Tạo một 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 cách sử dụ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 của mình, bạn nên tạo nguồn cấp dữ liệu mẫu chỉ có một nhóm nhỏ các thực thể. Khi xử lý nguồn cấp dữ liệu, bạn có thể gặp phải vấn đề. Bằng cách giới hạn kích thước của nhóm thực thể, bạn sẽ có thể gỡ lỗi những lỗi này và các cảnh báo một cách 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ụ để đảm bảo rằng nguồn cấp dữ liệu của bạn tuân thủ quy cách. Bạn nên bạn sử dụng các công cụ này để giải quyết tất cả các lỗi và cảnh báo có trong nguồn cấp dữ liệu mẫu của mình.

  3. Tạo nguồn cấp dữ liệu sản xuất

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

Tạo một 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. Hãy chọn một thực thể có cấu trúc khá phức tạp nhưng vẫn là thực thể tiêu biểu 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 các lỗi cú pháp và thiếu thuộc tính bắt buộc. (Xem phần tiếp theo để biết chi tiết.)

    Ví dụ về nguồn cấp dữ liệu có một thực thể Movie duy nhấ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

Sau đây là các công cụ giúp bạn xác thực nguồn cấp dữ liệu mẫu bằng dữ liệu có cấu trúc của Google cho nguồn cấp dữ liệu đa phương tiệ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ỗi lần một thực thể. Sử dụng công cụ này để xác thực một mẫu trong danh mục của mình để tìm các lỗi cấu trúc và lỗi nội dung thường gặp. Bạn có thể tìm hiểu 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ả các tệp trong một nguồn cấp dữ liệu. Hãy sử dụng công cụ này trong phát triển nguồn cấp dữ liệu để tránh các lỗi cấu trúc thường gặp. Bạn có thể tìm hiểu thêm chi tiết về tại đây.

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

  1. Sau khi bạn khắc phục 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. Sử dụng công cụ Xác thực nguồn cấp dữ liệu thường xuyên để xác thực một số ít thực thể trong nguồn cấp dữ liệu của bạn cùng một lúc (Dán một số lượng lớn các thực thể trên công cụ này có thể làm treo trình duyệt web). 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 nhạc phẩm.