Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Creare un feed

Il feed multimediale è un oggetto JSON che contiene una raccolta di entità che rappresentano i contenuti multimediali nel tuo catalogo, ad esempio serie TV, film, canzoni, album e altro ancora. Il primo passaggio del processo di onboarding consiste nell'iniziare a sviluppare i feed. Una volta pronti i file, devi ospitare il feed utilizzando uno dei metodi di hosting supportati per consentire a Google di recuperarlo regolarmente.

Requisiti per i formati file dei 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).
Se il file del feed ha dimensioni superiori a 1 GB (non compresso), suddividilo in più file.
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 sue entità in più file (ad esempio tvepisodes_01.json, tvepisodes_02.json e così via).
- Se 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 previsto dalla 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 di 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 stai eseguendo l'integrazione con Google per la prima volta.
Una volta inviato a Google, questo feed verrà analizzato in modo approfondito e ripetuto alcune volte per raggiungere un livello di qualità più elevato rispetto alla quantità di informazioni acquisite e alla loro correttezza prima di essere infine importato e lanciato.

Feed di gestione temporanea

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 elevato di nuove entità/metadati da lanciare in nuove località.
- Espansione del feed a nuovi tipi di piattaforme. Ad esempio, quando il feed di produzione viene lanciato solo sulla Ricerca Google e ora vuoi estendere il lancio a Google TV.
In questi casi, è necessario un feed di gestione temporanea. Questo feed è una copia del feed di produzione, con la differenza che contiene metadati aggiuntivi, ad esempio deep link per una nuova piattaforma, metadati per una nuova lingua e così via.
Analogamente al feed di produzione, questo verrà analizzato in modo approfondito e ripetuto alcune volte per raggiungere un livello di qualità più elevato in relazione alla quantità di informazioni acquisite e alla loro correttezza. Una volta raggiunta la soglia di qualità, questo feed sostituisce l'attuale feed di produzione per diventare 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 dell'utente finale non viene interrotta.

Collabora con il tuo rappresentante di Google per chiarire eventuali domande su quanto sopra.

Crea un file del feed

Durante la creazione del feed, segui queste best practice:

Crea 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 un piccolo insieme di entità. Durante la creazione del feed, è probabile che si verifichino problemi. Limitando le dimensioni dell'insieme di entità, potrai eseguire il debug di questi errori e avvisi più facilmente.
Convalida il feed di esempio

Forniamo strumenti che garantiscono che il tuo feed sia conforme alle specifiche. Ti consigliamo di utilizzare questi strumenti per risolvere tutti gli errori e gli avvisi rilevati nel feed di esempio.
Crea un feed di produzione

Dopo aver verificato che la struttura di un piccolo insieme di entità è corretta, sviluppa un feed per l'intero catalogo.

Crea un feed di esempio

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

Utilizza lo strumento di convalida dello schema JSON per verificare la presenza di errori di sintassi e proprietà obbligatorie mancanti. Per maggiori dettagli, consulta 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

I seguenti strumenti sono disponibili per aiutarti a convalidare un feed di esempio in base alle specifiche dei dati strutturati di Google per i feed multimediali:

Strumento di convalida dello schema JSON

Lo strumento di convalida dello schema JSON convalida tutti i file di un feed localmente prima del caricamento. Utilizza questo strumento durante lo sviluppo del feed per evitare errori comuni di struttura e tipo. Puoi trovare maggiori dettagli sullo strumento qui.
Proprietà del catalogo su Search Console

Dopo che il tuo rappresentante di Google ha attivato la proprietà catalogo di Search Console e il tuo feed di esempio o di gestione temporanea è stato importato, utilizza le proprietà catalogo su Search Console per esaminare gli errori di convalida, gli avvisi e la diagnostica di importazione a livello di entità.

Crea un feed di produzione

Una volta risolti tutti gli errori e gli avvisi strutturali nel feed di esempio, espandi il feed per includere tutte le entità del tuo catalogo.
Esegui lo strumento di convalida dello schema JSON sui file dei feed espansi e controlla le proprietà catalogo su Search Console dopo il caricamento per verificare che non siano presenti errori di convalida. Verifica che il feed includa tutte le entità del tuo catalogo confrontando il numero di entità nel feed con il numero di articoli nel catalogo.