Questa pagina è stata tradotta dall'API Cloud Translation.

Creare un feed

Il feed multimediale è un oggetto JSON contenente una raccolta di entità che rappresentano i contenuti multimediali nel tuo catalogo, come serie TV, film, brani, album e altro ancora. Il primo passo del processo di onboarding è iniziare a sviluppare i feed. Quando i file sono pronti, devi ospitare il feed utilizzando uno dei metodi di hosting supportati da Google per il recupero regolare.

Requisiti per i formati dei file dei feed

Di seguito sono riportati i requisiti per i file dei 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 le impostazioni dell'editor di file).
Suddividi il file in più file se il file del feed supera 1 GB (non compresso).
Ti consigliamo di creare un file in base al tipo di entità (ad esempio, tvseries.json, tvseasons.json, tvepisodes.json, movies.json e così via).
- Se uno qualsiasi di questi file supera 1 GB, suddividi le relative entità in più file (ad esempio, tvepisodes_01.json, tvepisodes_02.json e così via).
- Se la dimensione del file è inferiore a 1 GB, non esiste un limite al numero di entità che puoi includere in un singolo file.
Assicurati che il file sia codificato senza BOM, in base alle specifiche JSON. Per verificare 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 insieme rappresentano 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, questo feed verrà analizzato e ripetuto ampiamente alcune volte per raggiungere una qualità superiore, rispetto alla quantità di informazioni acquisite e alla sua correttezza prima che venga importata e lanciata.

Feed temporaneo

In alcuni casi d'uso è necessaria l'espansione del feed di produzione. Ecco alcuni esempi:
- Espansione del feed in modo da includere nuovi tipi di entità, non lanciato in precedenza.
- Espansione del feed per includere un numero enorme di nuove entità/metadati da lanciare in nuove impostazioni internazionali.
- Espansione del feed a nuovi tipi di piattaforma. ad esempio quando il feed di produzione viene lanciato solo su Ricerca Google e ora vuoi espanderlo su Google TV.
In questi casi, è necessario un feed temporaneo. Questo feed è una copia del feed di produzione, ad eccezione del fatto che ha metadati aggiuntivi, ad esempio link diretti per una nuova piattaforma, metadati per una nuova lingua e così via.
Analogamente al feed di produzione, questo verrà analizzato e ripetuto ampiamente alcune volte per ottenere una qualità superiore rispetto alla quantità di informazioni acquisite e alla sua correttezza. Una volta raggiunta la barra della qualità, questo feed sostituisce quello attuale per diventare il nuovo feed.
Questo feed ci consente di separare il lancio iniziale da quelli aggiuntivi, eseguire tutti i test obbligatori senza influire sul feed di produzione. Ciò garantisce interruzioni all'esperienza dell'utente finale.

Collabora con il tuo rappresentante di Google per chiarire eventuali dubbi in merito a quanto riportato 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 includa tutti i contenuti del tuo catalogo, ti consigliamo di creare un feed di esempio con un piccolo insieme di entità. Mentre lavori al feed, probabilmente hai problemi. Limitando le dimensioni dell'insieme di entità, potrai eseguire il debug di questi errori e avvisi più facilmente.
Convalidare il feed di esempio

Mettiamo a disposizione strumenti che assicurano la conformità del tuo feed alle specifiche. Ti consigliamo di utilizzare questi strumenti per risolvere tutti gli errori e gli avvisi presenti 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 catalogo. Scegli un'entità con una struttura ragionevolmente complessa, ma che è comunque tipica per un'entità nel catalogo.

Utilizza lo strumento Convalida dei feed di dati per verificare la presenza di errori di sintassi e proprietà obbligatorie mancanti. Per informazioni dettagliate, consulta la sezione successiva.

Esempio di 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"
        }
      ]
    }
  ]
}

Convalidare il feed di esempio

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

Strumento Convalida dei feed di dati

Lo strumento Feed dei dati per la convalida può convalidare una singola entità alla volta. Utilizza questo strumento per convalidare un'entità di esempio dal tuo catalogo per individuare errori strutturali ed errori comuni relativi ai contenuti. Qui puoi trovare ulteriori dettagli sullo strumento.
Strumento di convalida degli schemi JSON

Lo strumento di convalida dello schema JSON può convalidare tutti i file in un feed. Utilizza questo strumento durante lo sviluppo del feed per evitare gli errori strutturali comuni. Potete trovare maggiori 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 per includere tutte le entità nel catalogo.
Utilizza spesso lo strumento Convalida dei feed di dati per convalidare un numero ridotto di entità nel feed alla volta (un numero elevato di entità nello strumento potrebbe bloccare il browser web). Verifica che il tuo feed includa tutte le entità nel tuo catalogo confrontando il numero di entità nel tuo feed con il numero di articoli nel tuo catalogo.