Crear un feed

El feed de medios es un objeto JSON que contiene un conjunto de entidades que representan la contenido multimedia de tu catálogo, como series de TV, películas, canciones, álbumes y mucho más. El primer paso en el proceso de incorporación es comenzar a desarrollar tus feeds. Cuando los archivos estén listos, deberás alojar el feed con uno de los métodos de hosting admitidos para que Google lo recupere con regularidad.

Requisitos de formato de archivo de feed

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

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

    alt_text

  • Divide el archivo en varios archivos si el archivo de feed supera 1 GB (sin comprimir).

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

    • Si alguno de estos archivos supera 1 GB, divide sus entidades en varias archivos (por ejemplo, tvepisodes_01.json, tvepisodes_02.json, etcétera).
    • 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 la BoM, según la especificación de JSON. Para verificar 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

  • Esto representa el conjunto de archivos de feed JSON que, en conjunto, representan todo el catálogo que quieres lanzar en Google. Aprende a crear un feed en la siguiente sección.
  • Este es el único feed que necesitas si realizas la integración en Google por primera vez.
  • Una vez que se envíe el feed a Google, se analizará y se iterará en profundidad veces para lograr una barra de calidad más alta, es decir, la cantidad de información que se captura y su correcta antes de que se transfieran y inicien.

Feed de etapa de pruebas

  • Existen ciertos casos de uso que requieren la expansión del feed de producción. Algunos ejemplos de estas situaciones:
    • Expansión del feed para incluir nuevos tipos de entidades que no se hayan lanzado anteriormente.
    • Expansión del feed para incluir una gran cantidad de entidades o metadatos nuevos para lanzar en nuevos configuraciones regionales.
    • Expansión del feed a nuevos tipos de plataformas Por ejemplo, cuando el feed de producción solo lanzado en Búsqueda de Google y ahora quieres expandirlo a Google TV.
  • En esos casos, se requiere un feed de etapa de pruebas. Este feed es una copia del feed de producción, con la excepción de que Tiene metadatos adicionales, por ejemplo, vínculos directos para una plataforma nueva o metadatos para una configuración regional nueva etcétera.
  • Al igual que con el feed de producción, esto se analizará e iterará de manera exhaustiva varias veces para Lograr una barra de mayor calidad, es decir, la cantidad de información capturada y su precisión. Una vez que se alcanza el nivel de calidad, este feed reemplaza el feed de producción actual para convertirse en nuevo feed de producción.
  • Este feed nos permite separar el lanzamiento inicial de los adicionales, realizar todo las pruebas requeridas sin afectar el feed de producción. Esto garantiza que no haya interrupciones hasta el final la experiencia del usuario.

Comunícate con tu representante de Google para aclarar cualquier pregunta que puedas tener sobre los aspectos anteriores.

Crea un archivo de feed

Cuando crees el feed, sigue estas prácticas recomendadas:

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

    Antes de crear un feed con todo el contenido de tu catálogo, te recomendamos crear un feed de muestra con solo un conjunto pequeño de entidades. Cuando trabajes en tu feed, es probable que encuentres problemas. Si limitas el tamaño del conjunto de entidades, podrás depurar estos errores y las advertencias con más facilidad.

  2. Valida el feed de muestra

    Brindamos herramientas que garantizan que tu feed cumpla con las especificaciones. Recomendaciones Úsalas para resolver todos los errores y las advertencias que se encuentran en tu feed de muestra.

  3. Crea un feed de producción

    Una vez que hayas verificado que tienes una buena estructura para el pequeño conjunto de entidades, desarrolla un feed para todo tu catálogo.

Crea un feed de muestra

  1. Selecciona una entidad representativa de tu catálogo. Elige una entidad con una estructura razonablemente compleja, pero que siga siendo típica de una entidad del catálogo.
  2. Usa la herramienta de validación de feeds de datos para comprobar si hay errores de sintaxis y si faltan propiedades obligatorias. (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 los datos estructurados de Google para los feeds de medios.

  • 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. Usar esta herramienta para validar una muestra de tu catálogo en busca de errores estructurales y de contenido comunes. Puedes encontrar más consulta los detalles sobre la herramienta aquí.

  • Herramienta de validación del esquema de JSON

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

Crea un feed de producción

  1. Una vez que se resuelvan todos los errores y las advertencias en el feed de muestra, expande el feed para incluir todos las entidades de tu catálogo.
  2. Usar la herramienta de validación de feeds de datos con frecuencia para validar una pequeña cantidad de entidades en su feed a la vez (pegar una gran cantidad de de la herramienta podrían congelar el navegador). Confirma que tu feed incluya todas las entidades del catálogo mediante la comparación entre la cantidad de entidades del feed y la cantidad de artículos de la en tu catálogo de productos.