Azioni di Play Giochi

Panoramica

Questo documento introduce le Azioni di gioco per i videogiochi, elenca i requisiti dello schema e descrive in dettaglio la procedura di onboarding per il lancio della funzionalità.

Introduzione alle Azioni di Play Giochi

Versione mobile di Azioni di Play Giochi
Immagine delle azioni di Play Giochi su un dispositivo mobile
Versione desktop di Play Game Actions
Immagine delle azioni di Play Giochi su un computer

Le azioni di gioco per i videogiochi consentono agli utenti di giocare direttamente dalla pagina dei risultati di ricerca su computer o dispositivo mobile. Gli utenti visualizzano un'azione di Play Giochi nella scheda Panoramica della pagina dei risultati di ricerca organizzati (OSRP) o nel riquadro delle informazioni quando cercano un gioco a cui è associata almeno un'azione di Play Giochi. Funziona per le versioni demo o complete dei giochi disponibili senza costi, tramite abbonamento o acquisto à la carte e riproducibili in streaming dal cloud su computer o dispositivi mobili oppure scaricabili tramite app client locali su computer o console.

Le Azioni di gioco di Play sono basate su un feed, che contiene i dettagli del catalogo dei giochi. Il feed è un oggetto JSON che contiene una raccolta di entità. Un'entità è un oggetto schema.org che rappresenta il gioco nel tuo catalogo e il relativo link diretto per lo streaming del gioco (demo, prova istantanea o versione completa).

Affinché Google possa ottenere il tuo feed, devi archiviarlo in un file e ospitare il file in una posizione in cui Google possa accedervi. Per garantire che i contenuti siano aggiornati, Google recupera regolarmente il file del feed dall'host.

Nelle sezioni seguenti vengono descritti in dettaglio ciascuno di questi requisiti.

Inizia

Come indicato nella sezione precedente, le tue responsabilità in qualità di fornitore includono quanto segue:

  • Comprendi le informazioni necessarie per creare il feed, le relative fonti e disponibilità, nonché il modo in cui vengono inserite nel feed.
  • Crea un feed che contenga i dettagli richiesti di ogni entità di gioco nel tuo catalogo.
  • Ospita il feed su un server o un servizio di archiviazione cloud e consenti a Google di recuperarlo regolarmente.
  • Rispondi ai problemi sollevati da Google e risolvili. Potrebbero essere problemi relativi alla qualità o alla struttura dei file JSON stessi.
  • Mantieni aggiornato il feed man mano che il catalogo si evolve.
  • Assicurati che la qualità del feed venga mantenuta dopo il lancio.

Vediamoli nel dettaglio.

Prima di iniziare

Prima di iniziare a creare il feed, ti consigliamo di dedicare del tempo a comprendere i requisiti dei metadati delle Azioni di gioco di Play e a raccogliere tutte le informazioni necessarie in un unico posto. Prima di iniziare a creare un feed, ti consigliamo di procedere come segue:

  • Esamina i requisiti dei metadati per l'entità VideoGame.
  • Raccogli i metadati.
    • Esamina attentamente le proprietà obbligatorie e altamente consigliate. Google utilizza queste proprietà per riconciliare i contenuti nel feed con i contenuti nei database di Google. Più metadati fornisci per i tuoi contenuti, meglio Google può abbinarli.

Comprendere l'utilizzo di Opere e Edizioni in questa documentazione

  • Opera: il videogioco nella sua forma astratta. Nello specifico, metadati come titolo, sviluppatore, descrizione del gioco e editore sono attributi di un'opera.
  • Edizione: una versione concreta del videogioco. Nello specifico, metadati come l'anno di pubblicazione, il nome della piattaforma e i link diretti sono attributi dell'edizione.

Ad esempio, "Shadow of the Tomb Raider" è un'opera, ma ogni singola versione è un'edizione. In questo caso, l'opera "Shadow of the Tomb Raider" potrebbe avere un'edizione per Stadia, un'edizione per PlayStation, un'edizione per l'accesso anticipato su Stadia e così via.

Questa distinzione è particolarmente importante nel feed, in cui potrebbe essere non immediatamente evidente. Esistono due entità VideoGame:

  • VideoGame (Work) è l'entità VideoGame di "primo livello":
    • exampleOfWork è una proprietà di VideoGame (Work) e specifica una o più istanze di VideoGame (Edition).
    • Deve esserci almeno un exampleOfWork VideoGame (Edition) per ogni VideoGame (Work).
  • VideoGame (Edition) è l'entità VideoGame "di livello inferiore".

È utile ricordare che possono essere presenti più edizioni di un'opera. Ti consigliamo di raggruppare queste edizioni il più possibile. Questo facilita ai sistemi Google l'utilizzo di tutte le informazioni pertinenti di un videogioco e la loro visualizzazione nella Ricerca.

Comprendi due proprietà chiave e i relativi requisiti. È fondamentale impostarli correttamente prima di passare alla creazione del feed, che è il passaggio successivo.

URL canonico (url)

Un URL canonico (url) aiuta Google a riconciliare con precisione i contenuti del tuo catalogo con quelli nei database di Google.

"Un URL canonico è l'URL della pagina che Google ritiene più rappresentativo tra un insieme di pagine duplicate sul tuo sito. Ad esempio, se hai più URL per la stessa pagina (ad esempio: example.com?dress=1234 ed example.com/dresses/1234), Google ne sceglie uno come canonico." (Fonte: Raggruppare URL duplicati)

Di seguito sono riportati i requisiti per l'URL canonico:

  • url deve essere univoco a livello globale.
  • url deve contenere un URL canonico funzionante che Google possa scansionare.

Identificatore (@id)

Un identificatore (@id) deve soddisfare i seguenti requisiti:

  • Univoco a livello globale nel tuo catalogo:
    • Ad esempio, non utilizzare lo stesso @id per due videogiochi diversi.
  • Statico:
    • Non potrai modificare @id in un secondo momento.
  • Sotto forma di URI (Unified Resource Identifier):
    • Se l'identificatore locale (ID) dei tuoi contenuti non è in formato URI, anteponi il tuo dominio all'ID per soddisfare questo requisito. Ad esempio, se l'ID dei tuoi contenuti è 1234abc e il tuo dominio è https://example.com, @id può essere https://example.com/1234abc.
    • @id non deve essere un URL funzionante, ma solo in formato URI.
    • Il dominio utilizzato in @id (ad esempio, https://example.com) deve essere di proprietà della tua organizzazione.

Poiché l'url di un'entità soddisfa tutti i requisiti come identificatore (ovvero, univoco a livello globale, statico e sotto forma di URI), ti consigliamo di utilizzare l'url di un'entità come @id nei casi in cui ha senso.

Comprendere e identificare i requisiti dei link diretti

Quando un utente avvia le Azioni di gioco su un contenuto, Google utilizza il link diretto del contenuto per indirizzare l'utente direttamente al contenuto nella tua app o piattaforma. Tieni presente quanto riportato di seguito.

  • I link diretti devono aprire i contenuti di destinazione su tutte le piattaforme specificate. Piattaforme diverse possono avere link diretti diversi. Ad esempio, il link diretto che funziona sul web da computer potrebbe essere diverso da quello che funziona sul web da dispositivo mobile. Per ogni gioco, controlla se ha link diretti diversi in base alla piattaforma.
  • I link diretti possono includere parametri (&) o tag di ancoraggio (#).
  • Per garantire che i tuoi contenuti siano disponibili sulle varie piattaforme di Google (Ricerca, Assistente e Android TV), è necessario un link diretto.

Poiché l'url di un'entità soddisfa tutti i requisiti come identificatore (ovvero univoco a livello globale, statico e sotto forma di URI), ti consigliamo di utilizzare l'url di un'entità come @id nei casi in cui ha senso.

Piattaforma Descrizione
http://schema.org/DesktopWebPlatform Piattaforma di ricerca su browser web desktop.
http://schema.org/MobileWebPlatform Piattaforma di ricerca sul browser web mobile.
http://schema.org/AndroidPlatform Piattaforma di ricerca nell'app Android.
http://schema.org/AndroidTVPlatform Piattaforma Android TV nell'app Android TV.
http://schema.org/IOSPlatform Cerca la piattaforma nell'app per iOS.

Identifica i requisiti di accesso per i giochi del tuo catalogo: poni le seguenti domande e assicurati che esista un modo per identificare le risposte tramite i metadati nel feed.

  • Gli utenti devono accedere alla tua app o piattaforma per accedere ai contenuti?
  • Gli utenti hanno bisogno di un abbonamento?
  • Gli utenti devono effettuare un acquisto per giocare?
  • Il requisito di accesso cambia nel tempo?
  • Il requisito di accesso dipende dalla posizione del dispositivo?

Se offri più di un pacchetto di abbonamento che i tuoi utenti possono acquistare, scopri che cos'è un commonTier e come si applica alla tua integrazione con Google.

Tipi di paywall

Oggi Play Game Actions supporta solo i seguenti tipi di paywall:

Valore della categoria Tipo di paywall
nologinrequired Non è necessario effettuare acquisti o accedere.
free L'utente deve aver eseguito l'accesso, ma non ha bisogno di un abbonamento a pagamento.
subscription L'utente deve avere un abbonamento attivo. L'accesso è indipendente dal livello di abbonamento.
subscription L'utente deve avere un abbonamento attivo. L'accesso è indipendente dal livello di abbonamento.
purchase I contenuti sono disponibili per un periodo di tempo indefinito dopo l'acquisto.
rental I contenuti sono disponibili per un periodo di tempo limitato dopo l'acquisto.

Questi valori di categoria vengono utilizzati in un secondo momento durante la creazione del feed. Inoltre, tieni presente che la categoria rental nella tabella precedente è totalmente facoltativa oggi e potrebbe essere supportata in un futuro miglioramento del prodotto. Al momento, solo i valori delle categorie free, nologinrequired, subscription e purchase vengono utilizzati dal prodotto dal feed.

Infine, dai un'occhiata rapida al feed di esempio per farti un'idea del risultato finale.

Comprendere quanto sopra e assicurarsi che siano presenti metadati per rappresentare le risposte (a queste domande), sufficienti per passare alla fase di creazione del feed.

Creare il feed

Il feed Azioni di Play Giochi è un oggetto JSON che contiene una raccolta di entità che rappresentano i videogiochi del tuo catalogo. Devi fornire un feed come file o come più file e ospitarlo su un server o un servizio di archiviazione cloud per consentire a Google di recuperarlo regolarmente.

Rispettare i requisiti di formato, quantità e dimensioni dei file del feed

Devi rispettare i seguenti requisiti:

  • Tutti i file dei feed devono utilizzare l'estensione di nome file .json.
  • Assicurati che i nomi dei file non contengano spazi.
  • Non criptare il file del feed.
  • Codifica il file del feed in UTF-8 (controlla l'impostazione dell'editor di file). immagine di codifica
  • Se il file del feed ha dimensioni superiori a 1 GB non compresso, dividilo in più file.
    • Se le dimensioni del file sono inferiori a 1 GB, non ci sono limiti al numero di entità che puoi includere in un singolo file o al numero di file che invii a Google nell'ambito dell'invio del feed.
  • Assicurati che il file sia codificato senza BOM, come indicato nella specifica JSON. Per verificare questo aspetto sul sistema operativo Linux, hexdump file.json | head -n 1 non deve iniziare con BBEF all'indirizzo 0x00.

Rispettare i requisiti di contenuto del feed

Devi rispettare i seguenti requisiti dei contenuti:

  • Il feed non deve contenere entità inattive. Le entità inattive sono entità in cui availabilityEnds del link diretto è impostato su una data già passata o su entità che non sono più disponibili sul tuo sito.
  • Tutti i link diretti, come urlTemplate, e tutti gli URL, come url, che includi nel tuo feed devono essere URL di produzione. Non usare URL QA, di sviluppo o altri tipi di URL non di produzione.
  • Tutti gli URL, come url, devono essere canonici, come indicato nella sezione precedente.
  • Ogni entità nel feed deve specificare le seguenti proprietà:
    • Un ID univoco: @id
    • Un URL univoco: url
    • Un link diretto univoco: urlTemplate

Ecco alcuni consigli per la creazione del feed:

  • Scopri in dettaglio come è strutturato il feed.
  • Inizia con un feed di esempio.
    • Seleziona fino a cinque entità rappresentative dal catalogo. Scegli entità con una struttura ragionevolmente complessa, ma comunque tipica di un'entità nel catalogo, e crea il feed per la stessa.
  • Invialo al rappresentante di Google assegnato per una rapida convalida.
  • Dopo aver risolto tutti gli errori nel feed di esempio, espandi il feed in modo da includere tutte le entità del catalogo.
    • Per verificare che il feed includa tutte le entità del catalogo, confronta il numero di entità nel feed con il numero di articoli nel catalogo.

Ospitare il feed

Quando il file del feed è pronto, ospitalo in una posizione sicura. Google recupera regolarmente il feed per garantire che il contenuto sia aggiornato. Supportiamo i seguenti metodi di hosting:

Metodo di hosting Supporto per l'autenticazione
Google Cloud Storage Concedi l'autorizzazione Visualizzatore oggetti Storage a 088794101-100000002-account@partnercontent.gserviceaccount.com
HTTPS Richiede la condivisione di nome utente+password o certificati client HTTP.
SFTP Richiede la condivisione di password, chiave+frase o entrambi.
AWS S3 Richiede la condivisione dell'ID chiave e della chiave di accesso per il bucket AWS S3.

Dopo aver caricato il file del feed in un sistema host, contatta il team di Play Game Actions per esaminarlo.

Inviare il feed per la revisione

Una volta ospitato il file del feed, contatta il tuo contatto Play Game Actions assegnato per iniziare la procedura di revisione del feed. Assicurati di condividere le seguenti informazioni in questa comunicazione:

  • Panoramica/Descrizione: comunicaci se stai condividendo un feed di esempio o un feed di produzione completo. Se condividi un feed di esempio, comunicaci la data di arrivo stimata del feed di produzione, se possibile.
  • Posizione di hosting: l'URL del file del feed.
  • Autenticazione host: includi le credenziali di autenticazione per consentire a Google di recuperare il file del feed dall'host, se applicabile. Per ulteriori informazioni, consulta Ospitare il feed.
  • Account di test: un account di test che consente al team di Play Game Actions di accedere ai deep link sulla tua app o piattaforma per i test. Se il tuo feed contiene entità in più piattaforme, fornisci un account di test per ogni piattaforma.
  • Icons: invia le seguenti cinque icone. Queste icone vengono utilizzate accanto alle azioni di Play Giochi nella Ricerca.
Categoria Dimensioni (px) Dimensioni file Linee guida
Azioni di gioco su Ricerca/Cast/Altro
16x16 Le dimensioni del file per tutte le icone, ad eccezione di quella da 112 x 112 px, non possono superare 1 KB.

Le dimensioni del file dell'icona 112 x 112 px non possono superare i 3 KB.

 Sono necessarie tutte e cinque le dimensioni delle icone.

Le immagini devono rispettare i seguenti requisiti:

  • Un formato file PNG.
  • Una forma rotonda.
  • Uno sfondo trasparente.
  • Assicurati che le immagini siano anti-aliasing e non distorte o pixelate.
20 x 20
40x40
44x44
112x112

Esempio

icone di esempio

Come funziona la convalida dei feed

La convalida del feed si articola in due fasi:

  • Convalida della struttura:
    • Questa è la prima fase dei controlli di convalida.
    • Google fornisce feedback relativi alla struttura dei file JSON. Il file JSON è ben formato? Il feed contiene tutte le proprietà obbligatorie e quelle altamente consigliate? I link diretti forniti sono annotati in base ai nostri requisiti dei feed?
    • Questa fase richiede diverse discussioni con Google e continua finché non viene preso in considerazione tutto il feedback.
  • Riconciliazione dei metadati:
    • Ciò inizia solo dopo che il feed supera la fase di convalida della struttura ed è in questo momento che Google avvia la procedura di riconciliazione con il Knowledge Graph di Google.
    • In questa fase, forniamo un feedback sui metadati contenuti nel feed. Tutti i problemi devono essere risolti per un lancio riuscito. Ad esempio, il feedback in questa fase potrebbe chiederti di correggere il titolo di un gioco o la sua data di uscita.
    • Questa fase richiede anche diverse discussioni con Google e continua finché non viene preso in considerazione tutto il feedback.

Criteri di accettazione dei feed

Un feed viene considerato accettabile per il lancio quando tutti i problemi bloccanti sono stati risolti e Google ha certificato che la qualità dei metadati è al livello richiesto per il lancio.

Aggiornare il feed in base alle necessità

Anche se ti consigliamo di aggiornare il feed quotidianamente, questo dipende in ultima analisi dalla frequenza con cui il tuo catalogo cambia. Tieni presente i seguenti suggerimenti e condizioni:

  • La Ricerca Google non supporta gli aggiornamenti in tempo reale.
  • La Ricerca Google recupera il feed una volta al giorno e in genere indicizza i contenuti entro due giorni (al momento del lancio).
  • Se è prevista una variazione della disponibilità di un link diretto, usa availabilityStarts e availabilityEnds per impostare le date esatte.
  • Se l'entità non è più disponibile nel tuo catalogo, rimuovila completamente dal feed.

Riferimento

Panoramica della struttura del feed

Il feed Azioni di gioco di Play ha la seguente struttura:

diagramma del feed playgame

Busta del feed di dati

Un contenitore del feed di dati è l'oggetto di livello superiore nel feed Azioni di Play Giochi. L'oggetto contiene un array di oggetti markup dei contenuti (entità VideoGame (Work)) che rappresentano tutti i videogio nel tuo catalogo.

Proprietà Tipo previsto Descrizione
@context URL Required. Impostato su http://schema.org
@type Testo Required. Da impostare su DataFeed.
dateModified DateTime Required. La data e l'ora dell'ultima modifica del feed, nel formato ISO 8601 (incluso il fuso orario).
dataFeedElement Cosa Required. Le entità del tuo catalogo di giochi.

Modello

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {  },
    {  },
    {  },
    ...
  ]
}

Oggetti di markup dei contenuti

Un oggetto di markup dei contenuti rappresenta una singola entità nel tuo catalogo: VideoGame (Work). L'oggetto contiene l'identificatore e l'URL canonico dei contenuti e aiuta a descriverli tramite i metadati. L'oggetto di markup dei contenuti per VideoGame (Work) ha una proprietà chiamata exampleOfWork per collegarlo all'oggetto VideoGame(Edition). Questo VideoGame(Edition) può avere un array di oggetti di markup Action, che consentono di associare i contenuti a più oggetti di markup Action. Ad esempio, i contenuti possono avere un oggetto di markup Azione diverso per ogni regione.

Oggetti di markup dell'azione

Un oggetto di markup Azione descrive il link diretto che porta gli utenti al gioco e il livello di accesso richiesto per il gioco. L'oggetto è una proprietà (potentialAction) di un oggetto di markup dei contenuti. Per le Azioni di gioco di Play, utilizza un oggetto di specifica dell'accesso all'azione per specificare le limitazioni dell'accesso.

Proprietà Tipo previsto Descrizione
@type Testo Required. Sempre impostato su PlayGameAction.
gameAvailabilityType GameAvailabilityEnumeration o Text Required. Indica il tipo di disponibilità dei contenuti di gioco associati a questa azione, ad esempio se si tratta di una versione completa o di una demo. I valori accettati includono DEMO e FULL.
additionalType Testo Required. Indica il tipo di azione di gioco associata a questo gioco. I valori accettati includono:
  • StreamingPlayAction: indica che un gioco è disponibile per lo streaming online
  • DownloadPlayAction: indica che un gioco è disponibile per il download
target EntryPoint Required. Un oggetto di destinazione che fornisce il mapping dei link diretti a varie piattaforme Google.
target.@type Testo Required. Sempre impostato su EntryPoint.
target.urlTemplate URL Required. Un link diretto che indirizza gli utenti alla tua app o piattaforma e avvia la riproduzione del gioco.
target.inLanguage Testo Facoltativo. Lingua originale della serie nel formato BCP 47.
target.actionPlatform Testo Required. Le piattaforme mappate a urlTemplate. Le Azioni di gioco supportano i seguenti valori:
  • http://schema.org/DesktopWebPlatform
  • http://schema.org/MobileWebPlatform
  • http://schema.org/AndroidPlatform
  • http://schema.org/AndroidTVPlatform
  • http://schema.org/IOSPlatform

Per i requisiti, vedi Tipi di piattaforme.
actionAccessibilityRequirement ActionAccessSpecification Required. Un oggetto di specifica dell'accesso all'azione che descrive il requisito di accesso ai contenuti. Per maggiori dettagli, vedi Proprietà della specifica di accesso all'azione.

Modello

"potentialAction": {
  "@type": "PlayGameAction",
  "target": [
    {  },
    {  }
  ],
  "actionAccessibilityRequirement": [
    {  },
    {  }
  ]
}

Target

Un oggetto di destinazione fornisce la mappatura di un link diretto a varie piattaforme Google. L'oggetto è una proprietà (target) di un oggetto markup Azione. La proprietà urlTemplate acquisisce il link diretto e la proprietà actionPlatform acquisisce le piattaforme che supportano il link diretto.

Esempio

"target": [
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://schema.org/AndroidTVPlatform",
      "http://schema.org/IOSPlatform"
    ]
  },
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/mobile/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/MobileWebPlatform"
    ]
  }
]

Specifica dell'accesso all'azione

Un oggetto di specifica dell'accesso all'azione descrive il requisito di accesso ai contenuti in base alla regione e al periodo di tempo. L'oggetto è una proprietà, actionAccessibilityRequirement, di un oggetto markup Azione.

Esempio di target con due link diretti

"target": [
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://schema.org/AndroidTVPlatform",
      "http://schema.org/IOSPlatform"
    ]
  },
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/mobile/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/MobileWebPlatform"
    ]
  }
]

Specifica dell'accesso all'azione

Un oggetto di specifica dell'accesso all'azione descrive il requisito di accesso ai contenuti in base alla regione e al periodo di tempo. L'oggetto è una proprietà, actionAccessibilityRequirement, di un oggetto di markup Azione.

Proprietà Tipo previsto Descrizione
actionAccessibilityRequirement.@type Testo Required. Sempre impostato su ActionAccessSpecification.
actionAccessibilityRequirement.category Testo Required. Un requisito di accesso per i contenuti. Per i valori accettati e ulteriori informazioni, vedi Tipo di paywall.

Se un'entità rappresenta un gruppo di contenuti, devi impostare la categoria sul requisito di accesso meno restrittivo dei suoi contenuti. Ad esempio, se un gioco è disponibile senza costi utilizzando nologinrequired e tramite un abbonamento, imposta la categoria su nologinrequired.
actionAccessibilityRequirement.availabilityStarts Data Required. La data dopo la quale l'azione è disponibile, nel formato ISO 8601 (incluso il fuso orario). La data può essere impostata nel futuro.
  • Deve essere uguale o maggiore di 72 ore dopo availabilityStarts.
  • Se i contenuti sono sempre disponibili dopo la pubblicazione, imposta questa data a 20 anni dalla data corrente.

Richiediamo che l'entità corrispondente venga fornita nel feed almeno sette giorni prima della data availabilityStarts. In questo modo aumentano le probabilità che il gioco venga visualizzato in tempo sulle piattaforme Google.
actionAccessibilityRequirement.availabilityEnds Data Required. La data dopo la quale l'azione non è più disponibile, in formato ISO 8601 (incluso il fuso orario). La data può essere impostata nel futuro.
  • Deve essere uguale o maggiore di 72 ore dopo availabilityStarts.
  • Se i contenuti sono sempre disponibili dopo la pubblicazione, imposta questa data a 20 anni dalla data corrente.

Richiediamo che eventuali aggiornamenti alla data availabilityEnds vengano apportati nel feed almeno sette giorni prima della data availabilityEnds. In questo modo aumentano le probabilità che il gioco non venga più visualizzato sulle piattaforme Google a partire dalla data del availabilityEnds.
actionAccessibilityRequirement.eligibleRegion Country, City, State, GeoShape o Text Required. Le regioni in cui sono disponibili i contenuti. Se i contenuti sono disponibili a livello globale, utilizza la stringa speciale EARTH. Per capire cosa è necessario, consulta Proprietà GeoShape.
actionAccessibilityRequirement.ineligibleRegion Country, City, State, GeoShape o Text Obbligatorio se applicabile. Regioni in cui i contenuti sono soggetti a limitazioni. Non è necessario fornire questa proprietà se i contenuti sono disponibili ovunque all'interno di eligibleRegion.

Per capire cosa è necessario, consulta Proprietà GeoShape.
actionAccessibilityRequirement.requiresSubscription MediaSubscription Obbligatorio se applicabile. I dettagli dell'abbonamento necessario agli utenti per accedere ai contenuti. Per maggiori dettagli, vedi Proprietà degli abbonamenti ai contenuti multimediali.
  • Fornisci questa proprietà se category è subscription.
actionAccessibilityRequirement.expectsAcceptanceOf Offerta Obbligatorio se i contenuti richiedono un acquisto. I dettagli dell'offerta associata ai contenuti. Fornisci le informazioni sui prezzi per i seguenti casi:
  • Contenuti acquistati una tantum (rental o purchase)
  • Contenuti basati su abbonamento che richiedono un acquisto aggiuntivo da parte degli abbonati (subscription)

Se il prezzo è 0,00, rimuovi completamente l'oggetto Offerta e imposta actionAccessibilityRequirement.category su free. Per maggiori dettagli, consulta Proprietà dell'offerta.

La specifica dell'abbonamento ai contenuti multimediali

Un oggetto di abbonamento ai contenuti multimediali descrive i dettagli dell'abbonamento richiesto per i contenuti. L'oggetto è una proprietà, requiresSubscription, di un oggetto di specifica di accesso all'azione.

Importante: questo è necessario se actionAccessibilityRequirement.category è subscription e la tua offerta di abbonamento include più pacchetti o livelli oppure supporta i componenti aggiuntivi. Ometti questo valore se il tuo abbonamento è a un solo livello e dà accesso a tutti i contenuti del tuo catalogo.
Proprietà Tipo previsto Descrizione
requiresSubscription.@type Testo Required. Sempre impostato su MediaSubscription.
requiresSubscription.@id URL Required. L'ID univoco dell'abbonamento. Se i contenuti sono accessibili con abbonamenti diversi, ogni abbonamento deve avere un ID univoco.
requiresSubscription.name Testo Required. Il nome dell'abbonamento. Nota quanto segue:
  • Se i contenuti sono accessibili con abbonamenti diversi, questo nome deve corrispondere a quello del tuo sistema di autenticazione degli utenti. Ad esempio, se un utente può accedere ai contenuti in base all'abbonamento denominato Pacchetto 1, ma il sistema di autenticazione utilizza il nome PKG1, utilizza PKG1.
requiresSubscription.sameAs URL Facoltativo. La pagina che descrive l'abbonamento.
requiresSubscription.identifier Testo Obbligatorio se category è subscription e commonTier è false. Una stringa univoca per questo abbonamento che rappresenta l'accesso a un gruppo di contenuti nel tuo catalogo multimediale.
  • Google consiglia di utilizzare la seguente sintassi per identifier:nome di dominio + due punti (:) + livello di accesso ai contenuti. Esempi : example.com:basic, example.com:premium, example.com:sports
requiresSubscription.commonTier Valore booleano Obbligatorio se la categoria è impostata su abbonamento. Scopri di più su commonTier nella documentazione relativa ai requisiti comuni dei livelli.

Proprietà dell'offerta

Un oggetto offerta descrive il prezzo associato ai contenuti. L'oggetto è una proprietà (expectsAcceptanceOf) dell'oggetto specifica di accesso all'azione. Può essere utilizzato per due scopi:

  • Per fornire i dettagli dell'acquisto del gioco. actionAccessibilityRequirement.category deve essere impostato su purchase per questo caso d'uso.
  • Per fornire i dettagli dell'acquisto del gioco quando è in offerta. actionAccessibilityRequirement.category deve essere impostato su purchase per questo caso d'uso e devono essere fornite due offerte per azione: una per fornire i dettagli del prezzo di listino e l'altra per i dettagli del prezzo scontato.

Proprietà Tipo previsto Descrizione
expectsAcceptanceOf.@type Testo Obbligatorio: sempre impostato su Offer.
expectsAcceptanceOf.name Testo (Facoltativo) Il nome dell'offerta.
expectsAcceptanceOf.priceSpecification PriceSpecification Obbligatorio: i dettagli sui prezzi associati al gioco.
expectsAcceptanceOf.priceSpecification.@type Testo Obbligatorio: sempre impostato su UnitPriceSpecification.
expectsAcceptanceOf.priceSpecification.price Number Obbligatorio: il prezzo di acquisto dei contenuti. Il prezzo deve essere un valore positivo diverso da zero. Per i giochi con prezzo 0,00, imposta actionAccessibilityRequirement.category su "free".
expectsAcceptanceOf.priceSpecification.priceCurrency Testo Obbligatorio: la valuta del prezzo in formato ISO 4217 a tre lettere.
expectsAcceptanceOf.priceSpecification.priceType PriceTypeEnumeration o Text Obbligatorio se applicabile: il tipo di prezzo fornito nell'offerta.
Quando actionAccessibilityRequirement.category è impostato su purchase, questa è una proprietà obbligatoria e può accettare solo due valori:
  • https://schema.org/ListPrice: rappresenta il prezzo di listino di un gioco.
  • https://schema.org/SalePrice: rappresenta il prezzo scontato (in genere attivo per un periodo limitato) di un gioco.

Sia https://schema.org/ListPrice che https://schema.org/SalePrice sono obbligatori quando vengono forniti i dettagli dei prezzi scontati.
expectsAcceptanceOf.seller Organizzazione L'organizzazione che offre l'acquisto di contenuti.
expectsAcceptanceOf.seller.@type Testo Sempre impostato su Organization.
expectsAcceptanceOf.seller.name Testo Il nome del venditore.
expectsAcceptanceOf.seller.sameAs URL L'URL di una pagina web che identifica il venditore, ad esempio la home page del venditore.

Per ciascuno dei tipi di paywall supportati, l'esempio riportato di seguito fornisce informazioni su come deve essere creato actionAccessibilityObject:

Senza costi (non è richiesto l'accesso)

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "nologinrequired",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

Senza costi (non è richiesto l'accesso) con prova di un'ora

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "nologinrequired",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "eligibleDuration": 60
    }
  }
}

Senza costi (è necessario eseguire l'accesso)

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "free",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

Acquisto una tantum con sconto

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": [
      {
        "@type": "Offer",
        "name": "Original Price",
        "priceSpecification": {
          "@type": "UnitPriceSpecification",
          "price": 7.99
          "priceCurrency": "USD"
          "priceType": "https://schema.org/ListPrice"
        },
        "seller": {
          "@type": "Organization",
          "name": "Example",
          "sameAs": "http://www.example.com/"
          }
        },
        {
          "@type": "Offer",
          "name": "Sale Price",
          "priceSpecification": {
            "@type": "UnitPriceSpecification",
            "price": 4.99
            "priceCurrency": "USD"
            "priceType": "https://schema.org/SalePrice"
          },
          "seller": {
          "@type": "Organization",
          "name": "Example",
          "sameAs": "http://www.example.com/"
        }
      }
    ]
  }
}

Acquisto una tantum

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "price": 7.99,
      "priceCurrency": "USD",
      "seller": {
        "@type": "Organization",
        "name": "Example",
        "sameAs": "http://www.example.com/"
      }
    }
  }
}

Abbonamenti a un solo livello/più livelli/componenti aggiuntivi

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "subscription",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
    },
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

Abbonamenti e componenti aggiuntivi a più livelli

Di seguito viene descritto come vengono applicati gli abbonamenti a più livelli e i componenti aggiuntivi:

  • In un modello di abbonamento a un solo livello, un fornitore di servizi ha un solo livello di abbonamento. Tutti gli abbonati possono accedere agli stessi contenuti, indipendentemente dal pacchetto di abbonamento.
  • In un modello di abbonamento a più livelli, un fornitore di servizi ha più livelli di abbonamento, ad esempio Gold, Silver e Bronze. Gli utenti che hanno l'abbonamento di livello superiore possono accedere a tutti i contenuti dei livelli inferiori. Tuttavia, gli utenti che hanno l'abbonamento di livello inferiore non possono accedere ai contenuti di livello superiore. content example 1
  • In un modello di abbonamento ai componenti aggiuntivi, un fornitore di servizi consente agli utenti di ampliare i propri diritti e aggiungere contenuti a un abbonamento base. Gli utenti possono aggiungere tutti i contenuti che vogliono. content example 2

Modello generale di un'entità

Ecco un esempio del modello generale di un'entità:

Modello

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {  },
    {
       "@context": ["http://schema.org", {"@language": "en"}],
       "@type": "VideoGame",
       "@id": "http://www.example.com/game007",
       "url": "http://www.example.com/game007",
       "name": "Games Bond 007",
       "exampleOfWork": [
        {  },
        {
           "@type": "VideoGame",
            "@id": "http://www.example.com/game007Stadia",
            "url": "http://www.example.com/game007Stadia",
            "name": "Games Bond 007",
            // Other properties
           "potentialAction": [
              {  },
              {
                  "@type": "PlayGameAction",
                  "target": [
                  {  },
                  {  }
                  ],
                 "actionAccessibilityRequirement": [
                 {  },
                 {  }
                 ]
              }
          ],
    ...
    }
  ]
}

Definizioni dei tipi di dati strutturati

Questa sezione fornisce i dettagli delle proprietà di markup dei contenuti per il tipo di entità VideoGame. Affinché i tuoi contenuti siano idonei alla visualizzazione nei risultati di ricerca, devi includere le proprietà obbligatorie elencate qui. Ti consigliamo di includere anche le proprietà altamente consigliate per aggiungere ulteriori informazioni sui tuoi contenuti, in modo da offrire un'esperienza utente migliore e aiutarci con la riconciliazione delle entità con il Knowledge Graph di Google.

Tabella delle specifiche di VideoGame (Work)

Proprietà Tipo previsto Descrizione
@context Testo Required. Sempre impostato su ["http://schema.org", {"@language": "xx"}].
  • Il valore Where xx rappresenta la lingua delle stringhe nel feed. Il contesto di ogni entità radice deve avere @language impostato sul codice lingua appropriato nel formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, i nomi si presume siano in spagnolo, anche se la lingua dei sottotitoli codificati/doppiaggio è l'inglese.
@type Testo Required. Sempre impostato su VideoGame.
@id URL Required. L'identificatore del contenuto in formato URI, ad esempio https://example.com/1234abc. @id, deve soddisfare i seguenti requisiti:
  • Univoco a livello globale nel tuo catalogo.
  • Statico. L'ID deve essere stabile e non cambiare nel corso del tempo, anche se la proprietà url del gioco cambia. Viene considerato come una stringa opaca e non deve necessariamente essere un link funzionante.
  • Sotto forma di URI (Unified Resource Identifier).
  • Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione.

Poiché l'url di un'entità soddisfa tutti i requisiti di un identificatore, ti consigliamo di utilizzare l'url di un'entità come @id. Per ulteriori dettagli, consulta la sezione Identificatore.
url URL Required. L'URL canonico dei contenuti, che Google utilizza per abbinare i contenuti nel tuo feed ai contenuti nei database di Google. url deve soddisfare i seguenti requisiti:
  • url deve essere univoco a livello globale.
  • url deve contenere un URL canonico funzionante che Google possa scansionare.

Per il deep link di una riproduzione, consulta la proprietà urlTemplate dell'oggetto target.
name Testo Il nome del gioco.
  • Utilizza un array per elencare i nomi in lingue diverse. Per maggiori dettagli, consulta l'esempio Più regioni e lingue.
  • Tieni presente che è supportato un solo nome per ogni lingua (coppia lingua-paese).
description Testo Altamente consigliato. Una sinossi della partita. Limite di 300 caratteri.
  • Utilizza un array per contrassegnare la descrizione in più lingue. Per maggiori dettagli, consulta l'esempio Più regioni e lingue.
genre Testo Un elenco ordinato di tutti i generi pertinenti. Ad esempio: ["Action", "Role playing"]
image ImageObject Altamente consigliato. Le immagini correlate al gioco. Per maggiori dettagli sulle proprietà obbligatorie e facoltative da includere con image, consulta Proprietà immagine.
applicationCategory Testo (Facoltativo) Tipo di applicazione software. Imposta il valore su Game.
exampleOfWork VideoGame Obbligatorio. L'edizione di VideoGame. Questa entità VideoGame (edizione) contiene anche i dettagli del link diretto. Per maggiori dettagli, consulta la tabella delle specifiche di VideoGame (Edition).
playMode Text o GamePlayMode Facoltativo. Indica se questo gioco è multiplayer, cooperativo o per giocatore singolo. Il gioco può essere contrassegnato contemporaneamente come multiplayer, cooperativo e per giocatore singolo. Accetta i seguenti valori:
  • SINGLE_PLAYER
  • LOCAL_MULTI_PLAYER
  • ONLINE_MULTI_PLAYER
  • LOCAL_COOP
  • ONLINE_COOP

Tabella delle specifiche di VideoGame (Edition)

Proprietà Tipo previsto Descrizione
@type Testo Required. Sempre impostato su VideoGame.
@id URL Required. L'identificatore del contenuto in formato URI, ad esempio https://example.com/1234abc.@id, deve soddisfare i seguenti requisiti:
  • Univoco a livello globale nel tuo catalogo.
  • Statico. L'ID deve essere stabile e non cambiare nel corso del tempo, anche se la proprietà url del gioco cambia. Viene considerato come una stringa opaca e non deve necessariamente essere un link funzionante.
  • Sotto forma di URI (Unified Resource Identifier).
  • Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione.

Poiché l'url di un'entità soddisfa tutti i requisiti di un identificatore, ti consigliamo di utilizzare l'url di un'entità come @id. Per ulteriori dettagli, consulta la sezione Identificatore.
url URL Required. L'URL canonico dei contenuti, che Google utilizza per abbinare i contenuti nel tuo feed ai contenuti nei database di Google. url deve soddisfare i seguenti requisiti:
  • url deve essere univoco a livello globale.
  • url deve contenere un URL canonico funzionante che Google possa scansionare.

Per il deep link di una riproduzione, consulta la proprietà urlTemplate dell'oggetto target.
name Testo Il nome del gioco.
  • Utilizza un array per elencare i nomi in lingue diverse. Per maggiori dettagli, consulta l'esempio Più regioni e lingue.
  • Tieni presente che è supportato un solo nome per ogni lingua (coppia lingua-paese).
description Testo Altamente consigliato. Una sinossi della partita. Limite di 300 caratteri.
  • Utilizza un array per contrassegnare la descrizione in più lingue. Per maggiori dettagli, consulta l'esempio Più regioni e lingue.
genre Testo Un elenco ordinato di tutti i generi pertinenti. Ad esempio: ["Action", "Role playing"]
image ImageObject Altamente consigliato. Le immagini correlate al gioco. Per maggiori dettagli sulle proprietà obbligatorie e facoltative da includere con image, consulta Proprietà immagine.
applicationCategory Testo (Facoltativo) Tipo di applicazione software. Imposta il valore su Game.
playMode Text o GamePlayMode Facoltativo. Indica se questo gioco è multiplayer, cooperativo o per giocatore singolo. Il gioco può essere contrassegnato contemporaneamente come multiplayer, cooperativo e per giocatore singolo. Accetta i seguenti valori:
  • SINGLE_PLAYER
  • LOCAL_MULTI_PLAYER
  • ONLINE_MULTI_PLAYER
  • LOCAL_COOP
  • ONLINE_COOP
potentialAction PlayGameAction

Obbligatorio se applicabile. Un oggetto di markup dell'azione che fornisce i dettagli dell'azione.

Utilizza un array per specificare link diretti diversi in più regioni. Per saperne di più, consulta l'esempio Più regioni e lingue.
gameEdition Testo

Required. L'edizione di questo gioco.

Ad esempio, il popolare gioco "Shadow of the Tomb Raider" è offerto in quattro edizioni: "Croft Edition", "Standard Edition", "Digital Deluxe Edition" e "Ultimate Edition".
gamePlatform Testo Required. Piattaforma o sistema elettronico utilizzato per giocare al videogioco.
releasedEvent PublicationEvent Vivamente consigliato. Un PublicationEvent viene utilizzato per specificare la pubblicazione originale (globale o locale) dei contenuti da parte di un editore.
releasedEvent.@type Testo Required. Assicurati di impostare sempre questa proprietà su PublicationEvent.
releasedEvent.Location Paese Required. Le regioni associate a questo evento di lancio.

Utilizza i codici ISO 3166 per i paesi. Per indicare tutto il mondo, imposta il valore su EARTH.
releasedEvent.startDate Data o ora Opzione consigliata. Obbligatorio per ExclusiveEvent. La data di inizio della pubblicazione dell'entità.
releasedEvent.endDate Data o ora Facoltativo. Rappresenta la data di scadenza dei diritti sui contenuti.
releasedEvent.publishedBy Organization o Person Facoltativo. L'organizzazione o la persona che ha pubblicato questa entità.
contentRating Testo Obbligatorio per i giochi per adulti, vivamente consigliato altrimenti. Classificazione complessiva dei contenuti. Se la classificazione dei contenuti viene fornita sotto forma di stringa di testo, sono accettate due varianti:
  • L'agenzia di rating anteposta alla valutazione con uno spazio bianco tra le due. Ad esempio, una classificazione "Mature" dell'agenzia "Entertainment Software Rating Board" negli Stati Uniti deve essere descritta come Entertainment Software Rating Board Mature.
  • Un valore di RATING NOT KNOWN (senza distinzione tra maiuscole e minuscole) per indicare che non conosci la classificazione del gioco.
publisher Organization o Person Facoltativo. L'organizzazione o la persona che ha pubblicato questa entità.
contributor Organization o Person Facoltativo. Un collaboratore secondario di questa entità.

Tabella delle specifiche delle immagini

Le azioni di Play Giochi riutilizzano lo schema delle azioni multimediali per acquisire i requisiti delle immagini. Per saperne di più, consulta le specifiche dello schema delle immagini.

Ecco alcuni altri requisiti da tenere presente.

Proporzioni e contentAttributes Risoluzione minima (in pixel)
16:9, locandina iconica 3840x2160
2:3, locandina iconica 1000x1500
4:3, locandina iconica 800x600
Poster iconico 1:1 600x600
3:4, poster iconico 600x800
16:9, sfondo iconico [preferito] o sceneStill 3840x2160
2:3, sfondo iconico [preferito] o scenaStill 1000x1500
3:4, sfondo iconico [preferito] o scenaStill 600x800

Requisiti di formato

Di seguito sono riportati i requisiti di formato che devi rispettare per le dimensioni, la qualità e così via delle immagini:

  • Includi i poster e i sceneStills con la massima risoluzione che hai per il gioco.
  • L'immagine deve essere in formato JPG, PNG o WebP.
  • L'URL dell'immagine deve poter essere sottoposto a scansione e indicizzato.
  • Le dimensioni dei file non devono superare i 20 MB.
  • Preferiamo immagini adatte sia a smallFormat che a largeFormat.

  • L'immagine non deve contenere:

    • Immagine sfocata, pixelata, ruotata o di scarsa qualità.
    • Fotografie di stock o senza licenza.
    • Nudità.
    • Contenuti illegali.
  • Puoi includere dimensioni delle immagini diverse da quelle elencate nella tabella precedente.

Esempi

Le seguenti sezioni contengono esempi di feed campione per diversi scenari.

Feed di esempio con un'entità VideoGame

Ecco un esempio di entità VideoGame che rappresenta il gioco "Space Wars Made Up Game". Tieni presente che questa entità deve essere racchiusa nell'envelope del feed di dati nel file JSON per essere visibile a Google.

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type":"DataFeed",
   "dateModified":"2021-07-20T00:44:51Z",
   "dataFeedElement":[
      {
         "@context": ["http://schema.org", {"@language": "en"}],
         "@id":"https://www.examplegame.com/VideoGame007",
         "@type":"VideoGame",
         "url":"https://www.examplegame.com/games/VideoGame007",
         "name":"Space Wars Made Up Game",
         "description":"Space Wars offers an immersive RPG experience coupled with realistic gameplay.",
         "genre":[
            "Role playing"
         ],
         "applicationCategory":"Game",
         "publisher":{
            "name":"Made Up Media",
            "@id":"https://www.examplegame.com/uniuqe-id-org",
            "@type":"Organization"
         },
         "contributor":[
            {
               "roleName":"developer",
               "name":"Alpha Labs Man Made Studio",
               "@id":"https://www.studionice.com/uniuqe-id-alpha",
               "@type":"Organization"
            }
         ],
         "playMode":[
           "SINGLE_PLAYER", "LOCAL_MULTI_PLAYER", "ONLINE_MULTI_PLAYER", "LOCAL_COOP", "ONLINE_COOP"
         ],
         "image":[
            {
               "@context":"http://schema.org",
               "@type":"ImageObject",
               "name":"keyart_1X1_3X",
               "contentUrl":"https://lh3.googleusercontent.com/ept4",
               "copyrightHolder":{
                  "@type":"Organization",
                  "name":"Studio Nice"
               },
               "additionalProperty":[
                  {
                     "@type":"PropertyValue",
                     "name":"contentAttributes",
                     "value":[
                         "SMALLFORMAT", "LARGEFORMAT", "SCENESTILL", "CENTERED", "NOTITLE", "NOLOGO"
                     ]
                  }
               ]
            }
         ],
         "exampleOfWork":{
            "@id":"https://www.examplegame.com/VideoGame007/version/v3",
            "name":"Space Wars Made Up Game",
            "description":"Space Wars offers an immersive RPG experience coupled with realistic gameplay.",
            "gameEdition":"Early Access",
            "url":"https://www.examplegame.com/VideoGame007/version/v3/stream",
            "contentRating":[
               "Entertainment Software Rating Board Mature",
               "Pan European Game Information 12",
               "Unterhaltungssoftware Selbstkontrolle Video Game Rating System USK 12"
            ],
            "applicationCategory":"Game",
            "releasedEvent":[
               {
                  "@type":"PublicationEvent",
                  "startDate":"2020-11-30",
                  "location":{
                     "@type":"Country",
                     "name":"US"
                  }
               }
            ],
            "potentialAction":{
               "@type":"PlayGameAction",
               "gameAvailabilityType":"DEMO",
               "target":[
                  {
                     "@type":"EntryPoint",
                     "urlTemplate":"https://www.examplegame.com/VideoGame007/play",
                     "actionPlatform":[
                        "http://schema.org/DesktopWebPlatform",
                        "http://schema.org/MobileWebPlatform",
                        "http://schema.org/AndroidPlatform",
                        "http://schema.org/AndroidTVPlatform",
                        "http://schema.org/IOSPlatform"
                     ]
                  }
               ],
               "actionAccessibilityRequirement":[
                  {
                     "@type":"ActionAccessSpecification",
                     "availabilityStarts": "2015-01-01T00:00Z",
                     "availabilityEnds": "2015-12-31T00:00Z",
                     "eligibleRegion":{
                        "@type":"Country",
                        "name":[
                           "US"
                        ]
                     },
                     "category":"subscription",
                     "requiresSubscription":{
                        "@type":"MediaSubscription",
                        "name":"",
                        "@id":""
                     }
                  }
               ],
            },
            "gamePlatform": "Google Stadia",
            "publisher":{
               "name":"Made Up Media",
               "@id":"https://www.examplegame.com/uniuqe-id-org",
               "@type":"Organization"
            },
            "contributor":[
               {
                  "roleName":"developer",
                  "name":"Alpha Labs Man Made Studio",
                  "@id":"https://www.studionice.com/uniuqe-id-alpha",
                  "@type":"Organization"
               }
            ]
         }
      }
   ]
}

Rappresentazione di un'immagine di esempio con due personaggi del gioco

Illustrazione di una donna e di un uccello in un campo. 
{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "VideoGame",
  "@id": "http://www.examplegame.com/videoGame1",
  "url": "http://www.examplegame.com/videoGame1",

  ...,

  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mauren and Lord Wingflap!",
    "Keywords": "Mauren, Lord Wingflap the Destroyer",
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "character": [
      { "@type": "Person", "name": "Mauren" },
      { "@type": "Person", "name": "Lord Wingflap the Destoyer" }
    ],
    "copyrightHolder": {
      "@type": "Organization",
      "name": " ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": {
        "@type": "Audience",
        "geographicArea": [{"@type": "Country", "name": "US"},
                           {"@type": "Country", "name": "GB"}]
    },
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": [ "iconic", "background", "rightCentered", "noTitle", "noLogo",
                   "noCopyright", "noMatte", "smallFormat", "largeFormat"]
      }
    ]
  }
}

Gestire più regioni e lingue (internazionalizzazione)

Un'entità VideoGame potrebbe essere disponibile in più regioni e lingue.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "VideoGame",
  "@id": "http://www.example.com/my_favorite_game",
  "url": "http://www.example.com/my_favorite_game",
  "name": [
    {
      "@language": "en-us",
      "@value": "My Favorite Game"
    },
    {
      "@language": "es-mx",
      "@value": "mi juego favorito"
    },
    {
      "@language": "ja-jp",
      "@value": "私のfavourite game"
    }
  ],
  "description": [
    {
      "@language": "en-us",
      "@value": "Jenny meets Paul."
    },
    {
      "@language": "es-mx",
      "@value": "Jenny conoce a paul."
    },
    {
      "@language": "ja-jp",
      "@value": "PaulとJennyが会う。"
    }
  ],
  "potentialAction": [
    {
      "@type": "PlayGameAction",
      "gameAvailabilityType": "DEMO",
      "additionalType": "DownloadPlayAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_game?autoplay=true",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform"
        ]
      }
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "purchase",
        "availabilityStarts": "2021-06-24T11:00:00Z",
        "availabilityEnds": "2041-06-24T11:00:00Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "MX"
          }
        ]
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentLanguage",
          "value": [
            "en",
            "es"
          ]
        }
      ],
      "expectsAcceptanceOf": {
        "@type": "Offer",
        "priceSpecification": [
          {
            "@type": "UnitPriceSpecification",
            "price": 19.99,
            "priceCurrency": "USD",
            "priceType": "https://schema.org/ListPrice"
          },
          {
            "@type": "UnitPriceSpecification",
            "price": 360.00,
            "priceCurrency": "MXN",
            "priceType": "https://schema.org/ListPrice"
          }
        ],
        "seller": {
          "@type": "Organization",
          "name": "My Favorite Game Publisher"
        }
      }
    },
    {
      "@type": "PlayGameAction",
      "gameAvailabilityType": "DEMO",
      "additionalType": "DownloadPlayAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/jp/my_favorite_game?autoplay=true",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform"
        ]
      }
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "purchase",
        "availabilityStarts": "2021-07-24T11:00:00Z",
        "availabilityEnds": "2041-07-24T11:00:00Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "JP"
          }
        ]
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentLanguage",
          "value": [
            "ja"
          ]
        }
      ],
      "expectsAcceptanceOf": {
        "@type": "Offer",
        "priceSpecification": [
          {
            "@type": "UnitPriceSpecification",
            "price": 2189,
            "priceCurrency": "JPY",
            "priceType": "https://schema.org/ListPrice"
          }
        ],
        "seller": {
          "@type": "Organization",
          "name": "My Favorite Game Publisher"
        }
      }
    }
  ],
  // Other properties...
}