SportsEvents - Pemodelan, Praktik Terbaik, dan Feed Contoh

Definisi

SportsEvent adalah jenis entity yang mewakili pertandingan olahraga atau replay lengkap pertandingan olahraga.

Apa yang dapat dimodelkan sebagai SportsEvent? Pertandingan olahraga
Apa yang tidak dapat dimodelkan sebagai SportsEvent?

Konten video pendek atau klip atau konten tambahan apa pun. Berikut daftarnya:

  • Klip pendek rangkuman atau replay acak
  • Pratinjau game
  • Sorotan pertandingan
  • Kesalahan lucu dalam game
  • Klip wawancara pemain
  • Video di balik layar
  • Ulasan game (buatan pengguna atau lainnya)
  • Klip singkat acak dari game

Bagaimana cara menangani konten tambahan tersebut?

Kasus Penggunaan Umum untuk SportsEvents

S.No. Deskripsi Entitas yang Diperlukan
Kasus 1

Saya perlu membuat model SportsEvent yang merupakan bagian dari katalog TV live dan streaming online saya.

Pertandingan di-streaming melalui internet dan tidak terikat ke saluran mana pun.

SportsEvent yang mewakili game.

BroadcastEvent yang mewakili siaran pertandingan.

Kasus 2 Saya perlu membuat model SportsEvent yang merupakan bagian dari katalog TV live saya dan di-streaming secara online di sebuah channel.

SportsEvent yang mewakili game.

BroadcastEvent yang mewakili penayangan pertandingan.

BroadcastService, Organization, TelevisionChannel, CableOrSatelliteService entitas yang mewakili channel dan grup channel.

Kasus 3 Kombinasi dari dua kasus sebelumnya. Jika Anda menggabungkan kasus penggunaan sebelumnya, berikan semua jenis entity yang tercantum dalam kolom "Entities Required" yang sesuai.

Praktik terbaik dan insight tentang beberapa pemeriksaan yang kami lakukan

Panduan dan pemeriksaan kualitas berikut berlaku saat membuat model acara olahraga dan siarannya.

Terapkan aturan berikut di semua integrasi SportsEvent:

  • Tempatkan semua deep link olahraga di SportsEvent.potentialAction: Deep link tingkat pertandingan (WatchAction)—baik untuk livestream tanpa channel maupun replay Video on demand—harus berada secara eksklusif di entitas SportsEvent (SportsEvent.potentialAction). Jangan pernah menempatkan potentialAction di BroadcastEvent yang merujuk ke SportsEvent. (Untuk siaran channel linear tanpa deep link khusus acara, berikan deep link channel di BroadcastService.potentialAction.) Jika pertandingan memiliki beberapa streaming (misalnya, feed regional, siaran kandang atau tandang, beberapa bahasa, atau URL replay live dan Video on Demand terpisah), berikan array objek WatchAction di SportsEvent.potentialAction.
  • Periode pre-roll (availabilityStarts): Tetapkan SportsEvent.potentialAction.actionAccessibilityRequirement.availabilityStarts setidaknya 14 hari sebelum SportsEvent.startDate (availabilityStarts <= SportsEvent.startDate - 14 days) agar kartu pertandingan mendatang dan notifikasi tonton dapat muncul lebih awal. Anda tidak perlu mengirimkan entitas feed 14 hari sebelumnya—data peristiwa dapat dikirimkan lebih dekat ke hari pertandingan, asalkan stempel waktu availabilityStarts ditetapkan setidaknya 14 hari sebelum SportsEvent.startDate.
  • Buffer perpanjangan waktu (availabilityEnds): Tetapkan SportsEvent.potentialAction.actionAccessibilityRequirement.availabilityEnds setelah SportsEvent.endDate dengan buffer minimal 2 hingga 3 jam (availabilityEnds >= SportsEvent.endDate + 2 to 3 hours, atau hingga akhir periode pemutaran ulang Video on demand) sehingga deep link tidak akan habis masa berlakunya selama perpanjangan waktu live atau liputan pascapertandingan.
  • Persyaratan @id dan url:
    • Gunakan nilai @id yang berbeda: BroadcastEvent.@id harus berbeda dari SportsEvent.@id.
    • Hilangkan url: Jangan sertakan properti url pada entitas BroadcastEvent atau SportsEvent.
S.No. Entitas yang Diperlukan Panduan
Kasus 1

Saya perlu membuat model SportsEvent yang merupakan bagian dari katalog TV live dan streaming online saya.

Pertandingan di-streaming melalui internet dan tidak terikat ke channel mana pun.

Entitas yang Diperlukan

  • SportsEvent yang mewakili game
  • BroadcastEvent yang mewakili penayangan pertandingan

Panduan pemodelan

Subkasus 1: Pertandingan hanya tersedia secara live (dan bukan sebagai bagian dari katalog Video on demand)

  • Berikan entity BroadcastEvent untuk membagikan jadwal siaran, dengan mereferensikan pertandingan menggunakan BroadcastEvent.broadcastOfEvent dan menentukan negara siaran di BroadcastEvent.location.
  • Berikan deep link livestream di entitas SportsEvent menggunakan SportsEvent.potentialAction (dikonfigurasi dengan pre-roll 14 hari availabilityStarts dan buffer waktu tambahan 2–3 jam availabilityEnds).
  • Jangan berikan BroadcastEvent.potentialAction, BroadcastEvent.url, atau SportsEvent.url.
  • Jangan berikan BroadcastEvent.publishedOn karena pertandingan di-streaming secara online tanpa saluran linear.

Subkasus 2: Pertandingan tersedia secara live dan sebagai bagian dari katalog Video on demand (misalnya, saat replay pertandingan lengkap tetap tersedia sesuai permintaan)

  • Berikan entity BroadcastEvent untuk membagikan jadwal setiap siaran (merujuk ke BroadcastEvent.broadcastOfEvent dan menentukan BroadcastEvent.location).
  • Gabungkan pemutaran live dan Video on demand di SportsEvent.potentialAction—baik dengan memperpanjang availabilityEnds hingga akhir periode Video on demand jika URL dan haknya sama, atau dengan menyediakan beberapa objek WatchAction di SportsEvent.potentialAction dengan periode actionAccessibilityRequirement masing-masing.
  • Jangan berikan BroadcastEvent.potentialAction, BroadcastEvent.url, SportsEvent.url, atau BroadcastEvent.publishedOn.

Pemeriksaan kualitas yang harus dilakukan

  • Tetapkan BroadcastEvent.isLiveBroadcast ke boolean true (tanpa tanda petik) saat pertandingan disiarkan secara live. Tetapkan ke false untuk siaran replay terjadwal.
  • Untuk entitas BroadcastEvent yang tidak aktif, BroadcastEvent.startDate tidak boleh lebih awal dari SportsEvent.startDate.
  • Sertakan parentOrganization (dengan URL sameAs Wikipedia) di homeTeam dan awayTeam.
Kasus 2

Saya perlu membuat model SportsEvent yang merupakan bagian dari katalog TV live saya dan melakukan streaming online di saluran.

Entitas yang Diperlukan

  • SportsEvent yang mewakili game.
  • BroadcastEvent yang mewakili penayangan pertandingan.
  • BroadcastService, Organization, TelevisionChannel, CableOrSatelliteService entitas yang mewakili channel dan grup channel.

Panduan pemodelan

Subkasus 1: Pertandingan hanya tersedia secara live di channel linear (dan tidak sebagai bagian dari katalog Video on demand)

  • Berikan entitas BroadcastEvent untuk membagikan jadwal siaran, dengan BroadcastEvent.publishedOn yang mengarah ke entitas BroadcastService, BroadcastEvent.broadcastOfEvent yang mengarah ke entitas SportsEvent, dan BroadcastEvent.location yang menentukan negara siaran.
  • Berikan entity BroadcastService, Organization, TelevisionChannel, dan CableOrSatelliteService untuk merepresentasikan channel dan grup channel, dengan deep link channel di BroadcastService.potentialAction.
  • Jangan pernah memberikan BroadcastEvent.potentialAction, BroadcastEvent.url, atau SportsEvent.url.
  • Jika Anda juga mendukung deep link langsung khusus pertandingan, berikan di SportsEvent.potentialAction; jika pemutaran hanya tersedia melalui deep link channel linear di BroadcastService.potentialAction, hapus SportsEvent.potentialAction.

Sub-kasus 2: Pertandingan tersedia secara live di channel dan sebagai bagian dari katalog Video on demand

  • Berikan entity BroadcastEvent (dengan publishedOn, broadcastOfEvent, dan location) untuk membagikan jadwal siaran channel.
  • Berikan entitas BroadcastService, Organization, TelevisionChannel, dan CableOrSatelliteService, dengan deep link channel di BroadcastService.potentialAction.
  • Jangan pernah memberikan BroadcastEvent.potentialAction, BroadcastEvent.url, atau SportsEvent.url.
  • Berikan SportsEvent.potentialAction pada entitas SportsEvent untuk jendela pemutaran tingkat peristiwa/Video on demand.

Pemeriksaan kualitas yang harus dilakukan

  • Tetapkan BroadcastEvent.isLiveBroadcast ke boolean true (tanpa tanda petik) saat pertandingan disiarkan secara live, dan false untuk replay pertandingan.
  • Untuk entitas BroadcastEvent yang tidak aktif, BroadcastEvent.startDate tidak boleh lebih awal dari SportsEvent.startDate.
  • Sertakan parentOrganization (dengan URL sameAs Wikipedia) di homeTeam dan awayTeam.

Contoh

Kasus 1: Acara olahraga yang merupakan bagian dari katalog TV live dan di-streaming secara online

Acara siaran

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live_event/basketball/professional/final_game_6",
  "name": "2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "description": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B.",
  "startDate": "2019-09-16T10:00-08:00",
  "endDate": "2019-09-16T13:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": true,
  "broadcastOfEvent": {
    "@type": "SportsEvent",
    "@id": "http://example.com/basketball/professional/final_game_6"
  },
  "location": {
    "@type": "Country",
    "name": "US"
  }
}

Acara olahraga

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name": "2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport": "https://en.wikipedia.org/wiki/Basketball",
  "description": {
    "@language": "en",
    "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
  },
  "startDate": "2019-09-16T10:00-08:00",
  "endDate": "2019-09-16T13:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "Jane Doe"
      }
    ]
  },
  "location": {
    "@type": "Place",
    "name": "Example Stadium",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "1600 Amphitheatre Pkwy",
      "addressLocality": "Mountain View",
      "addressRegion": "CA",
      "postalCode": "94043",
      "addressCountry": "US"
    }
  },
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value": "EP000194303282"
    }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/pbl_finals_game_6?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",
      "availabilityStarts": "2019-09-01T10:00-08:00",
      "availabilityEnds": "2019-09-16T16:00-08:00",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Kasus 2: Acara olahraga yang merupakan bagian dari katalog TV live dan di-streaming secara online di suatu channel

Acara siaran

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live_event/basketball/professional/final_game_6",
  "name": "2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "description": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B.",
  "startDate": "2019-09-16T10:00-08:00",
  "endDate": "2019-09-16T13:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": true,
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "broadcastOfEvent": {
    "@type": "SportsEvent",
    "@id": "http://example.com/basketball/professional/final_game_6"
  },
  "location": {
    "@type": "Country",
    "name": "US"
  }
}

Acara olahraga

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name": "2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport": "https://en.wikipedia.org/wiki/Basketball",
  "description": {
    "@language": "en",
    "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
  },
  "startDate": "2019-09-16T10:00-08:00",
  "endDate": "2019-09-16T13:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "Jane Doe"
      }
    ]
  },
  "location": {
    "@type": "Place",
    "name": "Example Stadium",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "1600 Amphitheatre Pkwy",
      "addressLocality": "Mountain View",
      "addressRegion": "CA",
      "postalCode": "94043",
      "addressCountry": "US"
    }
  },
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value": "EP000194303282"
    }
  ]
}

BroadcastService, CableOrSatelliteService, TelevisionChannel, dan Organization seperti yang ditentukan di bagian Channel TV Live di bagian Konsep.

Bagaimana cara menangani konten tambahan?

Apa yang memenuhi syarat sebagai konten tambahan?
  • Klip pendek rangkuman atau replay acak
  • Pratinjau game
  • Sorotan pertandingan
  • Kesalahan lucu dalam game
  • Klip wawancara pemain
  • Video di balik layar
  • Ulasan game (buatan pengguna atau lainnya)
  • Klip pendek acak lainnya dari game
S.No. Kasus penggunaan Panduan pemodelan
Kasus 1 Saya memiliki konten tambahan di katalog Video on demand saya.
  • Tindakan ini tidak didukung dan tidak dapat diberikan dalam feed.
  • Namun, ViTA dapat digunakan untuk menyediakan subset konten ini. Hubungi perwakilan Google Anda untuk mempelajari lebih lanjut ViTA.
Kasus 2 Saya memiliki konten tambahan di katalog live saya

Subkasus 1: Konten tersedia untuk di-streaming secara live di internet

  • Berikan entity BroadcastEvent untuk membagikan jadwal siaran.
  • Berikan deep link konten tambahan menggunakan properti BroadcastEvent.potentialAction (pengecualian ini hanya berlaku untuk konten tambahan live mandiri karena tidak ada entitas SportsEvent dalam feed).
  • Tambahkan metadata terkait (ke klip) langsung ke BroadcastEvent . Misalnya, gambar dapat ditambahkan menggunakan properti BroadcastEvent.image . Rating usia dapat ditambahkan menggunakan properti BroadcastEvent.contentRating .
  • Karena jenis konten ini bukan SportsEvent, feed tidak boleh berisi entitas SportsEvent. Oleh karena itu, properti broadcastOfEvent di BroadcastEvent tidak boleh diberikan.
  • Karena tidak terkait dengan channel, jangan berikan properti publishedOn di BroadcastEvent.

Subkasus 2: Konten tersedia untuk di-streaming secara live di internet di channel

  • Entitas BroadcastEvent harus diberikan untuk membagikan jadwal siaran.
  • Entity BroadcastService, Organization, TelevisionChannel , CableOrSatelliteService harus disediakan untuk mewakili channel dan daftar penyedia.
  • Deep link ke game harus berupa deep link BroadcastService , yang diwakili oleh properti BroadcastService.potentialAction , yang harus disediakan.
  • Properti BroadcastEvent.potentialAction tidak boleh diberikan.
  • Metadata terkait (ke klip) harus ditambahkan langsung ke BroadcastEvent. Misalnya, gambar dapat ditambahkan menggunakan properti BroadcastEvent.image. Rating usia dapat ditambahkan menggunakan properti BroadcastEvent.contentRating.
  • Karena jenis konten ini bukan SportsEvent, feed tidak boleh berisi entitas SportsEvent. Oleh karena itu, properti broadcastOfEvent di BroadcastEvent tidak boleh diberikan.
  • Karena terkait dengan channel, berikan properti publishedOn di BroadcastEvent.
Kasus 3 Saya memiliki konten tambahan yang tersedia sebagai bagian dari katalog Video on demand dan TV live

Mengingat konten pendukung olahraga Video on demand tidak diterima di feed saat ini, kasus ini mirip dengan kasus 2. Lihat petunjuk dari sana.

Pertanyaan Umum

T: Di mana saya dapat menemukan spesifikasi terkait untuk entitas yang disebutkan sebelumnya?

J: Anda dapat menemukan spesifikasi yang diperlukan di sini.

Dokumentasi keseluruhan Link
SportsEvent Tautkan
BroadcastService, Organization, TelevisionChannel , CableOrSatelliteService Tautkan
BroadcastEvent Tautkan

T: Apakah ada dokumen yang lebih mendetail yang menjelaskan cara membuat model channel dan grup channel TV live?

J: Ya, Anda dapat menemukan detail selengkapnya di bagian Saluran TV Live di bagian Konsep. Jangan ragu untuk meminta akses lihat jika Anda tidak dapat melihat dokumen.

T: Apakah ViTA juga mendukung pertandingan live lengkap dan replay pertandingan lengkap?

ViTA mendukung metadata pada pertandingan live penuh dan replay pertandingan penuh berbasis liga (selain subset konten tambahan)

  • Untuk partner yang sudah memiliki feed Media Actions yang berfungsi dengan Google atau memiliki penawaran Video on demand atau TV live, Google mewajibkan feed tersebut diperluas dan menyertakan jenis SportsEvent yang didukung juga.

    • Untuk jangka pendek, partner dapat menggunakan ViTA untuk penyerapan konten tambahan. Dukungan untuk semua jenis konten melalui feed akan diluncurkan dalam jangka panjang.
  • Bagi partner yang tidak memiliki penawaran video on demand atau TV live, tetapi hanya menyediakan konten olahraga berbasis liga dan konten tambahan terkait, ViTA adalah opsi yang bagus untuk memulai. Hubungi perwakilan Google Anda untuk mempelajari lebih lanjut ViTA.