Questa pagina è stata tradotta dall'API Cloud Translation.

Creare un feed

Il feed di contenuti multimediali è un oggetto JSON che contiene una raccolta di entità che rappresentano i contenuti multimediali nel tuo catalogo, ad esempio serie TV, film, brani, album e altro ancora. Il primo passaggio della procedura di onboarding consiste nell'iniziare a sviluppare i feed. Una volta che i file sono pronti, devi ospitare il feed utilizzando uno dei metodi di hosting supportati per consentirne il recupero regolare da parte di Google.

Requisiti per i formati dei file del feed

Di seguito sono riportati i requisiti per i file del feed:

Il file del feed deve avere l'estensione di nome file .json.
Non criptare il file del feed.
Codifica il file del feed in UTF-8 (controlla l'impostazione dell'editor di file).
Suddividi il file in più file se il file del feed è più grande di 1 GB (non compresso).
Ti consigliamo di creare un file per tipo di entità (ad esempio tvseries.json, tvseasons.json, tvepisodes.json, movies.json e così via).
- Se uno di questi file supera 1 GB, suddividi le relative entità in più file (ad es. tvepisodes_01.json, tvepisodes_02.json e così via).
- Finché le dimensioni del file sono inferiori a 1 GB, non esiste alcun limite al numero di entità che puoi includere in un singolo file.
Assicurati che il file sia codificato senza BOM, come da specifica JSON. Per eseguire il controllo su un sistema operativo Linux, hexdump file.json | head -n 1 non deve iniziare con BBEF all'indirizzo 0x00.

Tipi di feed

Feed di produzione

Rappresenta l'insieme di file del feed JSON che rappresentano insieme l'intero catalogo che vuoi lanciare su Google. Puoi scoprire come creare un feed nella sezione di seguito.
Questo è l'unico feed di cui hai bisogno se esegui l'integrazione con Google per la prima volta.
Una volta inviato a Google, il feed verrà analizzato e sottoposto a iterazioni approfondite alcune volte per raggiungere un livello di qualità più elevato in termini di quantità di informazioni acquisite e correttezza prima di essere finalmente importato e lanciato.

Feed di staging

Esistono alcuni casi d'uso che richiedono l'espansione del feed di produzione. Ecco alcuni esempi di questi scenari:
- Espansione del feed per includere nuovi tipi di entità, non lanciati in precedenza.
- Espansione del feed per includere un numero enorme di nuove entità/metadati da lanciare in nuove lingue.
- Espansione del feed a nuovi tipi di piattaforme. Ad esempio, quando il feed di produzione è stato lanciato solo su Ricerca Google e ora vuoi espandere il lancio a Google TV.
In questi casi, è necessario un feed di staging. Questo feed è una copia del feed di produzione, tranne per il fatto che contiene metadati aggiuntivi, ad esempio link diretti per una nuova piattaforma, metadati per una nuova lingua e così via.
Come per il feed di produzione, questo feed verrà analizzato e ripetuto più volte per ottenere uno standard di qualità più elevato in termini di quantità di informazioni acquisite e della loro correttezza. Una volta raggiunta la barra di qualità, questo feed sostituisce il feed di produzione corrente diventando il nuovo feed di produzione.
Questo feed ci consente di separare il lancio iniziale dai lanci aggiuntivi ed eseguire tutti i test richiesti senza influire sul feed di produzione. In questo modo, l'esperienza utente finale non viene interrotta.

Rivolgiti al tuo rappresentante di Google per eventuali domande in merito a quanto sopra.

Creare un file del feed

Segui queste best practice per la creazione del feed:

Creare un feed di esempio utilizzando un piccolo insieme di entità

Prima di creare un feed che contenga tutti i contenuti del tuo catalogo, ti consigliamo di creare un feed di esempio con solo un piccolo insieme di entità. Mentre lavori al feed, è probabile che tu stia riscontrando dei problemi. Se limiti le dimensioni dell'insieme di entità, potrai eseguire il debug di questi errori e ammonimenti più facilmente.
Convalidare il feed di esempio

Forniamo strumenti che garantiscono la conformità del tuo feed alle specifiche. Ti consigliamo di utilizzare questi strumenti per risolvere tutti gli errori e gli avvisi rilevati nel feed di esempio.
Creare un feed di produzione

Dopo aver verificato di avere una buona struttura per il piccolo insieme di entità, sviluppa un feed per l'intero catalogo.

Creare un feed di esempio

Seleziona un'entità rappresentativa dal tuo catalogo. Scegli una persona giuridica con una struttura ragionevolmente complessa, ma comunque tipica di una persona giuridica nel catalogo.

Utilizza lo strumento di convalida del feed di dati per verificare la presenza di errori di sintassi e proprietà obbligatorie mancanti. (per maggiori dettagli, vedi la sezione seguente).

Esempio di un feed con una singola entità Movie

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Movie",
      "@id": "http://www.example.com/my_favorite_movie",
      "url": "http://www.example.com/my_favorite_movie",
      "name": "My Favorite Movie",
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
          "inLanguage": "en",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "actionAccessibilityRequirement": {
          "@type": "ActionAccessSpecification",
          "category": "subscription",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "name": "Example Package",
            "commonTier": true,
            "@id": "[partner determined string]"
          },
          "availabilityStarts": "2018-07-21T10:35:29Z",
          "availabilityEnds": "2019-10-21T10:35:29Z",
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        }
      },
      "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
      "releasedEvent": {
        "@type": "PublicationEvent",
        "startDate": "2008-01-20",
        "location": {
          "@type": "Country",
          "name": "US"
        }
      },
      "description": "This is my favorite movie.",
      "actor": [
        {
          "@type": "Person",
          "name": "John Doe",
          "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
        },
        {
          "@type": "Person",
          "name": "Jane Doe",
          "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
        }
      ],
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "IMDB_ID",
          "value":  "tt0123456"
        }
      ]
    }
  ]
}

Convalida il feed di esempio

Per aiutarti a convalidare un feed di esempio con le specifiche dei dati strutturati di Google per i feed multimediali, sono disponibili i seguenti strumenti.

Strumento di convalida dei feed di dati

Lo strumento di convalida dei feed di dati può convalidare una singola entità alla volta. Utilizza questo strumento per convalidare un'entità di esempio del tuo catalogo per rilevare errori strutturali ed errori comuni dei contenuti. Puoi trovare ulteriori dettagli sullo strumento qui.
Strumento di convalida dello schema JSON

Lo strumento di convalida dello schema JSON può convalidare tutti i file di un feed. Utilizza questo strumento durante lo sviluppo del feed per evitare errori strutturali comuni. Puoi trovare ulteriori dettagli sullo strumento qui.

Creare un feed di produzione

Una volta risolti tutti gli errori e gli avvisi nel feed di esempio, espandi il feed in modo da includere tutte le entità del tuo catalogo.
Utilizza spesso lo strumento di convalida dei feed di dati per convalidare un numero limitato di entità alla volta nel feed (l'inserimento di un numero elevato di entità nello strumento potrebbe bloccare il browser web). Verifica che il feed includa tutte le entità nel tuo catalogo confrontando il numero di entità nel feed con il numero di articoli nel catalogo.