Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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:
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.
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.
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.
[null,null,[],[[["\u003cp\u003eThe Media feed is a JSON object that contains media content, and onboarding begins with developing and hosting these feeds.\u003c/p\u003e\n"],["\u003cp\u003eFeed files must be in \u003ccode\u003e.json\u003c/code\u003e format, UTF-8 encoded without BOM, unencrypted, and potentially split into multiple files if exceeding 1GB.\u003c/p\u003e\n"],["\u003cp\u003eTwo types of feeds exist: Production feed for initial launch of your entire catalog and Staging feed for subsequent expansions or new platform integrations.\u003c/p\u003e\n"],["\u003cp\u003eBefore creating a full production feed, it is recommended to start with a sample feed, validate it using provided tools, and then expand it to include your entire catalog.\u003c/p\u003e\n"]]],["The initial step in onboarding is developing media feeds, which are JSON files representing your catalog's content. Once developed, these files must be hosted for regular Google fetching. Feed files must be in `.json` format, UTF-8 encoded, unencrypted, and under 1GB (uncompressed); splitting larger files is recommended. Two types exist: production (for initial launch) and staging (for expansion), both are validated and iterated. You should start with a small sample feed for validation, then use tools to validate it, and expand to a production feed.\n"],null,["# Create a feed\n\nThe Media feed is a JSON object that contains a collection of entities that represent the\nmedia content in your catalog, such as TV Series, Movies, Songs, Albums, and more. The first step in\nthe onboarding process is to start developing your feeds. Once the files are ready, you need to [host](./host-the-feed)\nthe feed using one of the supported hosting methods for Google to fetch regularly.\n| **Note:** If you haven't gathered all the required information for your content, see the [Collect Information](../collect-information/) section.\n\nFeed file format requirements\n-----------------------------\n\nThe following are the requirements for the feed file(s):\n\n- Feed file must have the filename extension `.json`.\n- Don't encrypt your feed file.\n- Encode your feed file in UTF-8 (check your file editor setting).\n\n- Split the file into multiple files if your feed file is larger than 1 GB (uncompressed).\n\n- We recommend you create a file per entity type (for example, `tvseries.json`, `tvseasons.json`, `tvepisodes.json`, `movies.json`, etc).\n\n - If any of these files exceeds 1GB, split its entities into multiple files (for example, `tvepisodes_01.json`, `tvepisodes_02.json`, etc).\n - As long as the file size is less than 1 GB, there is no limitation on how many entities you can include in a single file.\n- Ensure that the file is encoded **without** BOM, as per [JSON specification](https://tools.ietf.org/html/rfc7159#section-8.1). To check on a linux OS, `hexdump file.json | head -n 1` must not start with `BBEF` at address 0x00.\n\nTypes of feeds\n--------------\n\n### Production feed\n\n- This represents the set of json feed file(s) that together represent your entire catalog you want to launch on Google. You can learn how to create a feed in the section below.\n- This is the only feed you need if you are integrating with Google for the first time.\n- Once this feed is submitted to Google, it will be extensively analyzed and iterated on a few times to achieve a higher quality bar w.r.t the amount of information being captured and its correctness before it is finally ingested and launched.\n\n### Staging feed\n\n- There are certain use cases that require the expansion of the production feed. A few examples of such scenarios are:\n - Expansion of the feed to include new entity types, not previously launched.\n - Expansion of the feed to include a huge number of new entities/metadata to launch in new locales.\n - Expansion of the feed to new platform types. For example, when the production feed is only launched on Google Search and now you want to expand the launch to Google TV.\n- In such cases, a staging feed is required. This feed is a copy of the production feed except that it has additional metadata, for example, deep links for a new platform, metadata for a new locale and so on.\n- Similar to the production feed, this will be extensively analyzed and iterated on a few times to achieve a higher quality bar w.r.t the amount of information being captured and its correctness. Once the quality bar is achieved, this feed replaces the current production feed to become the new production feed.\n- This feed allows us to separate the initial launch from the additional launches, perform all required testing, without affecting the production feed. This ensures no disruptions to the end user experience.\n\nWork with your Google representative to clarify any questions you may have on the above.\n\nCreate a feed file\n------------------\n\nFollow these best practices when creating the feed:\n\n1. [Create a sample feed using a small set of entities](#create_a_sample_feed)\n\n Before building a feed that contains all the content in your catalog, we recommend you create a\n sample feed with only a small set of entities. While working on your feed, you're likely to run into\n issues. By limiting your the size of the set of entities, you will be able to debug these errors and\n warnings more easily.\n2. [Validate the sample feed](#validate_the_sample_feed)\n\n We provide tools that ensure that your feed is compliant with the specifications. We recommend\n you use these tools to resolve all the errors and warnings found in your sample feed.\n3. [Create a production feed](#create_a_production_feed)\n\n After you've verified that you have a good structure for the small set of your entities, develop a feed for your entire catalog.\n\n### Create a sample feed\n\n1. Select one representative entity from your catalog. Choose an entity with a reasonably complex structure, but is still typical for an entity in the catalog.\n 2. Use the [Data Feed Validation tool](https://actions.google.com/tools/feed-validator/u/0/) to check for syntax errors and missing required properties. (See the next section for details.) Example of a feed with a single `Movie` entity \n\n ```carbon\n {\n \"@context\": \"http://schema.org\",\n \"@type\": \"DataFeed\",\n \"dateModified\": \"2018-07-20T00:44:51Z\",\n \"dataFeedElement\": [\n {\n \"@context\": [\"http://schema.org\", {\"@language\": \"en\"}],\n \"@type\": \"Movie\",\n \"@id\": \"http://www.example.com/my_favorite_movie\",\n \"url\": \"http://www.example.com/my_favorite_movie\",\n \"name\": \"My Favorite Movie\",\n \"potentialAction\": {\n \"@type\": \"WatchAction\",\n \"target\": {\n \"@type\": \"EntryPoint\",\n \"urlTemplate\": \"http://www.example.com/my_favorite_movie?autoplay=true\",\n \"inLanguage\": \"en\",\n \"actionPlatform\": [\n \"http://schema.org/DesktopWebPlatform\",\n \"http://schema.org/MobileWebPlatform\",\n \"http://schema.org/AndroidPlatform\",\n \"http://schema.org/AndroidTVPlatform\",\n \"http://schema.org/IOSPlatform\",\n \"http://schema.googleapis.com/GoogleVideoCast\"\n ]\n },\n \"actionAccessibilityRequirement\": {\n \"@type\": \"ActionAccessSpecification\",\n \"category\": \"subscription\",\n \"requiresSubscription\": {\n \"@type\": \"MediaSubscription\",\n \"name\": \"Example Package\",\n \"commonTier\": true,\n \"@id\": \"[partner determined string]\"\n },\n \"availabilityStarts\": \"2018-07-21T10:35:29Z\",\n \"availabilityEnds\": \"2019-10-21T10:35:29Z\",\n \"eligibleRegion\": [\n {\n \"@type\": \"Country\",\n \"name\": \"US\"\n },\n {\n \"@type\": \"Country\",\n \"name\": \"CA\"\n }\n ]\n }\n },\n \"sameAs\": \"https://en.wikipedia.org/wiki/my_favorite_movie\",\n \"releasedEvent\": {\n \"@type\": \"PublicationEvent\",\n \"startDate\": \"2008-01-20\",\n \"location\": {\n \"@type\": \"Country\",\n \"name\": \"US\"\n }\n },\n \"description\": \"This is my favorite movie.\",\n \"actor\": [\n {\n \"@type\": \"Person\",\n \"name\": \"John Doe\",\n \"sameAs\": \"https://en.wikipedia.org/wiki/John_Doe\"\n },\n {\n \"@type\": \"Person\",\n \"name\": \"Jane Doe\",\n \"sameAs\": \"https://en.wikipedia.org/wiki/Jane_Doe\"\n }\n ],\n \"identifier\": [\n {\n \"@type\": \"PropertyValue\",\n \"propertyID\": \"IMDB_ID\",\n \"value\": \"tt0123456\"\n }\n ]\n }\n ]\n }\n ```\n\n### Validate the sample feed\n\nThe following tools are available to help you validate a sample feed with Google's structured data\nspecifications for media feeds.\n\n- **Data Feed Validation tool**\n\n The Data Feed Validation tool can validate a single entity at a time. Use this tool to validate a sample\n entity from your catalog for structural errors and common content errors. You can find more\n details about the tool [here](../tools/troubleshoot-using-the-data-feed-validation-tool).\n- **JSON Schema Validation tool**\n\n The JSON Schema Validation tool can validate all files in a feed. Use this tool during the\n development of the feed to avoid common structural errors. You can find more details about the\n tool [here](../tools/jsonschemas).\n\n### Create a production feed\n\n1. Once all the errors and warnings in the sample feed are resolved, expand the feed to include all the entities in your catalog.\n2. Use the [Data Feed Validation tool](https://actions.google.com/tools/feed-validator/u/0/) frequently to validate a small number of entities in your feed at a time (Pasting a large number of entities on the tool may freeze the web browser). Confirm that your feed includes all the entities in your catalog by comparing the number of entities in your feed with the number of items in your catalog."]]
