Creare un feed

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

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 del nome file .json.
  • Non criptare il file del feed.

  • Codifica il file del feed in UTF-8 (controlla l'impostazione dell'editor di file).

    alt_text

  • Suddividi il file in più file se il file del feed ha dimensioni superiori a 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 entità in più (ad esempio, tvepisodes_01.json, tvepisodes_02.json e così via).
    • Se la dimensione del file è inferiore 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 indicato nelle specifiche JSON. Per verificare su Linux OS, 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. Per sapere come creare un feed, consulta la sezione di seguito.
  • Questo è l'unico feed necessario se esegui l'integrazione con Google per la prima volta.
  • Una volta inviato a Google, il feed verrà analizzato approfonditamente e iterato volte a raggiungere un livello di qualità superiore rispetto alla quantità di informazioni prima dell'importazione e dell'avvio.

Feed temporaneo

  • Esistono alcuni casi d'uso che richiedono l'espansione del feed di produzione. Alcuni esempi scenari di questo tipo sono:
    • 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 nuovi impostazioni internazionali.
    • Espansione del feed a nuovi tipi di piattaforma. Ad esempio, quando il feed di produzione è sulla Ricerca Google, ma vuoi estenderlo anche a Google TV.
  • In questi casi, è richiesto un feed temporaneo. Questo feed è una copia del feed di produzione, con l'eccezione 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, questa verrà analizzata in modo approfondito e ripetuto più volte per raggiungere un livello di qualità superiore rispetto alla quantità di informazioni che vengono acquisite e alla loro correttezza. Una volta raggiunto il livello di qualità, questo feed sostituisce l'attuale feed di produzione per diventare nuovo feed di produzione.
  • Questo feed ci consente di separare il lancio iniziale da quelli aggiuntivi, eseguire tutte test richiesti, senza influire sul feed di produzione. In questo modo eviterai interruzioni fino alla fine un'esperienza utente positiva.

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

Creare un file del feed

Segui queste best practice durante la creazione del feed:

  1. 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 tuo feed, potresti incontrare che le applicazioni presentino problemi di prestazioni. Se limiti le dimensioni dell'insieme di entità, potrai eseguire il debug di questi errori e più facilmente gli avvisi.

  2. Convalidare il feed di esempio

    Forniamo strumenti che garantiscono la conformità del feed alle specifiche. I nostri suggerimenti utilizzi questi strumenti per risolvere tutti gli errori e gli avvisi rilevati nel feed di esempio.

  3. 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.

Crea un feed di esempio

  1. Seleziona un'entità rappresentativa dal catalogo. Scegli un'entità con una struttura ragionevolmente complessa, ma che è comunque tipica di un'entità nel catalogo.
  2. Utilizza lo strumento Data Feed Validation per verificare la presenza di errori di sintassi e di proprietà obbligatorie mancanti. Per informazioni dettagliate, consulta la prossima sezione.

    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

Sono disponibili i seguenti strumenti per aiutarti a convalidare un feed di esempio con i dati strutturati di Google specifiche per i feed multimediali.

  • Strumento Convalida feed di dati

    Lo strumento Data Feed Validation è in grado di convalidare una singola entità alla volta. Utilizza questo strumento per convalidare un campione del tuo catalogo per individuare errori di struttura ed errori comuni nei contenuti. Puoi trovare altre dettagli sullo strumento sono disponibili qui.

  • Strumento di convalida degli schemi JSON

    Lo strumento JSON Schema Validation può convalidare tutti i file di un feed. Usa questo strumento durante lo sviluppo del feed per evitare errori strutturali comuni. Puoi trovare ulteriori dettagli sulle qui.

Creare un feed di produzione

  1. Una volta risolti tutti gli errori e gli avvisi nel feed di esempio, espandi il feed in modo da includere tutti le entità nel tuo catalogo.
  2. Utilizzare lo strumento Data Feed Validation. spesso per convalidare un numero limitato di entità nel feed alla volta (incollando un gran numero sullo strumento potrebbero bloccare il browser web). Verifica che il feed includa tutte le entità nel tuo catalogo confrontando il numero di entità nel tuo feed con il numero di articoli nel tuo catalogo.
Indietro
Identifica il prezzo
Avanti
Ospita il feed