Crear un feed

El feed multimedia es un objeto JSON que contiene una colección de entidades que representan el contenido multimedia de tu catálogo, como series de TV, películas, canciones y álbumes. El primer paso del proceso de integración es comenzar a desarrollar tus feeds. Una vez que los archivos estén listos, debes alojar el feed mediante uno de los métodos de hosting compatibles para que Google lo recupere periódicamente.

Requisitos del formato de archivo del feed

A continuación, se indican los requisitos de los archivos de feed:

  • El archivo del feed debe tener la extensión de nombre de archivo .json.
  • No encriptes tu archivo de feed.
  • Codifique el archivo de su feed en UTF-8 (revise la configuración del editor de archivos).

    alt_text

  • Divida el archivo en varios archivos si el archivo tiene más de 1 GB (sin comprimir).

  • Te recomendamos crear un archivo por tipo de entidad (por ejemplo, tvseries.json, tvseasons.json, tvepisodes.json, movies.json, etc.).

    • Si alguno de estos archivos excede 1 GB, divide sus entidades en varios archivos (por ejemplo, tvepisodes_01.json, tvepisodes_02.json, etc.).
    • Siempre que el tamaño del archivo sea inferior a 1 GB, no hay límite en la cantidad de entidades que puedes incluir en un solo archivo.
  • Asegúrate de que el archivo esté codificado sin BOM, según la especificación JSON. Para comprobar en un SO Linux, hexdump file.json | head -n 1 no debe comenzar con BBEF en la dirección 0x00.

Tipos de feeds

Feed de producción

  • Representa el conjunto de archivos de feed JSON que, en conjunto, representan todo el catálogo que deseas lanzar en Google. Puede obtener información sobre cómo crear un feed en la siguiente sección.
  • Este es el único feed que necesitas si te integras a Google por primera vez.
  • Una vez que se envíe este feed a Google, se lo analizará y, luego, iterará en varias ocasiones para obtener una barra de mayor calidad con la cantidad de información que se captura y su precisión antes de que finalmente se transfiera.

Feed de etapa de pruebas

  • Hay ciertos casos de uso que requieren la expansión del feed de producción. A continuación, se muestran algunos ejemplos de estas situaciones:
    • Expansión del feed para incluir nuevos tipos de entidades.
    • Expansión del feed para incluir una gran cantidad de nuevas entidades o metadatos para el lanzamiento en configuraciones regionales nuevas.
    • Expansión del feed a nuevos tipos de plataformas Por ejemplo, cuando el feed de producción solo se lanza en la Búsqueda de Google y ahora deseas expandirlo a Google TV.
  • En estos casos, se requiere un feed de etapa de pruebas. Este feed es una copia del feed de producción, excepto que tiene metadatos adicionales, por ejemplo, vínculos directos para una plataforma nueva, metadatos para una configuración regional nueva, etcétera.
  • Al igual que en el feed de producción, esto se analizará y se repetirá de forma exhaustiva varias veces para lograr una barra de mayor calidad con la cantidad de información que se captura y su precisión. Una vez que se alcanza la barra de calidad, este feed reemplaza el feed de producción actual para convertirse en el nuevo.
  • Este feed nos permite separar el lanzamiento inicial de los lanzamientos adicionales y realizar todas las pruebas necesarias sin afectar el feed de producción. Esto garantiza que no se interrumpa la experiencia del usuario final.

Trabaje con su representante de Google para aclarar cualquier duda que tenga al respecto.

Cómo crear un archivo de feed

Siga estas prácticas recomendadas cuando cree el feed:

  1. Cree un feed de muestra con un conjunto pequeño de entidades

    Antes de crear un feed que incluya todo el contenido de tu catálogo, te recomendamos que crees un feed de muestra con un pequeño conjunto de entidades. Mientras trabajas en tu feed, es probable que tengas problemas. Si limitas el tamaño del conjunto de entidades, podrás depurar estos errores y advertencias con mayor facilidad.

  2. Valide el feed de muestra

    Proporcionamos herramientas para garantizar que su feed cumpla con las especificaciones. Te recomendamos usar estas herramientas para resolver todos los errores y las advertencias que se encuentran en tu feed de muestra.

  3. Cree un feed de producción

    Después de verificar que tienes una buena estructura para el conjunto pequeño de entidades, desarrolla un feed para todo tu catálogo.

Cree un feed de muestra

  1. Selecciona una entidad representativa de tu catálogo. Elige una entidad con una estructura razonablemente compleja, pero que sea típica de una entidad en el catálogo.
  2. Utilice la herramienta de validación de feeds de datos para comprobar si hay errores de sintaxis y las propiedades requeridas faltantes. (Consulta la siguiente sección para obtener más detalles).

    Ejemplo de un feed con una sola entidad 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"
            }
          ]
        }
      ]
    }
    

Valida el feed de muestra

Las siguientes herramientas están disponibles para ayudarlo a validar un feed de muestra con las especificaciones de datos estructurados de Google para los feeds multimedia.

  • Herramienta de validación de feeds de datos

    La herramienta de validación de feeds de datos puede validar una sola entidad a la vez. Usa esta herramienta para validar una entidad de muestra de tu catálogo en busca de errores estructurales y de contenido comunes. Puedes encontrar más detalles sobre la herramienta aquí.

  • Herramienta de validación de esquema JSON

    La herramienta de validación de esquemas JSON puede validar todos los archivos de un feed. Usa esta herramienta durante el desarrollo del feed para evitar errores estructurales comunes. Puedes encontrar más detalles sobre la herramienta aquí.

Crear un feed de producción

  1. Una vez que se resuelvan todos los errores y las advertencias del feed de muestra, expándelo para incluir todas las entidades de tu catálogo.
  2. Usa la herramienta de validación de feeds de datos con frecuencia para validar una pequeña cantidad de entidades en tu feed a la vez (pegar una gran cantidad de entidades en la herramienta puede inmovilizar el navegador web). Compara la cantidad de entidades de tu feed con la cantidad de elementos que contiene el feed para confirmar que incluya todas las entidades del catálogo.